From ec5340986943a4d3120d2f657fa3b032f072f2c8 Mon Sep 17 00:00:00 2001 From: Juraj Smiesko Date: Wed, 26 Nov 2025 16:15:26 +0100 Subject: [PATCH] Version bump of the packages + minor updates --- CONTRIBUTING.md | 1 - .../FccFastSimVertexing/Readme.md | 3 +- .../starterkit/FccFastSimDelphes/Readme.md | 39 ++++++++++++++----- requirements.txt | 6 +-- 4 files changed, 34 insertions(+), 15 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1737835e9..c8d777cbb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -80,7 +80,6 @@ sphinx-build -b html . build Start a web server to host the generated files from `build` directory ```bash -cd build python -m http.server -d build ``` diff --git a/fast-sim-and-analysis/FccFastSimVertexing/Readme.md b/fast-sim-and-analysis/FccFastSimVertexing/Readme.md index 93e1b0ce2..05ec17fb8 100644 --- a/fast-sim-and-analysis/FccFastSimVertexing/Readme.md +++ b/fast-sim-and-analysis/FccFastSimVertexing/Readme.md @@ -1,8 +1,7 @@ # Tracking and vertexing example using specific flavour decays > -> Original authors: Emmanuel Francois Perez, Clement Helsens -> Edited by: Juraj Smiesko +> Original authors: Emmanuel Francois Perez, Clement Helsens > diff --git a/fast-sim-and-analysis/k4simdelphes/doc/starterkit/FccFastSimDelphes/Readme.md b/fast-sim-and-analysis/k4simdelphes/doc/starterkit/FccFastSimDelphes/Readme.md index d9b088442..5005468cd 100644 --- a/fast-sim-and-analysis/k4simdelphes/doc/starterkit/FccFastSimDelphes/Readme.md +++ b/fast-sim-and-analysis/k4simdelphes/doc/starterkit/FccFastSimDelphes/Readme.md @@ -113,12 +113,21 @@ DelphesPythia8_EDM4HEP card_IDEA.tcl edm4hep_IDEA.tcl p8_ee_WW_ecm240.cmd p8_ee_ ## Sample Generation: Pythia8 + EvtGen -Author: Vasilisa Guliaeva - - -This part explains how to produce FCC-ee samples with **Pythia8** and [**EvtGen**](https://evtgen.hepforge.org), using the standard FCC configuration files and **EDM4hep** output format. - -**EvtGen** is a decay generator specialized in the simulation of hadronic decays of heavy-flavour particles with accurate angular correlations and form-factor models. **EvtGen** is interfaced to [**Pythia8**](https://github.com/HEP-FCC/k4Gen/blob/main/k4Gen/src/components/PythiaInterface.h#L88-L97) through **k4Gen**, so that events generated by **Pythia** can be decayed by **EvtGen** before detector simulation. +> +> Author: Vasilisa Guliaeva +> + +This part explains how to produce FCC-ee samples with +[**Pythia8**](https://pythia.org/) and +[**EvtGen**](https://evtgen.hepforge.org), using the standard FCC configuration +files and **EDM4hep** output format. + +[**EvtGen**](https://evtgen.hepforge.org/) is a decay generator specialized in +the simulation of hadronic decays of heavy-flavour particles with accurate +angular correlations and form-factor models. **EvtGen** is interfaced to +[**Pythia8**](https://github.com/HEP-FCC/k4Gen/blob/main/k4Gen/src/components/PythiaInterface.h#L88-L97) +through **k4Gen**, so that events generated by **Pythia** can be decayed by +**EvtGen** before detector simulation. We will generate a Monte Carlo sample of 1'000 events, matching the `winter2023` MC campaign, for $e^{+} e^{-} \;\rightarrow\; Z \;\rightarrow\; b\bar{b} \;\rightarrow\; B^{+} \;\rightarrow\; \tau^{+} \nu_{\tau} \;\rightarrow\; 3\pi$. All standard configuration files for FCC-ee Monte Carlo campaigns are provided in the [FCC-config repository (winter2023 branch)](https://github.com/HEP-FCC/FCC-config/tree/winter2023). @@ -133,8 +142,12 @@ Since the EDM4hep output card that maps Delphes collections into EDM4hep data st ```bash source /cvmfs/sw.hsf.org/spackages6/key4hep-stack/2022-12-23/x86_64-centos7-gcc11.2.0-opt/ll3gi/setup.sh ``` + **Event generation** -To generate events with Pythia8 + EvtGen, use the executable `DelphesPythia8EvtGen_EDM4HEP_k4Interface`. Make sure your FCC software setup is actually working in correct enviroment. You can check this by running: + +To generate events with Pythia8 + EvtGen, use the executable +`DelphesPythia8EvtGen_EDM4HEP_k4Interface`. Make sure your shell environment is +correctly set up by running: ```bash which DelphesPythia8EvtGen_EDM4HEP_k4Interface ``` @@ -143,11 +156,18 @@ For our stack output should be: /cvmfs/sw.hsf.org/spackages6/k4simdelphes/00-03-00/x86_64-centos7-gcc11.2.0-opt/pqqvt/bin/DelphesPythia8EvtGen_EDM4HEP_k4Interface ``` -The executable wrapper that connects Pythia8, EvtGen, and Delphes, and writes output in EDM4hep format. You can inspect its expected argument order by running: +The executable wrapper that connects Pythia8, EvtGen, and Delphes, and writes +output in EDM4hep format. You can inspect its expected argument order by +running: ```bash DelphesPythia8EvtGen_EDM4HEP_k4Interface -h ``` -it will display the following output: + +:::{admonition} `DelphesPythia8EvtGen_EDM4HEP_k4Interface` CLI arguments +:class: callout toggle + +The `DelphesPythia8EvtGen_EDM4HEP_k4Interface` takes the following CLI +arguments. ``` Usage: DelphesPythia8EvtGenconfig_file output_config_file pythia_card output_file DECAY.DEC evt.pdl user.dec @@ -160,6 +180,7 @@ DECAY.DEC - EvtGen full decay file, evt.pdl - EvtGen particle list, user.dec - EvtGen user decay file. ``` +::: To start the sample generation, we need to download the configuration files. diff --git a/requirements.txt b/requirements.txt index 03f56464f..aa82305e3 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,6 +1,6 @@ -Sphinx==7.3.7 -myst-parser==3.0.0 -sphinx-rtd-theme==2.0.0 +Sphinx==7.4.7 +myst-parser==3.0.1 +sphinx-rtd-theme==3.0.2 sphinx-togglebutton==0.3.2 sphinx-copybutton==0.5.2 sphinx-multiversion==0.2.4