<commit_before>\section{Quick Start}
This chapter serves as a swift introduction to \apsq for users who prefer to start quickly and learn the details while simulating. The typical user should skip the next paragraphs and continue to Section \ref{sec:introduction} instead. 

\apsq is a generic simulation framework for pixel detectors. It provides a modular, flexible and user-friendly structure for the simulation of independent detectors in the geometry. The framework currently relies on the Geant4~\cite{geant4}, ROOT~\cite{root} and Eigen3~\cite{eigen3} libraries, that need to be installed and loaded before using \apsq.

The minimal, default installation can be installed by executing the commands below. More detailed installation instructions are found in Section \ref{sec:installation}.
\begin{verbatim}
$ git clone https://gitlab.cern.ch/simonspa/allpix-squared
$ cd allpix-squared
$ mkdir build && cd build/
$ cmake ..
$ make install
$ cd ..
\end{verbatim}
The binary can then be executed with the example configuration file as follows:
\begin{verbatim}
$ bin/allpix -c etc/example.conf
\end{verbatim}

Hereafter, the example configuration can be copied and adjusted to the needs of the user. This example contains a simple setup of two test detectors. It simulates the whole process from the passage of the beam, the deposition of charges in the detectors, the particle propagation and the conversion of the collected charges to digitized pixel hits. All the generated data is finally stored on disk for later analysis.

After this quick start it is very much recommended to read the other sections in more detail as well. For quickly solving common issues the Frequently Asked Questions in Section \ref{sec:faq} may be particularly useful.<commit_msg>doc: update Quick Start<commit_after>\section{Quick Start}
This chapter serves as a swift introduction to \apsq for users who prefer to start quickly and learn the details while simulating.
The typical user should skip the next paragraphs and continue reading Section \ref{sec:introduction} instead. 

\apsq is a generic simulation framework for pixel detectors.
It provides a modular, flexible and user-friendly structure for the simulation of independent detectors in the geometry.
The framework currently relies on the Geant4~\cite{geant4}, ROOT~\cite{root} and Eigen3~\cite{eigen3} libraries which need to be installed and loaded before using \apsq.

The minimal, default installation can be installed by executing the commands below.
More detailed installation instructions can be found in Section \ref{sec:installation}.

\begin{verbatim}
$ git clone https://gitlab.cern.ch/simonspa/allpix-squared
$ cd allpix-squared
$ mkdir build && cd build/
$ cmake ..
$ make install
$ cd ..
\end{verbatim}
The binary can then be executed with the provided example configuration file as follows:
\begin{verbatim}
$ bin/allpix -c etc/example.conf
\end{verbatim}

Hereafter, the example configuration can be copied and adjusted to the needs of the user.
This example contains a simple setup of two test detectors.
It simulates the whole process, starting from the passage of the beam, the deposition of charges in the detectors, the particle propagation and the conversion of the collected charges to digitized pixel hits.
All generated data is finally stored on disk on ROOT TTrees for later analysis.

After this quick start it is very much recommended to proceed to the other sections of this user manual.
For quickly resolving common issues, the \nameref{sec:faq} in Section \ref{sec:faq} may be particularly useful.
{'fraction_non_alphanumeric': 0.05425055928411633, 'fraction_numerical': 0.0022371364653243847, 'mean_word_length': 4.835236541598695, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3939313', 'n_tokens_mistral': 897, 'n_tokens_neox': 844, 'n_words': 491}