[ Identification | Description | Input parameters | Links ]

The MCViNE_Phonon_CoherentInelastic_SingleXtal Component

Coherent one-phonon scattering from a single crystal, using a full phonon dispersion on a grid.

Identification

Description

Single-crystal coherent one-phonon scattering with dispersion and polarization
vectors from MCViNE IDF files (periodic over the reciprocal cell b1,b2,b3 given
in Qgridinfo; orient the crystal by rotating the component). For a final
direction (4pi, or a cone towards a target when focus_r>0) and a random
branch among those with Emin < 1.5 Ei, all final speeds solving
omega(Q) = |Ei-Ef| are found (Ridders' method on nsteps sub-intervals of
[0,2vi]); one is chosen and weighted by the delta-function Jacobian,
|sum_d b_d/sqrt(M_d) exp(iQ.d)(Q.e_d)|^2, Bose and Debye-Waller factors.

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_Phonon_CoherentInelastic_SingleXtal(idf_dir="MCViNE/fcc_toy_phonons", atoms="MCViNE/fcc_toy_atoms.dat", T=300, xwidth=0.01, yheight=0.01, zdepth=0.01)

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
idf_dirstrDirectory with MCViNE IDF phonon files: Qgridinfo, Omega2, Polarizations[, DOS]0
atomsstrAtoms file: one row per atom 'x y z mass b_coh sigma_inc sigma_abs' ([AA] cartesian, [amu], [fm], [barn], [barn]), same order as in the IDF files0
TKTemperature300
dw_coreAA^2Debye-Waller core; <0: computed from the DOS (idf_dir/DOS or dos)-1
dosstrOptional DOS file for the Debye-Waller factor (default: idf_dir/DOS)0
VcAA^3Unit cell volume; 0: (2pi)^3/|b1.(b2 x b3)| from Qgridinfo0
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 disk; 0: scatter into 4pi (MCViNE default)0
deltaV_Jacobi1Relative velocity step for the numerical Jacobian0.001
nsteps1Sub-intervals for the root search in vf100
xaccm/sRoot accuracy in vf10
unbiased10: MCViNE sampling (retries up to 100 direction/branch draws until omega(Q)=|Ei-Ef| has a solution, without correcting the weight: over-estimates when many directions have no solution). 1: single attempt, unbiased0
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