Scripting the Create Isoshells Process

A guide to scripting the Create Isoshells process

Scripting the Create Isoshells Process

The Create Isoshells process can be run from a script by using the ParseCommand() method, and passing in parameters to define the behavior. ParseCommand parameters use a method of name/value pairs which is similar to those used for some other processes in Datamine Studio products, but without the Files/Fields/Parameter syntax.

  • 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, then the bonding box is calculated automatically from the input data and boundaries.
  • If any bounding box value is supplied, then all values must be defined.
  • If TriSpacing is not defined, it is automatically calculated from the bounding box.

Parameters List

Parameter

Description

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 or continuous

(default=continuous)

Isolevel=value

value can be text or a number (depending on type of SampleValueField)
Can be repeated for multiple isovalues

BottomCut=number

no bottom cut if not defined

TopCut=number

no top cut if not defined

Distribution=none or log or normal

(default=none)

XRadius=number

(default=100)

YRadius=number

(default=100)

ZRadius=number

(default=100)

RotAxis1=1,2 or 3

1=X, 2=Y, 3=Z

RotAxis2=1,2 or 3

1=X, 2=Y, 3=Z

RotAxis3=1,2 or 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 or idw

(default=idw)

AlignEllipse=yes or 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 or no

(default=no)

XMin=number

 

YMin=number

 

ZMin=number

 

XMax=number

 

YMax=number

 

ZMax=number

 

XOrigin=number

 

YOrigin=number

 

ZOrigin=number

 

XLength=number

 

YLength=number

 

ZLength=number

 

OutputName=text

(default=Isosurface)

TriSpacing=number

(default=autocalculated)

DifferentObjects=yes or no

(default=yes)

IncludeBoundary=yes or no

(default=yes)

Smooth=integer number

1=Low, 2=Medium, 3=High (default=0)

 

note.gif (1017 bytes)                                        

When AlignEllipse=yes, use these parameters:

  • XMin

  • XMax

  • YMin

  • YMax

  • ZMin

  • ZMax

When AlignEllipse=no, use these parameters:

  • XOrigin

  • YOrigin

  • ZOrigin

  • XLength

  • YLength

  • ZLength

 

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 ");

  openbook.gif (910 bytes)   Related Topics

 

Creating Isoshells: more