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: PowderN

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

The PowderN Component

General powder sample (N lines, single scattering, incoherent scattering)

Identification

  • Site:
  • Author: P. Willendrup, L. Chapon, K. Lefmann, A.B.Abrahamsen, N.B.Christensen, E.M.Lauridsen.
  • Origin: McXtrace release 1.2
  • Date: 4.2.98

Description

General powder sample with
many scattering vectors
possibility for intrinsic line broadening
incoherent background ratio is computed from material datafile.
No multiple scattering. No secondary extinction.

Based on Powder1/Powder2/Single_crystal.
Geometry is a powder filled cylinder, sphere, box or any shape from an OFF file.
Incoherent scattering is only provided here to account for a background.
The efficient is highly improved when restricting the vertical scattering
range on the Debye-Scherrer cone (with 'd_phi' and 'focus_flip').
The unit cell volume Vc may also be computed when giving the density,
the atomic/molecular weight and the number of atoms per unit cell.

Sample shape:
Sample shape may be a cylinder, a sphere, a box or any other shape.
box/plate:       xwidth x yheight x zdepth (thickness=0)
hollow box/plate:xwidth x yheight x zdepth and thickness>0
cylinder:        radius x yheight (thickness=0)
hollow cylinder: radius x yheight and thickness>0
sphere:          radius (yheight=0 thickness=0)
hollow sphere:   radius and thickness>0 (yheight=0)
any shape:       geometry=OFF_file

The complex geometry option handles any closed non-convex polyhedra.
It computes the intersection points of the xray with the object
transparently, so that it can be used like a regular sample object.
It supports the PLY, 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 of the OFF file data, but its
bounding box may be resized using xwidth,yheight and zdepth.

If you use this component and produce valuable scientific results, please
cite authors with references bellow (in Links).

Example: PowderN(reflections = "c60.lau", d_phi = 15 , radius = 0.01,
yheight = 0.05, Vc = 1076.89, delta_d_d=0, DW=1,
format=Crystallographica)

Powder definition file format
Powder structure is specified with an ascii data file 'reflections'.
The powder data are free-text column based files.
The reflection list should be ordered by decreasing d-spacing values.
... d ... F2
Lines begining by '#' are read as comments (ignored) but they may contain
the following keywords (in the header):
#Vc           
#Debye_Waller 
#delta_d_d/d    
These values are not read if entered as component parameters (Vc=...)

The signification of the columns in the numerical block may be
set using the 'format' parameter, by defining signification of the
columns as a vector of indexes in the order
format={j,d,F2,DW,delta_d_d/d,1/2d,q,F}
Signification of the symbols is given below. Indices start at 1.
Indices with zero means that the column are not present, so that:
Crystallographica={ 4,5,7,0,0,0,0,0 }
Fullprof         ={ 4,0,8,0,0,5,0,0 }
Lazy             ={17,6,0,0,0,0,0,13}
Here again, NO quotes should be around the 'format' value.

At last, the format may be overridden by direct definition of the
column indexes in the file itself by using the following keywords
in the header (e.g. '#column_j 4'):
#column_j     
#column_d     
#column_F2    
#column_F     
#column_DW    
#column_Dd    
#column_inv2d 
#column_q     

Concentricity

PowderN assumes 'concentric' shape, i.e. can contain other components inside its
optional inner hollow. Example, Sample in Al cryostat:


COMPONENT Cryo = PowderN(reflections="Al.laz", radius = 0.01, thickness = 0.001,
concentric = 1, p_interact=0.1)
AT (0,0,0) RELATIVE Somewhere

COMPONENT Sample = some_other_component(with geometry FULLY enclosed in the hollow)
AT (0,0,0) RELATIVE Somewhere

COMPONENT Cryo2 = COPY(Cryo)(concentric = 0)
AT (0,0,0) RELATIVE Somewhere


(The second instance of the cryostat component can also be written out completely
using PowderN(...). In both cases, this second instance needs concentric = 0.)
The concentric arrangment can not be used with OFF geometry specification.

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
string reflections"NULL"
string material"NULL"
string geometry"NULL"
vector format{0,0,0,0,0,0,0,0}
vector mat_format{0,0,0,0,0}
radius0
yheight0
xwidth0
zdepth0
thickness0
pack1
Vc0
delta_d_d0
p_inc0.1
p_transmit0.1
DW0
nb_atoms1
d_phi0
d_theta360
p_interact0
concentric0
density0
weight0
barns1

Output parameters

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

Links


[ 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