generic classes and functions to query, access and process multi-spectral and SAR satellite images
Project description
UKIS-pysat
The UKIS-pysat package provides generic classes and functions to query, access and process multi-spectral and SAR satellite images.
data
Download satellites data from different sources (currently Earth Explorer, SciHub, STAC), deal with and structure metadata.
file
Work with you local satellite data files and read information out of file names and metadata files. Currently, focusing on Sentinel-1.
raster
Reading satellite data and performing simple, but cumbersome tasks. This is just a layer on top of rasterio for stuff we often need. It can very well be that using rasterio directly is often the better choice.
Read the documentation for more details: https://ukis-pysat.readthedocs.io.
Example
Here's an example about some basic features, it might also help to read through the tests.
from ukis_pysat.data import Source
from ukis_pysat.file import get_sentinel_scene_from_dir
from ukis_pysat.members import Datahub, Platform
from ukis_pysat.raster import Image
# connect to Scihub and query metadata (returns MetadataCollection)
src = Source(Datahub.Scihub)
meta = src.query_metadata(
platform=Platform.Sentinel2,
date=("20200101", "NOW"),
aoi=(11.90, 51.46, 11.94, 51.50),
cloud_cover=(0, 50),
)
# inspect MetadataCollection with Pandas
meta_df = meta.to_pandas()
print(meta_df[["srcid", "producttype", "cloudcoverpercentage", "size", "srcuuid"]])
# filter MetadataCollection by producttype
meta.filter(filter_dict={"producttype": "S2MSI1C"})
# save Metadata items as GeoJSON
meta.save(target_dir="target_dir/")
# get product_uuid of first metadata item
uuid = meta.items[0].to_dict()["srcuuid"]
# download geocoded quicklook and image
src.download_quicklook(platform=Platform.Sentinel2, product_uuid=uuid, target_dir="target_dir/")
src.download_image(platform=Platform.Sentinel2, product_uuid=uuid, target_dir="target_dir/")
# get sentinel scene from directory
with get_sentinel_scene_from_dir(target_dir) as (full_path, ident):
with Image(full_path.join('pre_nrcs.tif')) as img:
# scale the image array, having one band
img.arr = img.arr * 0.3
Environment variables to configure Datahub credentials
To use ukis_pysat.data
and to download from the respective Datahub you need to set the credentials as environment variables.
For EarthExplorer that's:
EARTHEXPLORER_USER=your_username
EARTHEXPLORER_PW=your_password
For SciHub that's:
SCIHUB_USER=your_username
SCIHUB_PW=your_password
Installation
The easiest way to install pysat
is through pip. Be aware, that Rasterio requires GDAL >= 1.11, < 3.1.
Most users will want to do this:
pip install ukis-pysat[complete] # install everything
There's also some lighter versions with less dependencies:
pip install ukis-pysat # only install core dependencies (ukis_pysat.file can be used)
pip install ukis-pysat[data] # also install dependencies for ukis_pysat.data
pip install ukis-pysat[raster] # also install dependencies for ukis_pysat.raster
Some helper functions might need additional dependencies like pandas
, dask[array]
or utm
. If this is the case you will receive an ImportError
.
Dependencies
For the latest list of dependencies check the requirements.
Contributors
The UKIS team creates and adapts libraries which simplify the usage of satellite data. Our team includes (in alphabetical order):
- Boehnke, Christian
- Fichtner, Florian
- Mandery, Nico
- Martinis, Sandro
- Riedlinger, Torsten
- Wieland, Marc
German Aerospace Center (DLR)
Licenses
This software is licensed under the Apache 2.0 License.
Copyright (c) 2020 German Aerospace Center (DLR) * German Remote Sensing Data Center * Department: Geo-Risks and Civil Security
Changelog
See changelog.
Contributing
The UKIS team welcomes contributions from the community. For more detailed information, see our guide on contributing if you're interested in getting involved.
What is UKIS?
The DLR project Environmental and Crisis Information System (the German abbreviation is UKIS, standing for Umwelt- und Kriseninformationssysteme 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.
UKIS 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.
Furthermore 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ukis_pysat-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7304a42bf3917580257040b2c4db2540e9d656b6033afd3f0f27959ff7b22e6 |
|
MD5 | e24847b4de3494fc4885ddd024ffdcc1 |
|
BLAKE2b-256 | 1c1b267b711d6817e02d4ce79a35d52ac92a35a6166b5079f48889589216bb83 |