Edit on GitLab

Granules

Search NetCDF files from a wide range of datasets, with search criteria such as bounding box, timespan, and some more properties depending on the datasource.

Common

You’ll find bellow characteristics that are common to all datasources.

Input parameters

You’ll find bellow the common <query-string> parameters that you can pass to the Granules resource.

Parameter Required XML name space Value description Value example
datasetId yes xmlns:cwic="http://cwic.wgiss.ceos.org/opensearch/extensions/1.0/" cwic:datasetId swi_l2anad
timeStart no xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/" time:start 1000-01-01T00:00:00Z
timeEnd no xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/" time:end 2200-01-01T00:00:00Z
geoBox no xmlns:geo="http://a9.com/-/opensearch/extensions/geo/1.0/" geo:box -180.0,-90.0,180.0,90.0

The bounding box take into account the 180th meridian.

See also paging options, and full xml description.

Atom output

Geometry

You’ll find bellow XML Namespaces used depending on the geometry you can find into the results output.

Name XML Namespace Use-cases
GeoRSS xmlns:georss="http://www.georss.org/georss/10" Express simple Point, Line, or Polygon
GML xmlns:gml="http://www.opengis.net/gml" Express complex MultiPolygon

You’ll find bellow complete geometries Atom output examples :

  • Point :
<georss:point>45.256 -71.92</georss:point>
  • Line :
<georss:line>45.256 -110.45 46.46 -109.48 43.84 -109.86</georss:line>
  • MultiLine :
<georss:where>
   <gml:MultiCurve>
      <gml:curveMember>
         <gml:LineString>
            <gml:posList srsDimension="2">-180 17.13384155479462 -176.296749 25.724932 -173.912852 30.518504 -171.241874 35.241834 -168.194436 39.87272 -164.654248 44.381335 -160.468893 48.726535 -155.440029 52.850418 -149.31812 56.670675 -141.816179 60.071104 -133.031569 62.804691 -121.776268 64.948036 -109.889994 66.00662699999999 -103.649719 66.149613</gml:posList>
         </gml:LineString>
      </gml:curveMember>
      <gml:curveMembers>
        <gml:LineString>
           <gml:posList srsDimension="2">90.718406 -66.149359 103.055895 -65.61539499999999 114.684628 -64.03132099999999 124.697347 -61.571546 132.994439 -58.439721 139.771098 -54.814401 145.31361 -50.83204199999999 149.893979 -46.590665 153.736123 -42.159275 157.014284 -37.586583 159.861583 -32.90752 162.379827 -28.147725 164.647844 -23.326569 168.650348 -13.61034 177.641333 11.076889 180 17.13384155479462</gml:posList>
         </gml:LineString>
      </gml:curveMembers>
   </gml:MultiCurve>
</georss:where>
  • Polygon :
<georss:polygon>-52.74485855102539 19.14626045227051 -52.74485855102539 18.74626045227051 -53.14485855102539 18.74626045227051 -53.14485855102539 19.14626045227051 -52.74485855102539 19.14626045227051</georss:polygon>
  • MultiPolygon :
 <georss:where>
	<gml:MultiPolygon>
		<gml:polygonMember>
			<gml:Polygon>
				<gml:outerBoundaryIs>
					<gml:LinearRing>
						<gml:posList>180.0,84.03658969804619 180.0,80.87312876712329 179.8382025651205,80.82729354858482 179.96001,76.03 179.78,75.34 179.49001,75.22000000000001 172.14999,74.35000000000001 161.5,73.51 149.69,73.37 134.2,72.65 120.89,70.87 110.13,68.28 101.83,65.17 95.33000000000001,61.67 90.24000000000001,57.96000000000001 86.13000000000001,54.04000000000001 82.77000000000001,50.03 79.95,45.95 77.53,41.78 75.43,37.57 73.60000000000001,33.34 71.97,29.09 69.16000000000001,20.53 65.73,7.61 62.05,-9.67 59.7,-22.63 57.58000000000001,-35.68 55.05,-53.08000000000001 53.40000000000001,-66.15 52.58000000000001,-74.86 52.45,-79.22000000000001 53.03,-83.57000000000001 58.81,-87.9 180.0,-87.76867617843598 180.0,-90.0 -180.0,-90.0 -180.0,-87.76867617843598 -135.08,-87.72000000000001 -107.75,-82.73 -93.69,-79.59 -82.01998999999995,-77.25 -72.57000999999997,-75.65 -67.15999999999997,-74.91000000000001 -58.5,-73.92 -51.38,-73.4 -33.35001,-73.19000000000001 -18.57000999999997,-72.08000000000001 -6.149989999999946,-69.99000000000001 3.67,-67.2 11.28,-63.94 17.24,-60.36000000000001 21.95,-56.57000000000001 25.8,-52.63 28.97,-48.59 31.63,-44.47000000000001 33.93,-40.3 35.93,-36.09 39.27,-27.59 40.7,-23.31 43.21,-14.73 45.36000000000001,-6.11 47.27,2.51 49.79000000000001,15.5 52.04000000000001,28.5 54.08000000000001,41.54000000000001 56.53,58.96000000000001 57.6,67.67 58.35,76.38000000000001 58.37,80.74000000000001 57.32000000000001,85.09 32.05,89.36000000000001 145.08,85.06 180.0,84.03658969804619</gml:posList>
					</gml:LinearRing>
				</gml:outerBoundaryIs>
			</gml:Polygon>
		</gml:polygonMember>
		<gml:polygonMember>
			<gml:Polygon>
				<gml:outerBoundaryIs>
					<gml:LinearRing>
						<gml:posList>-180.0,80.87312876712329 -180.0,84.03658969804619 -169.88,83.74000000000001 -178.81,84.37 -179.78,84.67 -179.75,87.47000000000001 -179.53999,87.96000000000001 -178.31,88.47000000000001 -176.45,88.97000000000001 -170.88,89.46000000000001 -107.91,89.87 -92.64000999999996,89.4 -125.53,86.10000000000001 -156.17999,79.49000000000001 -166.41,77.47000000000001 -179.22,75.42 -179.75,75.53 -179.60001,77.51 -179.09,77.72000000000001 -180.0,78.33000000000001 -179.7857353627432,80.93382729723932 -180.0,80.87312876712329</gml:posList>
					</gml:LinearRing>
				</gml:outerBoundaryIs>
			</gml:Polygon>
		</gml:polygonMember>
	</gml:MultiPolygon>
 </georss:where>

See a parsing example with Python.

Datasources Specifics

Learn more about datasources.

ARGO In-Situ Datasource

You’ll find bellow some specifics about the ARGO Satellite Datasource.

Supported protocols

You’ll find bellow the supported protocols regarding granule output.

Name Description Example
FTP Public FTP Ifremer GDAC ftp://ftp.ifremer.fr/ifremer/argo/dac/jma/2901483/profiles/R2901483_131.nc
HTTPS Public HTTPS Ifremer GDAC https://data-argo.ifremer.fr/dac/jma/2901483/profiles/R2901483_131.nc
ARGO FLEET MONITORING Nextgen Euro-Argo Fleet Monitoring web portal https://fleetmonitoring.euro-argo.eu/float/2901483?cycle=131
ARGO DATA SELECTION Nextgen Euro-Argo Data Selection web portal https://dataselection.euro-argo.eu/cycle/1512235

Available datasets

You’ll find bellow all the datasets available from that datasource. The datasetId is an input parameter of the <query-string>.

datasetId example
argo_cycles here

Additionnal notes

Regarding the argo_cycles dataset, only one vertical profile is returned per cycle. Indeed, it is always the main primary ascending vertical profile that is choosen. That’s why, there are only a single point and a single date to define a cycle.

Additionnal input parameters

Parameter Description Value example
platformId Filter by WMO 4903298
cycleId Filter by Cycle 30
mindepth Filter by min depth (decibar) 200
maxdepth Filter by max depth (decibar) 2000

CERSAT Satellite Datasource

You’ll find bellow some specifics about the CERSAT Satellite Datasource.

Supported protocols

You’ll find bellow the supported protocols regarding granule output.

Name Description Example
local Local file on Ifremer DATARMOR GPFS /home/datawork-cersat-public/[...]/2019/048/SRL_IPN_2PTP127_0376_20190217_190901_20190217_195920.CNES.nc
ftp Private Ifremer FTP servers ftp://eftp1.ifremer.fr/cfosat/sca_l2adm_/v2.4/2020/033/CFO_OPER_SCA_L2A__[...]02T195605.nc
https Private Ifremer HTTPS servers https://iwwoc.ifremer.fr/diffusion/sca_l2adm_/v2.4/2020/033/CFO_OPER_SCA_L2A_[...]00202T195605.nc

Available datasets

You’ll find bellow all the datasets available from that datasource. The datasetId is an input parameter of the <query-string>.

datasetId example
altika_igdr here
ascat_a_l2b_12km_knmi here
ascat_b_l2b_12km_knmi here
cryosat2_igdr here
gpm_l2_ku_v6a here
jason2_igdr here
jason3_igdr here
s1a_wv_ocn here
s1b_wv_ocn here
sca_l2a___ here
scatsat1_l2b_knmi here
swi_l2anad here
hy2b_l2a___ here
s3a_sr_2_wat here
s3b_sr_2_wat here
avhrr_sst_metop_a-osisaf-l2p-v1.0 here
avhrr_sst_metop_b-osisaf-l2p-v1.0 here
avhrr_sst_metop_c-osisaf-l2p-v1.0 here