Skip to content

Commit

Permalink
Revise prereq installation guide.
Browse files Browse the repository at this point in the history
  • Loading branch information
joaander committed Oct 7, 2024
1 parent c0aec5c commit 227670a
Showing 1 changed file with 32 additions and 7 deletions.
39 changes: 32 additions & 7 deletions BUILDING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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/

Expand Down

0 comments on commit 227670a

Please sign in to comment.