Décoder l'aide ESRI pour automatiser vos outils

Pour automatiser un outil ArcGIS via python il faut commencer par accéder à l'aide en ligne ESRI de l'outil. Tapez le nom de votre outil (en anglais) suivi de "arcpy" dans Google.

ProcédureAccédez à l'aide de l'outil "Clip".

Tapez clip "arcpy arcgis pro", vous accédez à l'aide officielle Esri de l'outil : https://pro.arcgis.com/fr/pro-app/latest/tool-reference/analysis/clip.htm.

Procédure
  1. L'aide en ligne ESRI commence par une description plus ou moins détaillée de l'outil et de son fonctionnement.

    Vous connaissez déjà l'outil, on peut passer directement au code ! --> Paramètres

  2. Après avoir cliqué sur « Paramètres », cliquez sur Python

    Vous retrouvez la ligne de code Python en 1 clic

  3. Comprendre la ligne de code

    Tous les paramètres de l'outil sont détaillés dans le tableau. Les paramètres sont appelés à l'intérieur des parenthèses ( ) et sont séparés d'une virgule. Le paramètre entre accolade { } est facultatif et peut être remplacé par des guillemets vides (plus d'informations en bas de page)

    Exemple d'utilisation de Clip :

    1
    import arcpy
    2
    arcpy.env.workspace = r'URL du dossier ou gdb'
    3
    4
    # Découper le réseau hydrographique de la France selon les limites du départements de l'oise
    5
    input_feature = 'Hydrographie_France.shp' # réseau hydrographique de la France
    6
    clipping_feature = 'Dpt_Oise.shp' # Limites du département de l'Oise
    7
    output_feature = 'Hydrographie_Oise.shp' # Couche générée en sortie
    8
    9
    arcpy.analysis.Clip(input_feature, clipping_feature, output_feature) # permet de découper le réseau hydrographique de la France selon les limites du départements de l'oise
    Compléments

    Pensez à vous diriger vers la fin de la page pour retrouver des exemples d'utilisation de l'outil en question.

  4. Exemple supplémentaire

    Exemple de l'outil buffer avec un paramètre facultatif au milieu de la ligne de code.

    1
    import arcpy
    2
    arcpy.env.workspace = r'URL du dossier ou gdb'
    3
    4
    # Génère de 500m autours du réseau hydrographique de l'Oise
    5
    input_feature = 'Hydrographie_Oise.shp' # réseau hydrographique de l'Oise
    6
    output_feature = 'Hydrographie_500m.shp' # Couche générée en sortie avec un tampon de 500m
    7
    distance = '500 Meters' #Buffer de 500m
    8
    9
    arcpy.analysis.Buffer(input_feature, output_feature, distance, "", "", 'ALL') # Génère un buffer de 500m : deux paramètres facultatifs ne sont pas pris en compte mais doivent être indiqués avec de pouvoir indiquer l'option dissove via la commande ALL) #ALL permet la fusion des buffer entre eux

    Attention

    L'écriture de « 500 Meters » est importante ! « 500 Meter » n'aurait pas fonctionné par exemple.

    Pensez à ouvrir l'outil sur ArcGIS Pro afin de voir l'écriture exacte des paramètres !