picolog: For PicoTech PicoLog data

Extractors for data files generated using PicoTech data logging tools.

yadg.extractors.picolog.tc08 module

Module for parsing PicoTech PicoLog files, such as those generated by the TC-08 thermocouple reader.

Usage

Available since yadg-5.1.

pydantic model dgbowl_schemas.yadg.dataschema_6_0.filetype.PicoLog_tc08

Config:

extra: str = forbid

Validators:

field filetype: Literal['picolog.tc08'] [Required]

Schema

xarray.DataTree:
  coords:
    uts:            !!float           # Unix timestamp, optional
  data_vars:
    {{ name }}      (uts)             # Temperature of the named thermocouple

Metadata

Metadata about the TC-08 device is read from the overall metadata file. The following parameters are currently parsed:

Model: model number of the network analyseer
Serial: serial number of the device
Software Version: software version with which the file was created

Uncertainties

Uncertainties in temperatures are set to 2.2°C, which is the usual value for a Type-K thermocouple.

Notes on file structure

The .picolog files are actually .tar archives, which include the following files:

a metadata.json file, containing information about the device and the thermocouples plugged in,
a data-map.json.gz file, containing information about chunks of data corresponding to each thermocouple,
a set of zipped binary files with data averaged at different time resolutions

Currently, the data is extracted from the 1.0.gz file only.

Code author: Peter Kraus

yadg.extractors.picolog.tc08.extract(*, fn: str, **kwargs: dict) → DataTree