Sign inSign up

noerw/sentinel_fire

By noerw

•Updated over 7 years ago

process Sentinel 2 data in R: sen2r with Sen2Cor and sf in docker

Image
0

10K+

noerw/sentinel_fire repository overview

⁠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

argumentshortvaluedefaultdescription
--help-h--show brief help
--aoi-ageojson json file-area of interest as geojson polygon geometry. Required.
--algorithm-dnbr|bais2dnbr and bais2select single algorithm. If not specified, dnbr AND bais2 will be run.
--start-sYYYYMMDD|NOW-XDAYSNOWstart date
--end-eYYYYMMDD|NOW-XDAYSNOW-5DAYSend date
--outdir-odirectory./path to output directory
--cloudcoverage-cNumber20maximum 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/.

namedescription
Scripts
s2_pipelineMain entrypoint for Sentinel_fire. Starts the whole pipeline.
s2_queryPrepares the download. Searches matching tiles and skips download for already downloaded files.
s2_downloadDownloads satellite imagery from Copernicus Apihub.
s2_preprocessPreprocesses the images using sen2cor.
s2_grouporbitGroups orbits by date. Needed in case the aoi is located at the dateline.
s2_clipStitches all images of a group and clips them to the aoi.
s2_changedetectionHandles the options of the different change detection algorithms and calls them.
s2_visualizeCreates html files displaying the computed images.
Change Detection
dNBRComputes the difference normalized burn ratio of two images.
BAIS2Computes the BAIS2 of a single image.
waterDetectionRemoves 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

Tag summary

Content type

Image

Digest

Size

670.5 MB

Last updated

over 7 years ago

docker pull noerw/sentinel_fire