McStas logo McStas - A neutron ray-trace simulation package ILL; PSI; ESS Niels Bohr Institute DTU Physics NEXMAP


About McStas
 Conditions of use
 Project funding

 Other Downloads (share)

Mailing list

Search web/mailinglist

 Wiki (GitHub)
 McStas manual


Report bugs (GitHub)

Code-repository (GitHub)

McStas: MCPL_output

[ Identification | Description | Input parameters | Links ]

The MCPL_output Component

Detector-like component that writes neutron state parameters into an mcpl-format binary, virtual-source neutron file.


  • Site:
  • Author: Erik B Knudsen
  • Origin: DTU Physics
  • Date: Mar 2016


Detector-like component that writes neutron state parameters into an mcpl-format
binary, virtual-source neutron file.

MCPL is short for Monte Carlo Particle List, and is a new format for sharing events
between e.g. MCNP(X), Geant4 and McStas.

When used with MPI, the component will output #MPI nodes individual MCPL files that
can be merged using the mcpltool.

MCPL_output allows a few flags to tweak the output files:
1. If use_polarisation is unset (default) the polarisation vector will not be stored (saving space)
2. If doubleprec is unset (default) data will be stored as 32 bit floating points, effectively cutting the output file size in half.
3. Extra information may be attached to each ray in the form of a userflag, a user-defined variable wich is packed into 32 bits. If
the user variable does not fit in 32 bits the value will be truncated and likely garbage. If more than one variable is to be attached to
each neutron this must be packed into the 32 bits.

These features are set this way to keep file sizes as manageable as possible.


Input parameters

Parameters in boldface are required; the others are optional.
polarisationuse1Enable storing the polarisation state of the neutron.0
doubleprec1Use double precision storage0
verbose1If 1) Print summary information for created MCPL file. 2) Also print summary of first 10 particles information stored in the MCPL file. >2) Also print information for first 10 particles as they are being stored by McStas.0
userflag1Extra variable to attach to each neutron. The value of this variable will be packed into a 32 bit integer.""
filenamestrName of neutron file to write. If not given, the component name will be used.0
userflagcommentstrString variable to describe the userflag. If this string is empty (the default) no userflags will be stored.""
merge_mpi1Flag to indicate if output should be merged in case of MPI1
keep_mpi_unmerged1Flag to indicate if original unmerged mcpl-files should be kept (or deleted).0
buffermax1Maximal number of events to save ( <= MAXINT), GPU/OpenACC only0


[ Identification | Description | Input parameters | Links ]

Generated on 2023-09-19 20:01:36

Last Modified: Tuesday, 16-Apr-2024 20:05:20 CEST
Search website mailinglist archive GitHub repos