Skip to content

3dgeo-heidelberg/AImon

Repository files navigation

AImon5.0

📖 About

The 3DGeo Research Group focuses on advancing geohazard monitoring through the use of 4D geospatial data. With global climate change accelerating environmental risks like landslides and rockfalls, our work leverages autonomous laser scanning (PLS) systems to capture real-time 3D data, enabling proactive risk management. We develop AI-driven methods for continuous hazard monitoring, bridging the gap between research and practical, application-oriented solutions. Our goal is to refine and extend multi-temporal analysis techniques to enhance hazard detection and mitigate the impact on communities and infrastructure. The study site is located in Trier, Germany.

Online documentation

Thorough online documentation on the research project, study site, developed methods, and publications can be found here. Feel free to use the notebook implementation examples as a starting point, and remember to cite this repository.

💻 Installation with a Conda environment

To avoid negative interactions between installed packages and version conflicts, a conda environment should be created for each new project. Follow the three next steps:

  1. Create a new environment and activate it.
conda create --name aimon python=3.11 -y
conda activate aimon
  1. Clone this repository and navigate to the main folder aimon
git clone https://github.com/3dgeo-heidelberg/aimon.git
cd aimon
  1. Install the release version using pip

    1. Regular installation
    python -m pip install .
    
    1. Editable mode
    python -m pip install -v --editable .
    

Usage from the main repository folder:

Bi-temporal:

python src/aimon/main.py -c "<path/to/config_file.json>" -f "<path/to/t_1.las>" "<path/to/t_2.las>"

Multi-temporal:

python src/aimon/main.py -c "<path/to/config_file.json>" -f "<path/to/t_1.las>" "<path/to/t_2.las>" "<path/to/t_3.las>" ... "<path/to/t_n-1.las>" "<path/to/t_n.las>"

📜 License

License: MIT
This is licensed under the MIT license.

📧 Contact

William Albert, albert@uni-heidelberg.de
Ronald Tabernig, ronald.tabernig@uni-heidelberg.de
3DGeo Research Group, Institute of Geography, Heidelberg University