Introduction à arcpy.mp

Présentation de arcpy.mp

Arcpy.mp est un sous-module Python appartenant au paquetage de site ArcPy. Il est installé avec ArcGIS Pro et accessible à tous les types de licences. Il a été conçu dans le but de manipuler le contenu de projets (.aprx) et de fichiers de couche (.lyr ou .lyrx) existants. Il propose également des fonctions permettant d'automatiser l'exportation et l'impression. Arcpy.mp permet d'automatiser la production des cartes. Il doit être utilisé pour générer des atlas complets, car il comprend des fonctions d'exportation, de création et de gestion des documents PDF.

Décrire certains des scénarios possibles permet de mieux comprendre les fonctionnalités offertes par Arcpy.mp. Voici quelques-uns des nombreux scénarios pouvant être accomplis par un script Python arcpy.mp :

• Créer un rapport sur les informations contenues dans les projets , telles que les couches et leurs sources de données, les couches dont les sources de données sont endommagées, l'étendue des données affichées ou les propriétés des élé ments de mise en page.
• Mettre à jour, réparer ou remplacer les sources des données des couches dans une carte ou un fichier de couche.
• Rechercher et remplacer une chaîne de texte pour toutes les mises en page d'un projet.
• Automatiser le partage des éléments de projet à héberger en ligne dans votre organisation.
• Créer des données géographiques par lots à l'aide de commandes d'exportation de cartes, telles que les séries d'images GeoTIFF liées à une liste d'entités dans une carte.
• Générer plusieurs atlas au format PDF, comme un atlas de référence ou un atlas thématique comportant une page de titre et plusieurs pages de cartes ainsi qu'un nombre indéfini de pages additionnelles proposant du contenu complémentaire, comme des rapports tabulaires et des listes de contact.

À qui s'adresse arcpy.mp ? Pourquoi a-t-il été conçu ?

Arcpy.mp a été conçu pour les analystes et développeurs SIG professionnels. À l'origine les scénarios répertoriés ci-dessus devaient être réalisés à l'aide d'ArcObjects, lequel s'avérait être un environnement de programmation très difficile à apprendre pour la plupart des professionnels des SIG. Arcpy.mp est un modèle d'objet plus rudimentaire, ce qui signifie que les fonctions arcpy.mp sont conçues pour remplacer de nombreuses lignes de code ArcObjects. Voici un exemple très simple de la façon dont arcpy.mp permet de référencer une mise en page existante dans un projet et de l'exporter au format PDF en utilisant simplement trois lignes de code.

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
lyt = aprx.listLayouts("Main Attractions*")[0]
lyt.exportToPDF(r"C:\Project\YosemiteNP\Output\Yosemite.pdf", resolution = 300)

La première ligne charge le module arcpy et est requise pour tous les scripts exécutés en dehors de ArcGIS Pro. La seconde ligne référence un projet ArcGIS Pro sur le disque. La troisième ligne recherche la première mise en page (à l'aide d'un index en base zéro) dont le nom commence par les mots Main Attractions (Attractions principales). La dernière ligne de code exporte la mise en page au format PDF avec une résolution en sortie de 300.

Meilleures façons de commencer

• Suivez le didacticiel Prise en main d'arcpy.mp.
• Révisez les Instructions concernant arcpy.mp
• Si vous avez utilisé des versions antérieures du logiciel arcpy.mapping et que vous utilisez maintenantArcGIS Pro, consultez la rubrique Migration d'arcpy.mapping à ArcGIS Pro.
• Révisez la Liste alphabétique des fonctions arcpy.mp et la Liste alphabétique des classes arcpy.mp pour obtenir une idée des fonctionnalités disponibles. Ces impressions sont également utiles pour écrire des scripts avec arcpy.mp.
• Toutes les rubriques d'aide concernant les classes et fonctions arcpy.mp contiennent des explications détaillées et des extraits de code qu'il est possible de copier et coller directement dans la fenêtre Python.