A Free and Open-source Automated Building Exterior Crack Inspection Software for Construction and Facility Managers. It works across all platforms (Windows, MacOS and Linux).
This tool has been developed at S.M.A.R.T. Construction Research Group at New York University Abu Dhabi, as an extension to our previous conference paper published at DOI:10.22260/ISARC2021/0086
Find our current paper at
Ko, P., Prieto, S.A., & Garcia de Soto, B. (2022). Developing a Free and Open-source Automated Building Exterior Crack Inspection Software for Construction and Facility Managers. arXiv preprint arXiv:2206.09742.
Before starting, have the sudo access using
sudo -s
For everything below, if 'python3' does not work, replace 'python3' with 'python'
- Download Git if you do not have it. And clone this repository using
git clone 'https://github.com/Pi-31415/ABECIS'
and change working directory with
cd ABECIS
-
Download Python 3 at Python Website, and install.
-
Then, upgrade pip using
python3 -m pip install --upgrade pip
- Install torch using
pip3 install torch torchvision torchaudio
- Install detectron2, the instance segmentation framework used by ABECIS
git clone https://github.com/facebookresearch/detectron2.git
python3 -m pip install -e detectron2
You might also need C++ Build Tools on Windows, get it here
If there is any issue with pycocotools, get C++ build tools first, then install with
pip install "git+https://github.com/philferriere/cocoapi.git#egg=pycocotools&subdirectory=PythonAPI"
- Run the python script named setup.py using the following command, to set up the dependencies.
python3 ./setup.py
[IMPORTANT] Don't forget to rerun setup.py to install dependencies afterwards.
- If everything ran smoothly, run ABECIS by
python3 ./abecis.py
Note: When running for the first time, it will automatically download the pre-trained model, and will take some time.
Example data of wall cracks taken in lab using DJI Matrice 300 RTK drone is available here
Please follow the steps on the application precisely, and it should be intuitive. A detailed user guide video and documentation is coming soon.
Please contact pk2269@nyu.edu for any issues regarding this software.