BEXPORT

Use this to export a block model to an ASCII file. The blocks to export can be selected by specifying selection parameters.


Usage:

bexport [options] <model>

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

Where:

Option Description
[options]

The [options] for this executable are:

-i <delimiter> Delimiter used to separate fields. Use 'C' for ','. Use 'T' for tabulator.
-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.
-e Include block extents.
-J Include corner offsets. This information will be reported after the block volume.
-I Include block IDs.
-V Include block volumes.
-c Include block centroids.
-L Include block lengths.
-E Include model extent.
-W Export block centroids as real-world co-ordinates.
-h <width.decimals> Format in which to print header.
-P <variable> Print a nominated block variable.
-f <width.decimals> Format in which to print the nominated block variable.
-A Print all block variables.
-N Initialise name variables with strings.
-H Include a header line, i.e. column names, in the resulting export file.
<model> Refers to the name of the block model containing the blocks to export.

Example:

bexport -o bexport_example.txt -A example.bmf

N ote The following warning messages displays if any triangulations have small area faces or coincident points.

Note triangulation <tfi> has one or more small area faces.
Note triangulation <tfi> has two or more coincident points.


In most cases the program will work correctly on triangulations with small faces or coincident points. However, if the triangulation contains a topological inconsistency, it is necessary to run trisnapon the triangulation to remove coincident points. Also, all triangulations should be checked for consistency and stability with the Model > Triangle Utility > Check option.