Skip to main content

Copernicus Download Manager

Project description

Build Status codecov PyPI python version Platform support GitHub license Join the chat at https://gitter.im/copinicoos/community

Copinicoos

Copinicoos is a Copernicus satellite image download manager.

Copinicoos can ...

  1. Automate the download of all results in a search query.
  2. Download in parallel processes, for faster downloads.
  3. Manage polling for offline products.
  4. Stop and resume downloads, anytime!

Install

pip install copinicoos

Usage

Interactive Mode

To launch,

py -m copinicoos

And then follow on-screen prompt:

  1. Enter Download Directory. Where products will be downloaded to. Entering nothing will default to current directory.

  2. Enter number of Corpernicus accounts. Each account will initialise 2 parallel download processes.

  3. Authenticate accounts by entering login credentials.

  4. Enter query. This can be obtained from Copernicus Open Hub Request Done: ( ... ). Just copy that whole string.

  5. Enter Polling Interval. Entering nothing will use default.

  6. Enter offline product download retries. Entering nothing will use default.

Resume download

Again, launch

py -m copinicoos

And then follow on-screen prompt:

  1. Enter download directory containing copinicoos_logs. Or, if current working directory has copinicoos_logs, entering nothing will resume download from current working directory's savepoint. Savepoints are stored inside copinicoos_logs.

  2. Agree to resume download

  3. Enter Polling Interval. Entering nothing will use default.

  4. Enter offline product download retries. Entering nothing will use default.

Argparse Mode

This mode is so that copinicoos can be called from a script.

All options:

py -m copinicoos <subcommand> -d <download-location> -r <offline-retries> -p <polling-interval>

Subcommand:

  • resume

  • fresh

resume

py -m copinicoos resume

Resume download from savepoint in current working directory.

py -m copinicoos resume -d <download directory>

Resume download from savepoint in <download directory>.

fresh

py -m copinicoos fresh <query> <credentials>

Start a fresh download.

Input can be read from a text file by affixing @ to file name eg.

py -m copinicoos fresh @query.txt @secrets.json

eg. Inside query.txt

( footprint:"Intersects(POLYGON((91.45532862800384 22.42016942838278,91.34620270146559 22.43895934481047,91.32598614177974 22.336847270362682,91.4350291249018 22.31804599405974,91.45532862800384 22.42016942838278)))" ) AND ( (platformname:Sentinel-1 AND producttype:GRD))

eg. Inside secrets.json

{
    "u1":"username1",
    "p1":"password1",
    "u2":"username2",
    "p2":"password2"
}

Note: " has to be escaped, ie \", if parsing directly to the cmd.

For more details:

py -m copinicoos --help

Logs

Logs can be found in a folder named copinicoos_logs in the same directory where products are downloaded to. Manually deleting copinicoos_logs will restart the download.

A summary of finished downloads can be found in copinicoos_logs\WorkerManager.log. Resume points are saved in <InstanceName>_progress.txt

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

copinicoos-0.0.2.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

copinicoos-0.0.2-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

Details for the file copinicoos-0.0.2.tar.gz.

File metadata

  • Download URL: copinicoos-0.0.2.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.3

File hashes

Hashes for copinicoos-0.0.2.tar.gz
Algorithm Hash digest
SHA256 a7611ef6e100870fd4407c032b5ccf07f5c62f93bdd7b98243a1de13d3f687ec
MD5 45ddea63769235de0bdfd132ea8de9f0
BLAKE2b-256 a55aefdd38b7b7e5a52d436eeb28bedf538aeadbe441ef6c3ce4b57e8c63e463

See more details on using hashes here.

File details

Details for the file copinicoos-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: copinicoos-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 18.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.3

File hashes

Hashes for copinicoos-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 638283be9e678e6d70b8a644c56896ff4b6766821786fe3d237818d81bbb97e6
MD5 e4c6ec297a910684c4876eb9e6fc7c2e
BLAKE2b-256 458548da4afb5436a00319eee9e6d39d839ecdb3079b276ca63e2ad09f67272e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page