Notebook y pruebas de ejecución

Utilice Notebook para inspeccionar el código ejecutado, ejecutar un comando en el kernel actual y seguir el trabajo de fondo. Para un archivo guardado, abra Provenance para inspeccionar la ejecución y la evidencia asociada con esa versión del archivo.

Antes de ejecutar Python o R, habilitar un tiempo de ejecución compatible. Para un ejemplo completo de análisis de datos, utilice el flujo de trabajo público-datos.

Plataforma

macOSWindowsLinux

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

Abrir una sesión Notebook

1. Abrir el proyecto y la conversación que contiene el cálculo que desea inspeccionar. Si usted está empezando de nuevo, pida al agente que ejecute un pequeño cálculo en el Sesión Notebook primero.
2. Seleccione Open notebook, o utilice el menú de conversación View notebook.
3. Seleccione la pestaña Notebook cuando una vista previa del archivo está activa.
4. Utilice Agent para elegir el propietario de la ejecución, luego Python / R / Bash para elegir el idioma.
5. Abra una carrera numerada y lea su estado de salida y finalización. Una actividad copiada etiquetada code shown contiene el código mostrado; inspeccionar la sesión original de producción para su historial de ejecución.

Control	Medida	Resultado
Agente	Seleccione Main o un agente infantil	Muestra los registros del propietario; agentes pueden tener núcleos separados
Idioma	Seleccione un idioma disponible	Cambia los registros y la consola; instalar idiomas desaparecidos en Runtimes
Corrida numerada	Seleccione una ejecución registrada	Abre su código, salida y estado
Copiar al portapapeles	Copiar código seleccionado	Mantiene caminos y dependencias externas como escritos
Ocultar salida / Mostrar salida	Colapso o ampliación de la salida	Cambia la vista sin reimprimir el código
ejecutar código en este kernel...	Introduzca y envíe código	Ejecuta en el kernel en vivo seleccionado
Cerrar / colapsar vista previa	Volver a la conversación	Mantiene historia de ejecución registrada

Comprueba Datos de entrada / Entradas cuando esté presente. Coincide con el archivo y la versión mostrada a su solicitud. Si una referencia no está disponible, reabrir o adjuntar la entrada prevista a través de la aplicación antes de reintentar.

Trabajar en el kernel en vivo

Ejecute un cheque en el kernel en vivo

Seleccione Python, haga clic en ejecutar código en este kernel..., e ingrese el siguiente comando auto-contenido. No requiere conjunto de datos, paquete de terceros o variables de una conversación anterior:

import sys
print("Python:", sys.version.split()[0])
print("Executable:", sys.executable)

Presione Entra para ejecutar; use Shift+Enter para una nueva línea. Descargue un menú de autocompleto abierto con Escape antes de enviar. Confirme una entrada python · you numerada y la información del intérprete en su salida. El ejecutable debe pertenecer al tiempo de ejecución que seleccionó.

Para R, seleccione R y envíe:

cat(R.version.string, "\n")
cat("R home:", R.home(), "\n")

Inspeccione la entrada R registrada y su salida. Python y R tienen variables separadas. Un NameError o object not found generalmente significa que el objeto no se ha creado en ese núcleo; inspeccionar su código antes de reutilizar un comando de otra sesión.

Para un cheque trabajado del intérprete y los resultados guardados, abra Horas de ejecución Python y R y seleccione Windows en la parte superior de la página.

Inspeccionar variables en vivo

1. Seleccione Inspect variables después de una carrera que crea variables.
2. Lea Name, Type, Size / Shape y Preview.
3. Introduzca un nombre de su propio código en Filter variables. Para el ejemplo de captura de pantalla, sha filtra las variables de hash enumeradas; elegir un nombre que existe en su propio núcleo.
4. Utilice Refresh variables para leer el espacio de nombres actual, y Show private variables si el nombre que necesita está oculto.
5. Seleccione Close para volver al Notebook.

Una vista previa puede abreviar un valor; imprimir el campo necesario en la consola para inspeccionarlo completamente. Variable tracking is limited significa que el gráfico de dependencia es incompleto. Para un resultado rastreado, stale indica que se ha cambiado la dependencia; unknown significa que la relación no puede ser establecida. Reaccione el código afectado antes de usar un resultado obsoleto.

Continuar después de un cambio de núcleo

Cambiar o reconstruir un tiempo de ejecución puede detener su núcleo. Los archivos guardados y los registros de ejecución permanecen separados de las variables en memoria. Después del cambio, ejecute el control de intérpretes arriba, recrea las variables requeridas reelaborando su código de producción y reabrir los archivos guardados que necesite.

Utilice Entornos de ejecución para la cancelación de configuración y reinstalación. Una reconstrucción de tiempo de funcionamiento, un reinicio normal del núcleo y la recuperación de un trabajo de fondo son diferentes operaciones; comprobar el estado de la operación relevante en lugar de asumir que restaurar el estado idéntico.

Ejecute el mismo cheque de cuenta de genes en R

Ejemplo práctico Chequee los recuentos de genes GSE60450 en R

1. Instalar y activar R.
2. Adjuntar el matriz original. Si se compara un resultado Python, adjuntar ese CSV a la misma conversación también.
3. Solicitar ejecución Session Notebook → R y los requisitos de entrada/salida en el flujo de trabajo de calidad de los datos. Especifique la preservación de identificadores completos y un archivo de salida separado.
4. Si aparece Change notebook runtime?, confirme Idioma: R y el intérprete indicado. Compruebe el entorno en la solicitud posterior Run R code?.
5. Abra Notebook → R, lea el registro de ejecución, luego abra la figura e informe CSV.

Compare métricas por el identificador de muestra completo usando el Base de referencia compartida. Mantenga la fuente y registro original que métricas incluyen o excluyen los ceros. El QC de cuenta cruda prepara los datos para un análisis estadístico diseñado por separado.

Mantener el resultado R y sus pruebas juntas

Abra el CSV de Provenance → Execution Log → Download notebook. Mantenga la exportación junto con su entrada y resultados. Una exportación para una versión de archivo puede omitir comandos de consola manual posteriores.

El inventario de paquetes Runtimes describe el entorno instalado; Provenance describe la evidencia ambiental capturada para un archivo particular. Lea los avisos de inventario de partial o caché en lugar de comparar los recuentos de paquetes como si fueran la misma lista.

Tareas de antecedentes y ejecución de los resultados

Pida la ejecución de antecedentes cuando una tarea de Python apoyada, R, REPL persistente o de cáscara debe continuar mientras trabaja en otro lugar. Incluya la entrada, salidas y condición de parada en la solicitud.

1. Después de la admisión, abra la entrada Background tasks de la conversación. Se agrupan las carreras locales y los trabajos remotos de Compute; una conversación sin tareas puede no mostrarlo.
2. Lea la identidad de tarea, el medio ambiente, el estado y el tiempo transcurrido.
3. Seleccione Open para inspeccionar el correspondiente trabajo de Notebook o Compute.
4. Para detener una tarea, seleccione su control Cancel y espere a que el estado se resuelva. Revise los archivos ya guardados antes de usarlos o desecharlos.
5. Después de la finalización, inspeccione el mensaje de resultado entregado y abra las salidas guardadas.
6. Después de la interrupción o de una aplicación reiniciar, inspeccione la tarea existente y cualquier mensaje de recuperación antes de enviar otra copia.

Estado	Qué hacer para comprobar
Queued / Running	Medio ambiente y progreso seleccionados; trabajos de concha puede esperar a una ranura de ejecución
Cancelación / Cancelación	Ya sea que la cancelación todavía se procesa o se ha resuelto
Completado	Resultado de salida y archivos de salida guardados
Failed / Timed out / Interrupted	Primer error, salida retenida y acción de recuperación ofrecida
Resultado no disponible	Registro de trabajo y detalles de recuperación existentes

Cerrar la lista de tareas deja la tarea en marcha. La terminación de un cálculo y la entrega de su mensaje de resultado son etapas separadas. Los trabajos remotos también necesitan las condiciones de host y agenda en Computación remota.

Inspección de una versión guardada

Abra un archivo guardado y seleccione File actions → Provenance, o Open Provenance en su vista previa ampliada. Confirme la versión seleccionada primero.

Tab o control	Úsalo para inspeccionar
Código	Captured product code, input references, copy/download and Generate script
Registro de ejecución	Registros de ejecución congelados para la versión seleccionada
Mensajes	Solicitudes y decisiones incluidas en el resultado
Entorno	Intérprete, información de paquetes y estado de captura; ver Condiciones de restauración.
Reproducibilidad	Entradas capturadas, cheques de repetición, comparaciones de salida y registros de verificación.
Revisión	Valoración asociada con esta versión exacta del archivo
Anterior / Siguiente Versión de artefacto	Pruebas para otra versión guardada; indisponible cuando no existe
Cerrar procedencia	Volver a la vista previa

Label	Significado y siguiente acción
atado	Las pruebas retenidas abarcan un alcance limitado. Mantenga ese alcance con código y resultados exportados.
parcial	Falta o no se confirma información ambiental. El registro requiere dependencias antes de la reutilización externa.
No hay ninguna revisión para esta versión	Esta versión de archivo no tiene revisión asociada. Uso Revisor para entender la conversación y la revisión del artefacto.
Entorno en caché	El inventario fue reutilizado. Comprueba el intérprete/paquete real cuando el entorno cambia de materia.

La edición de un informe crea otra versión de archivo; no reequilibra la computación que produjo un CSV separado. Ver Archivos y versiones.

Para inspeccionar una reseña, seleccione Review para la versión requerida, amplíe sus cheques y utilice Go to transcript para inspeccionar la actividad citada. No issues found se aplica a esos cheques y esa versión; no llena la ejecución perdida o evidencia del medio ambiente. Si se interrumpió una revisión, abra su entrada Review error y elija Re-run review. Después de la finalización, vuelva a la pestaña Review del archivo y confirme el nuevo resultado. El intento fallido anterior puede permanecer visible en la conversación.

Reproducibilidad

Para rehacer un resultado capturado, compare los productos y guardar el registro de verificación, siga el Guía de reproducción. Este capítulo abarca la ejecución de Notebook, la inspección de procedencia y la exportación de código.

Código de exportación y reutilización

Elija la exportación que coincida con su objetivo:

Objetivo	Entrada	Índice
Lea el código de productor registrado	Code → Captured producer block → Download	Fuente capturada con sus trayectorias y dependencias originales
Mantener las células Notebook registradas	Execution Log → Download notebook	Una exportación Notebook para el resultado/versión seleccionado
Preparar un script portátil	Code → Generate script	Una reconstrucción generada por modelos para inspeccionar y probar

Generar un script independiente

1. Abra el Provenance → Code de la versión prevista. Compruebe Inputs y Execution Log.
2. Seleccione un modelo predeterminado compatible en Settings → Model → Main model. Esta característica auxiliar utiliza esa política, que puede diferir de la selección de modelos de la conversación.
3. Seleccione Generate script y espere a que Generating… termine.
4. Lea la etiqueta Reconstrucción generada por la LLM. Compruebe las rutas de entrada, dependencias y lugares de salida antes de seleccionar Download script.
5. En el diálogo Guardar sistema, seleccione un directorio separado, compruebe el nombre de archivo .py y confirme Save. Abra el archivo guardado para confirmar que contiene el código mostrado.
6. Proporcione las entradas usando los nombres exactos esperados por el script, prepare sus dependencias, luego ejecute fuera de la aplicación. Compare los campos de salida y el checksum de entrada con el resultado guardado. Una descarga completa por sí sola no verifica el cálculo.

Ejemplo práctico Realizar el cheque RNA-seq exportado fuera de la aplicación

Para un ejemplo ejecutable descargado, guarde el script, entrada CSV y esperada JSON en una carpeta. En esa carpeta, ejecute python3 GSE60450-portable-check.py. El script utiliza la biblioteca estándar de Python. Renombrar el JSON descargado a expected.json antes de ejecutar: el script escribe GSE60450-portable-check.json. Compare ese archivo generado con expected.json antes de adaptar el script a nuevos datos.

Descargar código cuando la generación de script no está disponible

Si la aplicación devuelve La reconstrucción del código de artefactos no está disponible con la autenticación de suscripción Codex., utilice un proveedor compatible para esta operación auxiliar o descargue el código de productor capturado. Este error se refiere a la reconstrucción del script, no la ejecución ordinaria Codex Notebook.

Para RECONSTRUCTION_UNAVAILABLE, inspeccione los insumos perdidos o las pruebas de ejecución. Un código de descarga capturado preserva el código disponible; no puede recuperar pasos que nunca fueron capturados.

Exportar y reutilizar el Notebook registrado

Seleccione Provenance → Execution Log → Download notebook, elija una ubicación y ahorre. Abra la exportación y compruebe su lenguaje, células y salidas.

Antes de una repetición externa, prepare los archivos de entrada, dependencias registradas y un directorio de salida de forma computarizada. Sustitúyase caminos gestionados por la aplicación sólo en una copia de trabajo, manteniendo intacta la exportación original. La exportación no agrupa las credenciales ni el entorno de aplicación completo. Las exportaciones de ejemplo están disponibles en Datos de ejemplo.

Interpretar errores y advertencias

Síntoma	Siguiente acción
Perdido variable	Reaccionar el código que lo define en el idioma seleccionado / canal
Paquete perdido	Inspeccione los paquetes de tiempo de ejecución y siga Entornos de ejecución
Versión de entrada no disponible	Abrir o adjuntar la entrada actual prevista; resolver su identidad a través de la aplicación
PermissionError / acceso negado	Inspeccionar el alcance del archivo solicitado y el permiso; report persistent access failures using Solución de problemas
Error de red/instalador	Seguir Red usando el nombre de host afectado y el error completo
Advertencia con una carrera completa	Lea lo que afecta la advertencia, entonces inspeccione la salida guardada antes de decidir si se repetir

Al informar de un problema, mantenga la primera línea de falla, tiempo de ejecución seleccionado, identidad de archivo y estado de tarea. Enlace salvó la salida a su ejecución de producción real.