Entwine

Description

Entwine is a FOSS development for point cloud data management, designed to handle datasets with trillions of points into the Terabytes of data. It is capable of giving the mapper a 3D view of landscape, buildings and physical reality on the ground.

1. Installation of Conda

As usual always first get your system up-to-date. At the moment of writing this article and installing on our servers the latest version was 2024.02.1

1. sudo -i
2. sudo apt update
3. sudo apt upgrade
4. sudo apt install curl
5. cd /tmp
6. curl -O https://repo.anaconda.com/archive/Anaconda3-2024.02-1-Linux-x86_64.sh
   • Check for the latest version here
7. bash Anaconda3-2024.02-1-Linux-x86_64.sh we choose the default/recommended answers during the installations
8. source ~/.bashrc
9. conda -V if at this point there's no output, it means you chose "no" to not initialize the conda shell, see troubleshooting section

2 Creating Conda environment

1. conda create --name environtmentname python=3 replace environtmentname by whatever you choose
   • conda activate environtmentname
   • conda deactivate deactivate current environment
2. conda install <package-name>[=version] will install whatever package

3. Entwine environment

1. conda create --yes --name entwine --channel conda-forge entwine
2. conda activate entwine
3. conda install nodejs -y
4. npm install http-server -g
5. http-server entwine -p 8084 --cors

4. Entwine without autostart

If you choose not to automatically start with the entwine shell but prefer to keep the default shell upon every reboot, you need to start it manually. if you have successfully done the previous steps at this point it's simple:

1. eval "$(/home/entwineserver/anaconda3/bin/conda shell.bash hook)" replace 'bash' with whatever shell you're using, this activates conda!
2. conda activate entwine
3. entwine build -i ~/folder/input.laz -o ~/folder/outputfolder please note entwining a 1GB LAZ file can consume as much as 24GB RAM/SWAP space

Troubleshooting

Update conda

1. conda update conda
2. conda update anaconda

If you get an error PackageNotInstalledError: Package is not installed in prefix.

1. conda install anaconda

If you chose "no" at installation and thus didn't automatic start/initialize shell script

1. eval "$(/home/entwineserver/anaconda3/bin/conda shell.bash hook)" replace 'bash' with whatever shell you're using.
2. conda init

To disable Conda from automatic start at boot

1. conda config --set auto_activate_base false

Undo Conda shell integration

1. conda init --reverse $SHELL