File Processor Agent File – Series

<< Click to Display Table of Contents >>

Live > Agents > File Agents > File Processor > Settings > File >

File Processor Agent File – Series

 

Setting

Type

Description

seriesNameColumnHeaderRegexGroups

Regex Named Groups

The DT_LOGGER_SERIES.SERIES_NAME, SERIES_UNIT, and/or SERIES_FUNCTION identify the series to which the datum is added. They are used to find/add the series, and are obtained from each column's header text.

 

e.g., column's header text = 'Power(kWh)' => SERIES_NAME = 'Power', SERIES_UNIT = 'kWh' (see Lorentz example).

 

e.g., column's header text = 'CO(ppm)\n(Min)' => SERIES_NAME = 'CO', SERIES_UNIT = 'ppm', SERIES_FUNCTION = 'Min'
(see AreaRAE example).

 

If seriesNameColumnHeaderRegexGroups is empty, all of a column's header text is the SERIES_NAME (see YSI-EXO example).

 

The following criteria is used to identify the series:

1.If seriesFunctionColumnHeaderRegexGroups is not empty; the series' SERIES_NAME, SERIES_UNIT, and SERIES_FUNCTION.

Else

2.If seriesUnitColumnHeaderRegexGroups is not empty, the series' SERIES_NAME and SERIES_UNIT.

Else

3.The series' SERIES_NAME.

seriesUnitColumnHeaderRegexGroups

Regex Named Groups

seriesFunctionColumnHeaderRegexGroups

Regex Named Groups

 

Or

 

Setting

Type

Description

seriesNameColumnHeaderRegex

Regex

If this setting is not empty, and a column exists in the file whose header text matches this pattern, the DT_LOGGER_SERIES.SERIES_NAME identifies the series to which the datum is added. It is used to find/add the series, and is obtained from this column's values, in each data line (see LoggerDatum example).

 

Note: A series' SERIES_DESC may be changed to something more meaningful, to display it in the Live Widgets.

Example – When adding NEW series, this agent sets the series' SERIES_DESC equal to 'Min CO (ppm)', if SERIES_NAME = 'CO', SERIES_UNIT = 'ppm', and SERIES_FUNCTION = 'Min'.