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)


McXtrace: Shape

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

The Shape Component

A geometric shape without effect on photons, for instrument display purpose.

Identification

  • Site:
  • Author: E. Farhi
  • Origin: ILL
  • Date: Aug. 2021

Description

An inactive geometrical shape, for drawing purposes only.
It does not propagate photon, 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)
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 photon 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 sample0

Output parameters

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

Links

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

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

Generated on 2022-02-07 21:31:39


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