Explorador de variables#

El Explorador de variables te permite navegar y administrar de forma interactiva los objetos generados al ejecutar tu código.

Spyder Variable Explorer execution with a variable of type list

Muestra el contenido del espacio de nombres (incluyendo todos los objetos globales, variables, instancias de clase y más) de la sesión Terminal de IPython seleccionada, y te permite agregar, eliminar y editar sus valores a través de una variedad de editores basados en GUI.

Spyder Variable Explorer, with a list of variables and their contents

El Explorador de variables te proporciona información sobre el nombre, tamaño, tipo y valor de cada objeto. Para modificar una variable escalar, como un número, cadena o booleano, simplemente haz doble clic en el panel y escribe su nuevo valor.

Spyder Variable Explorer modifying value of a variable

Visor de objetos#

El Explorador de variables de Spyder ofrece soporte integrado para editar listas, cadenas, diccionarios, matrices NumPy, Pandas DataFrames, Series y más; además de poder crear gráficos y visualizarlos con un solo clic.

Cadenas de texto#

Cuando una variable de cadena es más larga que cuarenta caracteres, puedes hacer doble clic en ella para ver su valor en un editor de texto para modificarla más fácilmente.

Variable Explorer text editor, displaying a long string in a window

Diccionarios#

Al hacer doble clic en los diccionarios se desplegará un visor que muestra cada una de sus llaves con su valor asociado. Puedes hacer doble clic en cualquiera de los valores para modificarlos, lo que abrirá un nuevo visor si el valor en sí mismo es un objeto.

Dictionary editor displaying keys and their types, sizes, and values

Listas#

En el caso de las listas, el Explorador de variables principal muestra una vista previa de los diez primeros valores. Para verlos todos, haz doble clic en la lista para abrir un visor que te mostrará el índice, tipo, tamaño y valor de cada elemento de la lista. Al igual que los diccionarios, puedes hacer doble clic en los valores para editarlos.

List editor displaying a list, showing one being edited

Arreglos de NumPy#

Al igual que las listas, para las arreglos de Numpy el Explorador de variables muestra una vista previa de sus valores. Al hacer doble clic en ellos, se abrirá un visor que muestra los valores de la matriz en un «mapa de calor», con cada valor en una celda de cuadrícula coloreada en base a su cantidad numérica. Puedes desactivar el color de fondo desmarcando la opción apropiada en el visor, lo que sucederá automáticamente si la matriz es demasiado grande para mejorar el rendimiento.

Array editor array, displaying a "heatmap" of its values

Si es compatible con el tipo de datos, también puedes cambiar el formato de los valores del arreglo, eligiendo el número de decimales que desea que el arreglo muestre. Para esto, haz clic en el botón Formato y establece el formato deseado en el diálogo que aparece, usando la sintaxis estándar Printf-style syntax.

Además, puedes ajustar el tamaño de las filas y columnas del arreglo expandiendo o contrayendo sus encabezados. Al hacer clic en el botón Cambiar tamaño se establecerá automáticamente.

Array editor with a 2D int array, showing resizing of columns

DataFrames#

Los DataFrames, al igual que los arreglos de Numpy, se muestran en un visor donde puedes mostrar u ocultar los colores del «mapa de calor», cambiar el formato y cambiar el tamaño de las filas y columnas, ya sea de forma manual o automática.

Dataframe editor showing data frame "heatmap"

Adicionalmente, a partir de Spyder 4, el Explorador de variables tiene soporte MultiIndex en su inspector de DataFrame, incluyendo índices multi-nivel y multidimensionales.

Dataframe editor showing multi-index support

Menú de opciones#

El menú de opciones en la parte superior derecha del panel de Explorador de variables te permite filtrar los objetos mostrados por una serie de criterios diferentes.

Spyder Variable Explorer, with options menu

También te permite mostrar el mínimo y máximo de los arreglos de NumPy en lugar de una vista previa de sus valores.

Variable Explorer showing max and min values of numpy array

Botones de la barra de herramientas#

La barra de herramientas del Explorador de variables incluye varias características útiles que afectan a todo el espacio de nombres. Por ejemplo, puedes guardar los datos de la sesión actual como un archivo .spydata, que se puede cargar más tarde para recuperar todas las variables almacenadas.

Variable Explorer showing how to save and import data

Advertencia

No debes cargar ningún archivo .spydata desde cualquier fuente en la que no confíes (idealmente, solo aquellos archivos que hayas guardado tu mismp). Al igual que con cualquier Python pickle, no es inherentemente seguro contra código malicioso, ya que puede cargar cualquier objeto Python y puede ejecutar código arbitrario en tu máquina. Además, no se garantiza que funcione de forma fiable en todos los entornos de Python que no sean en aquel en el que se creó, por lo que sólo debería utilizarse como formato de persistencia local, y no para intercambio.

También hay un botón para eliminar todas las variables mostradas, y un cuadro de búsqueda para encontrar objetos por nombre o tipo.

Variable Explorer showing how to search variables

Por último, hay un botón para actualizar el contenido del Explorador de variables, que lo actualizará para mostrar el estado actual del código que se ejecuta en la consola IPython.

Funcionalidad avanzada#

El menú contextual, disponible haciendo clic derecho en cualquier variable, proporciona numerosas opciones adicionales para interactuar con objetos de varios tipos. Estas incluyen renombrar, eliminar o editar variables existentes, así como la opción Duplicar para crear una nueva copia de una de ellas bajo un nuevo nombre que puedes ingresar en el cuadro de diálogo resultante.

Variable Explorer showing duplicating a variable

Además, puedes copiar y pegar el valor de una variable, guardándola en el Explorador de variables con el nombre que elijas. Esto te permite cambiar el tipo de variable que estás pegando, lo que puede ser muy útil. Por ejemplo, te permite copiar fácilmente los elementos de una lista en una matriz.

Variable Explorer showing copying list into array

Adicionalmente, puedes crear un objeto desde cero directamente en el Explorador de variables con la opción Insertar, que te permite escribir la clave (que debería estar entre comillas) y el valor del elemento que deseas insertar. Además de añadir una nueva variable de nivel superior, esta característica también te permite crear una nueva llave en un diccionario, un nuevo elemento en una lista, y mucho más.

Variable Explorer showing insertion of a new variable

Para listas y arreglos de NumPy, hay opciones avanzadas disponibles, incluyendo la generación de gráficos e histogramas de sus valores apropiados a su tipo y dimensiones.

Plot window showing a plot, generated via the previous options

Incluso puedes guardar un arreglo en un archivo .npy simplemente haciendo clic en la opción apropiada, que luego puede ser cargada por Spyder o en tu código a través de numpy.load().

Context menu for an int array, with the Show image option selected

En el caso de arreglos bidimensionales, también puedes mostrarlos como imágenes, tratando sus valores como colores RGB. Para esto, Spyder utiliza los mapas de colores de Matplotlib, que pueden ser fácilmente cambiados para que coincidan con tus preferencias.

Interactive image based on the array's data

Finalmente, hemos añadido una acción de menú contextual para abrir cualquier objeto usando el nuevo Explorador de objetos incluso si ya tienen un visor incorporado (DataFrames, arreglos, etc) permitiendo una inspección más profunda del funcionamiento interno de estos tipos de datos.

Object explorer showing dataframe