Project

General

Profile

GENIE Configuration Files

GENIE is configured primarily via values in XML files. The two files most commonly modified by users are: UserPhysicsOptions.xml and EventGeneratorListAssembler.xml. The first allows changing underlying model choices and their parameters, while the second is used for asssembling collections of models into a unified set to be run together. It is critical that the user assure consistency between these files and any cross-section splines that are being used.

Quick Guide to UPS genie_xsec splines and EventGeneratorList fcl parameters

GENIE
code version
genie releases
genie_xsec EventGeneratorList
fcl parameter
interpretation
version qualifier
v2_12_10
.
(please check
release notes
for compatibility)
v2_12_10
(see further
info
)
DefaultPlusMECWithNC Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+CCMEC+NCMEC w/ CC+NC Dytman MEC
DefaultPlusValenciaMEC Default+CCMEC Like DefaultPlusMECWithNC but
but Valencia CC-MEC (NievesSimoVacasMEC)
EffSFTEM Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMEC Default+CCMEC Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
AltPion Default Use BergerSehgal instead of ReinSehgal
+ add in DFR-CC & DFR-NC
ValenciaQEBergerSehgalCOHRES Default LocalFGM + BergerSehgal (replace ReinSehgal)
Default+CCMEC add CC-MEC (NievesSimoVacasMEC)
Default+CCMEC+1K also add single Kaon
v2_12_8
.
(please check
release notes
for compatibility)
v2_12_8
(see further
info
)
DefaultPlusMECWithNC Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+CCMEC+NCMEC w/ CC+NC Dytman MEC
DefaultPlusValenciaMEC Default+CCMEC Like DefaultPlusMECWithNC but
but Valencia CC-MEC (NievesSimoVacasMEC)
EffSFTEM Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMEC Default+CCMEC Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
AltPion Default Use BergerSehgal instead of ReinSehgal
+ add in DFR-CC & DFR-NC
ValenciaQEBergerSehgalCOHRES Default LocalFGM + BergerSehgal (replace ReinSehgal)
Default+CCMEC add CC-MEC (NievesSimoVacasMEC)
Default+CCMEC+1K also add single Kaon
v2_12_6
.
(please check
release notes
for compatibility)
v2_12_6
(see further
info
)
DefaultPlusMECWithNC Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+CCMEC+NCMEC
( not Default+MEC )
w/ CC+NC Dytman MEC
DefaultPlusValenciaMEC Default+CCMEC Like DefaultPlusMECWithNC but
but Valencia CC-MEC (NievesSimoVacasMEC)
EffSFTEM Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMEC Default+CCMEC
( not Default+MEC)
Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
AltPion Default Use BergerSehgal instead of ReinSehgal
+ add in DFR-CC & DFR-NC
ValenciaQEBergerSehgalCOHRES Default LocalFGM + BergerSehgal (replace ReinSehgal)
Default+CCMEC
( not Default+MEC )
add CC-MEC (NievesSimoVacasMEC)
Default+CCMEC+1K
( not Default+MEC+1K )
also add single Kaon
v2_12_0
or
v2_12_2
or
v2_12_4
.
(please check
release notes
for compatibility)
v2_12_0
(see further
info
)
DefaultPlusMECWithNC Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+MEC w/ CC+NC Dytman MEC
CCPlusMecPlusNueEl CCinclMEC+NueEl Like DefaultPlusMECWithNC but
add EventGeneratorList CCinclMEC+NueEl
EffSFTEM Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMEC Default+MEC Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
AltPion Default Use BergerSehgal instead of ReinSehgal
+ add in DFR-CC & DFR-NC
ValenciaQEBergerSehgalCOHRES Default LocalFGM + BergerSehgal (replace ReinSehgal)
Default+MEC add CC-MEC (NievesSimoVacasMEC)
Default+MEC+1K also add single Kaon
v2_11_2 v2_11_2
(see further
info
)
DefaultPlusMECWithNCHadWFix
(implicit UseOldByScaleVar)
Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+MEC w/ CC+NC Dytman MEC
EffSFTEMHadWFix
(implicit UseOldByScaleVar)
Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMECDiNucOffHadWFix
(implicit UseOldByScaleVar)
Default+MEC Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
any without HadWFix
- (not ideal, wrong KNO to Pythia6
transition in W (ie. KNO only) during
event generation )
Nieves without DiNucOff
- Nieves won't run without associated
SetDiNucleonCode set to false
v2_11_0 v2_11_0
(see further
info
)
DefaultPlusMECWithNCUseOldBYScaleVar Default no MEC
Default+CCMEC w/ CC-only Dytman MEC
Default+MEC w/ CC+NC Dytman MEC
EffSFTEMUseOldByScaleVar Default Effective Structure Function
(replace FGMBodekRitchie)
+ Transverse Enhancement Model
LocalFGNievesQEAndMECUseOldByScaleVar Default+MEC Local Fermi Gas
+ Nieves (Valencia) Model for QE & CC MEC
any without UseOldByScaleVar - in general don't use these
wrong DISSF- flag settings
v2_10_{6,8,10} v2_10_6 defaultplusccmec Default no MEC
DefaultPlusCCMEC w/ Dytman CC MEC
tuned params
v2_10_6a defaultplusccmec either same as non-"a", but more isotopes
v2_10_2 v2_10_2 default Default no MEC
defaultplusccmec Default equivalent t above,
no MEC
DefaultPlusCCMEC w/ Dytman CC MEC
but w/ rollover, no params
v2_8_* v2_8_4 default Default twas what it was

UserPhysicsOptions.xml

This is where (user adjustable) parameters for individual models get set, and for some cases model choices are made.

EventGeneratorListAssembler.xml

Event Types (EventGeneratorList)

Note: For all versions of GENIEHelper tied to versions of GENIE R-2_8_0 and beyond, the collection of event types to generate is configured by the fcl parameter entry EventGeneratorList.

In most cases it is best to stick with Default (which is the default), though choices given in the above table are good alternatives.

Normally GENIE will generate the correct relative proportions of various event types (NC vs. CC, QE vs. DIS, etc). One can override this using the EventGeneratorList value (default is "Default"). In general the lead developer for GENIE discourages this approach for picking sub-processes because it selects only at the basic interaction level. After the initial interaction, effects such as intra-nuclear scattering can cause the event structure as it leaves the initial nucleus to appear different from what was selected. Also the transition from one type to another (e.g. resonance to DIS) is not particularly well defined and it really is only the aggregate that can be modelled. Nevertheless the allowed values are:

Default
AnomalyMediatedNuGamma
UHE
GLRES
CCQE+CCMEC
CCMEC
DFR
Charm
CharmCCDIS
CharmCCQE
IMD
NuEElastic
NuE
QE
CCQE
NCEL
RES
CCRES
NCRES
COH
CCCOH
NCCOH
DIS
CCDIS
NCDIS
NC
CC
( CC+CCMEC )
EMQE
EMRES
EMDIS
EM
HadronizationTest

This note here is not meant to describe the intent of each type, though generally it can be guessed from the name. The definitive list of allowed values can be found from the param_set names in the file $GENIE/config/EventGeneratorListAssembler.xml.