Developer Cloud Sandboxes solution

h1. ciop-catquery 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

h3. Example 1. 

<pre>

ciop-catquery --outputfields=dc:identifier,ical:dtstart,dct:spatial  --outputlimit=2  http://grid-eo-catalog.esrin.esa.int/catalogue/gpod/SAR_IMP_1P

</pre> 

h3. Example 2. 

<pre>

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>