Deprecation Notice

The Danesfield-App web application has been superseded by https://github.com/girder/Danesfield. This repo is deprecated, see the original README below.

Danesfield App

The Danesfield App is a web application for running the Danesfield algorithms and visualizing results. Danesfield addresses the algorithmic challenges of the IARPA CORE3D program by reconstructing semantically meaningful 3D models of buildings and other man-made structures from satellite imagery.

Video demo

Screenshots

Server

Requirements

• Conda
• Docker (docker-compose also recommended)

Setup

1. Run conda/install.sh. This will create and active a new conda environment, as well as install the required packages.
2. Pull the publicly available Danesfield image on Docker Hub
3. Run pip install -e server to install girder and it's
4. (Optional) To setup girder with some default settings, you can run python server/init_girder.py. A default admin user and password are included in that script. If you would like to configure this, you can export the GIRDER_ADMIN_USER and GIRDER_ADMIN_PASS environment varibales before running the above command.

Running dependent services/applicatons

Girder requires that MongoDB and RabbitMQ are running. If you've installed docker-compose, this can be done easily:

docker-compose up -d

You can stop these services by running docker-compose stop, and remove all associated data by runnning docker-compose down.

Running the application/services

Run the following commands separately on the machine you wish to host the application on (within the conda environment):

1. girder serve --host 0.0.0.0
2. python -m girder_worker -l info --concurrency 4

Girder should now be running.

Configuration

Models used:

1. UNet Semantic Segmentation
2. Building Segmentation
3. Material Classification
4. Roof Geon Extraction
5. Run Metrics

Upload all models to the models folder within the core3d collection, creating it if it doesn't exist.

Client Setup

See here