sentinelhub-py
Download and process satellite imagery in Python using Sentinel Hub services.
https://github.com/sentinel-hub/sentinelhub-py
Category: Sustainable Development
Sub Category: Environmental Satellites
Keywords
aws ogc-services python-library satellite-imagery sentinel-hub
Keywords from Contributors
eo-data eo-research earth-observation sentinel-2 cloud-detector color-perception paper true-color geotiff geojson
Last synced: about 16 hours ago
JSON representation
Repository metadata
Download and process satellite imagery in Python using Sentinel Hub services.
- Host: GitHub
- URL: https://github.com/sentinel-hub/sentinelhub-py
- Owner: sentinel-hub
- License: mit
- Created: 2017-05-17T12:00:34.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-10T11:46:03.000Z (about 2 months ago)
- Last Synced: 2025-04-25T14:44:27.999Z (1 day ago)
- Topics: aws, ogc-services, python-library, satellite-imagery, sentinel-hub
- Language: Python
- Homepage: http://sentinelhub-py.readthedocs.io/en/latest/
- Size: 220 MB
- Stars: 844
- Watchers: 50
- Forks: 251
- Open Issues: 18
- Releases: 64
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.MD
- License: LICENSE.md
README.md
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:
-
Sentinel Hub services
- Process API,
- Catalog API,
- Batch Processing API,
- BYOC API,
- Statistical API,
- OGC services (WMS/WCS/WFS),
- FIS,
- authentication and rate-limit handling,
-
geospatial utilities
- interface for geospatial objects and transformations,
- large area splitting,
- data collection objects,
- IO tools,
-
Geopedia WMS and REST API.
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 metadata
- Name: Sentinel Hub
- Login: sentinel-hub
- Email: [email protected]
- Kind: organization
- Description: Sentinel Hub services by Sinergise Solutions d.o.o.
- Website: https://www.sentinel-hub.com
- Location:
- Twitter: sentinel_hub
- Company:
- Icon url: https://avatars.githubusercontent.com/u/31830596?v=4
- Repositories: 39
- Last ynced at: 2025-01-19T06:51:54.081Z
- Profile URL: https://github.com/sentinel-hub
GitHub Events
Total
- Issues event: 12
- Watch event: 31
- Delete event: 2
- Issue comment event: 13
- Push event: 6
- Pull request review event: 2
- Pull request review comment event: 1
- Pull request event: 8
- Fork event: 2
- Create event: 2
Last Year
- Issues event: 12
- Watch event: 31
- Delete event: 2
- Issue comment event: 13
- Push event: 6
- Pull request review event: 2
- Pull request review comment event: 1
- Pull request event: 8
- Fork event: 2
- Create event: 2
Committers metadata
Last synced: 6 days ago
Total Commits: 1,235
Total Committers: 46
Avg Commits per committer: 26.848
Development Distribution Score (DDS): 0.377
Commits in past year: 41
Committers in past year: 4
Avg Commits per committer in past year: 10.25
Development Distribution Score (DDS) in past year: 0.171
| Name | 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... | ||
Committer domains:
- sinergise.com: 13
- envsys.co.uk: 1
- ijs.si: 1
- hygeos.com: 1
- spatialys.com: 1
- xlab.si: 1
- epicco.de: 1
- adamj.eu: 1
- hey.com: 1
- climate.com: 1
- google.com: 1
- sgsnb-jvis.sinergise.com: 1
- planet.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 177
Total pull requests: 387
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.61
Average comments per pull request: 0.66
Merged pull request: 368
Bot issues: 0
Bot pull requests: 0
Past year issues: 15
Past year pull requests: 18
Past year average time to close issues: about 1 month
Past year average time to close pull requests: about 17 hours
Past year issue authors: 10
Past year pull request authors: 4
Past year average comments per issue: 2.13
Past year average comments per pull request: 0.22
Past year merged pull request: 17
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- AdrienWehrle (9)
- mlubej (8)
- PeterFogh (6)
- SlowMo24 (4)
- akhildevelops (3)
- saanasum (3)
- wscullen (2)
- stamatisvas (2)
- geoexploring (2)
- patrickcgray (2)
- MinXu1991 (2)
- mdoubko (2)
- wouellette (2)
- jirikadlec2 (2)
- ColinMoldenhauer (2)
Top Pull Request Authors
- zigaLuksic (177)
- AleksMat (92)
- mlubej (22)
- batic (19)
- jgersak (17)
- chorng (9)
- Adrok24 (4)
- DomagojKorais (4)
- iovsn (3)
- jmakovecki (3)
- schwehr (2)
- mesuga-reymond (2)
- jonasViehweger (2)
- sebastianclarke (2)
- gobaRules (2)
Top Issue Labels
- help wanted (40)
- question (39)
- enhancement (33)
- bug (32)
Top Pull Request Labels
- bug (1)
- undecided (1)
Package metadata
- Total packages: 2
-
Total downloads:
- pypi: 43,800 last-month
- Total docker downloads: 11,801
- Total dependent packages: 13 (may contain duplicates)
- Total dependent repositories: 89 (may contain duplicates)
- Total versions: 80
- 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
- Licenses: 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 7 months ago)
- Last Synced: 2025-04-25T14:33:22.155Z (1 day ago)
- Versions: 65
- Dependent Packages: 11
- Dependent Repositories: 86
- Downloads: 43,800 Last month
- Docker Downloads: 11,801
-
Rankings:
- Dependent packages count: 0.962%
- Docker downloads count: 1.556%
- Dependent repos count: 1.608%
- Downloads: 1.896%
- Average: 1.957%
- Stargazers count: 2.321%
- Forks count: 3.399%
- Maintainers (6)
conda-forge.org: sentinelhub
- Homepage: https://github.com/sentinel-hub/sentinelhub-py
- Licenses: CC-BY-SA-4.0
- Latest release: 3.4.4 (published about 3 years ago)
- Last Synced: 2025-04-02T02:57:47.447Z (25 days ago)
- Versions: 15
- Dependent Packages: 2
- Dependent Repositories: 3
-
Rankings:
- Forks count: 11.879%
- Stargazers count: 15.178%
- Average: 16.128%
- Dependent repos count: 17.894%
- Dependent packages count: 19.561%
Dependencies
- 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
- python 3.9 build
- 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 *
Score: 21.51597314800824