eoplatform 0.2.0

Earth Observation made easy.

An Earth Observation Platform

Earth Observation made easy.

Report Bug | Request Feature

About

eoplatform is a Python package that aims to simplify Remote Sensing Earth Observation by providing actionable information on a wide swath of RS platforms and provide a simple API for downloading and visualizing RS imagery. Made for scientsits, educators, and hobbiests alike.

• Easy to access information on RS platforms
  • Band information
  • Orbit regimes
  • Scene statistics
• Accessible data downloading (in-progress)
  • Landsat 8
  • Sentinel-2
• Common band composites

Installation

eoplatform can be installed by running pip install eoplatform. It requires Python 3.7 or above to run.

If you want to install the latest version from git you can run

pip install git+git://github.com/mtralka/eoplatform

Example

Usage

eoplatform is fully accessible through the command line (CLI) and as a module import.

Querying platform info (cli)

CLI

Commands:

• info - find platform info
• download - download platform scenes

Usage: eoplatform info [OPTIONS] PLATFORM

Arguments:
  PLATFORM  [required]

Options:
  -d, --description / -nd, --no-description
                                  [default: description]     
  --help                          Show this message and exit.

EX:

eoplatform info Landsat8

show all info eoplatform has on Landsat8

eoplatform info Landsat8 -b

shows only Landsat8's bands

Module import

You can import your desired platform

from eoplatform import Landsat8

Landsat8.info()  # OR print(Landsat8)

or search from the eoplatform module itself

import eoplatform as eop

eop.info("Landsat8")

Downloading platform scenes

CLI

in-progress

Usage: eoplatform download [OPTIONS] PLATFORM

Arguments:
  PLATFORM  [required]

Options:
  --help  Show this message and exit.

Module import

in-progress

from eoplatform import Landsat8

Landsat8.download()

import eoplatform as eop

eop.download("Landsat8")

both methods accept the full range of search keword arguments

Roadmap

See the open issues for a list of proposed features (and known issues).

• download support

Contributing

Contributions are welcome. Currently, eoplatform is undergoing rapid development and contribution opportunities may be scarce.

• If you have suggestions for adding or removing features, feel free to open an issue to discuss it, or directly create a pull request with the proposed changes.
• Create individual PR for each suggestion.
• Use pre-commit hooks - pre-commit install
• Code style is black, mypy --strict

License

Distributed under the GNU GPL-3.0 License. See LICENSE for more information.

Built With

• Rich
• Typer

Authors

• Matthew Tralka