Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Sentinel Hub's cloud detector for Sentinel-2 imagery

Project description

Package version Supported Python versions Build status Overall downloads Last month downloads

Sentinel Hub's cloud detector for Sentinel-2 imagery

The s2cloudless Python package provides automated cloud detection in Sentinel-2 imagery. The classification is based on a single-scene pixel-based cloud detector developed by Sentinel Hub's research team and is described in more details in this blog.

Installation

The package requires a Python version >= 3.5. The package is available on the PyPI package manager and can be installed with

$ pip install s2cloudless

To install the package manually, clone the repository and

$ python setup.py build
$ python setup.py install

One of s2cloudless dependecies is lightgbm package. If having problems during installation please check LightGBM installation guide.

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

Input: Sentinel-2 scenes

The input to cloud detector are Sentinel-2 images. In particular, the cloud detector requires the following 10 Sentinel-2 band reflectances: B01, B02, B04, B05, B08, B8A, B09, B10, B11, B12, which are obtained from raw reflectance value in the following way: B_i/10000.

You don't need to worry about any of this, if you're doing classification of scenes obtained using Sentinel Hub's WMS or WCS services (i.e. using ours Python library sentinelhub-py).

Examples

Jupyter notebook on how to use the cloud detector to produce cloud mask or cloud probability map can be found in the examples folder.

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for s2cloudless, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size s2cloudless-1.3.0.tar.gz (6.2 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page