source/jana2/README.md

0001 ![C/C++ CI ubuntu](https://github.com/JeffersonLab/JANA2/actions/workflows/ccpp-linux.yml/badge.svg)<br>
0002 ![C/C++ CI docker](https://github.com/JeffersonLab/JANA2/actions/workflows/ccpp-docker.yml/badge.svg)<br>
0003 ![C/C++ CI macos](https://github.com/JeffersonLab/JANA2/actions/workflows/ccpp-macos.yml/badge.svg)<br>
0004 ![C/C++ CI cuda-ifarm](https://github.com/JeffersonLab/JANA2/actions/workflows/cuda-farm.yml/badge.svg)<br>
0005
0006 [![DOI](https://zenodo.org/badge/117695469.svg)](https://zenodo.org/badge/latestdoi/117695469)
0007 ## Welcome to JANA!
0008
0009 JANA is a C++ framework for multi-threaded HENP (High Energy and Nuclear Physics)  event reconstruction.
0010 Please see the [JANA website](https://jeffersonlab.github.io/JANA2/) for full documentation.
0011
0012 JANA2 is a complete rewrite retaining successful features from the original while modernizing the framework for a new generation of experiments. The code is under active development, but is ready for use as is. You are welcome to
0013 check it out and give feedback to help us improve it.
0014
0015 Just to whet your appetite a little, the code snippet below is the most common signature of JANA. A large fraction of end users won't really need to know much more than this.
0016
0017 ```c++
0018 auto tracks = jevent->Get<DTrack>();
0019
0020 for(auto t : tracks){
0021   // ... do something with a track
0022 }
0023 ```
0024
0025 To quickly download, build, install, and test on your system:
0026
0027 ```bash
0028 git clone https://github.com/JeffersonLab/JANA2
0029 cd JANA2
0030 mkdir build
0031 cmake -S . -B build -DCMAKE_INSTALL_PREFIX=`pwd`
0032 cmake --build build --target install -j 8
0033 bin/jana -Pplugins=JTest -Pjana:nevents=100
0034 ```
0035
0036 For a closer look, see our [tutorial](https://jeffersonlab.github.io/JANA2/#/tutorial).
0037
0038