data.coverage analyzes available data for a given time range and generates a report of the estimated coverage. The estimated coverage number is the number of defined times vs the expected number based on the mode of the time intervals seen as a percentage.
data.coverage [--interval=seconds|monthly|quarter|day] [--records=R11a,R21a,...] [--stdin] [--source=raw] [--csv] [station] [start end] [var1 ... varN]
The time specifiers for the data to be retrieved. Start is inclusive while end is exclusive, so all data contained within the half open interval [start,end) will be returned. Any convertible time format is accepted. Absent when reading from standard input.
The station identifier code. For example 'brw'. Case insensitive.
List of variables to inspect, one specifier per argument (space separated). Optional if records are set (below), if absent in that case then defaulting to all variables contained in those records. Accepts regular expression matches, wrapped in “^variable$”. NOTE: Regular expression matched variables tend to be very slow to query if records are not set.
Interval to report on, by default one month. If set to zero report over the whole time range. The special values “month”, “week”, “quarter” and “day” are also recognized. If defined as a number it is in seconds.
List of records to query. When present only these records are queried even if the variables list above would match more or would not match them at all.
Read from standard input, records and variable specifications are optional if present. If records or variables are set then they are used to filter the output.
Set the archive to query from when not reading from standard input, defaulting to raw.
Output data in CSV format instead of space separated.
data.coverage --records=S11a sgp 2008.0 2009.0
data.coverage --records=S11a --interval=week sgp 2008.0 2009.0 'Bs.*'
data.coverage --interval=quarter sgp 2008.0 2009.0 'Bs.*'
data.avg sgp S11a 2008.0 2009.0 | data.coverage --interval=week
for stn in $STATIONS; do data.coverage --interval=quarter --source=clean --csv $stn 1976.0 2009.5 'BsG.*' 'Ba[OLK].*' 'N_.*'; done
Note that is is very time consuming and will report coverage for stations that may not be verified in the DB system.