Skip to content


Repository files navigation

LNEx Logo


A pipeline for disaster relief, coordination and response.

Installation of packages and libraries

Clone DisasterRecord:

git clone

Install the requirements in requirements.txt:

pip install -r requirements.txt

Clone the Location Name Extractor (LNEx) to extract and geolocate location names (in function of DisasterRecord):

git clone

Follow the README of LNEx to have photon setup and working.

DisasterRecord use our in-house research developed to detect flooded images. The tool call the RESTful API end (in

We then detect objects (Vehicles, Animals, and People) in the images of flooded areas (in You should also clone the image objet detenction module with the following command:

git clone

Deploy the code

The IP and Port currently used in and are:

{'host': '', 'port': 31169}

These need to be changed manually in and with the exposed IP and port.

Then run the file :


Then run the file :


Now the tool should be working on
Note for Stream processing

DisasterRecord is capable of stream processing and is designed for that purpose. However, since we are demonstrting the tool for the purpose of this competition, we use pre-disaster data. In order to process streams you should make minor modifcations to read from the streaming API instead of reading from the JSON file we have in the Object Storage.

Working of the tool


    └── DisasterRecord
        ├── Aggregate Level  
        │   ├── Need classification
        │   │   └── need    : rescue
        │   │   └── need    : shelter
        │   ├── Object detection from flooded images
        │   │   └── object    : animals
        │   │   └── object    : people
        │   │   └── object    : vehicles
        │   ├── Available help location from OpenStreetMap
        │   │   └── osm    : rescue
        │   │   └── osm    : shelter
        │   └── Word cloud concepts
        └── Individual Level 
            ├── Need markers
            │   └── need    : rescue
            │   └── need    : shelter
            ├── Available Location markers
            │   └── Available    : rescue
            │   └── Available    : shelter
            └── Flood Mapping

The data in Object Storage is private data and have been used solely for the demonstration of this tool. We do not intend to distribute the data publicly. Kindly request us permission if you intend to use the data beyond this event.