Page History

Some tips on searching for data using Earthdata Search.

...

Searching: in general

Earthdata Search's free text search field attempts to understand free text queries. e.g. complex queries like "land surface temperature over Uganda for the last 10 years" -- but its algorithm is a work in progress, and may ."

Sometimes a text search does not return useful results.  This happens most often when the search includes:

• an unrecognized, misspelled or ambiguous location name;
• the name of a body of water, river and/or landmark.

For best results,

• If you know the specific collection name, shortname, id or project you are looking for, start your search using the free text field.  ; 
• otherwise, skip the free text field, and start your search using the search "facets" (aka checkboxes ) on the left to specify the most relevant scientific keywords, projects, etc.
• Next, specify the location you are interested in using the spacial criteria button (the compass icon) located to the right of the free text field. 

...

• Finally, specify the time you are interested in using the temporal criteria button (the clock icon) located to the right of the free text field.

So for example, to search for "land surface temperature over Uganda for the last 10 years"

1. Check the following checkboxes on the left:
   Keywords | Land Surface | Land Temperature
   Keywords | Surface Radiative Properties | Land Surface Temperature
   Keywords | Surface Thermal Properties | Land Surface Temperature
2. Enter temporal criteria:  click the clock button next to the free text field, and enter Start: 2008-01-01 00:00:00 and Stop: Today.
3. Enter spacial criteria:  click the compass button next to the free text field, and draw a bounding rectangle around Uganda.

Getting data: in general

You can download a granule, multiple granules, a single collection, or multiple collections.

TO DOWNLOAD A GRANULE, MULTIPLE GRANULES, OR A COLLECTION:

Click a collection to view its granules. In granule view, you'll see only the granules for the collection that fit your spacial and temporal constraints. Note that you can further refine what granules are selected using the "Granule Search" text field, the "Granule Filters" (the link with funnel icon) to the right of it, and the date slider at the bottom of the screen.

To download all selected granules, click the big green "Download All" button on the right hand side of the screen.

To download an individual granule, click the "Download single granule data" button (the down arrow icon) beside the granule

After clicking "Download All" or "Configure and download single granule data," you will see one or more of the following order options, depending on what the data provider supports:
o "Direct Download" - Allows you to download data as-is now from your browser, either by accessing a list of download links, by downloading a file of data links for offline processing, or by downloading a script that can be used with curl or wget.   (Note: tips for using the download script can be found here.)
o "Stage for Delivery" - Allows you to submit a request for a staged delivery.  You will receive an email with download instructions when the data is ready.
o "Customize Product" - Allows you to select custom service options to be performed (e.g. subsetting, reprojection, etc.) You will receive an email with download instructions when the data is ready.

TO DOWNLOAD MULTIPLE COLLECTIONS

1) Use the "Add to project" button to add collections to your "project" (similar to a shopping cart), and then click the "My Project" button in the upper right hand side of the screen.
2) For each collection in your project, click the collection and select the granules you want to download.
3) Go back to the project, and select the big green "Download Project Data" button on the right.

Searching: Filtering granules

In granule view, you can filter the granules selected using any combination of the following:

• temporal criteria (clock button on the upper left) - enter / modify the date criteria
• spacial criteria (compass button on the upper left) - enter / modify the location criteria
• the date slider at the bottom of the page
• the "Granule Search" field – enter one or more granule names or patterns
• the "Filter Granules Filters" button link (the funnel button on the rightlink to right of the Granule Search field) - specify Day / Night, Cloud Cover and other collection-specific attributes

Searching for granules by filename

To search for a specific granule file in Earthdata Search, you will first need to know the name, shortname or id of the collection name the collection to which it belongs.

When you have that, search for the collection, and then the collection, then click the collection in the search results, and in granule view use the "Granule Search" field to filter the collection's granules using the significant part of granule filename. 

For example, to search for file N42W072.zip in in the collection having the shortname ASTGTM:

1. Search for collection ASTGTM
2. Click on the collection, and in granule view in the "Granule Search" field type *N42W072*

Downloading individual granules

In granule view, you can quickly download granules one at a time using one of the following buttons next to each granule:

• "Download single granule data" - direct download of unmodified granule data, without creating an order
• "Configure and download single granule data" - create an order for the granule.  This allows full access to order options that might be offered by the data provider, e.g. subsetting, etc. 

...

Searching by recurring date:  How to search for all Novembers from 2000 to 2018:

1.  In the upper left corner of the screen, click the temporal icon (the clock).
2. In the dialog, check "Recurring"
3. In the dialog, click in "Start," then click "Nov," then click "1"
4. In the dialog, click in "End," then click "Nov," then click "30"
5. In the dialog, adjust "Year Range" to be 2000 - 2018  
6. In the dialog, click "Apply Filter"

...

Customizations: Data subsetting, reformatting, reprojection,

...

etc

"Subsetting servicesCustomizations" refers refer to data customization options offered by data providers for select productsoptional data processing/subsetting services that may be available from data providers.   These may include data reformatting (e.g. to NetCDF,  GeoTIFF, KLM and other file formats), data reprojection, data subsetting, and other options.

For a specific collection, the availability of customizations depends on whether the collection's provider supports customization services for it.   Collections for which subsetting services customizations are available are indicated with the label "SUBSETTINGCUSTOMIZABLE" following the collection name.    

To see only customizable products that support subsetting, check the "Features | Subsetting ServicesCustomizable" checkbox on the left in collection view.

To specify subsetting services, when placing an order a customization option, place an order for one or more granules of a customizable collection, and then choose the "Customize Order" option.    

Please note that subsetting NOTE: customization services are not offered for all products, and not all subsetting-capable customizable products support every option. 

...

https://landsat.usgs.gov/what-us-ard-tile-grid
https://landsat.usgs.gov/ard#Tile%20Grid

WRS-1 (Landsat 1-3)
Dimensions - Path/Row
Enter path and row coordinates separated by spaces, e.g. "2,3 5,7 8,8"
More info:
"The Worldwide Reference System (WRS) is a global notation used in cataloging Landsat data. Landsat 8 and Landsat 7 follow the WRS-2, as did Landsat 5 and Landsat 4. Landsat 1, Landsat 2, and Landsat 3 followed WRS-1.""
https://landsat.usgs.gov/what-worldwide-reference-system-wrs

WRS-2 (Landsat 4+)
Dimensions - Path/Row
Enter path and row coordinates separated by spaces, e.g. "2,3 5,7 8,8"
More info:
"The Worldwide Reference System (WRS) is a global notation used in cataloging Landsat data. Landsat 8 and Landsat 7 follow the WRS-2, as did Landsat 5 and Landsat 4. Landsat 1, Landsat 2, and Landsat 3 followed WRS-1.""
https://landsat.usgs.gov/what-worldwide-reference-system-wrs

Using NASA Earthdata datasets in other works

NASA data are freely accessible; however, when you publish these data or works based on the data, we request that you cite the datasets within the text of your work, and include references to the datasets in your reference list.

References to datasets should have enough detail to allow your audience to obtain the datasets themselves and conduct their own studies based on your work. (For complete provenance and understanding of specifically which parts of data were used and how, it also may be necessary to describe in detail, within the body of your work, exactly how the data is used.)

Because each discipline within Earth science has its own unique approach to data, each dataset provider has posted examples on how to cite and reference its discipline-specific data and services.   

These can be found at:
https://earthdata.nasa.gov/earth-observation-data/data-citations-acknowledgements

Related articles