updated Documentation and README (#274)
Some checks failed
Build on RHEL8 / build (push) Successful in 2m38s
Build on RHEL9 / build (push) Successful in 2m58s
Run tests using data on local RHEL8 / build (push) Failing after 3m16s

This commit is contained in:
2026-02-19 11:22:35 +01:00
committed by GitHub
parent 218f31ce60
commit 1f7a87cc30
2 changed files with 32 additions and 8 deletions

View File

@@ -25,7 +25,7 @@ mkdir build
cd build cd build
#configure using cmake #configure using cmake
cmake ../aare cmake ../aare -DAARE_PYTHON_BINDINGS=ON
#build (replace 4 with the number of threads you want to use) #build (replace 4 with the number of threads you want to use)
make -j4 make -j4
@@ -38,14 +38,17 @@ import aare
f = aare.File('Some/File/I/Want_to_open_master_0.json') f = aare.File('Some/File/I/Want_to_open_master_0.json')
``` ```
To run form other folders either add the path to your conda environment using conda-build or add it to your PYTHONPATH To run from other folders either add the path to your conda environment using conda-build or add the module to your PYTHONPATH
```bash
export PYTHONPATH=path_to_aare/aare/build:$PYTHONPATH
```
### Install using conda/mamba ### Install using conda/mamba
```bash ```bash
#enable your env first! #enable your env first!
conda install aare=2024.10.29.dev0 -c slsdetectorgroup conda install aare -c slsdetectorgroup # installs latest version
``` ```
### Install to a custom location and use in your project ### Install to a custom location and use in your project

View File

@@ -15,9 +15,16 @@ dependencies on older distributions.
.. note :: .. note ::
aare is developing rapidly. Check for the latest release by aare is developing rapidly. Check for available releases by
using: **conda search aare -c slsdetectorgroup** using: **conda search aare -c slsdetectorgroup**
To install the latest version of aare using conda, run:
.. code-block:: bash
conda install aare -c slsdetectorgroup
To install a specific version of aare, run:
.. code-block:: bash .. code-block:: bash
@@ -28,7 +35,7 @@ dependencies on older distributions.
cmake build (development install) cmake build (development install)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you are working on aare or want to test our a version that doesn't yet have If you are working on aare or want to test out a version that doesn't yet have
a conda package. Build using cmake and then run from the build folder. a conda package. Build using cmake and then run from the build folder.
.. code-block:: bash .. code-block:: bash
@@ -47,6 +54,20 @@ a conda package. Build using cmake and then run from the build folder.
# add the build folder to your PYTHONPATH and then you should be able to # add the build folder to your PYTHONPATH and then you should be able to
# import aare in python # import aare in python
To build the python bindings and use aare in python compile with option ``-DAARE_PYTHON_BINDINGS=ON``.
.. code-block:: bash
#in build folder
cmake ../aare -DAARE_PYTHON_BINDINGS=ON
make -j4
Make sure to add the build folder to your PYTHONPATH and then you should be able to import aare in python.
.. code-block:: bash
export PYTHONPATH=/path/to/aare/build:$PYTHONPATH
cmake build + install and use in your C++ project cmake build + install and use in your C++ project
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -79,9 +100,9 @@ For detailed options see the CMakeLists.txt file in the root directory of the pr
Use system libraries instead of using FetchContent to pull in dependencies. Default option is off. Use system libraries instead of using FetchContent to pull in dependencies. Default option is off.
**AARE_PYTHON_BINDINGS "Build python bindings" ON** **AARE_PYTHON_BINDINGS "Build python bindings" OFF**
Build the Python bindings. Default option is on. Build the Python bindings. Default option is off.
.. warning :: .. warning ::