Difference between revisions of "How to start using the ACTS framework"
Jump to navigation
Jump to search
(Created the page and wrote the "Setup" and "Run Examples" steps.) |
(Formatting) |
||
| Line 3: | Line 3: | ||
=== '''Setup:''' === | === '''Setup:''' === | ||
| − | * On the Stoomboot cluster, start by navigating to your user account directory. <code>/data/alice/<username></code> | + | * On the Stoomboot cluster, start by navigating to your user account directory. <code>/data/alice/<username></code> |
| − | * Next, activate a compatible LCG (LHC Computing Grid) software environment. LCG provides a pre-packaged set of libraries and compilers. For the Acts framework, a view containing GCC 13 or later is required for C++20 compatibility. A working example: <code>source /cvmfs/sft.cern.ch/lcg/views/LCG_108/x86_64-el9-gcc13-opt/setup.sh</code> | + | * Next, activate a compatible LCG (LHC Computing Grid) software environment. LCG provides a pre-packaged set of libraries and compilers. For the Acts framework, a view containing GCC 13 or later is required for C++20 compatibility. A working example: <code>source /cvmfs/sft.cern.ch/lcg/views/LCG_108/x86_64-el9-gcc13-opt/setup.sh</code> ''This command must be executed in every new shell session.'' |
| − | * Clone the [https://github.com/acts-project/acts/tree/main Acts repository] from GitHub to your local machine. Replace `<source>` with your desired directory name. | + | * Clone the [https://github.com/acts-project/acts/tree/main Acts repository] from GitHub to your local machine. Replace `<source>` with your desired directory name. <code>git clone <nowiki>https://github.com/acts-project/acts</nowiki> <nowiki><source></nowiki></code> |
| − | * Navigate into the cloned repository and configure the build with ''cmake''. To enable the Python bindings for the examples, you must explicitly pass the corresponding flags. | + | * Navigate into the cloned repository and configure the build with ''cmake''. To enable the Python bindings for the examples, you must explicitly pass the corresponding flags. <code>cd <source></code> <code>cmake -B build -S . -DACTS_BUILD_EXAMPLES=ON -DACTS_BUILD_EXAMPLES_PYTHON_BINDINGS=ON -DPYBIND11_USE_FETCHCONTENT=ON</code> |
* Next, compile the project. <code>cmake --build build</code> | * Next, compile the project. <code>cmake --build build</code> | ||
| Line 15: | Line 15: | ||
=== '''Run Examples:''' === | === '''Run Examples:''' === | ||
| − | * Before running the Python scripts, you must run the <code>setup.sh</code> script to configure your environment. This script modifies your PYTHONPATH, an environment variable that tells Python where to look for modules. | + | * Before running the Python scripts, you must run the <code>setup.sh</code> script to configure your environment. This script modifies your PYTHONPATH, an environment variable that tells Python where to look for modules. <code>source build/python/setup.sh</code> ''This command must be executed in every new shell session.'' |
* Once your environment is set up, you can execute any of the Python example scripts. The files are located in the <code>Examples/Scripts/Python</code> directory. For example, to run the particle propagation script, use the following command: <code>python Examples/Scripts/Python/propagation.py</code> | * Once your environment is set up, you can execute any of the Python example scripts. The files are located in the <code>Examples/Scripts/Python</code> directory. For example, to run the particle propagation script, use the following command: <code>python Examples/Scripts/Python/propagation.py</code> | ||
Revision as of 15:21, 9 September 2025
The Acts (A Common Tracking Software) framework is an open-source project designed for track reconstruction and simulation in particle physics experiments. This guide explains how to set up a local working environment on the Stoomboot cluster and run the included Python examples, following the Acts 'getting started' page with minor adjustments.
Setup:
- On the Stoomboot cluster, start by navigating to your user account directory.
/data/alice/<username>
- Next, activate a compatible LCG (LHC Computing Grid) software environment. LCG provides a pre-packaged set of libraries and compilers. For the Acts framework, a view containing GCC 13 or later is required for C++20 compatibility. A working example:
source /cvmfs/sft.cern.ch/lcg/views/LCG_108/x86_64-el9-gcc13-opt/setup.shThis command must be executed in every new shell session.
- Clone the Acts repository from GitHub to your local machine. Replace `<source>` with your desired directory name.
git clone https://github.com/acts-project/acts <source>
- Navigate into the cloned repository and configure the build with cmake. To enable the Python bindings for the examples, you must explicitly pass the corresponding flags.
cd <source>cmake -B build -S . -DACTS_BUILD_EXAMPLES=ON -DACTS_BUILD_EXAMPLES_PYTHON_BINDINGS=ON -DPYBIND11_USE_FETCHCONTENT=ON
- Next, compile the project.
cmake --build build
Run Examples:
- Before running the Python scripts, you must run the
setup.shscript to configure your environment. This script modifies your PYTHONPATH, an environment variable that tells Python where to look for modules.source build/python/setup.shThis command must be executed in every new shell session. - Once your environment is set up, you can execute any of the Python example scripts. The files are located in the
Examples/Scripts/Pythondirectory. For example, to run the particle propagation script, use the following command:python Examples/Scripts/Python/propagation.py
and [/code]