sentinelhub-py

Download and process satellite imagery in Python using Sentinel Hub services.

https://github.com/sentinel-hub/sentinelhub-py

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.6%) to scientific vocabulary

Keywords

aws ogc-services python-library satellite-imagery sentinel-hub

Keywords from Contributors

eo-data eo-research earth-observation cython
Last synced: 6 months ago · JSON representation

Repository

Download and process satellite imagery in Python using Sentinel Hub services.

Basic Info
Statistics
  • Stars: 865
  • Watchers: 49
  • Forks: 251
  • Open Issues: 19
  • Releases: 64
Topics
aws ogc-services python-library satellite-imagery sentinel-hub
Created almost 9 years ago · Last pushed 12 months ago
Metadata Files
Readme Changelog License

README.md

Package version Conda version Supported Python versions Build Status Docs status Overall downloads Last month downloads Code coverage

Introduction

The sentinelhub Python package is the official Python interface for Sentinel Hub services. It supports most of the services described in the Sentinel Hub documentation and any type of satellite data collections, including Sentinel, Landsat, MODIS, DEM, and custom collections produced by users.

The package also provides a collection of basic tools and utilities for working with geospatial and satellite data. It builds on top of well known packages such as numpy, shapely, pyproj, etc. It is also a core dependency of eo-learn Python package for creating geospatial data-processing workflows.

The main package resources are GitHub repository, documentation page, and Sentinel Hub forum.

Installation

The package requires a Python version >= 3.8. The package is available at the PyPI package index and can be installed with

$ pip install sentinelhub

or with an extension tag for additional functionalities

$ pip install sentinelhub[AWS] # extra dependencies for interacting with Amazon Web Services

Alternatively, the package can be installed with Conda from conda-forge channel

$ conda install -c conda-forge sentinelhub

To install the package manually, clone the repository and run

$ pip install .

Before installing sentinelhub on Windows it is recommended to install shapely package from Unofficial Windows wheels repository

Once installed the package can be configured according to configuration instructions in documentation.

Content

A high-level overview of the main functionalities:

Documentation

For more information on the package and to access the documentation, visit readthedocs.

Examples

The package has a collection of Jupyter notebooks with examples. They are available in the examples folder on GitHub and converted into documentation under Examples section.

Additionally, some examples are explained in Sentinel Hub webinar videos:

Blog posts

The package played a key role in many projects and use cases described at Sentinel Hub blog. The following blog posts are about the package itself:

Questions and Issues

Feel free to ask questions about the package and its use cases at Sentinel Hub forum or raise an issue on GitHub.

You are welcome to send your feedback to the package authors, Sentinel Hub research team, through any of Sentinel Hub communication channels.

License

See LICENSE.

Owner

  • Name: Sentinel Hub
  • Login: sentinel-hub
  • Kind: organization
  • Email: info@sentinel-hub.com

Sentinel Hub services by Sinergise Solutions d.o.o.

GitHub Events

Total
  • Issues event: 13
  • Watch event: 39
  • Delete event: 2
  • Issue comment event: 17
  • Push event: 6
  • Pull request review event: 2
  • Pull request review comment event: 1
  • Pull request event: 9
  • Fork event: 4
  • Create event: 2
Last Year
  • Issues event: 13
  • Watch event: 39
  • Delete event: 2
  • Issue comment event: 17
  • Push event: 6
  • Pull request review event: 2
  • Pull request review comment event: 1
  • Pull request event: 9
  • Fork event: 4
  • Create event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 1,235
  • Total Committers: 46
  • Avg Commits per committer: 26.848
  • Development Distribution Score (DDS): 0.377
Past Year
  • Commits: 41
  • Committers: 4
  • Avg Commits per committer: 10.25
  • Development Distribution Score (DDS): 0.171
Top Committers
Name Email Commits
AleksMat m****v@s****m 769
Žiga Lukšič 3****c 195
Matej Batič m****c@s****m 45
iovsn j****c@s****m 29
Matic Lubej m****j@s****m 26
devisperessutti d****i@s****m 17
Rok Mocnik r****k@s****m 17
Blaz Sovdat b****t@g****m 16
jgersak 1****k 15
Andrej Burja a****a@g****m 14
chorng 7****g 12
Tomi Slijepcevic t****c@g****m 10
dkorais d****s@s****m 9
avrecko a****o@s****m 8
Marcos de Jesus m****o@g****m 7
Matic Lubej m****j@p****m 5
Adrián Di Paolo 4****4 4
Anze Zupanc a****c@s****m 3
iovsn i****n@s****m 2
Anze Skerlavaj a****j@s****m 2
Kurt Schwehr s****r@g****m 2
Peter Fogh P****h 2
daviddemeij d****j@g****m 2
jonasViehweger 5****r 2
theirix t****x@g****m 1
Anthony Scarth a****k 1
Chris Chamberlin c****n@c****m 1
Regan Koopmans r****s@h****m 1
Abel Paz a****a@g****m 1
Adam Johnson me@a****u 1
and 16 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 178
  • Total pull requests: 404
  • Average time to close issues: 3 months
  • Average time to close pull requests: 3 days
  • Total issue authors: 123
  • Total pull request authors: 42
  • Average comments per issue: 2.51
  • Average comments per pull request: 0.67
  • Merged pull requests: 382
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 14
  • Pull requests: 19
  • Average time to close issues: 1 day
  • Average time to close pull requests: about 3 hours
  • Issue authors: 8
  • Pull request authors: 4
  • Average comments per issue: 0.5
  • Average comments per pull request: 0.05
  • Merged pull requests: 16
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • mlubej (9)
  • AdrienWehrle (8)
  • PeterFogh (6)
  • SlowMo24 (5)
  • akhildevelops (3)
  • saanasum (3)
  • wscullen (2)
  • stamatisvas (2)
  • geoexploring (2)
  • patrickcgray (2)
  • MinXu1991 (2)
  • mdoubko (2)
  • wouellette (2)
  • jirikadlec2 (2)
  • ColinMoldenhauer (2)
Pull Request Authors
  • zigaLuksic (185)
  • AleksMat (92)
  • mlubej (26)
  • batic (20)
  • jgersak (17)
  • chorng (11)
  • DomagojKorais (4)
  • Adrok24 (4)
  • iovsn (3)
  • jmakovecki (3)
  • sebastianclarke (2)
  • schwehr (2)
  • mesuga-reymond (2)
  • jonasViehweger (2)
  • gobaRules (2)
Top Labels
Issue Labels
help wanted (39) question (38) enhancement (34) bug (32)
Pull Request Labels
bug (1) undecided (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 40,032 last-month
  • Total docker downloads: 11,801
  • Total dependent packages: 13
    (may contain duplicates)
  • Total dependent repositories: 89
    (may contain duplicates)
  • Total versions: 143
  • Total maintainers: 6
pypi.org: sentinelhub

Python API for Sentinel Hub

  • Homepage: https://github.com/sentinel-hub/sentinelhub-py
  • Documentation: https://sentinelhub-py.readthedocs.io
  • License: MIT License Copyright (c) 2018 Sinergise Ltd. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  • Latest release: 3.11.1
    published over 1 year ago
  • Versions: 65
  • Dependent Packages: 11
  • Dependent Repositories: 86
  • Downloads: 40,032 Last month
  • Docker Downloads: 11,801
Rankings
Dependent packages count: 1.0%
Docker downloads count: 1.6%
Dependent repos count: 1.6%
Downloads: 1.9%
Average: 2.0%
Stargazers count: 2.3%
Forks count: 3.4%
Last synced: 6 months ago
proxy.golang.org: github.com/sentinel-hub/sentinelhub-py
  • Versions: 63
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.5%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
conda-forge.org: sentinelhub
  • Versions: 15
  • Dependent Packages: 2
  • Dependent Repositories: 3
Rankings
Forks count: 11.9%
Stargazers count: 15.2%
Average: 16.1%
Dependent repos count: 17.9%
Dependent packages count: 19.6%
Last synced: 6 months ago

Dependencies

.github/workflows/ci_action.yml actions
  • SvanBoxel/gitlab-mirror-and-ci-action master composite
  • actions/checkout v2 composite
  • actions/checkout v1 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v2 composite
.gitlab/docker/Dockerfile docker
  • python 3.9 build
pyproject.toml pypi
  • aenum >=2.1.4
  • click *
  • dataclasses-json *
  • numpy *
  • oauthlib *
  • pillow >=9.2.0
  • pyproj >=2.2.0
  • python-dateutil *
  • requests >=2.27.0
  • requests-oauthlib >=1.0.0
  • shapely *
  • tifffile >=2020.9.30
  • tomli *
  • tomli_w *
  • tqdm *
  • typing-extensions *
  • utm *