kitware/danesfield-app

Web application for the Danesfield System

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

danesfield-app's Issues

Workflow for Multiple Images

If I have multiple satellite images of a region, what is the general workflow for combining them using the Danesfield-App?

I have the app up and running, however there is no data or workflows shown. Judging from the readme, there must be a way to

1. upload the models from here, then
2. upload a set of images, and
3. run a job workflow.

Is that the correct workflow? If so, how do you upload models and images?

can i use the usgs earth explorer as the satellite images source for 3d reconstruction ? and thanks

README demo video

how to test the effect?

I send the test_data 'D1_mls_building.txt' to collections, and comfirn the 'Start a pipeline ' ,and then waited too long with no result! so,how to test the effect? or What are the test data format requirements?

Get original workflow working in G4

Add support for Cesium viewer

docker build failed, cannot pull p3d?

(girder_env) :~/workspace/3d_reconstruction/Danesfield-App/support/docker/p3d_gw$ sudo docker build -t gitlab.kitware.com:4567/core3d/danesfield-app/p3d_gw .
Step 1/3 : FROM p3d
pull access denied for p3d, repository does not exist or may require 'docker login'

Does it work on trees and park areas?

I just came across this method and wondered if it only works on building or also other structures like trees, bushes, park areas, etc.

Get imageless workflow working in G3 Dansfield