Metadata-Version: 2.4
Name: brails
Version: 4.1.3
Summary: BRAILS++: Building Regional Asset Inventories for Large Scale Simulation
Author: NHERI SimCenter
Author-email: NHERI SimCenter <nheri-simcenter@berkeley.edu>
License: BSD-3-Clause
Platform: any
Classifier: Programming Language :: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Natural Language :: English
Classifier: Environment :: Console
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
License-File: LICENSE.txt
Requires-Dist: addict
Requires-Dist: Cython
Requires-Dist: ftfy
Requires-Dist: matplotlib
Requires-Dist: opencv-python
Requires-Dist: pandas
Requires-Dist: pillow
Requires-Dist: plotly
Requires-Dist: pycocotools
Requires-Dist: pyarrow
Requires-Dist: rasterio
Requires-Dist: reverse-geocode
Requires-Dist: requests
Requires-Dist: scikit-learn
Requires-Dist: seaborn
Requires-Dist: shapely
Requires-Dist: supervision
Requires-Dist: timm
Requires-Dist: tensorboard
Requires-Dist: tensorboardX
Requires-Dist: torch<=2.5.0
Requires-Dist: torchvision<=0.20.0
Requires-Dist: transformers
Requires-Dist: wget
Requires-Dist: yacs
Requires-Dist: webcolors
Requires-Dist: yapf
Provides-Extra: development
Requires-Dist: flake8; extra == "development"
Requires-Dist: pylint; extra == "development"
Requires-Dist: black; extra == "development"
Requires-Dist: pytest; extra == "development"
Requires-Dist: pytest-cov; extra == "development"
Requires-Dist: jupyter; extra == "development"
Requires-Dist: jupytext; extra == "development"
Requires-Dist: sphinx; extra == "development"
Requires-Dist: sphinx-autoapi; extra == "development"
Requires-Dist: nbsphinx; extra == "development"
Requires-Dist: flake8-rst; extra == "development"
Requires-Dist: flake8-rst-docstrings; extra == "development"
Dynamic: author
Dynamic: description
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist

<h1 style="text-align: center;">BRAILS++: Building Regional Asset Inventories for Large Scale Simulation</h1>

[![Tests](https://github.com/NHERI-SimCenter/BrailsPlusPlus/actions/workflows/tests.yml/badge.svg)](https://github.com/NHERI-SimCenter/BrailsPlusPlus/actions/workflows/tests.yml/badge.svg)
[![DOI](https://zenodo.org/badge/184673734.svg)](https://zenodo.org/badge/latestdoi/184673734)
[![PyPi version](https://badgen.net/pypi/v/BRAILS/)](https://pypi.org/project/BRAILS/)
[![PyPI download month](https://img.shields.io/pypi/dm/BRAILS.svg)](https://pypi.python.org/pypi/BRAILS/)

## What is it?

```BRAILS++``` is an object-oriented framework for building applications that focus on generating asset inventories for large geographic regions.

## How is the repo laid out?

+ ```brails```: A directory containing the classes
  - ```brails/types```: directory containing useful datatypes, e.g., ```ImageSet``` and ```AssetInventory```
  - ```brails/processors```: directory containing classes that do ```image_processing``` to make predictions, e.g. RoofShape
  - ```brails/scrapers```: directory containing classes that do internet downloads, e.g., footprint and image scrapers.
  - ```brails/filters```: directory containing image filters, e.g., classes that take images and revise or filter out unnecessary portions of images.
  - ```brails/imputers```: directory containing classes that fill in missing ```AssetInventory``` datasets, i.e., filling in features that are missing in certain Assets of the AssetInventory.
  - ```brails/inferers```: directory containing classes that infer new asset features based on existing features in the Assets of ```AssetInventory```.
  - ```brails/utils```: directory containing misc classes that do useful things, e.g. geometric conversions
+ ```examples```: A directory containing example scripts and Jupyter notebooks
+ ```tests```: A directory containing unit tests. The directory structure follows that of ```brails```

## Quick Links

- [Documentation & Guides](https://nheri-simcenter.github.io/BrailsPlusPlus/)

## Installation instructions

```shell
pip install brails
```

## Acknowledgments

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

## Contributors

Want to see who made this possible? Check out the full list of contributors [here](./contributors.md).

## Contact

NHERI-SimCenter nheri-simcenter@berkeley.edu

<!-- todo: instructions on how to lint the code, and specific subfolder or file. -->
<!-- todo: example with the test suite. -->
<!-- todo: instructions on how to run the tests -->
<!-- todo: instructions on how to check coverage -->
<!-- python -m pytest tests --cov=brails --cov-report html -->
