Usar el entorno de scripts

Insights in ArcGIS Enterprise
Insights Desktop
Nota:

El entorno de scripts de Insights está disponible en Insights in ArcGIS Enterprise y Insights desktop. La conexión principal puede ser Insights in ArcGIS Enterprise o Insights in ArcGIS Online.

Las conexiones Jupyter Kernel Gateway se pueden deshabilitar para una organización de Insights in ArcGIS Enterprise durante el proceso de instalación. Póngase en contacto con su administrador si las conexiones Jupyter Kernel Gateway no están disponibles. Para obtener más información, consulte Instalar Insights in ArcGIS Enterprise.

Después de establecer una conexión con Jupyter Kernel Gateway, puede acceder al entorno de scripts y usarlo para crear y ejecutar scripts en Python y R. El entorno de scripts consta de una celda In[ ], donde se cargan o escriben scripts; una celda Out[ ], donde se muestran los resultados; y una barra de herramientas.

Abrir el entorno de scripts

Para usar el entorno de scripts, en primer lugar debe configurar un Jupyter Kernel Gateway y crear una conexión a la puerta de enlace. Una vez creada la conexión a la puerta de enlace, siga estos pasos para abrir el entorno de scripts y empezar a escribir scripts:

  1. Abra un libro de trabajo. Agregue datos a su libro de trabajo, en caso necesario.
    Sugerencia:

    También puede cargar datos desde el entorno de scripts.

  2. Haga clic en el botón Scripts Crear scripts en la barra de herramientas del libro de trabajo.
  3. Si una conexión no se había guardado anteriormente en el libro de trabajo, realice una de las siguientes acciones:
    • En Insights desktop, si se abre la ventana Nueva conexión a Jupyter Kernel Gateway, significa que no ha creado ninguna conexión a la puerta de enlace. Introduzca la dirección de ranura web y URL a su puerta de enlace para crear la conexión. Consulte Conectarse a una puerta de enlace kernel para obtener más información.
    • En Insights in ArcGIS Enterprise, si se abre la ventana Conexión de puerta de enlace kernel, seleccione una conexión de puerta de enlace kernel existente en el menú Nombre de entorno. También puede crear una nueva conexión en la pestaña Agregar nueva. Consulte Conectarse a una puerta de enlace kernel para obtener más información.

    Se abre el entorno de scripts y se agrega el encabezado Scripts al panel de datos.

  4. Use el menú Seleccionar kernel para elegir el kernel que utilizará para el script. En función de la conexión a la puerta de enlace kernel que esté utilizando, las opciones serán Python, R o ambas.

    El entorno de scripts se actualiza para incluir una celda In[ ], así como una barra de herramientas.

El entorno de scripts ya está listo para crear, cargar y ejecutar scripts.

Su script se guarda automáticamente bajo el encabezado Scripts en el panel de datos con el nombre Insights Script. Puede cambiar el nombre del script con el botón Cambiar nombre de script Cambiar nombre del script.

Las siguientes opciones también están disponibles para el script a través del botón Opciones de dataset Opciones de dataset:

  • Abrir: cargue el script en una celda In[ ].
  • Ejecutar: ejecute el script sin abrir el entorno de scripts.
  • Descargar: descargue el script como un archivo de Jupyter Notebook (.ipynb).
  • Publicar: publica el script para crear un elemento de script de Insights (disponible en Insights in ArcGIS Enterprise).
  • Eliminar: elimine el script del panel de datos.

Editar un script

Puede editar los scripts desde las celdas In[ ], incluso tras haber ejecutado la celda. Para editar un script, haga clic en la celda, realice las ediciones y ejecute la celda. Se crea una nueva celda Out[ ] con los resultados editados.

Exportar un script

Los scripts que se escriben en el entorno de scripts se pueden exportar y guardar como un script .py para Python, o como un script .R para R. Puede exportar un script desde el entorno de scripts seleccionando una o varias celdas y haciendo clic en el botón Exportar Exportar.

Las siguientes opciones de exportación están disponibles al guardar un script:

  • Descargar celda(s) seleccionada(s): solo guarda el script de las celdas In[ ] seleccionadas.
  • Descargar historial: guarda el script de todas las celdas In[ ] en el entorno de scripts como un archivo de Jupyter Notebook (.ipynb).

Los scripts exportados se guardarán en la carpeta de descargas predeterminada del equipo.

Cargar un script

Puede crear scripts directamente en el entorno de scripts escribiendo en la celda In[ ]. También puede cargar los scripts existentes en el entorno de scripts siguiendo estos pasos:

  1. Abra el entorno de scripts, en caso necesario, y seleccione el kernel correcto para el script que vaya a ejecutar.
  2. Haga clic en el botón Importar archivo Importar archivo de la barra de herramientas del entorno de scripts.
  3. Vaya al script que desea ejecutar y ábralo.

    El script se abre en la celda In[ ].

  4. Haga clic en el botón Ejecutar Ejecute de la barra de herramientas del entorno de scripts.

El script se ejecuta y los resultados aparecen en la celda Out[ ].

Los scripts guardados en el panel de datos también se pueden cargar en el entorno de scripts. Para cargar un script del panel de datos, siga estos pasos:

  1. Expanda el encabezado Scripts en el panel de datos.
  2. Haga clic en el botón Opciones de dataset Opciones de dataset para el script que desee cargar.
  3. Haga clic en Abrir.

    El script se abre en la celda In[ ].

Crear una tarjeta de imagen

Los resultados de los scripts, como los gráficos, se pueden exportar desde una celda Out[ ] para crear una tarjeta de imagen en su página de Insights. Para exportar una celda, debe ejecutar el script con el botón Ejecutar Ejecute, resaltar la celda Out[ ] y, después, hacer clic en el botón Crear tarjeta Crear tarjeta para mover la imagen de la celda Out[ ] más reciente a una tarjeta de imagen.

Nota:

Las tarjetas de imagen creadas a partir de scripts son estáticas y no cuentan con las mismas capacidades interactivas que las tarjetas de tabla, gráfico y mapa creadas en Insights.

Guardar el script en un modelo

Puede agregar el script de su entorno de scripts a su modelo como script de Insights con el botón Agregar al modelo Agregar al modelo. Puede editar el script de Insights desde la Vista de análisis Vista de análisis. Para obtener información sobre cómo actualizar un modelo en Insights, consulte Ejecutar de nuevo sus análisis.

Borrar o cerrar el entorno de scripts

Puede borrar los scripts, incluidas todas las celdas In[ ] y Out[ ], con el botón Reiniciar Reiniciar. Borrar el entorno de scripts es una operación que no se puede deshacer.

El entorno de scripts se cierra haciendo clic en el botón de cerrar Cerrar o yendo a otra página de Insights.

Si tiene que cambiar entre la página de Insights y el entorno de scripts, se recomienda minimizar el entorno con el botón de minimizar Minimizar en lugar de cerrarlo, para no perder los scripts.