Ya utilizaste color y linewidth con la función plot. En los siguientes ejemplos encontrarás más funciones y parámetros. No necesitas memorizar todos sus nombres ni su orden: PyneIDE muestra su ayuda junto al código.

En este capítulo utilizaremos first_chart.py, que ya has creado. No hace falta ejecutar el programa.

Pasa el puntero sobre el nombre de una función

  1. Abre first_chart.py desde el grupo Scripts de la vista Pyne.
  2. Busca la llamada plot(close, "Close", ...) dentro de main().
  3. Sitúa el puntero sobre plot, al principio de la línea, y déjalo ahí un momento.

La ayuda emergente muestra la lista de parámetros y la descripción de la función. Si el contenido es largo, sitúa el puntero sobre la ayuda y desplázate dentro de ella. Puedes cerrarla con Esc.

La ayuda de PyneIDE está abierta sobre la llamada a plot en first_chart.py; la lista indica que el valor predeterminado de linewidth es 1.
La ayuda sobre plot también muestra los tipos de los parámetros y sus valores predeterminados.

¿Cómo leer la lista de parámetros?

La ayuda puede enumerar más ajustes de los que usamos en el ejemplo. Basta con buscar los que necesites en ese momento.

En plot, por ejemplo:

  • series es el valor que se dibujará. En nuestro programa lo ocupa close.
  • title es el nombre del dibujo. Lo proporciona el segundo argumento, "Close".
  • linewidth es el grosor de la línea. El = 1 de la lista indica su valor predeterminado; linewidth=2 lo sustituye en el ejemplo.

Un parámetro es el nombre de un dato o ajuste que espera una función. Un argumento es el valor que le pasas al llamarla. Por tanto, linewidth es un parámetro y el 2 proporcionado en linewidth=2 es un argumento.

Si ves un tipo junto al nombre, te orienta sobre el valor esperado. Por ejemplo, int significa número entero. Volverás a encontrar anotaciones de tipo en los siguientes capítulos; no necesitas aprender ahora la lista completa.

La descripción de la ayuda aparece en inglés; el libro explica en español el significado de los parámetros utilizados. Con una función nueva conviene leer primero la descripción y después buscar el ajuste que quieras cambiar.

Otra posibilidad: saltar a la definición

Si quieres ver dónde está escrita una función, mantén pulsado Command en macOS o Ctrl en Windows o Linux y haz clic en plot. El editor abre su definición. También puedes hacer clic derecho en el nombre y elegir Go to Definition.

En el archivo abierto, debajo de def plot(...) encontrarás la descripción y el funcionamiento de la función. Este código pertenece a la biblioteca instalada: basta con leerlo para este ejercicio, no lo modifiques. Para volver a tu programa, haz clic en la pestaña first_chart.py.

PyneIDE ha saltado a def plot en el archivo plot.py de la biblioteca; debajo se ven las descripciones de los parámetros.
Saltar a la definición abre el código fuente de plot en la biblioteca. Tu programa sigue abierto en otra pestaña.

No necesitas conocer el funcionamiento interno de la biblioteca para completar los ejemplos del libro. Esta posibilidad resulta útil si quieres estudiar una función con más detalle más adelante.

Pruébalo por tu cuenta

Abre la ayuda de plot y busca linewidth. ¿Cuál es su valor predeterminado? Después mira tu llamada: ¿utiliza ese mismo valor?

Solución del ejercicio

El valor predeterminado es 1. En first_chart.py aparece linewidth=2, así que ajustamos el grosor a 2. Si omites ese argumento, la función utiliza el valor predeterminado, 1.