Responses

PCF (Project Control File)

Full path of the PCF file for the project. (xxx10.dat)

There is no default value for PCF, thus it is a required entry.

Input Directory

Full path to the directory of the geometry objects containing shell elements.

Default Input Directory path is you current working directory or your project directory if running the script from MineSight(R)

Output Directory

Full path to the directory where the partials files are written.

Default Output Directory path is you current working directory or your project directory if running the script from MineSight(R)

Sub Blocks

An integer in the range of 1 to 100.

This is the subcell count voxel.exe uses to compute partials and the same value as the maximum of the X or Y default subcell count for volume calculations used in MineSight(R) File-->Project Settings-->Volumes.

MineSight(R) Project Space Settings

Default sub blocks value is 10 in this script.

Real

Boolean value indicating whether the values written in the partials files are in integer or float format.

• If set to one (1), or checked, partials files are written with float values.
• If set to zero (0), or unchecked, partials files are written with integer values.

Default value for Real is zero or FALSE.

Closed Solids Only

Boolean value indicating whether to use closed solids only.

• If set to one (1), or checked, partials files are generated for closed solids only.
• If set to zero (0), or unchecked, surfaces/solids with openings are skipped.

Default value for using Closed Solids Only is zero or FALSE.

Write Audit Report File

Boolean value indicating whether to create an audit report of the run.

• If set to one (1), or checked, a report is generated.
• If set to zero (0), or unchecked, a report is not generated.

Default value for Write Audit Report File is zero or FALSE.

Spawn Report

Boolean value indicating whether to spawn the audit report in notepad.exe.

• If set to one (1), or checked, the report is spawned by notepad.exe.
• If set to zero (0), or unchecked, a report is not spawned.

If spawning the report, it will be spawned after the panel is closed in an interactive run, or after the processing is complete in a silent run.

Default value for Spawn Report is zero or FALSE.

Report File Path

Full path for the report file. If the file already exists, it will be over-written. If the file does not exist, it will be created.

Default value for Report File Path is createPartials.txt in your current or project directory.

Partials File Names

String field indicating how to name the corresponding partials files created from each shell.

Wildcards are available to build the partials file names:

• $orig = name of the original element, or attributed name
• $obj = name of the geometry object (.msr), or parent name
• $count = incremental integer

These wildcards can be combined to create unique names for all the partials files created. Literals can also be combined with the wildcards. Example partials files names:

• high-$count.prt
• low-$orig-$count.out

If $count wildcard is used, integer values for Start and Step are required.

Example File Naming using $obj-$count.prt

*Source*        *Partials File*
pit3solid.msr -> pit3solid-1.prt
              -> pit3solid-2.prt
              -> pit3silid-n.prt

              where n is last solid in the .msr file and
                    1 is first solid in the .msr file.

If a target file already exists, it will be overwritten. When there
are multiple solids in one *.msr file, multiple *.prt files are created.

Default value for Partials File Names is $obj-$count.prt: which is the name of the geometry object (without .msr) a hyphen and sequential count, starting at one at each geometry object and incremented by one for each shell element in that geometry object. The default extension of the partials files created is .prt.

$count Start

Integer value indicating starting value for $count, which is a wildcard that can be used to build the output partials file names.

Default $count Start value is one (1).

$count Step

Integer value indicating the increment value for $count, which is a wildcard that can be used to build the output partials file names.

Default $count Step value is one (1).

$count Reset

Boolean value indicating whether to reset the wildcard $count start, which is a wildcard that can be used to build the output partials file names, at each new geometry object.

• If set to one (1), or checked, $count begins at $count start with each new geometry object encountered in the Input Directory.
• If set to zero (0), or unchecked, $count is continuously incremented over all the geometry objects in the Input Directory.

Default value for $count Reset is one or TRUE.

Save Responses

Boolean value indicating whether to save the responses entered into the GUI panel to the .ini file. If running silently, the .ini file remains unchanged.

• If set to one (1), or checked, responses are saved to the .ini file.
• If set to zero (0), or unchecked, responses are not saved to the .ini file.

Responses are not saved unless an actual good run is made. If cancel is pressed before a successful run, the responses are not saved.

Default value for Save Responses is zero or FALSE.

Responses File Setup

The best way to setup a response file is to run the script interactively once and check Save Responses on the lower right corner of the dialog. This will create a response file in the current working directory.

The name of the response file is always createPartials.ini. If you rename the script, the subsequent response file created will be script_name.ini.

The response file is simply a text file with tokens valued for each of the parameters needed in the run. Comments can be entered in the .ini file with a pound sign in column one.

The format of the response file is:

token = value

The token must be exactly as shown below in the example. The values should not be enclosed in quotes and should be the type required, or an error will occur.

Example Response File

PCF_FLN = C:\currentProject\rot10.dat
SOURCE_DIR = C:\currentProject\_msresources\high5
# the following token, IO_IN_SAME_DIR is ignored in silent mode
IO_IN_SAME_DIR =0
TARGET_DIR = C:\currentProject\_msresources\high5
SUB_BLOCKS = 10
REAL = 0
PARTIALS_FLNS = $obj-$count.prt
COUNT_START = 1
COUNT_STEP = 1
COUNT_RESET = 1
CLOSED_SOLIDS_ONLY = 0
WRITE_RPT_FILE = 0
SPAWN_RPT_FILE = 0
RPT_FLN = C:\currentProject\createPartials.txt
# the following token, SAVE_RESPONSES is ignored in silent mode
SAVE_RESPONSES = 1

Audit Report

If an audit of the run is desired, check the Write Audit Report File in the panel or set WRITE_RPT_FILE = 1 in the response file. Also, supply the report file path and indicate whether to spawn the report in notepad.exe.

The report details the parameters sent to the voxel engine, information about each shell element read and the partials file created from that element.

Example Audit Report

==================================================
D:\work\partials\createPartials.pyc
Tue Aug 21 15:45:06 2007
==================================================
PCF:              D:\currentProject\msop10.dat
Input Directory:  D:\CURRENTPROJECT\_MSRESOURCES\SHELLS
Output Directory: D:\CURRENTPROJECT\_MSRESOURCES\SHELLS
Voxel Parameters:
-dx        20.0000 (Block width in x direction)
-dy        20.0000 (Block width in y direction)
-dz        15.0000 (Block width in z direction)
-nx       150      (Number of blocks in x direction)
-ny       125      (Number of blocks in y direction)
-nz        64      (Number of blocks in z direction)
-xmin    1000.0000 (Min model limit in x direction)
-ymin    4000.0000 (Min model limit in y direction)
-zmin    2000.0000 (Min model limit in z direction)
-sb        10      (Sub blocks)

--------------------------------------------------
Input geometry object:  Geometry1.msr
--------------------------------------------------

Element 1: Skipped - Has openings.

Element 2: Skipped - Has openings.

Element 3: Output partials file:  cone-1.prt
Executing voxel ...
Reading data from disk ... done

Element 4: Output partials file:  cube-2.prt
Executing voxel ...
Reading data from disk ... done

Element 5: Output partials file:  cylinder-3.prt
Executing voxel ...
Reading data from disk ... done
Error in voxel engine.

Element 6: Output partials file:  deciduous tree-4.prt
Executing voxel ...
Reading data from disk ... done

Element 7: Skipped - Has openings.

Element 8: Output partials file:  miner-5.prt
Executing voxel ...
Reading data from disk ... done

Element 9: Skipped - Has openings.

Element 10: Output partials file:  sphere-6.prt
Executing voxel ...
Reading data from disk ... done

==================================================
Total geometry objects processed: 1
Total elements processed: 6
==================================================