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

Mailing list

Search

Documentation
 Manual
 Commands
 Wiki (GitHub)
 Tutorial

Links

Report bugs (GitHub)

Code-repository (GitHub)


McXtrace: Shape

[ Identification | Description | Input parameters | Links ]

The Shape Component

A geometric shape without effect on X-rays, for instrument display purpose.

Identification

  • Author: E. Farhi
  • Origin: ILL
  • Date: June 23rd 2009

Description

An inactive geometrical shape, for drawing purposes only.
It does not propagate x-ray, nor interact.
Shape:
Geometric 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)
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/powercrust, and
viewed with geomview
The default size of the object depends of the OFF file data, but its
bounding box may be resized using xwidth,yheight and zdepth.

Example: Shape(radius=0.05, yheight=0.1)
Shape(geometry="socket.off")

Input parameters

Parameters in boldface are required; the others are optional.
NameUnitDescriptionDefault
geometrystrName of an Object File Format (OFF) file for complex geometry. The OFF file may be generated from XYZ coordinates using qhull/powercrust0
radiusmOuter radius of sample in (x,z) plane0
xwidthmHoriz. dimension of sample (bounding box if off file), as a width0
yheightmVert. dimension of sample (bounding box if off file), as a height. A sphere shape is used when 0 and radius is set0
zdepthmDepth of sample (bounding box if off file)0
thicknessmThickness of hollow box or cylinder (spheres are drawn solid)0
nx1x-comp of orientation vector0
ny1y-comp of orientation vector1
nz1z-comp of orientation vector0
center1Flag to determine if OFF object is centered on its centre of mass.1
AT ( , , ) RELATIVE
ROTATED ( , , ) RELATIVE

Links

  • Source code for Shape.comp.
  • Geomview and Object File Format (OFF)
  • Powercrust/qhull

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

Generated on mcxtrace 3.10.2


Last Modified: Monday, 02-Nov-2026 21:43:07 CET
Search website mailinglist archive GitHub repos