https://github.com/aresta/serialdataviz
Plot data from the serial port. Time series plots, XY plots and scatter plots.
https://github.com/aresta/serialdataviz
arduino electronics esp32 serial-communication serialport
Last synced: 4 months ago
JSON representation
Plot data from the serial port. Time series plots, XY plots and scatter plots.
- Host: GitHub
- URL: https://github.com/aresta/serialdataviz
- Owner: aresta
- License: gpl-3.0
- Created: 2024-11-10T11:56:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-17T18:51:40.000Z (over 1 year ago)
- Last Synced: 2025-04-03T04:33:09.028Z (about 1 year ago)
- Topics: arduino, electronics, esp32, serial-communication, serialport
- Language: Python
- Homepage:
- Size: 1.76 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Serial Data Plotter
Plot data from the serial port. Time series plots, XY plots and scatter plots are supported at the moment.
Data can be just numbers separated by comas or spaces, or named variables.
## Requeriments
Python >= 3.8 (I believe, not tested)
## Installation
#### Clone the github repository
```
git clone https://github.com/aresta/serialdataviz
cd serialdataviz
```
#### Install a Python virtual environment (Optional)
```
python -m venv venv
source venv/bin/activate
```
#### Install dependencies
```
pip install -r requirements.txt
```
## Run
```
py serialdataviz.py
```
## Serial Data formats
You should send the values in the serial port with one of the next formats, depending on the plot type and if you want to name the variables.
The plot type can be selected in the configuration dialog of the application.
### Time series
- One number per line.
```
10.58
13.84
16.80
-19.38
-21.52
```
- Several numbers per lines, separated by comas or spaces. Each number will get a default variable name: Var1, Var2...
```
10.58,70.67,-6.27
13.84,72.12,36.46
16.80,73.60,72.71
24.95,83.35,-41.07
24.42,85.13,-78.28
```
- Several groups, separated by comas or spaces:
```
:number
```
```
Signal_A:10.58,Signal_B:70.67,Another:-6.27
Signal_A:13.84,Signal_B:72.12,Another:36.46
Signal_A:16.80,Signal_B:73.60,Another:72.71
Signal_A:24.91,Signal_B:81.62,Another:4.77
Signal_A:24.95,Signal_B:83.35,Another:-41.07
Signal_A:24.42,Signal_B:85.13,Another:-78.28
```
### XY plot and Scatter plot
- Two numbers *x,y* per line, separated by comas or spaces.
- Several pairs, separated by semicolons. Each pair will get a default variable name: Var1, Var2...
```
number,number;
```
- Several groups of var names and values , separated by semicolons:
```
:number,number;
```
```
Test:-9.27,-9.65;Another one:0.59,4.94
Test:-9.73,-9.33;Another one:-0.66,4.39
Test:-9.96,-8.93;Another one:-1.86,3.30
Test:-9.98,-8.44;Another one:-2.95,1.82
Test:-9.77,-7.86;Another one:-3.86,0.11
Test:-9.34,-7.20;Another one:-4.53,-1.61
```
Take into account that the variable names and the data structure will be parsed only from the first valid line received. The application expects that all lines will have the same structure, so you shouldn't change the order of the variables on the fly.
## Cursors
You can use the cursors to measure positions or relative distances.
In the time series plot if you configure the rate of each received sample (in seconds, milliseconds or microsenconds), the X axis will show the time units and the cursor delta will show also the frequency.
## License
Distributed under the GPL v3.0 or later License. See the LICENSE file in the root of the project for more information.