Terragon: A Unified Framework for Earth Observation Data Cube Generation
Terragon: A Unified Framework for Earth Observation Data Cube Generation - Published in JOSS (2025)
Science Score: 95.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
Found .zenodo.json file -
✓DOI references
Found 1 DOI reference(s) in JOSS metadata -
○Academic publication links
-
✓Committers with academic emails
2 of 4 committers (50.0%) from academic institutions -
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Repository
Basic Info
- Host: GitHub
- Owner: drnhhl
- License: mit
- Language: Python
- Default Branch: main
- Homepage: https://terragon.readthedocs.io/en/stable/
- Size: 3.27 MB
Statistics
- Stars: 22
- Watchers: 2
- Forks: 0
- Open Issues: 3
- Releases: 7
Metadata Files
README.md
Terragon
Terragon - Earth(Poly)gon. Create EO Minicubes from Polygons and simplify EO Data downloading.
You want to download Earth Observation data but don't want to spend hours just for accessing all different APIs? Then this is for you!
We currently support these data providers: - Planetary Computer (pc) - Google Earth Engine (gee) - Copernicus Data Space Ecosystem (cdse) (not all collections supported) - Alaska Satellite Facility (asf) (not all collections supported)
Usage
Installation
Install the package via PyPi:
python
pip install "terragon-downloader"
Optional with the dependency you want to use:
python
pip install "terragon-downloader[pc]"
Downloading EO data
```python import terragon import geopandas as gpd from shapely.geometry import Polygon
example polygon
gdf = gpd.GeoDataFrame(geometry=[Polygon( [(446993, 3383569), (446993, 3371569), (434993, 3371569), (434993, 3383569), (446993, 3383569)])], crs='EPSG:32616' # the dataset will receive the crs from the dataframe )
initialize backend/data source (here planetary computer)
tg = terragon.init('pc')
download data
da = tg.create(shp=gdf, # polygon in geopandas format (minicube will receive the same CRS) collection="sentinel-2-l2a", # name of the collection startdate="2021-01-01", # start date of tiles enddate="2021-01-05", # end date of tiles bands=["B02", "B03", "B04"], # bands to retrieve resolution=20, # pixel size in meter ) ``` Other data backends work with the same principle, some may require an account, check out the Demos.
Limitations
Users must provide authentication (if required) for the data providers to Terragon and must comply with their licensing agreements. Instructions on how to create accounts and the necessary information for each data provider can be found in the Demos.
This library relies on external data providers. Therefore, the reproducibility cannot be guaranteed and depends on the providers. Users should ensure they check the relevant license terms for data and services and cite them appropriately. The data offered may also vary across providers. It is important to note that each provider operates independently and utilizes different processing pipelines. This can result in various products that may not be compatible with one another, even if their collections share a similar name on the platforms of the data providers. Additionally, certain data or patches may be available from some providers but not from others. This includes mosaicking, which depends on the chosen collection and is not handled by this library.
Contribute
You found a bug or a data source is missing? We encourage you to raise an issue or provide a PR. For details, please see the contributing guideline.
We are looking for contributors to add more collections to CDSE. Please get in touch if you are interested.
License
This work is licensed under the MIT license.
Citation
If you use this work, please consider citing the following paper: Coming soon.
Acknowledgement
This work is inspired by cubo
Owner
- Name: Adrian Höhl
- Login: drnhhl
- Kind: user
- Repositories: 1
- Profile: https://github.com/drnhhl
JOSS Publication
Terragon: A Unified Framework for Earth Observation Data Cube Generation
Authors
Chair of Data Science in Earth Observation, Technical University of Munich, Munich Center for Machine Learning
Chair of Data Science in Earth Observation, Technical University of Munich, Remote Sensing Technology Institute (IMF), German Aerospace Center (DLR)
Chair of Data Science in Earth Observation, Technical University of Munich, Munich Center for Machine Learning
Editor
Jack Atkinson
Tags
remote-sensing earth-observationGitHub Events
Total
- Create event: 25
- Issues event: 16
- Release event: 5
- Watch event: 20
- Delete event: 18
- Issue comment event: 11
- Push event: 66
- Pull request review comment event: 11
- Pull request review event: 18
- Pull request event: 38
- Fork event: 1
Last Year
- Create event: 25
- Issues event: 16
- Release event: 5
- Watch event: 20
- Delete event: 18
- Issue comment event: 11
- Push event: 66
- Pull request review comment event: 11
- Pull request review event: 18
- Pull request event: 38
- Fork event: 1
Committers
Last synced: 5 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Adrian Höhl | 8****l@u****m | 19 |
| Adrian Höhl | a****l@t****e | 10 |
| Paul Höhn | p****n@d****e | 7 |
| Paul Höhn | 6****7@u****m | 3 |
Issues and Pull Requests
Last synced: 5 months ago
All Time
- Total issues: 13
- Total pull requests: 21
- Average time to close issues: 5 days
- Average time to close pull requests: 2 days
- Total issue authors: 3
- Total pull request authors: 3
- Average comments per issue: 0.69
- Average comments per pull request: 0.05
- Merged pull requests: 17
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 13
- Pull requests: 20
- Average time to close issues: 5 days
- Average time to close pull requests: 2 days
- Issue authors: 3
- Pull request authors: 3
- Average comments per issue: 0.69
- Average comments per pull request: 0.05
- Merged pull requests: 16
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- AtmaMani (8)
- drnhhl (3)
- usethedata (2)
Pull Request Authors
- drnhhl (17)
- PaulH97 (3)
- jatkinson1000 (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 136 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 7
- Total maintainers: 1
pypi.org: terragon-downloader
Create EO Minicubes from Polygons and simplify EO Data downloading.
- Homepage: https://github.com/drnhhl/terragon
- Documentation: https://readthedocs.org
- License: MIT License Copyright (c) 2024 Adrian Höhl 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: 0.3.0
published 5 months ago