Ozone Monitoring Instrument (OMI)

IMPORTANT! Switch to HTTPS -- FTP is being switched off

Paths to files and directories via https follow similar patterns to ftp, for example the following URL ftp://omisips1.omisips.eosdis.nasa.gov/outgoing/OMCLDRR/ corresponds to https://omisips1.omisips.eosdis.nasa.gov/outgoing/OMCLDRR

You can use curl or wget in scripts to pull files; for example to get all the files in a directory the following wget command will grab the files and save to the current working directory:

wget -rnd https://omisips1.omisips.eosdis.nasa.gov/outgoing/OMTO3/
or to list the contents (note as html):
wget -O - https://omisips1.omisips.eosdis.nasa.gov/outgoing/OMTO3/

Instructions for downloading data via https protocol can be found here

OMI / Aura

(HTPS download link)
(Global Change Master Directory link)
OMCLDRR L2 Effective Cloud Pressure and Fraction (Raman Scattering) Swath 13x24 km 0.01 N/A
OMTO3e L3 TOMS-Like Ozone and Radiative Cloud Fraction Daily Global 0.25x0.25 deg 0.003 Browse
OMTO3 L2 Ozone (O3) Total Column Swath 13x24 km 0.71 Browse
OMAERUV L2 Near UV Aerosol Optical Depth and Single Scattering Albedo Swath 13x24 km 0.07 N/A
OMSO2NRTb L2 Sulphur Dioxide (SO2) Total Column Swath 13x24 km 0.58 N/A

Instructions for downloading data via https protocol from OMISIPS1

OMI and OMPS downloads are being switched from ftp to http(s). ESDIS, our parent organization, requires that we track who downloads files and we do this via Earthdata login and/or appkeys.
Earthdata login is appropriate when using a browser as the redirection for http will work correctly. However when using the command line tools this becomes complex. To simplify this we have implemented App Keys ; you generate a key and pass it to your script in a header.

Requesting an App Key

App keys are string tokens that identify who you are. App keys get passed in the authorization header of each HTTP GET request, and they last at least 3 months; which means they can be used in scripts. Any user that does not already have an app key for the OMI/OMPS SIPS can get one by performing the following steps:

  • Go to the LAADS DAAC URL: https://ladsweb.modaps.eosdis.nasa.gov/tools-and-s...
  • Login by going to Profile -> Earthdata Login
    • Note the first time you login via Earthdata Login, it will prompt you to accept authorization of Sentinel3 and MERIS, you must accept to continue.
  • Select Profile / App Keys from the top menu
  • Create your new AppKey by entering a description and clicking the "Create New App Key" button
  • Highlight and copy the app key from the list and save in a file for use later.Retrieving an App Key

Any forgotten or lost AppKeys can be retrieved using the following steps:

  • Login to the LAADS DAAC web site using the Profile -> Earthdata Login menu
  • Select Profile / App Keys from the top menu
  • Highlight and copy any existing App Keys from the list

Users are permitted to have more than one App Key at a time.

To use the App Key with wget (replace MY_APP_KEY with key copied from website):

wget -nd -r --header='Authorization: Bearer MY_APP_KEY'


Same example with curl:

curl -H 'Authorization: Bearer MY_APP_KEY' https://omisips1.omisips.eosdis.nasa.gov/outgoing/... > result

The example above passes your app key via the Authorization HTTP header while utilizing the Bearer schema. When finished, the resulting download will be written to a file called “result“ in whatever directory (folder) you run the command from.

The app key located in the header is how the SIPS identifies users. If the app key is invalid, or missing the command will not work.

To get a listing (to standard out) of the OMTO3 directory via wget use:

wget -nd --header='Authorization: Bearer MY_APP_KEY' https://omisips1.omisips.eosdis.nasa.gov/outgoing/... -O -

To download a single file:

For example OMI-Aura_L2-OMTO3_2018m0529t0918-o73776_v883-2018m0529t120750.he5 go to the current directory: wget -nd --header='Authorization: Bearer MY_APP_KEY' https://omisips1.omisips.eosdis.nasa.gov/outgoing/...

To download all files in the OMTO3 directory to a given directory

FOO in this case and filters out any file ending in '.html' :

wget -r -nd --header='Authorization: Bearer MY_APP_KEY' -R ".html" https://omisips1.omisips.eosdis.nasa.gov/outgoing/... -P FOO

Example scripts and more information can be found at: https://ladsweb.modaps.eosdis.nasa.gov/tools-and-services/data-download-scripts/

If using the the example scripts found on ladsweb,the URL must be changes to the omisips URL: https://omisips1.omisips.eosdis.nasa.gov/outgoing/

Back to top

Last Updated: Sep 20, 2018 at 11:25 AM EDT