Différences entre versions de « SBK-CSV-File »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
Ligne 47 : Ligne 47 :
  
 
=== First row ===
 
=== First row ===
The first row contains the columns title. As they are text values, each entry is double-quoted.
+
The <font color="teal">'''first row'''</font> contains the columns title. As they are text values, each entry is double-quoted.
 
The title of data columns use the "'''long description'''" of the data together with "'''unit name'''" of the captured data.
 
The title of data columns use the "'''long description'''" of the data together with "'''unit name'''" of the captured data.
  

Version du 6 juillet 2024 à 19:10

Forewords

When recording the sensor data, the DataLogger do store the data into a CSV file.

Unlike a computer, the microcontroler that powers the DataLogger has no concept of regional settings.

Consequently, the commonly used settings are applied when generating the CSV files and write numeric values into them.

CSV convention

The comma is used as field separator.

Numbers are written with

  • dot as decimal separator
  • Without thousand separator

Text value are double quoted

DateTime are encoded with the format "dd/mm/yyyy hh:nn:ss"

  • dd: day of the month in two positions
  • mm: month of the year in two positions
  • yyyy: year in four positions
  • hh: hour in two positions (00 to 24)
  • nn: minutes in two positions (00 to 59)
  • ss: seconds in two positions (00 to 59)

CSV filename is based on its creation time:

  • yyyymmdd-hhnnss.csv (see datetime encoding here above)
  • CSV files are stored into the /data path.

CSV File content

The capture below shows an example of CSV file generated by the datalogger.

"iter","datetime","Pression Atmosphérique (hectopascal)","Temperature (Celcius)"
1,01/01/2021 00:01:29, 990.92, 22.92
2,01/01/2021 00:01:30, 990.90, 22.91
3,01/01/2021 00:01:31, 990.88, 22.86
4,01/01/2021 00:01:32, 990.90, 22.85
5,01/01/2021 00:01:33, 990.88, 22.84
6,01/01/2021 00:01:34, 990.88, 22.85
7,01/01/2021 00:01:35, 990.84, 22.84
8,01/01/2021 00:01:36, 990.88, 22.83
9,01/01/2021 00:01:37, 990.87, 22.84

First row

The first row contains the columns title. As they are text values, each entry is double-quoted. The title of data columns use the "long description" of the data together with "unit name" of the captured data.


The very first column is the "iteration" number. The number increments of 1 for each new data capture. Thanks to this number, it is quite easy to detect missing entry in the log file (which may sometime happens when capturing lot of data at very high rate).

The second column

The other columns, one by captured data, contains the data with format identical to preview mode.

xxxxxxx


Written by Meurisse D. for MCHobby


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.