Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 

What is BRAILS

BRAILS (Building Recognition using AI at Large-Scale) provides a set of Python modules that utilize deep learning (DL), and computer vision (CV) techniques to extract information from satellite and street level images. The BRAILS framework will also provide turn-key applications that allow the users to put the individual modules together to determine multiple attributes in a single pass.

Documentation

Online documentation is available at https://nheri-simcenter.github.io/BRAILS-Documentation.

Acknowledgements

This work is based on material supported by the National Science Foundation under grants CMMI 1612843 and CMMI 2131111.

Contact

NHERI-SimCenter nheri-simcenter@berkeley.edu

Quickstart

Installation

The easiest way to install the latest version of BRAILS is using pip:

pip install git+https://github.com/NHERI-SimCenter/BRAILS

Example: InventoryGenerator Workflow

This example demonstrates how to use the InventoryGenerator method embedded in BRAILS to generate regional-level inventories.

The primary input to InventoryGenerator is location. InventoryGenerator accepts four different location input: 1) region name, 2) list of region names, 3) bounding box of a region, 4) A GeoJSON file containing building footprints.

Please note that you will need a Google API Key to run InventoryGenerator.

#import InventoryGenerator:
from brails.InventoryGenerator import InventoryGenerator

# Initialize InventoryGenerator:
invGenerator = InventoryGenerator(location='Berkeley, CA',
                                  nbldgs=100, randomSelection=True,
                                  GoogleAPIKey="")

# Run InventoryGenerator to generate an inventory for the entered location:
# To run InventoryGenerator for all enabled attributes set attributes='all':
invGenerator.generate(attributes=['numstories','roofshape','buildingheight'])

# View generated inventory:
invGenerator.inventory

How to cite

@misc{brails,
  title={NHERI-SimCenter/BRAILS: Release v2.0.0},
  journal={Zenodo}, 
  author={Wang, Charles and Hornauer, Sascha and Cetiner, Barbaros and Guo, Yunhui and McKenna, Frank and Yu, Qian and Yu, Stella X. and Taciroglu, Ertugrul and Law, Kincho H.,
  year={2021}, 
  month={Mar},
  url={https://zenodo.org/record/4570554}  
  doi="10.5281/zenodo.4570554"
}