[ Identification | Description | Input parameters | Links ]

The Guide_anyshape Component

Reflecting surface (guide and mirror) with any shape, defined from an OFF file, optionally with m, alpha, W (R0, Qc) given per face in the file.

Identification

Description

This is a reflecting object component. Its shape is defined from an OFF file,
given with its file name. The object size is set as given from the file, where
dimensions should be in meters. The bounding box may be re-scaled by specifying
xwidth,yheight,zdepth parameters. The object may optionally be centered when
using 'center=1'.

The reflectivity is specified either from the usual parametric description
R0,Qc,alpha,W,m, or from a reflectivity file 'reflect' with a 2 column
format [q(Angs-1) R(0-1)], or per face from the geometry file (file_coatings=1).

Per-face coatings (file_coatings=1, replaces the former Guide_anyshape_r):
the numbers following the vertex indices of each face in the OFF/PLY file
are read as m, alpha, W (IN THIS ORDER), optionally followed by R0 and Qc:
nv  i1 i2 ... inv   m alpha W [R0 [Qc]]
e.g.  4 0 5 6 4   3.0 6.07 0.003
Values that are not given in the file are taken from the component
parameters. See the example file Guide_r.off.
Former Guide_anyshape_r(m=0, alpha=0, W=0, ...) corresponds to
Guide_anyshape(file_coatings=1, ...).

The complex OFF/PLY geometry option handles any closed non-convex polyhedra,
with polygons of any number of vertices.
It supports the OFF, NOFF and COFF file formats (colours are ignored, but
face colours would be interpreted as coatings when file_coatings=1).
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.
PLY geometry files are also supported.

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
xwidthmRedimension the object bounding box on X axis is non-zero0
yheightmRedimension the object bounding box on Y axis is non-zero0
zdepthmRedimension the object bounding box on Z axis is non-zero0
center1When set to 1, the object will be centered w.r.t. the local coordinate frame0
transmit1When true, non reflected neutrons are transmitted through the surfaces, instead of being absorbed. No material absorption is taken into account though0
R01Low-angle reflectivity0.99
QcAA^-1Critical scattering vector0.0219
alphaAASlope of reflectivity3
m1m-value of material. Zero means completely absorbing.2
WAA^-1Width of supermirror cut-off0.003
reflectq(AA^-1) R(0-1)(str) Reflectivity file name. Format0
geometrystrName of the OFF/PLY file describing the guide geometry0
file_coatings1When 1, use m, alpha, W [R0, Qc] given per face in the geometry file instead of the parameters (which then serve as defaults for values missing in the file).0
AT ( , , ) RELATIVE
ROTATED ( , , ) RELATIVE

Links


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

Generated on mcstas 3.9.2