An open API service indexing awesome lists of open source software.

https://github.com/tibroc/floodfill

This is an implementation of the floodfill algorithm for fire event detection as described in Archibald & Roy 2009. For docs see:
https://github.com/tibroc/floodfill

fire-detection fire-ecology floodfill remote-sensing

Last synced: 3 months ago
JSON representation

This is an implementation of the floodfill algorithm for fire event detection as described in Archibald & Roy 2009. For docs see:

Awesome Lists containing this project

README

        

floodfill
=========

.. image:: https://travis-ci.com/tibroc/floodfill.svg?branch=master
:target: https://travis-ci.com/tibroc/floodfill
.. image:: https://coveralls.io/repos/github/tibroc/floodfill/badge.svg?branch=master
:target: https://coveralls.io/github/tibroc/floodfill?branch=master

This is an implementation of the floodfill algorithm for fire event detection as described in:

| Archibald, Sally & Roy, David. (2009).
| Identifying individual fires from satellite-derived burned area data.
| III-160 . 10.1109/IGARSS.2009.5417974.

Installation
------------

To install this python package you need to download the repository,
navigate to the root folder of it and install it using the ``setup.py``:

.. code-block:: bash

python setup.py install

Usage
-----

The program can be executed as a python module:

.. code-block:: bash

python -m floodfill -h

The program provides some command line parameters that let you define its behavior.
The ``-h`` flag will give you an overview over the options and how to use it.

A simple test run can be done like this:

.. code-block:: bash

mkdir output
python -m floodfill --input=tests/test_data.tif --output-folder=output -b

Parallelization
~~~~~~~~~~~~~~~

If you have several files to process (in recursive mode), you can parallelize
processing by setting ``--n-workers`` to a value that suits your number of cores
(if you specify a higher number of workers than you have cores, the program will
automatically take the maximum number of cores available).

.. code-block:: bash

mkdir output
python -m floodfill --input=tests/test_data.tif\
--output-folder=output\
--n-workers=4