Create Isoshells: Automation
The Create Isoshells tool can be automated using a script.
As with most commands available via Studio's COM interface, access is granted using the ParseCommand() method, and passing in parameters to define the behavior. ParseCommand parameters use a method of name and value pairs which is similar to those used for some other processes in Studio products:
- Parameters must be separated by semicolons.
- All filenames must refer to files which are already in the project - if this is not the case, errors are displayed.
- If no bounding box value is supplied, the bonding box is calculated automatically from the input data and boundaries.
- If any bounding box value is supplied, all values must be defined.
- If TriSpacing is not defined, it is automatically calculated from the bounding box.
Parameters List
|
Parameter |
Notes |
|
SampleFile=filename |
filename = dm sample file name |
|
SampleXField=fieldname |
fieldname = field name for X coordinate |
|
SampleYField=fieldname |
fieldname = field name for Y coordinate |
|
SampleZField=fieldname |
fieldname = field name for Z coordinate |
|
SampleValueField=fieldname |
fieldname = field name for values |
|
SampleWeightingField=fieldname |
fieldname = field name for weighting (optional) |
|
Mode=category | continuous |
(default=continuous) |
|
Isolevel=value |
value can be text or a number (depending on type of
SampleValueField) |
|
BottomCut=number |
no bottom cut if not defined |
|
TopCut=number |
no top cut if not defined |
|
Distribution=none | log | normal |
(default=none) |
|
XRadius=number |
(default=100) |
|
YRadius=number |
(default=100) |
|
ZRadius=number |
(default=100) |
|
RotAxis1=1 | 2 | 3 |
1=X, 2=Y, 3=Z |
|
RotAxis2=1 | 2 | 3 |
1=X, 2=Y, 3=Z |
|
RotAxis3=1 | 2 | 3 |
1=X, 2=Y, 3=Z |
|
RotAngle1=number |
number is rotation in degrees around the related axis (default=0) |
|
RotAngle2=number |
number is rotation in degrees around the related axis (default=0) |
|
RotAngle3=number |
number is rotation in degrees around the related axis (default=0) |
|
IDWPower=number |
(default=2) |
|
EstimationMethod=ok | idw |
(default=idw) |
|
AlignEllipse=yes | no |
(default=yes) |
|
InsideWireframeFile=filename |
filename = dm wf file name (optional) |
|
AboveWireframeFile=filename |
filename = dm wf file name (optional) |
|
BelowWireframeFile=filename |
filename = dm wf file name (optional) |
|
PerimeterFile=filename |
filename = dm str filename (optional) |
|
UseSelectedPerimeter=yes | no |
(default=no) |
|
XMin=number |
Minimum value in X of bounding box * |
|
YMin=number |
Minimum value in Y of bounding box * |
|
ZMin=number |
Minimum value in Z of bounding box * |
|
XMax=number |
Maximum value in X of bounding box * |
|
YMax=number |
Maximum value in Y of bounding box * |
|
ZMax=number |
Maximum value in Z of bounding box * |
|
XOrigin=number |
Local origin or bounding box in X ** |
|
YOrigin=number |
Local origin or bounding box in Y ** |
|
ZOrigin=number |
Local origin or bounding box in Z ** |
|
XLength=number |
Length of bounding box along X axis ** |
|
YLength=number |
Length of bounding box along Y axis ** |
|
ZLength=number |
Length of bounding box along Z axis ** |
|
OutputName=text |
(default=Isosurface) |
|
TriSpacing=number |
(default=autocalculated) |
|
DifferentObjects=yes | no |
(default=yes) |
|
IncludeBoundary=yes | no |
(default=yes) |
|
Smooth=integer number |
1=Low, 2=Medium, 3=High (default=0) |
* Only used where AlignEllipse=yes.
** Only used where AlignEllipse=no.
Example
oDmApp.ParseCommand("create-shells SampleFile=_vb_holes; SampleXField=X; SampleYField=Y; SampleZField=Z; SampleValueField=AU; Isolevel=0.5; TriSpacing=25; XRadius=15; YRadius=15; ZRadius=15 ");
Related topics and activities
