Saltar al contenido principal

Horas de ejecución Python y R

Abra Settings → Runtimes para seleccionar los entornos Python y R disponibles para cuadernos y el Agente. El estado Ready de un entorno indica la detección/configuración exitosa; su interruptor Enable controla por separado la disponibilidad al agente.

Elija un entorno gestionado por aplicaciones o un intérprete existente. Inspeccione su camino, versión, Listo estado y Activar el interruptor antes de usar. El sistema R y R gestionados por aplicaciones pueden coexistir.

Plataforma
Su elección se mantiene a través de capítulos.

Elija un entorno para su proyecto

Grabar el nombre de intérprete, la ruta y la versión. Para un primer análisis de Python, prefiera el entorno aislado gestionado por aplicaciones, por lo que los cambios en paquetes no alteran un entorno de investigación no relacionado. Inspeccione Packages para las bibliotecas necesarias antes de solicitar la instalación. Un listado de paquetes exitoso es un cheque de sólo lectura; no otorga al agente permiso para modificar un intérprete externo.

Después de un fallo de ejecución, distinguir un intérprete no disponible, un paquete perdido, una solicitud denegada y un error de código. La reinstalación es adecuada para un tiempo de ejecución gestionado roto, no para cada análisis fallido. Si necesita reproducir un resultado, mantenga la versión de entrada y el código junto con los detalles de tiempo de ejecución.

Comprender los controles principales

ControlPropósito y límite
RecheckRefresh descubrió intérpretes y su estatus. El panel muestra la última vez. No está disponible durante el trabajo de configuración en conflicto.
Network settingsConfiguración abierta para protección de red Notebook. El banner explica si las sesiones y descargas de paquetes están limitadas a dominios aprobados.
Let the Agent create environmentsControla si el Agente puede crear entornos y configurar tiempos de ejecución perdidos. Apagar esto no elimina los controles explícitos de configuración o reparación del usuario.
Add interpreter…Abra el selector ejecutable del sistema para un intérprete existente. Seleccione el ejecutable real, luego confirme su ruta detectada y estado Listo.
Download and set upPreparar un entorno gestionado por aplicaciones cuando no esté.
Cancel durante la configuraciónSolicite la cancelación de la configuración de ejecución. Espera a que la operación se calme antes de comenzar otra.
Retry setupIntentar una configuración infructuosa después de resolver su causa.
Habilitar [ambiente]Ponga el entorno disponible para la selección de agentes. El desactivar un entorno en uso puede requerir una confirmación de impacto.
Allow package installConsentimiento separado para un entorno Python o R externo habilitado. El consentimiento R se limita a una biblioteca personal seleccionada. La inclusión de paquetes no requiere el consentimiento de instalación.
Paquetes [cuenta]Abra el inventario de embalaje instalado para ese intérprete.
ReinstallConfirmación abierta antes de reconstruir un entorno gestionado por aplicaciones.

Instalar un entorno gestionado por aplicaciones

Instalar Python gestionado por aplicaciones

Ajustes de tiempo de ejecución antes de la configuración Python

  1. Encuentra a Python → App-managed environment.
  2. Seleccione Download and set up.
  3. Lea el mensaje de progreso y espere. Cancel se pone disponible mientras la configuración se ejecuta.
  4. Sobre el éxito, confirme conda: default-python, App-managed, y Ready.
  5. Compruebe la ruta del intérprete y el interruptor Activar conda: default-python.

Creación del entorno Python gestionado por aplicaciones

Python setup complete

Confirme Ready, la ruta de intérprete seleccionada y el estado habilitado. Los recuentos y versiones de paquetes pueden variar con la fuente de instalación; no use la ruta temporal de la captura de pantalla como un entorno permanente.

Instalar R gestionado por aplicaciones

  1. Abrir Settings → Runtimes y desplazarse a R.
  2. Bajo App-managed environment, seleccione Download and set up. Un sistema existente R no le impide instalar este entorno separado.
  3. Espera a que la descarga y la creación del medio ambiente terminen. Mantenga la aplicación abierta y lea cualquier error antes de reintentar.
  4. Confirme conda: default-r, App-managed, Ready, y un interruptor habilitado.
  5. Abre Packages. Introduzca r-base en Filter packages para comprobar la versión y el canal R instalados; despejar el filtro para ver todos los paquetes.

Descarga del entorno R gestionado por aplicaciones

R gestionado por aplicaciones instalado y habilitado

Confirme que el filtrado r-base devuelve el paquete R instalado, con su versión y canal. Los totales del paquete reflejan su entorno y pueden diferir de la captura de pantalla.

Comprobación de la base r en el inventario del paquete R

Conectar un intérprete existente

Utilice R ya instalado en su computadora

Seleccione Recheck e inspeccione la ruta y versión detectada R. Si su intérprete está ausente, use Add interpreter… para seleccionar su ejecutable. Ready y Enable tienen diferentes significados: la detección confirma que el intérprete está disponible; habilitar hace que sea seleccionable por el Agente.

En un R Notebook, compruebe R.home() para confirmar el medio ambiente en uso. Para instalar dependencias, autorice una biblioteca personal usando el pasos externos de instalación R.

Un camino detectado como /opt/homebrew/bin/R identifica una instalación del sistema.

Registro y uso externo Python

  1. Prepare el entorno Python que usted tiene la intención de utilizar.
  2. Seleccione Add interpreter…, elija su ejecutable Python y verifique Ready, el camino y la versión.
  3. Utilice Recheck para verificar la detección, y luego habilitar ese entorno específico.
  4. Pídale al agente que lo seleccione explícitamente para el Notebook.
  5. Imprimir sys.executable y la versión Python antes de confiar en sus bibliotecas instaladas.

Si un intérprete de enlace no puede ser seleccionado en el selector de archivo macOS, seleccione el ejecutable real del entorno deseado. Confirme sys.executable después de encuadernarlo. Utilice un camino de instalación estable en lugar de la ruta de ejemplo temporal de la captura de pantalla.

Permiso del paquete y resultado de la instalación

Para un nuevo paquete en un entorno Python externo, consulte Allow package install primero. Después de conceder permiso, espere a que la instalación termine y verifique la importación en el mismo entorno antes de continuar.

Si la instalación reporta 403 Forbidden o destination resolves to a non-public network address, inspeccione el nombre de host afectado y siga Red antes de reintentar. Estos errores se refieren al acceso a la red y no prueban que el paquete no está disponible. Mantenga la protección de la red activada.

Desactivar un entorno utilizado por un Notebook

Seleccione su interruptor Enable y lea el kernel activo/idle cuenta antes de confirmar. Desactivar puede cerrar el núcleo; después de volver a habilitar, seleccione un plazo disponible para la sesión de nuevo. Este panel proporciona controles de habilitación/desactivables en lugar de una acción Quitar intérprete separada.

Instalar paquetes en R externo

Utilice esto cuando su intérprete R existente funciona pero necesita un paquete adicional. La aplicación otorga acceso a la instalación a una biblioteca personal existente, no a las bibliotecas del sistema o del sitio.

  1. En Settings → Runtimes, active el entorno R externo previsto y confirme su trayectoria/versión.
  2. Bajo Personal R package library, inspeccione la ubicación detectada o seleccione una biblioteca elegible. Si no se detecta ninguno, utilice Advanced options → Choose library folder… para seleccionar una biblioteca personal de escritura existente visible a ese intérprete R. Esta acción no crea una carpeta.
  3. Activar Allow package install. Lea la ruta seleccionada antes de autorizar: otros proyectos que utilizan esta biblioteca pueden ver los cambios de paquete instalados.
  4. Solicite el paquete requerido a través de la operación de gestión de paquetes de la aplicación, nombrando este entorno R. Siga el resultado de la instalación y cualquier instrucción de kernel-restart.
  5. Ejecutar R.home(), .libPaths(), library(PACKAGE_NAME) y packageVersion("PACKAGE_NAME") en ese entorno, reemplazando el marcador de paquetes. Confirme que la biblioteca destinada se utiliza antes de continuar el análisis.

Apaga Allow package install para revocar el consentimiento de instalación futuro. No desinstala paquetes ya escritos. Revoque el consentimiento antes de elegir otra biblioteca. Si no existe una carpeta elegible, prepare una biblioteca personal R fuera de la aplicación o utilice un entorno gestionado por la aplicación; no elija la biblioteca del sistema para evitar un cheque fallido.

Restaurar paquetes de cerraduras capturadas

Para un resultado guardado, abra Provenance → Environment e inspeccione el bloqueo capturado. Use Download bundle cuando se ofrezca. Lea las instrucciones y requisitos del paquete antes de restaurar cualquier cosa.

R externo requiere una instalación renv disponible y un renv.lock compatible; Python externo necesita una cerradura de requisitos compatibles con hahes pinificados. Un camino de intérprete y una lista de nombres de paquetes por sí solos no son suficientes. Los requisitos de intérprete, plataforma, arquitectura y gestión de paquetes capturados deben coincidir con el entorno de restauración.

Extraiga el paquete, elija un nuevo destino que usted posee, y ejecute su restore-packages.py incluido con los caminos de intérprete y destino reales, siguiendo las instrucciones enganchadas. El script revisa los requisitos y las sumas de verificación antes de restaurar los paquetes, y luego comprueba sus versiones y caminos efectivos. Si un cheque falla, resuelve esa condición en lugar de editar la cerradura para forzar el éxito. Open-Science no adopta o elimina este destino externo.

Esto es una restauración condicional de paquetes, no un clon de ambiente completo. Reabrir el resultado y utilizar Reproducibilidad cuando una receta capturada soportada está disponible para comparar los productos.

Inspeccione los paquetes instalados

Seleccione Packages en la tarjeta Python prevista. El diálogo muestra que el camino del medio ambiente, fuente de paquetes y estado.

Ingrese un nombre de paquete como numpy en Filter packages, inspeccione su versión y canal, y luego despeje el filtro para restaurar la lista. Usa Close para regresar.

Filtrar los paquetes Python instalados

Las columnas de la tabla son Name, Version, Build, y Channel. Un dash in Build significa que no se muestra valor de construcción. Este diálogo es un inventario: no tiene botones de instalación de paquetes o desinstalación. No busque un campo de “Install package” dentro de este diálogo.

Verificar el medio ambiente con un análisis real

Ejecutar un pequeño cálculo en el entorno elegido, reabrir su salida y compararlo con el Base de referencia compartida. Siga R Notebook para la ejecución y exportación.

El flujo de trabajo de calidad de los datos proporciona una ruta Python utilizando dependencias existentes. Un cálculo exitoso no demuestra que se pueden instalar nuevos paquetes o reiniciar un kernel.

Computación Notebook real exitosa

Si una importación falla, inspeccione el tiempo seleccionado y sus paquetes instalados. Para una descarga rechazada porque un nombre de host se resuelve a una dirección reservada, siga Red. El código de ejecución con los paquetes existentes no establece que se pueden instalar paquetes adicionales.

Antes de otro análisis, inspeccione sus paquetes requeridos en el entorno seleccionado. Utilice la operación de gestión de paquetes soportada si es necesario, lea el resultado real, siga cualquier requisito de reinicio, y verifique la importación. Una autorización de permiso, tarjeta de progreso o intérprete listo no es una prueba de importación.

Para un resultado guardado con incompleto medio ambiente o evidencia de ejecución, abra Provenance e inspeccione la información que falta. Para preparar una nueva versión para un control de reproducibilidad, siga para la preparación del medio ambiente. El emparejar un resultado numérico no llena la procedencia perdida.

Confirme el intérprete activo

Después de preparar Python o R, ejecute los siguientes comandos en el idioma Notebook correspondiente para comprobar su versión y ruta reales. Los ajustes pueden enumerar varios entornos; utilizar la salida de la corriente para identificar la que se usa.

Python:

import sys
print(sys.version)
print(sys.executable)

R:

R.version.string
R.home()

A continuación, leer una pequeña tabla de proyectos, comprobar su recuento de filas y guardar el resultado. Después de reabrir la aplicación, ejecute el cheque nuevamente antes de continuar un análisis. Un informe histórico legible no significa que las variables anteriores en memoria todavía existan. Ver Notebook y pruebas de ejecución para los controles Notebook.

Mantener y reparar entornos

Cancelar configuración y reingreso

Durante Download and set up, elija Cancel y espere a Configuración de tiempo de ejecución cancelada. Elija Retry setup, espere a Ready, y abra Packages para inspeccionar el medio ambiente. No comience una segunda configuración mientras la primera operación todavía se está adaptando.

Configuración cancelada y reingreso disponible

Reinstalar un entorno gestionado

  1. Guardar los informes necesarios y grabar cualquier paquete que hayas añadido.
  2. Seleccione Reinstall en el entorno gestionado previsto.
  3. Lea el aviso de impacto, luego elija Reinstall runtime.
  4. Espere a Ready e inspeccione Packages.
  5. Iniciar una nueva célula Notebook y reabrir sus entradas y salidas guardadas.

Reinstalación de confirmación durante una sesión Notebook

La reinstalación elimina y recrea el medio ambiente. En la recuperación ejercida, una célula activa fue cancelada con Huir cancelado: el tiempo de ejecución se detuvo mientras esta célula estaba ejecutando. La vieja historia de Notebook se mantuvo visible, pero su espacio de nombres ya no existía. Una célula fresca confirmó que una variable anterior estaba ausente; el CSV sin cambios todavía regresó las filas 12 y cuenta 269,027,617, y el informe guardado reabrido.

Historia Notebook retenida después de que su núcleo fue detenido

Los archivos retenidos y la memoria del núcleo retenido son diferentes. Recrear variables reelaborando el código requerido. Los paquetes adicionales pueden necesitar reinstalación; la recuperación exitosa del entorno base no establece la recuperación de cada dependencia adicional.

Construcción de desarrollo: micromamba no encontrada

El primer intento de la fuente no se pudo realizar antes de la provisión porque el proceso de desarrollo no podía localizar micromamba.

Error real de la microromamba desaparecido en una construcción de fuente

La aplicación envasada incluye este binario. Para una construcción de fuentes, punto OPEN_SCIENCE_MICROMAMBA_BIN en un ejecutable de micromamba válido en el entorno de lanzamiento de ese proceso y reiniciar la instancia de desarrollo. Utilice el camino binario de una instalación compatible y confirme que es ejecutable antes de relanzar.

Esta variable de entorno es un detalle de configuración de desarrollo, no un campo en la página Runtimes. No borre un directorio de entorno para trabajar alrededor de este error de descubrimiento.