ARM Data Quality Web Services
The ARMDQR web service is a world accessible mechanism to query the DQR database. The service will return a list of time blocks (start/end time pairs) that delineate when a user should not use or should be suspicious of ARM data. Read the DQR Web Service User Guide for help with integrating this service with your data processing code. See the 2015 Science Team Meeting Poster for an overview.
Mandatory Parameters
- datastream
- Name of the ARM datastream, for example: nsamfrsrC2.b1
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband - varname
- Name of the variable (or field) as defined in the netCDF datastream.
For example: direct_horizontal_broadband
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband
Optional Parameters
- dqrfields
- DQR fields that will be returned in the response. Valid values are: dqrid,starttime,endtime,metric,subject.
The response will be provided in the same order.
Default response will contain starttime and
endtime
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband&dqrfields=dqrid,starttime,endtime,metric,subject - timeformat
- Used
to specify how time is specified as
an input parameter and also how time will be returned in a
response. Valid values are: YYYYMMDD.hhmmss or armtime, armtime
is seconds since 1970-01-01 (as used in data files).
YYYYMMDD.hhmmss
is date-time as used in filenames. YYYY is four digit year, MM is 2
digit month, DD is 2 digit day, hh is 2 digit hour, mm is 2 digit
minute, ss is 2 digit seconds.
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband&dqrfields=dqrid,starttime,endtime,metric,subject&timeformat=YYYYMMDD.hhmmss - searchmetric
-Used to limit the
type of DQR to be returned. One or more metric types may be specified.
The
default is to return only DQRs of type incorrect.
Valid values are: missing,
suspect, incorrect (multiple values separated by
comma)
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband&dqrfields=dqrid,starttime,endtime,metric,subject&timeformat=yyyymmdd.hhmmss&searchmetric=incorrect,suspect
Machine Readable Delimited Data Response
-
Example asking for "dqrid, startime, endtime, metric, subject" using same timeformat as that used in ARM filenames
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband&dqrfields=dqrid,starttime,endtime,metric,subject&timeformat=YYYYMMDD.hhmmss&searchmetric=incorrect,suspect
D070813.1|20070601.000000|20070831.235900|suspect|NSA/MFRSR/C2 - Instrument shading problem D050811.4|20050808.050000|20050810.210000|suspect|NSA/MFRSR/C2 - Intermittent data D090302.2|20090204.203000|20090302.220200|incorrect|NSA/MFRSR/C2 - Shadowband misalignment
- Same query, but changing timeformat to armtime (seconds since 1970) and only asking for starttime, endtime:
http://www.archive.arm.gov/dqrws/ARMDQR?datastream=nsamfrsrC2.b1&varname=direct_horizontal_broadband&dqrfields=starttime,endtime&timeformat=armtime&searchmetric=incorrect,suspect
1180656000|1188604740 1123477200|1123707600 1233779400|1236031320