acts

Experiment-independent toolkit for (charged) particle track reconstruction in (high energy) physics experiments implemented in modern C++

https://github.com/acts-project/acts

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.1%) to scientific vocabulary

Keywords

particle-track-reconstruction physics-experiment reconstruction simulation
Last synced: 7 months ago · JSON representation ·

Repository

Experiment-independent toolkit for (charged) particle track reconstruction in (high energy) physics experiments implemented in modern C++

Basic Info
  • Host: GitHub
  • Owner: acts-project
  • License: mpl-2.0
  • Language: C++
  • Default Branch: main
  • Homepage: https://acts.readthedocs.io
  • Size: 107 MB
Statistics
  • Stars: 114
  • Watchers: 10
  • Forks: 210
  • Open Issues: 188
  • Releases: 192
Topics
particle-track-reconstruction physics-experiment reconstruction simulation
Created about 7 years ago · Last pushed 7 months ago
Metadata Files
Readme Contributing License Code of conduct Citation Authors Zenodo

README.md

ACTS Common Tracking Software

or A Common Tracking Software if you do not like recursive acronyms

10.5281/zenodo.5141418 Chat on Mattermost Coverage Latest release Status Metrics

ACTS is an experiment-independent toolkit for (charged) particle track reconstruction in (high energy) physics experiments implemented in modern C++.

More information can be found in the ACTS documentation.

Quick start

ACTS is developed in C++ and is build using CMake. Building the core library requires a C++20 compatible compiler, Boost, and Eigen. The following commands will clone the repository, configure, and build the core library

sh git clone https://github.com/acts-project/acts <source> cmake -B <build> -S <source> cmake --build <build>

For more details, e.g. specific versions and additional dependencies, have a look at the getting started guide. If you find a bug, have a feature request, or want to contribute to ACTS, have a look at the contribution guidelines.

Versioning and public API

Release versions follow semantic versioning to indicate whether a new version contains breaking changes within the public API. Currently, only a limited part of the visible API is considered the public API and subject to the semantic versioning rules. The details are outlined in the versioning and public API documentation.

Repository organization

The repository contains all code of the ACTS projects, not just the core library that a physics experiment is expected to use as part of its reconstruction code. All optional components are disabled by default. Please see the getting started guide on how-to enable them.

  • Core/ contains the core library that provides functionality in the Acts namespace.
  • Plugins/ contains plugins for core functionality that requires additional external packages. The functionality also resides in the Acts namespace.
  • Fatras/ provides fast track simulation tools based on the core library. This is not part of the core functionality and thus resides in the separate ActsFatras namespace.
  • Examples/ contains simulation and reconstruction examples. These are internal tools for manual full-chain development and tests and reside in the ActsExamples namespace.
  • Tests/ contains automated unit tests, integration tests, and (micro-)benchmarks.
  • thirdparty/ contains external dependencies that are usually not available through the system package manager.

Authors and license

Contributors to the ACTS project are listed in the AUTHORS file.

The ACTS project is published under the terms of the Mozilla Public License, v. 2.0. A copy of the license can be found in the LICENSE file or at https://mozilla.org/MPL/2.0/ .

The ACTS project contains copies of the following external packages:

Owner

  • Name: Acts
  • Login: acts-project
  • Kind: organization

Citation (CITATION.cff)

cff-version: 1.1.0
message: If you use this software, please cite it using these metadata.
title: 'A Common Tracking Software Project'
doi: 10.5281/zenodo.5141419
authors:
- given-names: Andreas
  family-names: Salzburger
  affiliation: CERN
- given-names: Paul
  family-names: Gessinger
  affiliation: CERN
- given-names: Fabian
  family-names: Klimpel
  affiliation: CERN / TUM Muenchen
- given-names: Moritz
  family-names: Kiehn
  affiliation: CERN
- given-names: Bastian
  family-names: Schlag
  affiliation: CERN / JGU Mainz
- given-names: Hadrien
  family-names: Grasland
  affiliation: Universite Paris-Saclay / CNRS/IN2P3
- given-names: Robert
  family-names: Langenberg
- given-names: Corentin
  family-names: Allaire
  affiliation: CERN
- given-names: Xiaocong
  family-names: Ai
  affiliation: DESY Hamburg
- given-names: Benjamin
  family-names: Huth
  affiliation: Universitaet Regensburg
- given-names: Louis-Guillaume
  family-names: Gagnon
  affiliation: UC Berkeley
- given-names: Noemi
  family-names: Calace
  affiliation: CERN
- given-names: Attila
  family-names: Krasznahorkay
  affiliation: CERN
- given-names: Beomki
  family-names: Yeo
  affiliation: UC Berkeley
- given-names: Charles
  family-names: Leggett
  affiliation: LBNL
- given-names: Czirkos
  family-names: Angela
  affiliation: Eotvos Lorand University
- given-names: Tomohiro
  family-names: Yamazaki
  affiliation: UC Berkeley
- given-names: Joana
  family-names: Niermann
  affiliation: CERN
- given-names: Irina
  family-names: Ene
  affiliation: UC Berkeley
- given-names: Joe
  family-names: Osborn
  affiliation: Oak Ridge National Laboratory
- given-names: Rocky
  family-names: Garg
  name-particle: Bala
  affiliation: Stanford University
- given-names: Andreas
  family-names: Stefl
  affiliation: CERN / TU Wien
- given-names: Luis Falda
  family-names: Coelho
  affiliation: CERN / University of Coimbra
  orcid: https://orcid.org/0000-0002-2298-3605
- given-names: Alexander J.
  family-names: Pfleger
  affiliation: CERN / University of Graz
  orcid: https://orcid.org/0000-0001-5524-7738
- given-names: Guilherme
  family-names: Almeida
  affiliation: University of Lisbon
  orcid: https://orcid.org/0000-0002-4257-4278
- given-names: Stephen Nicholas
  family-names: Swatman
  affiliation: CERN / University of Amsterdam
  orcid: https://orcid.org/0000-0002-3747-3229
- given-names: Felix
  family-names: Russo
  affiliation: CERN / TU Wien
  orcid: https://orcid.org/0009-0005-8975-2245
- given-names: Carlo
  family-names: Varni
  affiliation: UC Berkeley
version: 10.0.0
date-released: 2021-07-28
repository-code: https://github.com/acts-project/acts
license: MPL-2.0

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 121
  • Total pull requests: 1,502
  • Average time to close issues: 8 months
  • Average time to close pull requests: 18 days
  • Total issue authors: 33
  • Total pull request authors: 62
  • Average comments per issue: 2.36
  • Average comments per pull request: 2.76
  • Merged pull requests: 1,024
  • Bot issues: 4
  • Bot pull requests: 10
Past Year
  • Issues: 52
  • Pull requests: 792
  • Average time to close issues: 8 days
  • Average time to close pull requests: 8 days
  • Issue authors: 23
  • Pull request authors: 45
  • Average comments per issue: 1.77
  • Average comments per pull request: 2.35
  • Merged pull requests: 493
  • Bot issues: 4
  • Bot pull requests: 8
Top Authors
Issue Authors
  • andiwand (26)
  • paulgessinger (24)
  • AJPfleger (11)
  • asalzburger (7)
  • bedanar (5)
  • benjaminhuth (4)
  • coderabbitai[bot] (4)
  • timadye (3)
  • veprbl (3)
  • stephenswat (3)
  • osbornjd (3)
  • CarloVarni (2)
  • DraTeots (2)
  • murnanedaniel (2)
  • wdconinc (2)
Pull Request Authors
  • andiwand (389)
  • paulgessinger (359)
  • AJPfleger (172)
  • asalzburger (131)
  • benjaminhuth (97)
  • CarloVarni (54)
  • stephenswat (41)
  • junggjo9 (30)
  • ssdetlab (27)
  • dimitra97 (20)
  • timadye (13)
  • pbutti (10)
  • ntadej (10)
  • goetzgaycken (9)
  • felix-russo (8)
Top Labels
Issue Labels
Stale (33) automerge (12) Component - Examples (10) Infrastructure (8) Component - Core (7) Component - Documentation (5) Improvement (5) Component - Plugins (5) Bug (4) Track Finding (4) Track Fitting (3) Changes Performance (3) Vertexing (3) Component - Fatras (2) Event Data Model (2) Impact - Minor (2) Impact - Critical (1) Clustering (1) SP formation (1) Seeding (1) Feature (1) Wont Fix (1) :construction: WIP (1) fpe (1) Ambiguity Resolution (1)
Pull Request Labels
automerge (968) Component - Core (647) Component - Examples (549) Infrastructure (234) Component - Plugins (219) Track Finding (169) Event Data Model (149) Changes Performance (131) Track Fitting (126) Component - Documentation (110) Seeding (104) Vertexing (80) Component - Fatras (61) Stale (38) :stop_sign: blocked (32) Ambiguity Resolution (23) :construction: WIP (20) Fails Athena tests (12) Breaks Athena build (12) SP formation (10) Clustering (9) :construction_worker_woman: User Action Needed (6) Bug (6) dependencies (6) coderabbit (5) github_actions (4) Improvement (4) Needs Discussion (4) Breaking change (3) Feature (2)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 131
proxy.golang.org: github.com/acts-project/acts
  • Versions: 131
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.3%
Average: 5.5%
Dependent repos count: 5.7%
Last synced: 7 months ago

Dependencies

.github/workflows/analysis.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/download-artifact v2 composite
  • actions/upload-artifact v3 composite
  • codecov/codecov-action v3 composite
.github/workflows/backport.yml actions
  • tibdex/backport v2 composite
.github/workflows/builds.yml actions
  • actions/cache/restore v3 composite
  • actions/cache/save v3 composite
  • actions/checkout v3 composite
  • actions/download-artifact v3 composite
  • actions/upload-artifact v3 composite
.github/workflows/checks.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
.github/workflows/docs.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
.github/workflows/iwyu.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
.github/workflows/labels.yml actions
  • actions/checkout v3 composite
  • actions/labeler v4 composite
.github/workflows/pr-lint.yml actions
  • amannn/action-semantic-pull-request v4 composite
.github/workflows/pr_commands.yml actions
  • actions/checkout v3 composite
.github/workflows/release.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/release_pr.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/remove-automerge-label.yml actions
  • actions-ecosystem/action-remove-labels v1 composite
.github/workflows/report.yml actions
  • actions/checkout v3 composite
  • actions/github-script v6 composite
  • actions/setup-python v4 composite
  • peter-evans/create-or-update-comment v2 composite
  • peter-evans/find-comment v2 composite
.github/workflows/stale.yml actions
  • actions/stale v8 composite
.github/workflows/trigger_athena.yml actions
CI/clang_tidy/requirements.in pypi
  • PyYAML *
  • codereport *
  • pydantic *
  • rich *
CI/clang_tidy/requirements.txt pypi
  • appdirs ==1.4.4
  • codereport ==0.3.2
  • commonmark ==0.9.1
  • fs ==2.4.16
  • jinja2 ==3.1.2
  • markupsafe ==2.1.1
  • pydantic ==1.9.0
  • pygments ==2.11.2
  • python-slugify ==6.1.2
  • pyyaml ==6.0
  • rich ==12.2.0
  • six ==1.16.0
  • text-unidecode ==1.3
  • typing-extensions ==4.1.1
CI/commands/requirements.in pypi
  • aiohttp *
  • gidgethub *
  • typer *
CI/commands/requirements.txt pypi
  • aiohttp ==3.8.5
  • aiosignal ==1.3.1
  • async-timeout ==4.0.3
  • attrs ==23.1.0
  • cffi ==1.15.1
  • charset-normalizer ==3.2.0
  • click ==8.1.7
  • cryptography ==41.0.3
  • frozenlist ==1.4.0
  • gidgethub ==5.3.0
  • idna ==3.4
  • multidict ==6.0.4
  • pycparser ==2.21
  • pyjwt ==2.8.0
  • typer ==0.9.0
  • typing-extensions ==4.7.1
  • uritemplate ==4.1.1
  • yarl ==1.9.2
CI/poetry.lock pypi
  • certifi 2020.6.20
  • chardet 3.0.4
  • click 7.1.2
  • colorama 0.4.3
  • commonmark 0.9.1
  • cursor 1.3.4
  • deprecated 1.2.10
  • halo 0.0.29
  • idna 2.10
  • log-symbols 0.0.14
  • pprintpp 0.4.0
  • pygithub 1.51
  • pygments 2.6.1
  • pyjwt 1.7.1
  • pyyaml 5.3.1
  • requests 2.24.0
  • rich 3.3.0
  • sh 1.13.1
  • six 1.15.0
  • spinners 0.0.24
  • termcolor 1.1.0
  • typing-extensions 3.7.4.2
  • urllib3 1.25.9
  • wrapt 1.12.1
CI/pyproject.toml pypi
  • PyGithub ^1.51
  • PyYAML ^5.3.1
  • click ^7.1.2
  • halo ^0.0.29
  • python ^3.7
  • rich ^3.3.0
  • sh ^1.13.1
CI/release_requirements.in pypi
  • PyYAML *
  • aiohttp *
  • gidgethub *
  • python-dotenv *
  • python-semantic-release *
  • sh *
  • typer *
CI/release_requirements.txt pypi
  • aiohttp ==3.7.4.post0
  • async-timeout ==3.0.1
  • attrs ==21.2.0
  • bleach ==4.1.0
  • certifi ==2021.5.30
  • cffi ==1.14.6
  • chardet ==4.0.0
  • charset-normalizer ==2.0.4
  • click ==8.0.1
  • click-log ==0.3.2
  • colorama ==0.4.4
  • cryptography ==3.4.8
  • docutils ==0.17.1
  • dotty-dict ==1.3.0
  • gidgethub ==5.0.1
  • gitdb ==4.0.7
  • gitpython ==3.1.18
  • idna ==3.2
  • importlib-metadata ==4.8.1
  • invoke ==1.6.0
  • jeepney ==0.7.1
  • keyring ==23.1.0
  • multidict ==5.1.0
  • packaging ==21.0
  • pkginfo ==1.7.1
  • pycparser ==2.20
  • pygments ==2.10.0
  • pyjwt ==2.1.0
  • pyparsing ==2.4.7
  • python-dotenv ==0.19.0
  • python-gitlab ==2.10.1
  • python-semantic-release ==7.19.1
  • pyyaml ==5.4.1
  • readme-renderer ==29.0
  • requests ==2.26.0
  • requests-toolbelt ==0.9.1
  • rfc3986 ==1.5.0
  • secretstorage ==3.3.1
  • semver ==2.13.0
  • setuptools-scm ==6.0.1
  • sh ==1.14.2
  • six ==1.16.0
  • smmap ==4.0.0
  • tomlkit ==0.7.0
  • tqdm ==4.62.2
  • twine ==3.4.2
  • typer ==0.4.0
  • typing-extensions ==3.10.0.1
  • uritemplate ==3.0.1
  • urllib3 ==1.26.6
  • webencodings ==0.5.1
  • wheel ==0.37.0
  • yarl ==1.6.3
  • zipp ==3.5.0
CI/requirements.txt pypi
  • certifi ==2020.6.20
  • chardet ==3.0.4
  • click ==7.1.2
  • colorama ==0.4.3
  • commonmark ==0.9.1
  • cursor ==1.3.4
  • deprecated ==1.2.10
  • halo ==0.0.29
  • idna ==2.10
  • log-symbols ==0.0.14
  • pprintpp ==0.4.0
  • pygithub ==1.51
  • pygments ==2.6.1
  • pyjwt ==1.7.1
  • pyyaml ==5.3.1
  • requests ==2.24.0
  • rich ==3.3.0
  • sh ==1.13.1
  • six ==1.15.0
  • spinners ==0.0.24
  • termcolor ==1.1.0
  • typing-extensions ==3.7.4.2
  • urllib3 ==1.25.9
  • wrapt ==1.12.1
CI/requirements_fpe_masks.in pypi
  • aiohttp *
  • gidgethub *
  • rich *
  • typer *
CI/requirements_fpe_masks.txt pypi
  • aiohttp ==3.8.4
  • aiosignal ==1.3.1
  • async-timeout ==4.0.2
  • attrs ==23.1.0
  • cffi ==1.15.1
  • charset-normalizer ==3.1.0
  • click ==8.1.4
  • cryptography ==41.0.1
  • frozenlist ==1.3.3
  • gidgethub ==5.3.0
  • idna ==3.4
  • markdown-it-py ==3.0.0
  • mdurl ==0.1.2
  • multidict ==6.0.4
  • pycparser ==2.21
  • pygments ==2.15.1
  • pyjwt ==2.7.0
  • rich ==13.4.2
  • typer ==0.9.0
  • typing-extensions ==4.7.1
  • uritemplate ==4.1.1
  • yarl ==1.9.2
Examples/Python/tests/requirements.in pypi
  • awkward * test
  • pytest * test
  • pytest-check * test
  • pytest-rerunfailures * test
  • pytest-xdist * test
  • pyyaml * test
  • uproot * test
Examples/Python/tests/requirements.txt pypi
  • attrs ==21.4.0 test
  • awkward ==1.7.0 test
  • execnet ==1.9.0 test
  • iniconfig ==1.1.1 test
  • numpy ==1.22.2 test
  • packaging ==21.3 test
  • pluggy ==1.0.0 test
  • py ==1.11.0 test
  • pyparsing ==3.0.7 test
  • pytest ==7.0.1 test
  • pytest-check ==1.0.4 test
  • pytest-rerunfailures ==10.2 test
  • pytest-xdist ==3.2.1 test
  • pyyaml ==6.0 test
  • tomli ==2.0.1 test
  • uproot ==4.1.9 test
Examples/Scripts/requirements.in pypi
  • PyYAML *
  • awkward *
  • hist *
  • matplotlib *
  • mplhep *
  • pandas *
  • pydantic *
  • rich *
  • scipy *
  • typer *
  • uproot *
Examples/Scripts/requirements.txt pypi
  • awkward ==2.1.3
  • awkward-cpp ==14
  • boost-histogram ==1.3.2
  • click ==8.1.3
  • contourpy ==1.0.7
  • cycler ==0.11.0
  • fonttools ==4.39.3
  • hist ==2.6.3
  • histoprint ==2.4.0
  • importlib-resources ==6.0.0
  • kiwisolver ==1.4.4
  • markdown-it-py ==3.0.0
  • matplotlib ==3.7.1
  • mdurl ==0.1.2
  • mplhep ==0.3.27
  • mplhep-data ==0.0.3
  • numpy ==1.24.3
  • packaging ==23.1
  • pandas ==2.0.1
  • pillow ==9.5.0
  • pydantic ==1.10.7
  • pygments ==2.15.1
  • pyparsing ==3.0.9
  • python-dateutil ==2.8.2
  • pytz ==2023.3
  • pyyaml ==6.0
  • rich ==13.5.2
  • scipy ==1.10.1
  • six ==1.16.0
  • typer ==0.7.0
  • typing-extensions ==4.5.0
  • tzdata ==2023.3
  • uhi ==0.3.3
  • uproot ==5.0.7
  • zipp ==3.16.2
docs/requirements.in pypi
  • breathe *
  • myst-parser *
  • sphinx *
  • sphinx_rtd_theme *
docs/requirements.txt pypi
  • alabaster ==0.7.12
  • babel ==2.10.3
  • breathe ==4.34.0
  • certifi ==2022.6.15
  • charset-normalizer ==2.1.0
  • docutils ==0.16
  • idna ==3.3
  • imagesize ==1.4.1
  • importlib-metadata ==4.12.0
  • jinja2 ==3.1.2
  • markdown-it-py ==2.1.0
  • markupsafe ==2.1.1
  • mdit-py-plugins ==0.3.0
  • mdurl ==0.1.2
  • myst-parser ==0.18.0
  • packaging ==21.3
  • pygments ==2.12.0
  • pyparsing ==3.0.9
  • pytz ==2022.2.1
  • pyyaml ==6.0
  • requests ==2.28.1
  • snowballstemmer ==2.2.0
  • sphinx ==5.1.1
  • sphinx-rtd-theme ==1.0.0
  • sphinxcontrib-applehelp ==1.0.2
  • sphinxcontrib-devhelp ==1.0.2
  • sphinxcontrib-htmlhelp ==2.0.0
  • sphinxcontrib-jsmath ==1.0.1
  • sphinxcontrib-qthelp ==1.0.3
  • sphinxcontrib-serializinghtml ==1.1.5
  • typing-extensions ==4.3.0
  • urllib3 ==1.26.11
  • zipp ==3.8.1