\(\renewcommand\AA{\unicode{x212B}}\)
Table of Contents
Name | Direction | Type | Default | Description |
---|---|---|---|---|
InputWorkspace | Input | MatrixWorkspace | Mandatory | The name of the workspace containing the instrument to add the Environment |
Filename | Input | string | Mandatory | The path name of the file containing the Environment. Allowed extensions: [‘.stl’, ‘.3mf’] |
Scale | Input | string | cm | The scale of the stl: m, cm, or mm |
OutputWorkspace | Output | MatrixWorkspace | Mandatory | The name of the workspace that will contain the loaded Environment of the sample |
EnvironmentName | Input | string | Environment | |
Add | Input | boolean | False | |
XDegrees | Input | number | 0 | The degrees to rotate on the x axis by |
YDegrees | Input | number | 0 | The degrees to rotate on the y axis by |
ZDegrees | Input | number | 0 | The degrees to rotate on the z axis by |
TranslationVector | Input | dbl list | 0,0,0 | Vector by which to translate the loaded environment |
SetMaterial | Input | boolean | False | |
ChemicalFormula | Input | string | The chemical formula, see examples in documentation | |
AtomicNumber | Input | number | 0 | The atomic number |
MassNumber | Input | number | 0 | Mass number if ion (use 0 for default mass sensity) |
SampleNumberDensity | Input | number | Optional | This number density of the sample in number of atoms per cubic angstrom will be used instead of calculated |
ZParameter | Input | number | Optional | Number of formula units in unit cell |
UnitCellVolume | Input | number | Optional | Unit cell volume in Angstoms^3. Will be calculated from the OrientedLattice if not supplied. |
CoherentXSection | Input | number | Optional | Optional: This coherent cross-section for the sample material in barns will be used instead of tabulated |
IncoherentXSection | Input | number | Optional | Optional: This incoherent cross-section for the sample material in barns will be used instead of tabulated |
AttenuationXSection | Input | number | Optional | Optional: This absorption cross-section for the sample material in barns will be used instead of tabulated |
ScatteringXSection | Input | number | Optional | Optional: This total scattering cross-section (coherent + incoherent) for the sample material in barns will be used instead of tabulated |
AttenuationProfile | Input | string | The path name of the file containing the attenuation profile. Allowed extensions: [‘.dat’] | |
SampleMassDensity | Input | number | Optional | Measured mass density in g/cubic cm of the sample to be used to calculate the number density. |
NumberDensityUnit | Input | string | Atoms | Choose which units SampleNumberDensity referes to. Allowed values: [‘Atoms’, ‘Formula Units’] |
Loads an environment into the sample of a workspace, either replacing the current environment, or adding to it. The newly added Environment can be translated by a vector, and rotated by an angle along each axis applied in order X,Y,Z, rotation applies before translation. You may also set a material for the environment to be loaded, this follows the same inputs as SetSampleMaterial v1.
The following types of input file are supported:
*.stl
stereolithography https://en.wikipedia.org/wiki/STL_(file_format)
This is a file format consisting of a list of faces specified by their vertex coordinates.
The file may be in ASCII or Binary format, and all the faces must be triangular.
The normals are ignored, but the vertices must be in the order required by the standard
(counter-clockwise when viewed from outside).*.3mf
https://3mf.io
This is a 3D printing format that allows multiple objects to be stored in a single file,
each with a representation similar to the .stl format ie a list of faces and verticesCategories: AlgorithmIndex | DataHandling\Instrument
C++ header: LoadSampleEnvironment.h (last modified: 2021-03-31)
C++ source: LoadSampleEnvironment.cpp (last modified: 2021-03-31)