Help: Earth Model v.1

Service interface URL Builder Help Revisions

Description

The Earth Model web service provides access to community-contributed Earth models hosted by the IRIS’s Earth Model Collaboration data product (EMC, http://ds.iris.edu/ds/products/emc-earthmodels/). There are five service query methods:

/modelinfo

Produces a list of available Earth models along with a short summary for each.

  • Output format:
    • text (.txt, plain text)
    • JSON (.json, JavaScript Object Notation)

/model

Provides data for a model or a subset of a model via clipping and/or decimating.

  • Output format:
    • netCDF (.nc, network Common Data Form)
    • GeoCSV (.csv, tabular text formatting for geoscience data)

/isosurface

Provides isosurface data for selected variable(s) from a selected Earth model.

  • Output format:
    • netCDF (data)
    • GeoCSV (data)

/plane

Provides data from a model by intersecting the model with a plane.

  • Output format:
    • netCDF (data)
    • GeoCSV (data)
    • PNG (image)

/line

Provides data from a model by intersecting the model with a vertical line.

  • Output format:
    • netCDF (data)
    • GeoCSV (data)
    • PNG (image)

Technical model details

Technical details of the EMC Earth models are available from EMC model detail pages.

Formatting a GET request on the command line.

Requests can be automated using the cURL command line utility:

Use the lower-case (-o) option to specify a file name of your choosing and save to the current working directory:

    curl ‘http://service.iris.edu/iriswsbeta/earth-model/1/model?model=CAM2016&variable=dVsha&nodata=404’ -o “output.zip”

Alternatively, combine the -O (remote-name) and -J (remote-header-name) options to save the results using a server-specified Content-Disposition filename. The file type (.txt, .nc, .csv, or .zip) and name will depend on the endpoint and the format of the request.

    curl -JO ‘http://service.iris.edu/iriswsbeta/earth-model/1/model?model=CAM2016&variable=dVsha&nodata=404’

We recommend always using the -L option to allow cURL to follow HTTP redirections specified by our systems. The DMC uses HTTP redirection during maintenance to continue servicing requests. You may wish to use the -f option. This will cause cURL to return an exit code of 22 if data is not found or the request is improperly formatted.

Encoding special values, in particular + (plus)

Special values in HTTP query content must be encoded or otherwise it may be misinterpreted by the server. Usually HTTP client software does this automatically. One particular special value, the plus (+), can cause confusion with this service. In a URL, the plus (+) is translated to a space character. To avoid this translation and properly submit a plus sign using the encoded value: %2B in place of plus signs.

Problems with this service?

Please send an email report of which service you were using, your URL query, and any error feedback to:
data-help@earthscope.org
We will address your issue as soon as possible.