pxt-calliope/docs/device/data-analysis/viewing.md
Galen Nickel dbb26a2b51
Data analysis topics (#708)
* Local commit

* First part of  'data analysis' topics

* Delete pngs

* Second blast of edits and pics

* Delete that copy button pic

* Work in plot bar graph

* Dastardly png
2018-03-14 15:54:32 -07:00

2.4 KiB

Viewing your data

Recording data

When your code is writing data, and the editor is recording it, the Show data button is displayed in the simulator under the board and simulation controls.

Show data button

Data view window

If you press the Show data button, the editor will switch from the Blocks or JavaScript view to display a charting window and a text console.

Data chart and console

The console window under the graph will show the data in the format it was written. The chart is the visual representation of the values appearing on the console.

Time scroll

The chart will display new data as it arrives. The chart will scroll with time to continue to display new values.

Data chart time scroll

Data view controls

The chart window shows the data view controls on top of the chart.

Data view controls

Here's what the controls do:

Return: The return button switches the view back to previous code window (either Blocks or JavaScript).

Return button

Source: Tells you where the data is coming from. If the code writing the data is running in the simulator, then the source is Simulator. If your code is running on the @boardname@ and connected by USB, the source is @boardname@.

Source label

Pause: The pause button will stop the display of new values and stop scrolling. When you resume, the chart starts again with the current value written.

Pause button

Resume: The resume button will start displaying new values after the Pause button was pressed.

Resume button

Download: The download button collects the data your code has written and downloads it to your computer as a file called something like data-11-2018-23-00-0700.csv. The numbers in the filename are the date and time when the file is created. The file may automatically open in an editor or spreadsheet if one of those programs is associated with csv files.

Download button