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