File Search Help

Using The Form

The search page will locate publicly available files within the Ocean Data Processing System (ODPS).

Search Tabs:

• Basic: Find OB.DAAC Standard datasets.
• Advanced: Perform a Basic search or find datasets in the Provisional, Special, or Test categories.
• Ancillary: Find OB.DAAc Ancillary datasets.
• Subscription: Find data based on Subscription ID.

Date Range:

Search by selecting either the Start and End date filters or by incrementing the Backdays counter.

• Backdays Search Options:

Filename Pattern:

See File-naming Convention for additional examples.

Additional Options

The "Additional Options" checkboxes allow further customization of the output.

• Unselect All Checkboxes: Return results as HTML listing.
• Display results as text, one file name per line: This will print each file name on its own line. It will generate a list like this:
  T2003122090500.L1A_LAC.R0000032134_21N_17N_160W_152W.hdf
  T2003122090500.L1A_LAC.bz2
  • Also include full URL path: This will prepend the file name with the full URL location of the file.
    https://oceandata.sci.gsfc.nasa.gov/cgi/getfile/T2003122090500.L1A_LAC.R0000032134_21N_17N_160W_152W.hdf
• Include checksum with file name: Show the checksum before the file name.
  76cea78f6f859cfb73df3091c609087dd4659650 T2003122090500.L1A_LAC.R0000032134_21N_17N_160W_152W.hdf

Using the API

OB.DAAC has a file search utility that is accessible through command line interface (CLI).

Available options:

• sensor_id - mission identifier (numerical)
  • valid options:
    
    • 0 - GLOBAL
    • 6 - SeaWiFS
    • 7 - Aqua-MODIS
    • 8 - Terra-MODIS
    • 9 - OCTS
    • 11 - CZCS
    • 14 - SNPP-VIIRS
    • 19 - MERIS
    • 21 - OCM2
    • 25 - HICO
    • 27 - GOCI
    • 28 - L8OLI
    • 29 - S3A-OLCI
    • 32 - OCIA
    • 33 - NOAA20-VIIRS
    • 35 - SE1-Hawkeye
    • 36 - S3B-OLCI
    • 39 - Merged-S3-CYAN
    • 41 - PACE_SPEXONE
    • 42 - PACE_OCI
    • 43 - NOAA21-VIIRS
    • 44 - MERIS-ILW
    • 46 - S3A-ILW
    • 47 - S3B-ILW
    • 49 - Merged-S3-ILW
  • sdate - start date and time of desired data (format YYYY-MM-DD 00:00:00)
  • edate - end date and time of desired data (format YYYY-MM-DD 00:00:00)
  • psdate - when file processing began (format YYYY-MM-DD 00:00:00)
  • pedate - when file processing completed (format YYYY-MM-DD 00:00:00)
  • dtid - data type identifier (i.e. level). This is a dynamically populated listing.
  • addurl - include full url in search result (boolean, 1=yes, 0=no)
  • results_as_file - return results as a test file listing (boolean, 1=yes; 0=no, returning an HTML page)
  • search - text string search
  • subID - subscription ID to search
  • subType - subscription type
    
    • valid options: 1 (non-extracted, default), 2 (extracted)
  • std_only - restrict results to standard products (i.e. ignore extracts, regional processings, etc.; boolean)
  • cksum - return a checksum file for search results (boolean; sha1sums except for Aquarius soil moisture products which are md5sums; forces results_as_file; ignores addurl)
  • format - file is returned in format specified.
    • valid options: txt, json, html

  Here is an example using the file search utility to find and download OCTS daily L3 binned chlorophyll data from November 1, 1996 through December 31, 1999.

  Wget:

        wget -q --post-data="results_as_file=1&sensor_id=9&dtid=1142&suite_id=CHL&sdate=1997-11-01 00:00:00&edate=2022-01-01 23:59:59&subID=1001&subType=1&period=DAY" -O - https://oceandata.sci.gsfc.nasa.gov/file_search
     

  cURL:

  curl -d "sensor=octs&am;sdate=1996-11-01&edate=1997-01-01&dtype=L3b&addurl=1&results_as_file=1&search=*DAY_CHL*" https://oceandata.sci.gsfc.nasa.gov/file_search |grep getfile | cut -d "'" -f 2 | head -1 | xargs -n 1 curl -LJO -n -c ~/.urs_cookies -b ~/.urs_cookies

Using the API

OB.DAAC provides an API for use through a command line interface (CLI) or programming language.

Posting Information

Method: HTTP GET
Base URL: https://oceandata.sci.gsfc.nasa.gov/file_search

Submission Field List