https://github.com/scottstanie/sentineleof
Download Sentinel 1 precise orbit files
https://github.com/scottstanie/sentineleof
insar orbit sar sentinel-1
Last synced: 4 months ago
JSON representation
Download Sentinel 1 precise orbit files
- Host: GitHub
- URL: https://github.com/scottstanie/sentineleof
- Owner: scottstanie
- License: mit
- Created: 2018-08-22T01:23:35.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-11-28T18:39:02.000Z (7 months ago)
- Last Synced: 2025-11-30T22:55:48.516Z (7 months ago)
- Topics: insar, orbit, sar, sentinel-1
- Language: Python
- Homepage:
- Size: 3.95 MB
- Stars: 118
- Watchers: 6
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/scottstanie/sentineleof/actions/workflows/ci.yml)
[![PyPI version][pypi-version]][pypi-link]
[![Conda-Forge][conda-badge]][conda-link]
[![PyPI platforms][pypi-platforms]][pypi-link]
[conda-badge]: https://img.shields.io/conda/vn/conda-forge/sentineleof
[conda-link]: https://github.com/conda-forge/sentineleof-feedstock
[pypi-link]: https://pypi.org/project/sentineleof/
[pypi-platforms]: https://img.shields.io/pypi/pyversions/sentineleof
[pypi-version]: https://img.shields.io/pypi/v/sentineleof
# 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](https://registry.opendata.aws/s1-orbits/).
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](https://scihub.copernicus.eu/) in favor of [the new Copernicus Data Space Ecosystem](https://dataspace.copernicus.eu/). 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
```bash
pip install sentineleof
```
or through conda:
```bash
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
```bash
eof
```
and download either the precise orbit files, or, if the POEORB files have not been released, the restituted RESORB files.
Running
```bash
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:
```python
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.