Skip to content

ESGF_Web_Search_User_Guide

Stephen Pascoe edited this page Apr 9, 2014 · 6 revisions
Wiki Reorganisation
This page has been classified for reorganisation. It has been given the category MOVE.
The content of this page will be revised and moved to one or more other pages in the new wiki structure.

ESGF Search User Guide

Summary

Any ESGF site allows the user to search for data through any combination of two operations:

  • Entering arbitrary words in a free text area
  • Using the pre-defined search categories (a.k.a. facets ) and selecting any number of options

The search always returns matching results found at all ESGF sites throughout the federation. If a site happens to be unavailable, the search automatically skips it.

The returned results are always datasets , i.e. abstract data containers which, in the most common case, contain files . To download individual files, add the datasets to your Data Cart , and then click on the HTTP links to download files individually, or ask the site to generate a wget script to download all files at once. Alternatively, expert users can bypass the search interface and generate a wget script directly by typing a URL that contains the desired search constraints - this is described in detail here .

Free Text Search

Syntax

  • Enter one or more words. By default multiple words are combined as logical _ OR _ .

  • Use the explicit operators AND , OR (in upper case) to request that all of the words, or any of the words be present in the metadata.

  • Words are searched for in all metadata fields. To request that a word be found in a specific metadata field, use the notation field:word

  • You can use the wildcard * to match a portion of a word, in all fields or a specific field.

Examples

    • (search for all datasets, no constraints)
  • ocean (search for all datasets that contains the word _ ocean _ in any of its metadata fields)

  • air temperature (search for datasets that contain the word _ air _ or the word _ temperature _ , possibly both)

  • air OR temperature (same as _ air temperature _ - words are combined in logical OR by default)

  • "air temperature" (match the exact phrase _ air temperature _ )

  • air AND temperature (search for datasets that contain both words _ air _ and _ temperature _ , but not necessarily in that order, and not necessarily in the same metadata field)

  • project:CMIP5 AND variable:hus (search for datasets that are part of the _ cmip5 _ project and contain the variable _ hus _ )

  • cloud AND project:CMIP5 AND variable:hus (restrict the previous search to datasets that contain the word _ cloud _ , anywhere in the metadata)

  • id:IPSL AND variable:hus* (search using wildcards in the two metadata fields _ id _ and _ variable _ )

Faceted Search

You can select any number of facet values as search constraints, and mix them with the free text constraints. To select a facet option, first click on the facet in the left bar menu, then on one of its possible values. Once a facet is selected, its set of options will only include the option selected. To back out of that selection, click on the corresponding constraint in the upper left window that lists the current selection.

References

  • User Guide : complete guide to using the ESGF portal user interface
Clone this wiki locally