Fonctions raster Python personnalisées

Les fonctions raster Python sont des scripts personnalisés qui permettent de traiter et d’analyser des données raster dans ArcGIS. Alors qu’ArcGIS fournit une suite complète de fonctions raster intégrées, certaines exigences analytiques peuvent nécessiter des implémentations personnalisées. Ces fonctions personnalisées, développées en Python, peuvent être intégrées à des chaînes de fonctions raster afin d’étendre les fonctionnalités analytiques de l’analyse raster standard.

Dans ArcGIS Enterprise 11.5, une nouvelle API d’administration a été introduite pour rationaliser l’enregistrement, le déploiement et la gestion des fonctions raster Python personnalisées. Cette API fournit une interface simple qui permet aux administrateurs de gérer des fonctions personnalisées dans leur environnement d’entreprise.

Pour en savoir plus sur l’utilisation de cette API d’administration, consultez la documentation ArcGIS Enterprise.

Exigences d’empaquetage pour les fonctions raster Python personnalisées

Pour déployer correctement une fonction raster Python personnalisée dans ArcGIS Enterprise, assurez-vous que les conditions requises suivantes sont remplies :

1. Fichiers requis
   • Modèle de fonction raster (.rft.xml) : définit la chaîne de fonctions raster et fait référence au script Python associé.
   • Script Python (.py) : contient l’implémentation sur les fonctions raster personnalisées.

   Les deux fichiers doivent être inclus dans le paquetage de déploiement.

2. Conventions d’affectation de noms
   • Cohérence : le nom du script Python doit correspondre au nom spécifié dans le fichier de modèle de fonction raster.
   • Caractères valides : les noms de fichier doivent commencer par une lettre et peuvent contenir des lettres, des chiffres et des traits de soulignement.

     Attention :

     Évitez d’utiliser des caractères spéciaux ou de commencer les noms par des chiffres.

3. Spécification de chemin d’accès au fichier

   Dans le modèle de fonction raster, référencez le script Python en utilisant le préfixe [functions] suivi du chemin relatif. Par exemple :

   [functions]Custom\Subfolder\script_name.py

   La syntaxe permet de s’assurer qu’ArcGIS localise le script dans le répertoire functions indiqué.

4. Structure de répertoires

   Organisez les fichiers dans le sous-dossier en suivant le répertoire du chemin d’accès aux fichiers indiqué dans le modèle de fonction raster. Par exemple :

   "PythonModule": "[functions]Custom\\Tree_Health.py"

   Pour cet exemple de fichier zip, le contenu doit inclure le fichier rft et le fichier Python.

   
   Graphique conceptuel de contenu de dossier.
5. Paquetage de déploiement

   Compressez le sous-dossier contenant les fichiers .rft.xml et .py dans une archive .zip. Ce paquetage peut être enregistré et déployé à l’aide de l’API d’administration introduite dans ArcGIS Enterprise 11.5.

Déploiement d’une fonction raster Python personnalisée dans ArcGIS Enterprise

Pour déployer une fonction raster Python personnalisée dans ArcGIS Enterprise, procédez comme suit :

1. Accéder au répertoire de l’API d’administration
   • Naviguez jusqu’au répertoire de l’API d’administration ArcGIS Enterprise.
   • Connectez-vous à l’aide d’un compte doté des privilèges administratifs.
2. Enregistrer la fonction raster personnalisée
   • Dans le répertoire de l’API d’administration, accédez à Services> Types.
   • Sélectionnez Custom Raster Functions (Fonctions raster personnalisées).
   • Cliquez sur le bouton Register (Enregistrer).
   • Utilisez l’option Choose File (Sélectionner un fichier) pour accéder au fichier .zip contenant votre fonction raster personnalisée et le sélectionner.
   • Cliquez sur Register (Enregistrer) pour terminer le processus d’enregistrement.
3. Vérifier l’enregistrement
   • Si l’enregistrement aboutit, la fonction raster personnalisée apparaît sous Registered Custom Raster Functions (Fonctions raster personnalisées enregistrées) dans le répertoire de l’API d’administration.
4. Accéder à l’option Registered Function (Fonction enregistrée) dans le portail
   • Se connecter au portail ArcGIS Enterprise
   • Accédez à My Content (Mon contenu) ou My Organization (Mon organisation) pour localiser l’élément de modèle de la fonction raster personnalisée enregistrée.
5. Utiliser la fonction raster personnalisée
   • La fonction raster personnalisée enregistrée peut désormais être utilisée de la même façon que les modèles de fonction raster fournis par le système.
   • Elle peut être intégrée aux processus de traitement raster à l’aide d’outils comme Raster Function Editor (Éditeur de fonctions raster).