From 3c599556b52193f809a28e2ccb10826658d5068f Mon Sep 17 00:00:00 2001 From: Brieuc Francois Date: Wed, 20 Mar 2024 13:30:29 +0100 Subject: [PATCH] Mit tutorial: first step (#142) * First push for the MIT tutorial * Replace deprecated tutorials --- .../FCCeeGeneralOverview.md | 84 +++++++++++++++++++ full-detector-simulations/README.md | 9 +- 2 files changed, 86 insertions(+), 7 deletions(-) create mode 100644 full-detector-simulations/FCCeeGeneralOverview/FCCeeGeneralOverview.md diff --git a/full-detector-simulations/FCCeeGeneralOverview/FCCeeGeneralOverview.md b/full-detector-simulations/FCCeeGeneralOverview/FCCeeGeneralOverview.md new file mode 100644 index 00000000..ead4a927 --- /dev/null +++ b/full-detector-simulations/FCCeeGeneralOverview/FCCeeGeneralOverview.md @@ -0,0 +1,84 @@ +# FCC-ee Full Sim General Overview + + + +Welcome to this general overview of the FCC-ee Full Simulation. +This tutorial aims at showing you how to run the state of the art full simulation of the various detector concepts currently under study for FCC-ee: CLD, ALLEGRO and IDEA. The DD4hep geometry descriptions of these detectors are hosted in the [k4geo](https://github.com/key4hep/k4geo/tree/main/FCCee) GitHub repository and made centrally available with the Key4hep stack under the `$K4GEO` environment variable. + + + +So, let's start playing with Full Sim! + +## Towards Full Sim physics analyses with CLD + +The CLD detector has a complete geometry description and reconstruction chain. It is thus a very good candidate to start full sim physics analyses. To illustrate that, we will process some physics events through its Geant4 simulation and reconstruction, look at automatically generated diagnostic plots and produce ourselves a higher level quantity plot. + +### Running CLD simulation + +Let's first run the CLD Geant4 simulation, through ddsim, for some e+e- → + + + +```bash +source /cvmfs/sw-nightlies.hsf.org/key4hep/setup.sh + +``` + +### Running CLD reconstruction + +Inspect the ROOT file content with + + + +``` +podio-dump wzp6_ee_mumuH_ecm240_edm4hep_recoed_edm4hep.root +``` + +### Analyzing the output + +Let's now use the reconstructed sample to produce some physics quantities. + +TOBEWRITTEN + +If we had to analyze a large amount of events we would of course use FCCAnalyses or plain C++. + +For a realistic analysis you would also need to access much more information than what is shown here. To understand what member can be called on a given edm4hep object, you can use this [Doxygen page](https://edm4hep.web.cern.ch/classedm4hep_1_1_reconstructed_particle-members.html) + +## Optimizing a detector with Full Sim + + +## Running IDEA simulation with detailed Drift Chamber + + +## Detector visualization + +Displaying detector geometries is very useful to understand what is actually being simulated without having to enter the code. One example of tool (out of many) is described here, chosen for its simplicity together with the particular feature of hosting the needed data locally, leading to smooth performance of the visualization. + +Let's first generate the files containing the geometry that will be used by the display tool. + +```bash +# connect to a machine with cvmfs mounted +source /cvmfs/sw-nightlies.hsf.org/key4hep/setup.sh +wget https://fccsw.web.cern.ch/fccsw/tutorials/static/python/dd4hep2root +chmod +x dd4hep2root +./dd4hep2root -c $K4GEO/FCCee/CLD/compact/CLD_o2_v05/CLD_o2_v05.xml -o CLD_o2_v05_geom.root +echo $PWD/CLD_o2_v05_geom.root +``` + +Now, let's copy the file containing the geometry on your local machine: + +``` +scp USERNAME@HOSTNAME:ABSOLUTE_PATH_TO_GEOMETRY . +``` + +Load the file from your computer with the triple-dot button of this webpage: https://root.cern/js/latest/ . + +From there, you can navigate the geometry hierarchy to see how volumes are nested, display all or parts of the detector (right click on a volume > Draw > all), play with the camera settings (right click on an empty space in the display window > Show Controls, Clipping > Enable X and Enable Y), etc. See the following picture for illustration: + +```{image} https://fccsw.web.cern.ch/fccsw/tutorials/MIT2024/pictures/JSROOT_Screenshot.png +:align: center +``` + +This tool is useful but not perfect and will not meet all the needs (especially if you want to overlay a physics event). To go further, other solutions are described in the dedicated [Visualization](https://hep-fcc.github.io/fcc-tutorials/master/full-detector-simulations/Visualization/Visualization.html) tutorial. + + diff --git a/full-detector-simulations/README.md b/full-detector-simulations/README.md index b6ae73e7..4f1fde1f 100644 --- a/full-detector-simulations/README.md +++ b/full-detector-simulations/README.md @@ -13,14 +13,9 @@ If you have any problems or questions, you can .. toctree:: :caption: Contents: - FCCeeCLD/FCCeeCLD.md - FCCeeDriftChamber/FCCeeDriftChamber.md + FCCeeGeneralOverview/FCCeeGeneralOverview.md FCCeeGuineaPigIRBackgrounds/README.md - - FccCaloPerformance/CaloFullSimExercise.md - FCCeeCaloPhotonPi0Discrimination/FCCeeCaloPhotonPi0Discrimination.md - Geometry/Geometry.md Visualization/Visualization.md - + ```