act.io.read_icartt#

act.io.read_icartt(filename, return_None=False, apply_scale_factors=True, **kwargs)[source]#

Returns xarray.Dataset with stored data and metadata from a user-defined query of ICARTT from a single datastream. Has some procedures to ensure time is correctly formatted in returned Dataset.

Scale factors from header line 11 are applied by default. They are applied to the data columns only, so the ULOD_Value, LLOD_Value and uncertainty attributes are carried through exactly as the file states them, unscaled. Limit of detection flags in the data are left untouched.

Parameters:

  • filename (str) – Name of file to read.

  • return_None (bool, optional) – Catch IOError exception when file not found and return None. Default is False.

  • apply_scale_factors (bool, optional) – Multiply each dependent variable by its scale factor. Default is True. When False the values are returned exactly as the file records them and the scale factor is left live in the scale_factor attribute, which is a reserved CF name that xarray will act on if the Dataset is written to netCDF and read back.

  • **kwargs (keywords) – keywords to pass on through to Icartt.from_file.

Returns:

ds (xarray.Dataset (or None)) – ACT Xarray dataset (or None if no data file(s) found).