BMARCH

Use this to create grade shell triangulations from an existing block model.


Usage:

bmarch [options] <model> <variable> <filename> <lev> [level] [level]...

<> indicates a mandatory switch.
[ ] indicates an optional switch


Where:

Option

Description

[options]

The [options] for this executable are:

-e

Use an exact grade block outline.

-a<value>

Add a border and pad it with a nominated value.

-T

Use this to create the top surfaces of the block model's exact boundary, based on the range of levels on which you are shelling.

-P

Use this to create the bottom surfaces of the block model's exact boundary, based on the range of levels on which you are shelling.

-w

Use this to construct side walls in the resulting grade shell. The -T or -P switches must be used in order to construct side walls.

-l

Use this to construct the base of the actual block model over areas where no blocks match the grade shell level. The -T or -P switches must be used in order to construct the base.

-i

Use this to allocate memory for only one Z level of the grid. The memory is then moved incrementally through the data to produce the grade shell. Although this method results in slower execution time, it avoids memory problems.

If you are using the -e switch, then the block model will be incrementally read (using the exact block boundary algorithm). Although this method results in a slower execution time, it uses less memory and allows you to shell larger block models.

-cellsize <x y z>

Specify the cell size of the cube used in the marching cube algorithm. If the -cellsize switch is not entered, then the minimum block schema size will be used to define the cell size of the cube.

Note

The specified cell size must be larger than the minimum block size. If the cell size is less than the block size, then the minimum block size will be used instead. If the cell size is larger than the minimum block size, then weight averaging based on volumes will be used to calculate the grade value for the cell.

A cube with large cube extents will result in less points and triangles in the resultant grade shell triangulation. This will, however, result in a grade shell that isn't as accurate when compared to one that was created using smaller cube extents.

-default <value>

Use this to replace the default value for the grade shell variable.

For example: If the default value is '-99.0', then it could be replaced by '0.0' to ensure that the weighted average is correctly calculated.

The -cellsize switch must be used in order to replace the default value.

-o <file>

Redirect output to a nominated file. You will need to include a file extension, for example '.asc'.

-k <file>

Append output to a nominated file. You will need to include a file extension, for example '.asc'.

-v <variable> [value]

Mask with variable.

-t <triangulation>

Bounding triangulation.

-n <top surface>

Top bounding surface triangulation.

-u <lower surface>

Lower bounding surface triangulation.

-B <triangulation>

Use a single bounding surface.

-Z

Project down the Z-axis, i.e. select the blocks that fall below the nominated surface. If the -Z switch is omitted, then all blocks that fall above the nominated surface will be selected instead.

Note:   This switch can only be used when a single bounding surface has been specified.

-O

Select blocks outside the solid only.

-bm <xl, xt, yl, yt, zl, zt>

Define the bounding extents using block model co-ordinates. When using this switch, you will need to specify the minimum and maximum X, Y and Z co-ordinates.

-bw <xl, xt, yl, yt, zl, zt>

Define the bounding extents using real world co-ordinates. When using this switch, you will need to specify the minimum and maximum X, Y and Z co-ordinates.

-s <mx,my,mz>

Sub-block dimensions.

-p <a,b,c,d>

Include planed blocks.

-C <condition>

Use conditional expression.

-r <offset>

Provide a plane offset buffer.

-X

Use proportional volumes against solid.

<model>

Enter the name of the block model that will be used to create the grade shell triangulation.

<variable>

Enter the variable for which the grade shell is created.

<filename>

Enter the name for the resulting triangulation.

<lev> [level]

Enter the cutoff levels that you want to shell. You only need to use the <lev> switch when wishing to shell a single level.