act.io.read_icartt

act.io.read_icartt(filename, format=Formats.FFI1001, return_None=False, **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 fomatted in returned Dataset.

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

  • format (str) – ICARTT Format to Read: FFI1001 or FFI2110.

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

  • **kwargs (keywords) – keywords to pass on through to icartt.Dataset.

Returns:

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

Examples

This example will load the example sounding data used for unit testing.

import act
ds = act.io.icartt.read_icartt(act.tests.sample_files.AAF_SAMPLE_FILE)
print(ds.attrs['_datastream'])