CPX2

CPX2 is a tool to view and manipulate in the form of graphs. It supports modification of various time spanning input parameters to the DB system, such as mentor edits, segmentation, and system comments.

Command Line Usage

cpx2 [--switch[=value]] [station] [start [end]]

If not specified CPX2 will attempt to infer the station from the current working directory or the $MYSTN environment variable. If neither the start nor end is given the prior seven days (starting at the most recent midnight) will be displayed. If the start time is given as the word “realtime” then CPX2 will start in realtime station mode, with the default window being 1 day. Otherwise if only a start is given, then the end is set to seven days from the start. If both a start and end are given and the start was “realtime” then the end is interpreted as being the time window in fractional days. Otherwise if both are given then CPX2 starts up with that time range. Absolute times may be given in multiple convertible time formats as well as accepting “now” to represent exactly the current time. As long as at least one time is absolute the other may be relative. For any ambiguous argument structure (any structure other than all three of station, start and end set) the station must be in the $STATIONS environment variable. A relative time consists of a digit and a type, for example “1w” for one week from the other time bound. Valid relative ranges are:

  • s - Seconds
  • m - Minutes
  • h - Hours
  • d - Days
  • w - Weeks (exactly seven days, not aligned to real weeks).

Arguments

station

The station code to start for. This also determines the configuration file loaded by default.

start

The start time or “realtime” to start CPX2 in realtime mode.

end

The end time or if in realtime mode, the window size in days.

Switches

--graph-png=FileName:GraphName:Width:Height

Generate a PNG of the specified graph. Width and Height are in pixels. If any exports are requested CPX2 will not start in GUI mode and will exit when all generation is complete.

--graph-eps=FileName:GraphName:Width:Height:DPI

Generate an EPS file of the specified graph. Width and Height are in inches. If any exports are requested CPX2 will not start in GUI mode and will exit when all generation is complete.

--tab-png=FileName:TabName:Width:Height

Generate a PNG of the specified tab. Width and Height are in pixels. If any exports are requested CPX2 will not start in GUI mode and will exit when all generation is complete.

--tab-eps=FileName:TabName:Width:Height:DPI

Generate an EPS file of the specified tab. Width and Height are in inches. If any exports are requested CPX2 will not start in GUI mode and will exit when all generation is complete.

--config=FileName

Use the specified file for station configuration isntead of the default [$CPX2/etc/cpx2.$STATION.xml].

--mode=<raw|edit|editintensive|clean|avgh|avgd|avgm>

Set the data mode to start up in:

  • raw - Raw data and display mode.
  • edit - Edited data in a split pane mode.
  • editintensive - Edited data with intensive calculations (for example humidograph fits).
  • clean - Clean (passed) data.
  • avgh - Hourly averaged clean data.
  • avgd - Daily averaged clean data.
  • avgm - Monthly averaged clean data.

A mode implies a default data source.

--source=<Source>

Override the initial default data source implied by the mode.

--dbavg=<AverageTime>

Use data.avg with the given time instead of data.get. The AverageTime argument is passed directly to the --interval switch in data.avg, so only time specifiers allowed by data.avg are accepted.

Additionally, the specifier may end in a “f” which is not passed to data.avg but causes it to be called with the --fill switch. This can be used to force breaking of data gaps (since they would be filled with MVCs).

--contam

Causes CPX2 to included contaminated data even when it would normally be filtered (edited data or by the –dbavg switch). This will not include contaminated data if the source already has it removed (“avgH” for example).

--help

Display help.

Example Usage

Display week 21 of MLO data

cpx2 mlo 2009W21 1w

Start using a non-default configuration

cpx2 --config=$CPX2/etc/cpx2.brw.smps.xml brw

Generate a PNG of a graph

cpx2 --export-png=output.png:Scattering:800:400 sgp 2009:10 2009:30