McXtrace logo

McXtrace - An X-ray ray-trace simulation package

Synchrotron SOLEIL DTU Physics

McXtrace

About McXtrace
 Publications
 Project Partners
 Project People
 Goal

Download
 Components

Documentation
 Manual
 Commands
 Wiki (GitHub)
 Tutorial

Mailing list

Links

Search

Code-repository (GitHub)

Report bugs (GitHub)


McStas: Single_crystal

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

The Single_crystal Component

Release: McXtrace 1.5 Mosaic single crystal with multiple scattering vectors, optimised for speed with large crystals and many reflections.

Identification

  • Site:
  • Author: Kristian Nielsen
  • Origin: Risoe
  • Date: December 1999

Description

Single crystal with mosaic. Delta-D/D option for finite-size effects.
Rectangular geometry. Multiple scattering and secondary extinction included.
The mosaic may EITHER be specified isotropic by setting the mosaic input
parameter, OR anisotropic by setting the mosaic_a, mosaic_b, and mosaic_c
parameters.
The crystal lattice can be bent locally, keeping the external geometry unchanged.
Curvature is spherical along vertical and horizontal axes.

Speed/stat optimisation using SPLIT
In order to dramatically improve the simulation efficiency, we recommend to
use a SPLIT keyword on this component (or prior to it), as well as to disable
the multiple scattering handling by setting order=1. This is especially powerful
for large reflection lists such as with macromolecular proteins. When an incoming
particle is identical to the preceeding, reciprocal space initialisation is
skipped, and a Monte Carlo choice is done on available reflections from the last
repciprocal space calculation! To assist the user in choosing a "relevant" value
of the SPLIT, a rolling average of the number of available reflections is
calculated and presented in the component output.

Mosacitiy modes:
The component features three independent ways of parametrising mosaicity:
a) The original algorithm where mosaicity is implemented by extending each
reflection by a Gaussian "cigar" in reciprocal space, characterised by
the parameters mosaic and delta_d_d.
(Also known as "isotropic mosaicity".)
b) A similar mode where mosaicities can be non-isotropic and given as the
parameters mosaic_a, mosaic_b and mosaic_c, around the unit cell axes.
(Also known as "anisotropic mosaicity".)
c) Given two "macroscopically"/experimentally measured width/mosaicities
of two independent reflections, parametrised by the list
mosaic_AB = {mos_a, mos_b, a_h, a_k, a_l, b_h, b_k, b_l}, a set of
microscopic mosaicities as in b) are estimated (internally) and applied.
(Also known as "phenomenological mosaicity".)


Sample shape:
Sample shape may be a cylinder, a sphere, a box or any other shape
box/plate:       xwidth x yheight x zdepth
cylinder:        radius x yheight
sphere:          radius (yheight=0)
any shape:       geometry=OFF file

The complex geometry option handles any closed non-convex polyhedra.
It computes the intersection points of the x-ray with the object
transparently, so that it can be used like a regular sample object.
It supports the OFF and NOFF file format but not COFF (colored faces).
Such files may be generated from XYZ data using:
qhull < coordinates.xyz Qx Qv Tv o > geomview.off
or
powercrust coordinates.xyz
and viewed with geomview or java -jar jroff.jar (see below).
The default size of the object depends on the OFF file data, but its
bounding box may be resized using xwidth,yheight and zdepth.

Crystal definition file format
Crystal structure is specified with an ascii data file. Each line contains
4 or more numbers, separated by white spaces:

h k l ... F2

The first three numbers are the (h,k,l) indices of the reciprocal lattice
point, and the 7-th number is the value of the structure factor |F|**2, in
barns. The rest of the numbers are not used; the file is in the format
output by the Crystallographica program.
The reflection list should be ordered by decreasing d-spacing values.
Lines begining by '#' are read as comments (ignored). Most sample parameters
may be defined from the data file header, following the same mechanism as
PowderN.

Current data file header keywords include, for data format specification:
#column_h 
#column_k 
#column_l 
#column_F2 
#column_F  
and for material specification:
#sigma_abs 
#sigma_inc 
#Delta_d/d 
#lattice_a 
#lattice_b 
#lattice_c 
#lattice_aa 
#lattice_bb 
#lattice_cc 

See the Component Manual for more defails.

Example: Single_crystal(xwidth=0.01, yheight=0.01, zdepth=0.01,
delta_d_d=1e-4, mosaic = 5,
ax = 3.8186, ay = 0, az = 0,
bx = 0, by = 3.8843, bz = 0,
cx = 0, cy = 0, cz = 11.6777,
reflections="YBaCuO.lau")

Vanadium incoherent elastic scattering with multiple scattering
Single_crystal(xwidth=0.01, yheight=0.01, zdepth=0.01,
reflections="", sigma_abs=5.08, sigma_inc=4.935,
ax=3.0282, by=3.0282, cz=3.0282/2)

Also, always use a non-zero value of delta_d_d.

%VALIDATION:
This component is undergoing validation.

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
reflectionsstrFile name containing structure factors of reflections. Use empty ("") or "NULL" for incoherent scattering only0
string geometry0
vector mosaic_AB{0,0, 0,0,0, 0,0,0}
string material0
xwidth0
yheight0
zdepth0
radius0
delta_d_d1e-4
mosaic-1
mosaic_a-1
mosaic_b-1
mosaic_c-1
recip_cell0
barns0
ax0
ay0
az0
bx0
by0
bz0
cx0
cy0
cz0
p_transmit-1
sigma_abs0
sigma_inc0
aa0
bb0
cc0

Output parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault

Links

  • Source code for Single_crystal.comp.
  • See ICSD powder diffraction data base
  • Fullprof powder refinement: http://www.ill.eu/sites/fullprof/index.html
  • Crystallographica software: http://www.crystallographica.com/
  • Geomview and Object File Format (OFF)
  • Java version of Geomview (display only) jroff.jar
  • Powercrust/qhull

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

Generated on 2022-02-07 20:46:44


Last Modified: Wednesday, 11-May-2022 22:46:12 CEST
Search website mailinglist archive GitHub repos