sentineleof 0.11.1

Download precise orbit files for Sentinel 1 products

Sentinel EOF

Tool to download Sentinel 1 precise/restituted orbit files (.EOF files) for processing SLCs

Changes to Sentinel-1 orbit files source

The source for orbit files provided by ASF has switched to their public S3 bucket. Since the S3 bucket is public, no Earthdata credentials are required.

To use this directly bypass the default of using the Copernicus Data Space Ecosystem (CDSE), you can pass the --force-asf flag[^1] to the command line tool.

Changes to Copernicus Data Space Ecosystem (since October, 2023)

The Copernicus Scihub client has discontinued service in favor of the new Copernicus Data Space Ecosystem. The new service no longer allows anonymous public downloads (using the gnssuser), which means you must register for either a Dataspace account (to use the CDSE data).

Changes required by you to continue using CDSE-provided orbits with this tool:

Register for CDSE

1. Register for an account with Copernicus Data Space account at https://dataspace.copernicus.eu/ (using the Loging button, which will have the option for a "Register" page)
2. After creating the username and confirming your email, store your username/password in a ~/.netrc file (or, on Windows, ~_netrc) with the hostname dataspace.copernicus.eu:

machine dataspace.copernicus.eu
  login MYUSERNAME
  password MYPASSWORD

Setup and installation

pip install sentineleof

or through conda:

conda install -c conda-forge sentineleof

This will put the executable eof on your path

Usage

After setting up your ~/.netrc (see above), if you have a bunch of Sentinel 1 zip files (or unzipped SAFE folders), you can simply run

eof

and download either the precise orbit files, or, if the POEORB files have not been released, the restituted RESORB files.

Running

eof --search-path /path/to/safe_files/ --save-dir ./orbits/

will search /path/to/safe_files/ for Sentinel-1 scenes, and save the .EOF files to ./orbits/ (creating it if it does not exist)

Command Line Interface Reference

Full options available for the command line tool are:

$ eof --help
Usage: eof [OPTIONS]

  Download Sentinel precise orbit files.

  Saves files to `save-dir` (default = current directory)

  Download EOFs for specific date, or searches for Sentinel files in --path.
  Will find both ".SAFE" and ".zip" files matching Sentinel-1 naming
  convention. With no arguments, searches current directory for Sentinel 1
  products

Options:
  -p, --search-path DIRECTORY     Path of interest for finding Sentinel
                                  products.   [default: .]
  --save-dir DIRECTORY            Directory to save output .EOF files into
                                  [default: .]
  --sentinel-file PATH            Specify path to download only 1 .EOF for a
                                  Sentinel-1 file/folder
  -d, --date TEXT                 Alternative to specifying Sentinel products:
                                  choose date to download for.
  -m, --mission [S1A|S1B|S1C]     If using `--date`, optionally specify
                                  Sentinel satellite to download (default:
                                  gets S1A, S1B, and S1C)
  --orbit-type [precise|restituted]
                                  Optionally specify the type of orbit file to
                                  get (default: precise (POEORB), but fallback
                                  to restituted (RESORB))
  --force-asf                     Force the downloader to search ASF instead
                                  of ESA.
  --debug                         Set logging level to DEBUG
  --cdse-access-token TEXT        Copernicus Data Space Ecosystem access-
                                  token. The access token can be generated
                                  beforehand. See https://documentation.datasp
                                  ace.copernicus.eu/APIs/Token.html
  --cdse-user TEXT                Copernicus Data Space Ecosystem username. If
                                  not provided the program asks for it
  --cdse-password TEXT            Copernicus Data Space Ecosystem password. If
                                  not provided the program asks for it
  --cdse-2fa-token TEXT           Copernicus Data Space Ecosystem Two-Factor
                                  Token. Optional, unless 2FA Authentification
                                  has been enabled in user profile.
  --ask-password                  ask for passwords interactively if needed
  --update-netrc                  save credentials provided interactively in
                                  the ~/.netrc file if necessary
  --netrc-file TEXT               Path to .netrc file. Default: ~/.netrc
  --max-workers INTEGER           Number of parallel downloads to run. Note
                                  that CDSE has a limit of 4
  --help                          Show this message and exit.

To use the function from python, you can pass a list of dates:

from eof.download import download_eofs

download_eofs([datetime.datetime(2018, 5, 3, 0, 0, 0)])
download_eofs(['20180503', '20180507'], ['S1A', 'S1B', 'S1C'])

[^1]: This will be the default in a future version of this package. It is currently still an optional a flag to keep backward compatibility.