Las funciones de ráster de Python son scripts personalizados que se pueden utilizar para procesar y analizar datos ráster en ArcGIS. Aunque ArcGIS ofrece un completo conjunto de funciones ráster integradas, ciertos requisitos analíticos pueden requerir implementaciones personalizadas. Estas funciones personalizadas, desarrolladas en Python, pueden integrarse en cadenas de funciones ráster para ampliar las capacidades analíticas del análisis de ráster estándar.
En ArcGIS Enterprise 11.5, se ha introducido una nueva API administrativa para simplificar el registro, la implementación y la administración de funciones de ráster de Python personalizadas. Esta API proporciona una interfaz sencilla para que los administradores administren funciones personalizadas en todo el entorno de su empresa.
Para obtener información detallada sobre el aprovechamiento de esta API administrativa, consulte la documentación de ArcGIS Enterprise.
Requisitos de empaquetado para funciones de ráster de Python personalizadas
Para implementar correctamente una función de ráster de Python personalizada en ArcGIS Enterprise, asegúrese de que se cumplen los siguientes requisitos previos:
- Archivos requeridos
- Plantilla de función ráster (.rft.xml): define la cadena de funciones ráster y hace referencia al script asociado de Python.
- Script de Python (.py): contiene la implementación de las funciones ráster personalizadas.
Ambos archivos deben incluirse en el paquete de implementación.
- Convenciones de nomenclatura
- Consistencia: el nombre del script de Python debe coincidir con el nombre especificado en el archivo de plantilla de la función ráster.
- Caracteres válidos: los nombres de archivo deben comenzar con una letra y es posible incluir letras, números y guiones bajos.
Precaución:
Evite utilizar caracteres especiales al principio de los nombres con números.
- Especificación de la ruta del archivo
En la plantilla de la función ráster, haga referencia al script de Python utilizando el prefijo [functions] seguido de la ruta relativa. Por ejemplo:
[funciones]Personalizado\Subcarpeta\nombre_del_script.py
La sintaxis garantiza que ArcGIS localice el script dentro del directorio de funciones designado.
- Estructura de directorio
Organice los archivos en la subcarpeta siguiendo la ruta del archivo que especificó en la plantilla de la función ráster. Por ejemplo:
"PythonModule": "[funciones]Personalizado\\Tree_Health.py"
En este archivo zip de ejemplo, el contenido debe incluir el archivo rft y el archivo de Python.
Gráfico conceptual de contenido de la carpeta. - Paquete de implementación
Comprima la subcarpeta que contiene los archivos .rft.xml y .py en un archivo .zip. Este paquete se puede registrar e implementar utilizando la API administrativa introducida en ArcGIS Enterprise 11.5.
Implementar una función de raster de Python personalizadas en ArcGIS Enterprise
Para implementar una función de ráster de Python en ArcGIS Enterprise, siga estos pasos:
- Acceder al directorio API del administrador
- Desplácese hasta el Directorio API del administrador de ArcGIS Enterprise.
- Inicie sesión con una cuenta con privilegios administrativos.
- Registrar la función ráster personalizada
- En el directorio API del administrador, vaya a Servicios > Tipos.
- Seleccione Funciones de ráster personalizadas.
- Haga clic en el botón Registrar.
- Utilice la opción Elegir archivo para examinar y seleccionar el archivo .zip que contiene su función ráster personalizada.
- Haga clic en Registrar para completar el proceso de registro.
- Verificar el proceso de registro
- Una vez completado correctamente el registro, la función ráster personalizada aparecerá en Funciones ráster personalizadas registradas en el Directorio API del administrador.
- Acceda a la Función registrada en el portal.
- Iniciar sesión en el portal de ArcGIS Enterprise
- Vaya a Mi contenido o Mi organización para localizar el elemento de plantilla de función ráster personalizada registrado.
- Utilice la función ráster personalizada
- La función ráster personalizada registrada ahora se puede utilizar de forma similar a las plantillas de funciones ráster proporcionadas por el sistema.
- Se puede incorporar a flujos de trabajo de procesamiento ráster utilizando herramientas como el Editor de funciones de ráster.