# Welcome to the LFHCal TB tutorial

This page is meant to make you familiar with the setup of the LFHCal test beams executed during the last years, prepare you for upcoming test beams in terms of setting up the HGCROC readout as well as allowing you to simulate our test beam geometry using the central epic-software framework. 

This page is divided in multiple sections:

* [HGCROC SETUP - TEST BEAM ](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam):
  * This section walks you through how to setup the [HGCROC-protoboards ](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam/setting-up-the-hgcroc-board)and the [DAQ computer](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam/setting-up-daq-pc). Moreover, it explains how to [setup and calibrate the HGCROC](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam/getting-started-hgcroc-and-calibrations) prior to data taking and explains how to [take data](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam/data-taking-hgcroc) using this setup. Last but not least it gives an introduction on how to [convert the HGCROC data to a root](https://friederikebock.gitbook.io/epiclfhcaltb-ana/hgcroc-setup-test-beam/data-decoding-10g) readable format in a standalone way.
* [TB ANALYSIS BASICS](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-analysis-basics):
  * This section gives an overview where to find the TB-analysis package and how to install it [(link)](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-analysis-basics/tb-analysis-basics). It explains how to [get access to the data](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-analysis-basics/getting-the-data) from the different campaigns, their initial data format and [how to convert](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-analysis-basics/converting-the-data) it to a root readable format compatible with the analysis software laid out in the following sections. Moreover, it explains how the electronics channel numbering relates to the physical space and how to [build the nessesary mapping files](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-analysis-basics/creating-a-mapping-file) to do this correctly.
* [CALIBRATION](https://friederikebock.gitbook.io/epiclfhcaltb-ana/calibration)
  * The calibration section explains the process necessary to get from raw TB data to a calibrated output which can be used for physics performance studies. The current steps described are:

    * The [pedestal extraction](https://friederikebock.gitbook.io/epiclfhcaltb-ana/calibration/pedestal-extraction)
    * The [TOA Phase extraction](https://friederikebock.gitbook.io/epiclfhcaltb-ana/calibration/toa-phase-extraction) (HGCROC data only)
    * The [MIP calibration](https://friederikebock.gitbook.io/epiclfhcaltb-ana/calibration/mip-calibration)

    It is also explained how the corresponding calibrations are then applied to the data ([link](https://friederikebock.gitbook.io/epiclfhcaltb-ana/calibration/apply-calibrations)). 
* [DATA ANALYSIS](https://friederikebock.gitbook.io/epiclfhcaltb-ana/data-analysis)
  * This sections explains the initial software prepared for the [basic QA of the data](https://friederikebock.gitbook.io/epiclfhcaltb-ana/data-analysis/basic-qa-of-calibrated-data) as well as a very simple version of an [event display](https://friederikebock.gitbook.io/epiclfhcaltb-ana/data-analysis/simple-event-display).
* [COMPARISONS](https://friederikebock.gitbook.io/epiclfhcaltb-ana/comparisons)
  * This section explains the initial software prepared to do comparisons of multiple runs regarding their calibration objects as well as initial data content [(link)](https://friederikebock.gitbook.io/epiclfhcaltb-ana/comparisons/compare-calibrations). 
* [TB SIMULATIONS](https://friederikebock.gitbook.io/epiclfhcaltb-ana/tb-simulations)
  * This section is meant to explain how to setup the simulation of the TB geometry and emulate the respective readout versions. It is currently significantly under construction. 
* [OLDER SOFTWARE](https://friederikebock.gitbook.io/epiclfhcaltb-ana/older-software)
  * In this section the initial software for the analysis prior to 2024 is described, which might serve as basis for some extensions regarding the single photon peak extraction for instance.