|
|
# Input File format
|
|
|
|
|
|
Input files with data from NetAtmo observations are assumed to be in [CSV format](https://en.wikipedia.org/wiki/Comma-separated_values#Example). The CSV file headers are assumed to look as follows:
|
|
|
|
|
|
id,time_utc,lat,lon,alt,pressure,temperature,humidity,sum_rain_1
|
|
|
|
|
|
**N.B.:** The column labelled `pressure` actually contains [*mean sea-level pressure* data](https://www.netatmo.com/en-us/glossary/atmospheric-pressure). You should neither convert the pressure nor change the data label in the input file, as `netatmoqc` is already aware of this.
|
|
|
|
|
|
### Input File Example
|
|
|
|
|
|
The contents of a typical `netatmoqc` input file look like the following:
|
|
|
|
|
|
```
|
|
|
id,time_utc,lat,lon,alt,pressure,temperature,humidity,sum_rain_1
|
|
|
fdsgs4gr,1522640535,57.87425881,20.851848,15.0,1014.2,,,0.0
|
|
|
iufuhqdd,1522640615,48.98412901,11.544848,124.0,1003.0,-1.1,43.0,0.0
|
|
|
udqbdr8q,1522640740,60.05484849,10.701577,34.0,1003.1,9.8,56.0,
|
|
|
⋮
|
|
|
|
|
|
```
|
|
|
|
|
|
**N.B.:** The ellipsis (⋮) in should not be present in the file. In the example above, they just indicate that there may be more lines similar to the preceding ones.
|
|
|
|
|
|
|
|
|
# Input File Paths
|
|
|
The file paths are expected to follow the pattern
|
|
|
|
|
|
data_rootdir/YYYYMM/DD/YYYYMMDDThhmmssZ.csv
|
|
|
|
|
|
where:
|
|
|
|
|
|
* `data_rootdir` is the upper-level path to the input files, specified in the config file (see below)
|
|
|
* `YYYY` is a 4-digit year
|
|
|
* `MM`, `DD`, `hh`, `mm` and `ss` represent, respectively, 2-digit month, day, hour, minute and second
|
|
|
|
|
|
The `data_rootdir` path should be specified using a homonymous keyword under the `[general]` section of the config file, as illustrated in the example below:
|
|
|
|
|
|
```
|
|
|
# Example of how to specify the path to the input files in your config file
|
|
|
# The ellipsis (⋮) just represent whatever code that might also be present in the file
|
|
|
⋮
|
|
|
[general]
|
|
|
⋮
|
|
|
data_rootdir="$SOME/PATH/TO/MY/DATA/ROOTDIR"
|
|
|
⋮
|
|
|
⋮
|
|
|
```
|
|
|
|
|
|
### Input File Directory Tree Example
|
|
|
```
|
|
|
data_rootdir
|
|
|
├── 201804
|
|
|
│ ├── 01
|
|
|
│ │ └── 20180401T000506Z.csv
|
|
|
│ ├── 02
|
|
|
│ │ └── 20180402T031504Z.csv
|
|
|
│ └── 30
|
|
|
│ └── 20180430T121504Z.csv
|
|
|
└── 201805
|
|
|
├── 01
|
|
|
│ └── 20180501T000506Z.csv
|
|
|
├── 02
|
|
|
│ └── 20180502T031504Z.csv
|
|
|
└── 31
|
|
|
└── 20180531T121504Z.csv
|
|
|
``` |