act.utils.DatastreamParserARM

class act.utils.DatastreamParserARM(ds='')[source]

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.