[ Identification | Description | Input parameters | Links ]

The MCViNE_DGSSXRes Component

Resolution kernel for direct-geometry single-crystal spectrometers (aims at a pixel and TOF window).

Identification

Description

Scatters towards a target disk (position target_x/y/z or target_index, radius
focus_r) and picks the arrival time at the target uniformly in
tof_at_target +/- dtof/2 (absolute neutron time, s). The final speed follows
from the flight distance. Weight: solid_angle/4pi * dtof * dE/dt * vf/vi, as in
MCViNE. Record ki/kf with monitors to build the resolution ellipsoid (similar
in purpose to McStas' TOFRes_sample, with MCViNE's weighting).

Transport (same as MCViNE HomogeneousNeutronScatterer): on the first
passage the neutron is forced to scatter at a uniformly chosen depth, weighted
by path length, attenuation exp(-(mu+sigma)x) and the scattering coefficient;
on exit it is attenuated by exp(-(mu+sigma)L_out). With order>1 further
scatterings are sampled analogically (truncated exponential). With
p_transmit>0 that fraction of events is kept as the attenuated direct beam.
mu(v) = absorption_coefficient*2200/v. Events for which the kernel cannot
scatter (kinematically forbidden) are absorbed.

Geometry: box (xwidth,yheight,zdepth), cylinder (radius,yheight), hollow
cylinder (+thickness) or sphere (radius only). All vectors (Q, targets,
reciprocal vectors, atom positions) are in the component's local frame.

Uses the shared runtime share/mcvine-lib.h/.c.

Example: MCViNE_DGSSXRes(target_index=2, focus_r=0.0125, tof_at_target=0.0052, dtof=1e-5, scattering_coefficient=10, xwidth=0.01, yheight=0.01, zdepth=0.01)

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
target_xmTarget position (component frame) x0
target_ymTarget position y0
target_zmTarget position z0
target_index1Relative index of a component to aim at (overrides target_x/y/z when non-zero)0
focus_rmRadius of the target disk0.01
tof_at_targetsDesired absolute time of arrival at the target0.001
dtofsWidth of the time window1e-5
absorption_coefficientm^-1Absorption coefficient at 2200 m/s (MCViNE convention; scales as 1/v)0
scattering_coefficientm^-1Scattering coefficient0
sigma_absbarnAlternative: absorption cross section per unit cell at 2200 m/s (used when Vc>0)0
sigma_scatbarnAlternative: scattering cross section per unit cell (used when Vc>0)0
VcAA^3Unit cell volume; when >0, coefficients are computed from sigma_abs, sigma_scat0
radiusmOuter radius of a cylinder (with yheight) or of a sphere (yheight=0)0
xwidthmWidth of a box sample0
yheightmHeight of a box or cylinder sample0
zdepthmDepth of a box sample0
thicknessmWall thickness of a hollow cylinder (0: filled)0
pack1Packing factor (scales absorption and scattering coefficients)1
p_transmit1Monte Carlo fraction of events kept as unscattered transmitted beam (0: always scatter)0
order1Maximum number of scattering events per neutron (1: single scattering)1
AT ( , , ) RELATIVE
ROTATED ( , , ) RELATIVE

Links


[ Identification | Description | Examples | Input parameters | Links ]

Generated on mcstas 3.9.2