diff --git a/BUILDING.rst b/BUILDING.rst index 200f0c9..92ea91b 100644 --- a/BUILDING.rst +++ b/BUILDING.rst @@ -82,6 +82,38 @@ Install prerequisites You will need to install a number of tools and libraries to build **fresnel**. The options ``ENABLE_EMBREE`` and ``ENABLE_OPTIX`` each require additional libraries when enabled. +Install the required dependencies: + +.. code-block:: bash + + micromamba install cmake embree git ninja numpy pybind11 python qhull + +Install additional packages needed to run the unit tests: + +.. code-block:: bash + + micromamba install pillow pytest + +Install additional packages needed to build the documentation: + +.. code-block:: bash + + micromamba install furo nbsphinx ipython sphinx-copybutton + +.. note:: + + This guide assumes that you use the micromamba_ package manager. Adjust the commands + appropriately for the package manager of your choice. + +.. warning:: + + When using a ``conda-forge`` environment for development, make sure that the environment does + not contain ``clang``, ``gcc``, or any other compiler or linker. These interfere with the native + compilers on your system and will result in compiler errors when building, linker errors when + running, or segmentation faults. + +.. _micromamba: https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html + **General requirements:** - **C++17** capable compiler @@ -197,13 +229,6 @@ Other option changes take effect at any time: Pass the following options to CMake_ to optimize the build for your processor: ``-DCMAKE_CXX_FLAGS=-march=native -DCMAKE_C_FLAGS=-march=native`` -.. warning:: - - When using a ``conda-forge`` environment for development, make sure that the environment does - not contain ``clang``, ``gcc``, or any other compiler or linker. These interfere with the native - compilers on your system and will result in compiler errors when building, linker errors when - running, or segmentation faults. - .. _CMake: https://cmake.org/ .. _Ninja: https://ninja-build.org/