data.aggregate.plots.yearly

data.aggregate.plots.yearly generates the yearly level plots. By default it places them in /aer/www/net/$STATION/images/stats. The configuration file plots.conf defines what is generated. By default a station specific instance of it must exist and must define a start time.

The basic method of operation is to call CPX2 with various configuration and command line options to generate output PNG files.

Command Line Usage

data.aggregate.plots.yearly [--source=source] [--output=directory]
	              station [<ignored>] end

Arguments

end

Specifies the end point to generate plots for. Generally this should be on a year boundary, so something like “2009.0” would specify all of 2008, inclusively. Any convertible time format is accepted.

station

The station identifier code. For example 'brw'. Case insensitive.

<ignored>

Ignored parameter. Required for data.aggregate.station compatibility.

[--source=archive]

Select the source archive to request data from, defaulting to clean.

[--output=directory]

Override the directory from the configuration file to create graphs under. Sub directories for each graph type are automatically created.

CPX2 Configuration File Notes

In general the CPX2 configuration files used are the same as those used in normal CPX2 mode. They should however consider that the amount of data being loaded is much greater and may cause memory constraints. Additionally the environment variable “CURRENT_START” is set to the start of the “current” time interval (usually the latest year) and can be used within embedded Perl code to split out data for difference plots.

The configuration file names specified in plots.conf are used to find the specific XML file to use while the graph names defined in the configuration file translate to the graph names as defined in the XML file. The graph names are also used to construct the output file names.

Example Usage

data.aggregate.plots.yearly bnd 2009.0