El editor

El graficador serie

Grafica los números que imprime tu sketch, en la pestaña Graficar junto a Serie.

Lo que no puede ver: solo lo que imprime el sketch. El eje x es el tiempo simulado del fotograma en que llegó una línea, así que dos líneas impresas en el mismo fotograma comparten marca de tiempo; nada se interpola, se suaviza ni se filtra; y una línea que la regla actual no puede leer se queda en la pestaña Serie en lugar de convertirse en un punto. Esa línea es lo primero en el panel, arriba de la gráfica, y no se desplaza fuera de la vista.

Imprimir algo para graficar

Cualquier cosa que imprima una placa con monitor serie. Un número suelto es una curva:

Serial.println(analogRead(A0));

Varios números en una línea son varias curvas, separados por un espacio, una coma o un tabulador:

Serial.print(reading);
Serial.print(',');
Serial.println(target);

Y un par etiqueta:valor le pone nombre a su curva, que es lo que pone una palabra en la leyenda en lugar de #1:

Serial.print("temp:");
Serial.print(celsius);
Serial.print(" humidity:");
Serial.println(humidity);

Ese es a propósito el formato del graficador del Arduino IDE: un sketch escrito para el Serial Plotter del IDE grafica aquí sin cambiar una línea, y un sketch escrito aquí grafica allá.

Las dos reglas, y por qué hay dos

El botón en el encabezado del panel alterna entre ellas.

Números en cualquier parte es lo predeterminado. Cada número en una línea se convierte en un punto y cada palabra se ignora, así que un sketch escrito antes de que alguien pensara en graficar funciona tal cual. La estación meteorológica imprime

reading 3: 23.4 C, 48 %RH

y aparecen dos curvas, 23.4 y 48. El costo es honesto y conviene conocerlo: un mensaje con un número dentro (DHT22 en el pin 2) también es un punto, y cae en la primera curva. Presiona Limpiar después del mensaje, o cambia de regla.

Solo la línea completa es la regla del Arduino IDE: la línea solo se grafica si cada token en ella es un número o un etiqueta:valor. Nunca entra nada espurio, y un sketch que mezcla prosa con sus números no grafica nada. La línea de estado bajo la gráfica dice cuántas líneas se quedaron en Serie, así que una gráfica vacía siempre tiene su razón en pantalla.

En cualquier caso, 0x1f no es 31 y un token vacío no es cero: un número tiene que parecerlo (12, -0.5, +3, .25, 1e-3) o no lo es.

Cómo leer la gráfica

El eje y se ajusta automáticamente según las curvas que estén activadas y la ventana visible, con una décima parte del recorrido de aire arriba y abajo, redondeado a un paso de 1-2-5 para que las líneas de la cuadrícula caigan en números legibles. Una línea plana recibe un recuadro en lugar de dibujarse como una curva de ruido.

El selector de ventana elige cuánto tiempo se ve en pantalla, desde un segundo hasta cinco minutos. Los puntos más antiguos se conservan, no se descartan: amplia la ventana y vuelven a aparecer, y el CSV los incluye todos.

La leyenda es un botón por curva. Haz clic en una para quitar esa curva de la gráfica, lo que también la saca del escalado, así una curva que va de 0 a 1023 no aplana las cuatro que están a su lado. El número en cada tecla es el valor más reciente de esa curva.

Pausa deja de agregar puntos. La placa sigue ejecutándose y sigue imprimiendo, y la pestaña serie sigue llenándose: es una pausa de la gráfica, no del circuito, y la línea de estado lo indica mientras está activada.

CSV entrega todos los puntos como archivo: una fila por instante, una columna por curva. Una curva que no imprimió nada en ese momento recibe una celda vacía en lugar de un cero, porque "no lo dijo" y "dijo cero" son cosas distintas.

Qué contiene

Doce curvas y veinte mil puntos cada una, con el más antiguo descartado primero. Un sketch que imprime una etiqueta nueva en cada línea es un error, no datos, así que el decimotercer nombre se rechaza y la línea de estado lo indica.

Una gráfica pertenece a una ejecución. Al pulsar Ejecutar de nuevo se inicia una gráfica vacía, porque una curva que continuara tras un reinicio serían dos circuitos distintos dibujados como uno.

Un ejemplo para abrir

Estación meteorológica imprime una temperatura y una humedad cada dos segundos y medio, en una línea con palabras: la regla predeterminada grafica ambas, y la falla de la primera lectura es un hueco, no un cero.

Ver también