source/acts/README.md

0001 # Acts Common Tracking Software
0002
0003 or *A Common Tracking Software* if you do not like recursive acronyms
0004
0005 [![10.5281/zenodo.5141418](https://zenodo.org/badge/DOI/10.5281/zenodo.5141418.svg)](https://doi.org/10.5281/zenodo.5141418)
0006 [![Chat on Mattermost](https://badgen.net/badge/chat/on%20mattermost/cyan)](https://mattermost.web.cern.ch/acts/)
0007 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=acts-project_acts&metric=coverage)](https://sonarcloud.io/summary/new_code?id=acts-project_acts)
0008 [![Latest release](https://badgen.net/github/release/acts-project/acts)](https://github.com/acts-project/acts/releases)
0009 [![Status](https://badgen.net/github/checks/acts-project/acts/main)](https://github.com/acts-project/acts/actions)
0010 [![Metrics](https://badgen.net/badge/metric/tracker/purple)](https://acts-project.github.io/metrics/)
0011
0012 Acts is an experiment-independent toolkit for (charged) particle track
0013 reconstruction in (high energy) physics experiments implemented in modern C++.
0014
0015 More information can be found in the [Acts documentation](https://acts.readthedocs.io/).
0016
0017 ## Quick start
0018
0019 Acts is developed in C++ and is build using [CMake](https://cmake.org). Building
0020 the core library requires a C++20 compatible compiler,
0021 [Boost](https://www.boost.org), and [Eigen](https://eigen.tuxfamily.org). The
0022 following commands will clone the repository, configure, and build the core
0023 library
0024
0025 ```sh
0026 git clone https://github.com/acts-project/acts <source>
0027 cmake -B <build> -S <source>
0028 cmake --build <build>
0029 ```
0030
0031 For more details, e.g. specific versions and additional dependencies, have a
0032 look at the [getting started guide](docs/getting_started.md). If you find a bug,
0033 have a feature request, or want to contribute to Acts, have a look at the
0034 [contribution guidelines](CONTRIBUTING.rst).
0035
0036 ## Versioning and public API
0037
0038 Release versions follow [semantic versioning](https://semver.org/spec/v2.0.0.html)
0039 to indicate whether a new version contains breaking changes within the public API.
0040 Currently, only a limited part of the visible API is considered the public API
0041 and subject to the semantic versioning rules. The details are outlined in the
0042 [versioning and public API documentation](docs/versioning.rst).
0043
0044 ## Repository organization
0045
0046 The repository contains all code of the Acts projects, not just the core library
0047 that a physics experiment is expected to use as part of its reconstruction code.
0048 All optional components are disabled by default. Please see the
0049 [getting started guide](docs/getting_started.md) on how-to enable them.
0050
0051 -   `Core/` contains the core library that provides functionality in the `Acts`
0052     namespace.
0053 -   `Plugins/` contains plugins for core functionality that requires
0054     additional external packages. The functionality also resides in the `Acts`
0055     namespace.
0056 -   `Fatras/` provides fast track simulation tools based on the core
0057     library. This is not part of the core functionality and thus resides in the
0058     separate `ActsFatras` namespace.
0059 -   `Examples/` contains simulation and reconstruction examples. These are
0060     internal tools for manual full-chain development and tests and reside in
0061     the `ActsExamples` namespace.
0062 -   `Tests/` contains automated unit tests, integration tests, and
0063     (micro-)benchmarks.
0064 -   `thirdparty/` contains external dependencies that are usually not available
0065     through the system package manager.
0066
0067 ## Authors and license
0068
0069 Contributors to the Acts project are listed in the [AUTHORS](AUTHORS) file.
0070
0071 The Acts project is published under the terms of the Mozilla Public License, v. 2.0.
0072 A copy of the license can be found in the [LICENSE](LICENSE) file or at
0073 https://mozilla.org/MPL/2.0/ .
0074
0075 The Acts project contains copies of the following external packages:
0076
0077 -   [OpenDataDetector](https://github.com/acts-project/OpenDataDetector)
0078     licensed under the MPLv2 license.