norwin/sentinel2_pipeline
1
0
Fork 0
mirror of https://github.com/noerw/sentinel_fire synced 2025-03-12 18:00:28 +01:00
Code Issues Releases Wiki Activity
Processing Sentinel 2 imagery for fire detection
100 commits 11 branches 0 tags 702 KiB
Python 45.7%
Shell 35.2%
R 16.7%
Dockerfile 2.4%
Find a file
Exact
Norwin Roosen 6e054b3d67 improve visualization
2019-01-31 20:42:25 +01:00
aoi shrink myanmar2 aoi 2019-01-30 14:14:12 +01:00
bin fixes 2019-01-31 20:42:25 +01:00
changeDetection fixes 2019-01-31 20:42:25 +01:00
data repo setup 2018-11-15 23:19:15 +01:00
visualization improve visualization 2019-01-31 20:42:25 +01:00
.dockerignore avoid installation of sen2r 2018-11-20 15:58:57 +01:00
.gitignore add smaller myanmar aoi 2018-12-14 14:20:41 +01:00
crontab add monitoring dockerfile #14 2018-12-14 14:41:21 +01:00
docker-compose.yml more pipeline fixes 2019-01-25 12:29:14 +01:00
Dockerfile file check and small fixes 2019-01-28 16:54:29 +01:00
Dockerfile.monitoring add monitoring dockerfile #14 2018-12-14 14:41:21 +01:00
README.md update README and comments 2019-01-29 18:38:15 +01:00
requirements.txt avoid installation of sen2r 2018-11-20 15:58:57 +01:00

README.md

Sentinel_fire 💣🔥🛰

Burned area detection on Sentinel 2 imagery for monitoring of conflict areas.

This project was developed in the scope of the study project "Monitoring Conflict Areas with Satellite Image Time Series" winter term 2018, at ifgi as the concluding assignment.

how to run it

This application is best started via docker / docker-compose. If you want to run it natively instead, please follow the installation steps outlined in the Dockerfile.

To install the application, run:

docker-compose build s2

Then, to start processing, run:

docker-compose run s2 bin/s2_pipeline <arguments>

Try --help for an overview of available options.

Options/Arguments

argument short value default description
--help -h - - show brief help
--aoi -a geojson json file - area of interest as geojson polygon geometry. Required.
--algorithm - dnbr|bais2 dnbr and bais2 select single algorithm. If not specified, dnbr AND bais2 will be run.
--start -s YYYYMMDD|NOW-XDAYS NOW start date
--end -e YYYYMMDD|NOW-XDAYS NOW-5DAYS end date
--outdir -o directory ./ path to output directory
--cloudcoverage -c Number 20 maximum percentage of allowed cloud coverage.
--cleanup - - - remove intermediate results after processing, if flag is set

Scripts

All scripts are available under ./bin/ and will be called in order of appearance in table below. Change detection algorithms are located under ./changeDetection/.

name description
Scripts
s2_pipeline Main entrypoint for Sentinel_fire. Starts the whole pipeline.
s2_query Prepares the download. Searches matching tiles and skips download for already downloaded files.
s2_download Downloads satellite imagery from Copernicus Apihub.
s2_preprocess Preprocesses the images using sen2cor.
s2_grouporbit Groups orbits by date. Needed in case the aoi is located at the dateline.
s2_clip Stitches all images of a group and clips them to the aoi.
s2_changedetection Handles the options of the different change detection algorithms and calls them.
s2_visualize Creates html files displaying the computed images.
Change Detection
dNBR Computes the difference normalized burn ratio of two images.
BAIS2 Computes the BAIS2 of a single image.
waterDetection Removes water bodies from an image.

Development

Adding changeDetection scripts

  1. Add script file to ./changeDetection
  2. Add script options to s2_changeDetection

Adding scripts to the pipeline

  1. Add script file to ./bin (make sure to specify path to executable in first line)
  2. Add script options to s2_pipeline at according processing step.

Contact Us

For any queries, difficulties in installation and/or usage please contact one of the team.

License

GPL-3.0