Ciop-catquery » History » Revision 2
Revision 1 (Herve Caumont, 2013-06-18 16:23) → Revision 2/7 (Herve Caumont, 2013-06-18 16:25)
h1. Ciop-catquery
Command Line (CLI) reference
{{>toc}}
h2. Name
ciop-catquery --
h2. Synopsys
<pre>
ciop-catquery [options] [<catalogue_url | ENVIRONMENT: $_CIOP_CQI_LOCATION>]
</pre>
Catalogue URL Parameters:
> Argument is the catalogue URL string.
> on the Sandbox, the environment variable $_CIOP_CQI_LOCATION is predefined
h2. Description
The following options are available
> [-a|--attribute=attribute1:condition1] [-a attribute2:condition2] [...]] attribute to filter on condition
> [-b|--bbox=xmin,ymin,xmax,ymax] bounding box extend to query on
> [-ce|--ce=hostname] computing element access control (not used in Sandbox mode, legacy option)
> [-d|--debug] show more debugging info
> [-f|--filequery=txt_query_file] add the query parameters from the txt_query_file
> [-gbt|--getbboxtimes=xmin,ymin,xmax,ymax] get the product acquisition times of the defined bounding-box
> [-o|--outputfields="field[,field,field]"] metadata field to output (defaults: dc:identifier)
> [-s|--sortorder="attribute[:asc|:desc],attribute[:asc|:desc]"] sort by attribute
> [-se|--series="SERIES_NAME"] specify the series if not defined in URL
> [-tq|--timequery="begin=YYYY-MM-DDTHH:MM:SS.sTZD;end=[;method=]"]
> > specify time range for query.
> > begin=YYYY-MM-DDThh:mm:ss.sZ
> > end=YYYY-MM-DDThh:mm:ss.sZ
> > [method=<sensing_interval,sensing_start,sensing_stop,processing,insertion>]
> > (default: sensing_interval)
> [-ox|--output-xml] keep xml ouput format from the catalogue
> [-ol|--outputlimit=max_rows] maximum number of result rows to output (default: 20)
> [-p|--productname=productname] specify product if not defined in URL
> [-O|--outputfile=output_filename] output in output_filename instead of stdout
> [-to|--timeout=max_sec] max timeout for query
> [-x|--xmlfilequery=xml_query_file] query by XML file
The catalogue URL has the form:
http://catalogue_server/database/schema/[series]
The environment variable $_CIOP_CQI_LOCATION can be used to initialize the CatalogueURL (instead of command-line). On the Sandbox, the environment variable $_CIOP_CQI_LOCATION is predefined.
Valid attribute search fields:
> size:
> orbitNumber:
> processorVersion:
> processingCenter:
> acquisitionStation:
-
*See man page for range and list operators.*-
h2. Examples
<pre>
ciop-catquery --outputfields=dc:identifier,ical:dtstart,dct:spatial --outputlimit=2 http://grid-eo-catalog.esrin.esa.int/catalogue/gpod/SAR_IMP_1P
ciop-catquery --getbboxtimes=-19,13,-4,30 --product=MER_RR__1PQACR20040902_104546_000026292030_00037_13117_0000.N1 http://maps.terradue.com/catalogue/gpod/MER_RR__1P
</pre>