Création d'un bon exemple de géotraitement

Un exemple de géotraitement est un fichier .zip qui contient des fichiers présentant un intérêt pour la communauté de géotraitement. Vous pouvez ajouter un exemple de géotraitement à la page Mon contenu d'ArcGIS Online.

Le contenu le plus courant consiste en des jeux de données, des documents et des boîtes à outils réunis dans un dossier. Les exemples de géotraitement vous permettent également de fournir des boîtes à outils Python et les fichiers de documentation associés (.xml).

Si vous utilisez ArcGIS 10.1 for Desktop, vous devez créer un paquetage de géotraitement (au lieu d'un exemple de géotraitement), puis l'ajouter et le partager sur ArcGIS Online.

Les instructions suivantes vous expliquent comment consolider les jeux de données, les documents et les boîtes à outils dans un seul dossier, que vous pouvez alors compresser.

Consolidation des ressources dans un dossier

La première étape de la création d'un exemple de géotraitement consiste à consolider toutes les ressources dans un seul dossier.

Pour notre exemple, nous allons supposer que vous souhaitez ajouter et partager une boîte à outils personnalisée sur ArcGIS Online. Cette boîte à outils contient des modèles, qui utilisent les outils de script que vous avez développés. Les modèles utilisent également des couches dans un document ArcMap, couches qui référencent des jeux de données enregistrés à différents emplacements de votre ordinateur. Pour partager votre boîte à outils et vos outils, vous devez rassembler toutes les ressources utilisées par les outils (jeux de données, documents ArcMap, etc.) dans un seul dossier, que vous pouvez alors comprimer dans un fichier .zip. Le rassemblement de ces ressources dans un seul dossier est ce que l'on appelle la consolidation.

Pour consolider les ressources, vous devez copier ou déplacer les jeux de données dans un dossier, réinitialiser les sources de données de toutes les couches de vos modèles et utiliser des chemins relatifs d'accès à toutes les données.

Pour de plus amples informations sur la consolidation, reportez-vous à la rubrique d'aide Présentation rapide du partage d'outils d'ArcGIS Desktop 10.0 et à la liste de contrôle ci-dessous.

Paquetages de géotraitement pour la version 10.1

Avec ArcGIS 10.1 for Desktop, vous devez utiliser un paquetage de géotraitement, au lieu d'un exemple de géotraitement, pour partager les workflows de géotraitement.

Avec les paquetages de géotraitement, vous n'avez pas besoin de consolider les ressources manuellement. Lors de la création des paquetages, ArcGIS consolide automatiquement toutes les ressources requises dans un dossier temporaire, qui est comprimé en paquetage (.gpk). Cette consolidation automatique est à la fois extensive et récursive. Par exemple, si un outil utilise d'autres outils personnalisés, ceux-ci sont copiés dans le dossier temporaire et examinés pour déterminer leurs dépendances éventuelles. Le même principe s'applique aux données : si une couche référence un jeu de données qui, à son tour, a une relation avec d'autres jeux de données, les jeux de données en question sont eux aussi copiés et examinés pour déterminer les dépendances éventuelles.

Structure et contenu du fichier .zip

La rubrique Structure de partage des outils de l'aide d'ArcGIS Desktop 10.0 présente une structure de dossiers, la structure ToolShare, que nous vous recommandons d'adopter pour consolider toutes les ressources utilisées par vos outils. Vous devez ensuite compresser ce dossier dans un fichier .zip afin de créer l'exemple de géotraitement.

Un dossier construit suivant la structure ToolShare est représenté ci-dessous. Le dossier racine contient tout ce dont les outils ont besoin pour s'exécuter. Toutes les ressources doivent se trouver dans le dossier racine ou ses sous-dossiers.

Nom du dossier

Description du contenu

ToolData

Contient toutes les données utilisées par les outils. Contient généralement les géodatabases de fichiers, les rasters et les fichiers de couche.

Scripts

Contient les scripts (fichiers .py) de tous les outils de script que vous envoyez.

Scratch

Ce répertoire peut être utilisé pour écrire les données intermédiaires des modèles et les données temporaires des scripts. Il contient généralement un fichier de géodatabase appelé « scratch ».

Doc

Contient tout ce qui peut aider l'utilisateur à comprendre les outils fournis, notamment des fichiers PDF, des fichiers d'aide compilés (.chm) ou des documents Word et PowerPoint. Contient également toutes les images utilisées dans les diagrammes de modèle.

Un exemple de géotraitement téléchargé sur ArcGIS Online est un fichier .zip qui contient un dossier racine, comme illustré ci-dessous. Lors de la création du fichier .zip, veillez à ajouter seulement le dossier racine et pas ses contenus.

Liste de contrôle

Utilisez la checklist suivante (fichier PDF) pour vous aider à créer un bon exemple de géotraitement.