act.utils.DatastreamParserARM

class act.utils.DatastreamParserARM(ds='')

Class to parse ARM datastream names or filenames into its components. Will return None for each attribute if not extracted from the filename.

Variables:

• site (str or None) – The site code extracted from the filename.

• datastream_class (str) – The datastream class extracted from the filename.

• facility (str or None) – The datastream facility code extracted from the filename.

• level (str or None) – The datastream level code extracted from the filename.

• datastream (str or None) – The datastram extracted from the filename.

• date (str or None) – The date extracted from the filename.

• time (str or None) – The time extracted from the filename.

• ext (str or None) – The file extension extracted from the filename.

Example

>>> from act.utils.data_utils import DatastreamParserARM
>>> file = 'sgpmetE13.b1.20190501.024254.nc'
>>> fn_obj = DatastreamParserARM(file)
>>> fn_obj.site
'sgp'
>>> fn_obj.datastream_class
'met'

Constructor that initializes datastream data member and runs parse_datastream class method. Also converts datastream name to lower case before parsing.

dsstr

The datastream or filename to parse

set_datastream(ds)

Method used to set or reset object by passing a new datastream name.

datastream	Property returning current datastream name stored in object in standard lower case.
datastream_class	Property returning current datastream class name stored in object in standard lower case.
datastream_standard	Property returning datastream name in ARM-standard format with facility in caps.
date	Property returning date from filename.
ext	Property returning file extension from filename.
facility	Property returning current facility name stored in object in standard upper case.
level	Property returning current data level stored in object in standard lower case.
site	Property returning current site name stored in object in standard lower case.
time	Property returning time from filename.