Project

General

Profile

Ciop-catquery » History » Revision 4

Revision 3 (Herve Caumont, 2013-06-18 16:25) → Revision 4/7 (Herve Caumont, 2013-06-18 16:26)

h1. Ciop-catquery 

 {{toc}} 

 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>