mirror of
https://github.com/slsdetectorgroup/aare.git
synced 2026-02-20 03:28:43 +01:00
updated Documentation and README (#274)
This commit is contained in:
11
README.md
11
README.md
@@ -25,27 +25,30 @@ 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
|
||||||
```
|
```
|
||||||
|
|
||||||
Now you can use the Python module from your build directory
|
Now you can use the Python module from your build directory
|
||||||
|
|
||||||
```python
|
```python
|
||||||
import aare
|
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
|
||||||
|
|||||||
@@ -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 ::
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user