Parser arguments

Exactly one PWA application is provided for each individual reaction (e.g. pbarpReactionApp, epemReactionApp or .gammapReactionApp). The choice of the application mode, the definition of the decay trees and a lot of other parser options can be set by a configuration file. An example of such a configuration file can be found in the tutorial. All supported parser options are listed below:

Arguments required in the Command Line

The following arguments can not be used in the configuration file but only in the command line when running the respective application

Option Argument Description

-c

--configFile

{path/name} Path and or name of the main configuration file
--pbarpFiles {path/name} Path to configuration file for a pbarp reaction channel
--epemFiles {path/name} Path to configuration file for a e+ e- reaction channel
--ggFiles {path/name} Path to configuration file for a γ γ or central production reaction channel
--pipiScatteringFiles {path/name} Path to configuration file for scattering channel

Arguments to define the PWA model

Common

Option Arguments Description
addDynamics {particle} {dynamic} [argument1 ...] Adds a dynamic amplitude to the decay of a particle. Arguments have to be added for specific dynamics. When the K-matrix formalism is used a configuration file has to be given.
cloneParticle {particle1} {particle2} Create a new particle {particle2} in the particle table that has the same properties as particle {particle1}
decay {formalism} [noiso] {particle1} To {particle2} {particle3} Adds the decay of particle1 to the amplitude using a certain spin formalism. The [noiso] option is optional and disables isospin couplings
finalStateParticle {name} Name of one final state particle. The order of final state particles in the configuration file has to be the same as in the data/monte carlo files
production {particle1} {particle2} Adds the production of two particles to the amplitude
replaceParamSuffix {string1} {string2} Replace a part of a parameter name ({string1}) with {string2}. This option can be used to merge parameters.
replaceMassKey {particle name} {new name} Replace the name of a particle inside the Mass/Width parameter name. This option can be used to merge parameters.
useProductionBarrier {bool} {double) Enable or disable barrier factors for the production system and optioal an argument for setting th​e qR-barrier constant (default: 0.197) can be added
massRange {min} {max} {particle1} {particle2} ... {particleN} Set mass interval for the invariant mass of particle1 particle2 ... particleN
productionFormalism {string} Choose formalism for the production process: "Heli", "Cano" or "Tensor" are supported

Antiproton-Proton-Annihilation

Option Argument Description
lmax {value} Maximal contributing orbital antiproton-proton momentum
dropPbarpLForParticle {particle name} {value} Drop a pbarp L for certain particle
pbarmom {momentum in GeV} Anitiproton momentum in lab frame. Required for histogramming
spinDensity {particle name} Calculate spin density matrix elements of this particle

Other Arguments

General

Option Argument Description
datFile {path} Path to file containing data events
errLogMode {string} Choose mode for error logger: "debug", "trace", "routine", "warning", "error" and "alert" are supported.
mode {mode name} Set execution mode. See list of modes.
mcFile {path} Path to file containing monte carlo events
orderInFile {string1} {string2} {string3} {string4} Order of the 4-vector elements in input files: "Px Py Pz E" and "E Px Py Pz" are supported.
serializationFile {path} Path to serialization file (for qa, sdm modes)
name {string} Set a name that is attached to all output file names
noOfDataEvents {value} Set maximum number of data events for PWA- or QA-mode
paramFile {path} Path to file containing start parameters
pdgTableFile {path} Path of the pdg-table file, containing particle definitions and properties
preFactor {value} Set prefactor for an individual amplitude
ratioMcToData {value} Limit number of read monte carlo events by setting a ratio
unitInFile {string: GEV or MEV} Chosen unit in the ASCII input files
useEventWeight {bool} Read a (leading) weight for each set of four-vectors in the datFile (NOT mcFile currently)

Minimization

Option Argument Description
cacheAmps {bool} enable/disable caching of amplitudes
mnParFix {parameter name} Fix parameter
doScaling {bool} enable/disable pwa fit just for scaling (scaling parameter free; remaining parameter fixed)
contributionError {none} Calculate error of wave contribution in qa mode
evoIterations {int} Max number of iterations for evolutionary minimizer
evoPopulation {int} Population size for evolutionary minimizer
minimumTolerance {float} Sets the migrad tolerance argument

Histogramming

Option Argument Description
histAngles {particle name 1} from {particle name 1} {particle name 2} ... Create histogram of angles of particle 1 in the cms frame of (particle 1)+(particle 2)+...
histMass {particle name 1} {particle name 2} ... Create histogramm of the invariant mass of the specified particles

Options for the Client/Server-Mode

Option Argument Description
serverAddress {value} IP or hostname of server
serverPort {value} Port for server. Default is 22222
noOfClients {value} Number of clients the server expects

Options for Coupled Channel Mode

Option Argument Description
clientNumberWeights {weight channel 1} {weight channel 2} ... Weights to assign the number of clients to the respective channels. If the option is not given the clients are auto-assigned. The weights become normalized so "clientNumberWeights = 0.2 0.8" is the same as "clientNumberWeights = 5 20"

Options for Event Generator

Option Argument Description
generateWithModel {bool} use model or phasespace only
randomSeed {int} start seed for random generator
noOfGenEvents {int} number of events to be generated

Options for qaMode

Option Argument Description
serializationFile {path} The serialization file contains the covariance matrix of the pwa result. This file is needed for later error calculations.
contributionError {bool} Calculates the error of the total contribution and the individual contributions defined by the option "calcContribution". The --serializationFile argument needs to be set.
calcContribution {name} withZeroAmp {string} {string} ... Calculates the number of events for a part of the full amplitude (i.e. only for a certain resonance). This is done by setting all parameters that include {string} as a substring in their name to zero. The calculated contribution ist tagged with {name}.
saveContributionHistos {bool} Generates an additional root-File with histogramms for each contribution defined with the option "calcContribution" in the configuration file. The name of the rootfile is composed by the general option {name} and the {name} of the contribution as set in the calcContribution option.
JulianPychy - 03 Jul 2014
Topic revision: r13 - 2023-01-30, MeikeKuessner
Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki Send feedback | Imprint | Privacy Policy (in German)