Skip to content

Latest commit

 

History

History
127 lines (106 loc) · 3.44 KB

INSTALL.md

File metadata and controls

127 lines (106 loc) · 3.44 KB
Raw

Build pythonocc-7.8.1 from scratch on a fresh Ubuntu 22.04 install

Requirements

pythonOCC-7.8.1 needs the following libraries or programs to be installed before you can compile/use it:

All the necessary libraries can be downloaded/installed using apt:

sudo apt-get update
sudo apt-get install -y wget libglu1-mesa-dev libgl1-mesa-dev libxmu-dev libxi-dev build-essential cmake libfreetype6-dev tk-dev python3-dev rapidjson-dev python3 git python3-pip libpcre2-dev

Build swig

The required swgi version is 4.2.1. Unfortunately, the ubuntu ppa only provides an outdated. If swig 4.2.1 is not available on your machine, you have to download/build by yourself (depends on libpcre2, previously installed):

wget http://prdownloads.sourceforge.net/swig/swig-4.2.1.tar.gz
tar -zxvf swig-4.2.1.tar.gz
cd swig-4.2.1
./configure && make -j4 && make install

Build OpenCascade

Download/extract version 7.8.1 https://github.com/Open-Cascade-SAS/OCCT/archive/refs/tags/V7_8_1.tar.gz

wget https://github.com/Open-Cascade-SAS/OCCT/archive/refs/tags/V7_8_1.tar.gz
tar -xvzf V7_8_1.tar.gz

Prepare the build stage:

cd OCCT-7.8.1
mkdir cmake-build
cd cmake-build

Choose an installation destination. Default is /usr/local, but it is better to set up an other folder so that it's easier to work with concurrent versions.

$ cmake -DINSTALL_DIR=/opt/occt781 -DBUILD_RELEASE_DISABLE_EXCEPTIONS=OFF ..

then

make -j4
sudo make install

and finally add the libraries to the system

echo "/opt/occt781/lib" >> /etc/ld.so.conf.d/occt.conf

Build pythonocc

First create a local copy of the git repository:

git clone https://github.com/tpaviot/pythonocc-core.git

then

cd pythonocc-core
mkdir cmake-build && cd cmake-build

# Path to the installation folder
PYTHONOCC_INSTALL_DIRECTORY=<PATH-TO-INSTALL>

cmake \
 -DOCCT_INCLUDE_DIR=/opt/occt781/include/opencascade \
 -DOCCT_LIBRARY_DIR=/opt/occt781/lib \
 -DCMAKE_BUILD_TYPE=Release \
 -DPYTHONOCC_INSTALL_DIRECTORY=$PYTHONOCC_INSTALL_DIRECTORY \
  ..

make -j4 && make install 

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/build/occt781/lib

If PYTHONOCC_INSTALL_DIRECTORY is unset, it will be installed to site-packages/OCC. Also add your LD_LIBRARY_PATH in your .bashrc file.

Build pythonocc with numpy support

numpy enables fast STL file loading. In order to benefit from this feature, you must install the numpy package (including the dev part), and compile pythonocc with:

 -DPYTHONOCC_MESHDS_NUMPY=ON

simple test

$ python
>>> from OCC.Core.gp import gp_Pnt
>>> p = gp_Pnt(1., 2., 3.)
>>> p.X()
1.0
>>>

additional dependencies

Additional python packages are required if you want to benefit from all pythonocc features.

pip install svgwrite numpy numpy-stl matplotlib PyQt5

test

In order to check that everything is ok, run the pythonocc unittest suite:

pip install pytest
pytest

demos

Download/test demos available at https://github.com/tpaviot/pythonocc-demos