From 58414777be599593bfdb1e04347699719af20140 Mon Sep 17 00:00:00 2001 From: Kristoffer Andersen Date: Mon, 27 Nov 2023 10:25:11 +0100 Subject: [PATCH] Update installation.rst add more information about conda package installation --- .../docs/ifcopenshell-python/installation.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/ifcopenshell-python/docs/ifcopenshell-python/installation.rst b/src/ifcopenshell-python/docs/ifcopenshell-python/installation.rst index d2bdcfc913..06720593a7 100644 --- a/src/ifcopenshell-python/docs/ifcopenshell-python/installation.rst +++ b/src/ifcopenshell-python/docs/ifcopenshell-python/installation.rst @@ -116,11 +116,23 @@ Conda conda install -c ifcopenshell -c conda-forge ifcopenshell # Alteratively, to install an older, stable version conda install -c conda-forge ifcopenshell + # If you want to install additional packages that rely on occt, you should install them at the same time into a fresh environment + conda create -n testenv -c conda-forge ifcopenshell pythonocc-core .. note:: Installing IfcOpenShell from Conda will also install IfcConvert. +.. note:: + + If you plan on using any other packages using `occt` (OpenCascade) you will need to ensure that + the `occt` version installed by `ifcopenshell` is compatible with the other packages. + A common error when using two packages compiled with different `occt` versions are + `ImportError: cannot import name 'V3d' from 'OCC'`. To avoid this, you should install + both packages at the same time and let conda resolve the common occt version. Here is an + example where `ifcopenshell` and `pythonocc-core` are installed in the same environment `testenv` + `conda create -n testenv -c conda-forge ifcopenshell pythonocc-core` + .. warning:: Conda builds are not yet available for Mac ARM devices (M1 chip). Instead,