You're reading the documentation for a development version.
For the latest released version, please have a look at v0.5.1.

7. Biasing commands#

Macro commands related to microscopic cross-section (XS) biasing of particle interactions.

Warning

When biasing is used, the simulation becomes a non-analog Monte Carlo simulation! Use with caution, since (over-)biasing can distort the results and lead to wrong conclusions!

Macro command

Type

M?

Description

Example values

Default value

/SEE/biasing/biasParticle

string

n

Particle name to apply XS biasing for

proton, neutron, alpha, gamma, etc.

-

/SEE/biasing/biasProcess

string

n

Particle process name to be biased, can be used multiple times after biasParticle command

protonInelastic, hadElastic, etc.

-

/SEE/biasing/biasFactor

double

n

XS bias weight factor per particle (>0.)

1000

-

/SEE/biasing/biasNonPrimariesToo

bool

n

Apply XS bias for non-primary particles as well, by default only primary processes are biased

true

false

  • Multiple processes of particle species can be biased by using /SEE/biasing/biasProcess multiple times after the /SEE/biasing/biasParticle

  • By default, only primary particles are biased

  • For biasing particles that are non-primary particles, enable this by the /SEE/biasing/biasNonPrimariesToo command

  • Multiple particle species can be also biased by using a biasParticle command per each particle, and then the related biasProcess to define at least one process, plus the biasNonPrimariesToo is needed too

The Standard Scoring output histograms always contain the bias weight corrected data, so there is nothing to do with these histograms from a biasing point of view. The Detailed Scoring Hits output data is not corrected, however contains the inverse biasing weight of each particle and event in separate column (weight), which is equals to 1, when XS biasing is not used. For more, see Output Files.