SHINE_mapping
π SHINE-Mapping: Large-Scale 3D Mapping Using Sparse Hierarchical Implicit Neural Representations (ICRA 2023)
νμΌ νμκΈ°
μ΅μ’ λ²μ λ€μ΄λ‘λ (.zip)- maicity_batch.yaml
- ncd_batch.yaml
- docker_kitti_batch.yaml
- kitti_batch.yaml
- kitti_incre_reg.yaml
- kitti_incre_replay.yaml
- maicity_batch.yaml
- maicity_incre_reg.yaml
- maicity_incre_replay.yaml
- ncd_batch.yaml
- ncd_incre_reg.yaml
- ncd_incre_replay.yaml
- rgbd_batch.yaml
- rgbd_incre_reg.yaml
- rgbd_incre_replay.yaml
- lidar_dataset.py
- rgbd_to_kitti_format.py
- crop_intersection.py
- eval_utils.py
- evaluator.py
- __init__.py
- decoder.py
- feature_octree.py
- geo_decoder_8dim.pth
- convert_rgbd_to_kitti_format.sh
- download_kitti_example.sh
- download_maicity.sh
- download_ncd_example.sh
- download_neural_rgbd_data.sh
- __init__.py
- config.py
- data_sampler.py
- incre_learning.py
- loss.py
- mesher.py
- pose.py
- semantic_kitti_utils.py
- tools.py
- visualizer.py
- .gitignore
- Dockerfile
- LICENSE.txt
- README.md
- shine_batch.py
- shine_incre.py
# μ€μΉ κ°μ΄λ
git clone https://github.com/PRBonn/SHINE_mapping
κΉνλΈμμ νλ‘μ νΈ μ½λ μ 체λ₯Ό λ΄ μ»΄ν¨ν°λ‘ λ΄λ €λ°μ΅λλ€.
cd SHINE_mapping
λ°©κΈ λ΄λ €λ°μ νλ‘μ νΈ ν΄λ μμΌλ‘ μ΄λν©λλ€.
2. 곡μ μ€μΉ μ€ν¬λ¦½νΈ
μ¬μ μΆμ²- Python 3 pip λͺ λ Ήμ΄λ₯Ό μ°λ €λ©΄ Pythonμ΄ νμν©λλ€.
pip install torch==1.12.1+cu116 torchvision==0.13.1+cu116 torchaudio==0.12.1 --extra-index-url https://download.pytorch.org/whl/cu116
PyPIμ λ°°ν¬λ ν¨ν€μ§λ₯Ό λ°λ‘ μ€μΉν©λλ€. μμ€ ν΄λ‘ μ΄ νμ μμ΅λλ€.
pip install kaolin==0.12.0 -f https://nvidia-kaolin.s3.us-east-2.amazonaws.com/torch-1.12.1_cu116.html
PyPIμ λ°°ν¬λ ν¨ν€μ§λ₯Ό λ°λ‘ μ€μΉν©λλ€. μμ€ ν΄λ‘ μ΄ νμ μμ΅λλ€.
pip install open3d scikit-image wandb tqdm natsort pyquaternion
PyPIμ λ°°ν¬λ ν¨ν€μ§λ₯Ό λ°λ‘ μ€μΉν©λλ€. μμ€ ν΄λ‘ μ΄ νμ μμ΅λλ€.
pip install kiss-icp
PyPIμ λ°°ν¬λ ν¨ν€μ§λ₯Ό λ°λ‘ μ€μΉν©λλ€. μμ€ ν΄λ‘ μ΄ νμ μμ΅λλ€.
μ΄ λ ν¬μ READMEμ μ ν μ€μ λͺ λ Ήμ΄λ₯Ό κ·Έλλ‘ κ°μ Έμμ΅λλ€.
3. Docker
μ¬μ- Git GitHubμμ νλ‘μ νΈ μ½λλ₯Ό λ΄λ €λ°μΌλ €λ©΄ νμν©λλ€.
- Docker Desktop 컨ν μ΄λλ₯Ό λΉλνκ³ μ€ννλ €λ©΄ νμν©λλ€. μ€μΉ ν μ€νν΄μ λ°±κ·ΈλΌμ΄λμ μΌλμΈμ.
docker build --tag shine .
Dockerfileμ κΈ°λ°μΌλ‘ μ€ν κ°λ₯ν μ΄λ―Έμ§λ₯Ό λΉλν©λλ€.
docker run --rm -v ${pwd}/:/repository -v /tmp/shine_test_data:/data -it --gpus all shine
λΉλλ μ΄λ―Έμ§λ₯Ό μ€μ 컨ν μ΄λλ‘ μ€νν©λλ€.
docker run --rm -v .:/repository -v ${MY_DATA_DIR}:/data -it --gpus all shine bash
λΉλλ μ΄λ―Έμ§λ₯Ό μ€μ 컨ν μ΄λλ‘ μ€νν©λλ€.
<a href="#containerized-installation">Docker</a>
μ΄ λͺ λ Ήμ΄λ₯Ό ν°λ―Έλμ κ·Έλλ‘ μ λ ₯ν΄ μ€ννμΈμ.
μ΄ λ ν¬μ READMEμ μ ν μ€μ λͺ λ Ήμ΄λ₯Ό κ·Έλλ‘ κ°μ Έμμ΅λλ€.
