{"id":13735989,"url":"https://github.com/dlr-eoc/ukis-pysat","last_synced_at":"2025-04-10T18:54:03.454Z","repository":{"id":43293168,"uuid":"259635994","full_name":"dlr-eoc/ukis-pysat","owner":"dlr-eoc","description":"The ukis-pysat package provides generic classes and functions to query, access and process multi-spectral and SAR satellite images","archived":false,"fork":false,"pushed_at":"2023-06-06T05:53:00.000Z","size":1054,"stargazers_count":28,"open_issues_count":0,"forks_count":8,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-24T16:41:32.440Z","etag":null,"topics":["gis","satellite-data","stac","ukis"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dlr-eoc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-04-28T12:51:59.000Z","updated_at":"2025-03-06T19:37:02.000Z","dependencies_parsed_at":"2023-02-16T05:16:04.712Z","dependency_job_id":"477a9550-f58f-4b81-ab69-032f2c3ac9e9","html_url":"https://github.com/dlr-eoc/ukis-pysat","commit_stats":{"total_commits":212,"total_committers":11,"mean_commits":"19.272727272727273","dds":0.6415094339622642,"last_synced_commit":"b4534f43527c11b62891021062a5937866e78da9"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlr-eoc%2Fukis-pysat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlr-eoc%2Fukis-pysat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlr-eoc%2Fukis-pysat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlr-eoc%2Fukis-pysat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dlr-eoc","download_url":"https://codeload.github.com/dlr-eoc/ukis-pysat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248275365,"owners_count":21076581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gis","satellite-data","stac","ukis"],"created_at":"2024-08-03T03:01:13.854Z","updated_at":"2025-04-10T18:54:03.432Z","avatar_url":"https://github.com/dlr-eoc.png","language":"Python","funding_links":[],"categories":["`Python` processing of optical imagery (non deep learning)"],"sub_categories":["Python libraries related to EO"],"readme":"[![UKIS](https://raw.githubusercontent.com/dlr-eoc/ukis-pysat/master/docs/ukis-logo.png)](https://www.dlr.de/eoc/en/desktopdefault.aspx/tabid-5413/10560_read-21914/) UKIS-pysat\n==============\n\n![ukis-pysat](https://github.com/dlr-eoc/ukis-pysat/workflows/ukis-pysat/badge.svg)\n[![codecov](https://codecov.io/gh/dlr-eoc/ukis-pysat/branch/main/graph/badge.svg)](https://codecov.io/gh/dlr-eoc/ukis-pysat)\n![Upload Python Package](https://github.com/dlr-eoc/ukis-pysat/workflows/Upload%20Python%20Package/badge.svg)\n[![PyPI version](https://img.shields.io/pypi/v/ukis-pysat)](https://pypi.python.org/pypi/ukis-pysat/)\n[![Documentation Status](https://readthedocs.org/projects/ukis-pysat/badge/?version=latest)](https://ukis-pysat.readthedocs.io/en/latest/?badge=latest)\n[![GitHub license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE.txt)\n[![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://black.readthedocs.io/en/stable/)\n[![DOI](https://zenodo.org/badge/259635994.svg)](https://zenodo.org/badge/latestdoi/259635994)\n\n\nThe UKIS-pysat package provides generic classes and functions to access and process multi-spectral and SAR satellite images.\n\n\n### file\nWork with you local satellite data files and read information out of file names and metadata files. Currently, focusing on Sentinel-1.\n\n\n### raster\nReading satellite data and performing simple, but cumbersome tasks. This is just a layer on top of [rasterio](https://github.com/mapbox/rasterio) for stuff we often need. It can very well be that using *rasterio* directly is often the better choice.\n\n\nRead the documentation for more details: [https://ukis-pysat.readthedocs.io](https://ukis-pysat.readthedocs.io/en/latest/).\n\n## Example\nHere's an example about some basic features, it might also help to read through the [tests](https://github.com/dlr-eoc/ukis-pysat/blob/master/tests).\n###Sentinel Dataset\n\n```python\n# import all the required libraries\nfrom ukis_pysat.file import get_sentinel_scene_from_dir\nfrom ukis_pysat.raster import Image\n\n\n# get sentinel scene from directory\nwith get_sentinel_scene_from_dir(\"/users/username/tmp\") as (full_path, ident):\n    with Image(full_path.join(\"pre_nrcs.tif\")) as img:\n        # scale the image array, having one band\n        img.arr = img.arr * 0.3\n```\nFor working with the Landsat we need an item id for downloading the product\nCheck [Pystac](https://pystac.readthedocs.io/en/1.0/) documentation for more functionality on [STAC](https://stacspec.org/).\n\n\n## Installation\nThe easiest way to install `ukis-pysat` is through pip. Be aware, that Rasterio requires GDAL \u003e= 1.11, \u003c 3.1.\n\nMost users will want to do this:\n```shell\npip install ukis-pysat[complete]  # install everything\n```\n\nThere's also some lighter versions with less dependencies:\n\n```shell\npip install ukis-pysat  # only install core dependencies (ukis_pysat.file can be used)\n\npip install ukis-pysat[data]  # also install dependencies for ukis_pysat.data\n\npip install ukis-pysat[raster]  # also install dependencies for ukis_pysat.raster\n```\n\nSome helper functions might need additional dependencies like `pandas`, `dask[array]` or `utm`. If this is the case you will receive an `ImportError`.\n\n\n### Dependencies\nFor the latest list of dependencies check the [requirements](https://github.com/dlr-eoc/ukis-pysat/blob/master/requirements.txt).\n\n\n## Contributors\nThe UKIS team creates and adapts libraries which simplify the usage of satellite data. Our team includes (in alphabetical order):\n* Boehnke, Christian\n* Fichtner, Florian\n* Mandery, Nico\n* Martinis, Sandro\n* Riedlinger, Torsten\n* Wieland, Marc\n\nGerman Aerospace Center (DLR)\n\n## Licenses\nThis software is licensed under the [Apache 2.0 License](https://github.com/dlr-eoc/ukis-pysat/blob/master/LICENSE.txt).\n\nCopyright (c) 2020 German Aerospace Center (DLR) * German Remote Sensing Data Center * Department: Geo-Risks and Civil Security\n\n## Changelog\nSee [changelog](https://github.com/dlr-eoc/ukis-pysat/blob/master/CHANGELOG.rst).\n\n## Contributing\nThe UKIS team welcomes contributions from the community.\nFor more detailed information, see our guide on [contributing](https://github.com/dlr-eoc/ukis-pysat/blob/master/CONTRIBUTING.md) if you're interested in getting involved.\n\n## What is UKIS?\nThe DLR project Environmental and Crisis Information System (the German abbreviation is UKIS, standing for [Umwelt- und Kriseninformationssysteme](https://www.dlr.de/eoc/en/desktopdefault.aspx/tabid-5413/10560_read-21914/) aims at harmonizing the development of information systems at the German Remote Sensing Data Center (DFD) and setting up a framework of modularized and generalized software components.\n\nUKIS is intended to ease and standardize the process of setting up specific information systems and thus bridging the gap from EO product generation and information fusion to the delivery of products and information to end users.\n\nFurthermore, the intention is to save and broaden know-how that was and is invested and earned in the development of information systems and components in several ongoing and future DFD projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdlr-eoc%2Fukis-pysat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdlr-eoc%2Fukis-pysat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdlr-eoc%2Fukis-pysat/lists"}