Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 3.55 KB

UseWindowsCondaBinary.md

File metadata and controls

93 lines (66 loc) · 3.55 KB

Installing, testing and using a CloudComPy binary on Windows 10 or 11, with Conda

The binary CloudComPy*_-date-.7z available here is built in a Conda environment. (see here for the corresponding building instructions).

As CloudComPy is under development, these instructions and the link are subject to change from time to time...

This binary works only on Windows 10 or 11, and with a Conda environment as described below, not anywhere else!

You need a recent installation of Anaconda3 or miniconda3.

Note: CloudComPy versions released in 2024 and earlier were built using a Conda Python 3.10 environment: CloudComPy310. Now, new versions are built with a Python 3.11 Conda environment: CloudComPy311

You need to create a conda environment for CloudComPy: for instance, in Anaconda3, use the Anaconda3 prompt console:

conda activate
conda update -y -n base -c defaults conda

If your environment CloudComPy311 does not exist or to recreate it from scratch: (note: it's better to regularly recreate the environment, because there are sometimes a lot of changes)

conda create -y --name CloudComPy311 python=3.11
   # --- erase previous env with the same name if existing

Add or update the packages

conda activate CloudComPy311
conda config --add channels conda-forge
conda config --set channel_priority flexible
conda install -y "boost=1.84" "cgal=5.6" cmake "draco=1.5" "ffmpeg=6.1" "gdal=3.8" jupyterlab laszip "matplotlib=3.9" "mpir=3.0" "mysql=8" notebook numpy "opencv=4.9" "openmp=8.0" "openssl>=3.1" "pcl=1.14" "pdal=2.6" "psutil=6.0" pybind11 quaternion "qhull=2020.2" "qt=5.15.8" scipy sphinx_rtd_theme spyder tbb tbb-devel "xerces-c=3.2"

Install the binary in the directory of your choice.

Using CloudCompare and CloudComPy:

From the conda prompt, you have to set the Path and Pythonpath once :

conda activate CloudComPy310
cd <path install>\CloudComPy310
envCloudComPy.bat

To run CloudCompare:

CloudCompare

To execute a Python script (for instance myscript.py) using CloudComPy:

python myscript.py

The IDE Spyder and Jupyter can be launched in this environment:

spyder

The first time you run Spyder, you may need to add the paths to CloudCompare and the test scripts to the PYTHONPATH, using the menu Tools / PYTHONPATH Manager. These paths are the same as those defined in the envCloudComPy.bat script.

jupyter notebook

An example of notebook is provided in doc/samples/histogramOnDistanceComputation.ipynb.

Execute all the Python tests:

conda activate CloudComPy310
cd  <path install>\CloudComPy310\doc\PythonAPI_test

NB: envCloudComPy.bat is OK but not mandatory here, ctest resets the necessary paths

To execute all the tests (takes about three minutes, creates about 1.3GB of data files):

ctest

The files created with the tests are in your user space: %USERPROFILE%\CloudComPy\data

In case of problem:

There may be differences in the versions of conda packages. When updating the conda configuration, the package versions may change slightly.This is usually not a problem, but since the CloudComPy binary is fixed, there may be a version difference on a package, which makes it incompatible with CloudComPy. For your information, here is the list of package versions when CloudComPy was built.

The result of conda list command is provided in the sources in building directory