blkper Page 1 of 3

Studio 3 Process Help

BLKPER - create a set of perimeters around cells in a block model

Process Name Menu Path Link to Command Table

BLKPER Applications | Model Manipulation Processes | Create Click here
Perimeters Around Model

Models | Manipulation Processes | Create Perimeters Around

Model

 Introduction

 Files, Fields and Parameters

 Notes

 Example

 Errors

Introduction

Creates a set of perimeters around blocks in a model file.

How to use

The perimeters are either on horizontal benches or on vertical sections, parallel to the axes of the model. The starting perimeter, the
distance between perimeters and the number of perimeters are defined by parameter. All perimeters are open and clockwise for
perimeters surrounding model cells. For empty areas (voids), perimeters are created to isolate the void, and then linked to the non-void
zone.

More specifically, If a set of cells completely surrounds a void then this is dealt with by creating an anti-clockwise perimeter around the
void. This is then linked to the enclosing clockwise perimeter with a two-way bridge of zero width.

If a cell contains sub-cells, it is treated as if it were a complete cell.

More than one perimeter will be created for each plane if there are disjoint groups of cells.

Files, Fields and Parameters

Input Files

Name Description I/O Status Required Type

IN Input model file, which must contain the standard Input Yes Block
model fields. Model

Output Files

Name I/O Status Required Type Description

OUT Output Yes String Output perimeter file.
Perimeter values have the
format: PVALUE =
nnn.mm where:- nnn =
the plane number. mm =
the perimeter number in
the plane. XP,YP and ZP
are true world
coordinates.

Parameters

Name Description Required Default Range Values

Parameter to specify the
plane of the output
DIRECT Yes 1 1,3 1,2,3
perimeter: 1 = XY, 2 =
XZ, 3 = YZ.

mk:@MSITStore:C:\Program%20Files%20(x86)\Datamine\Studio3\Help\DatamineStu... 7/03/2019
blkper Page 2 of 3

Value of the coordinate

perpendicular to the
STARTPOS Yes Undefined Undefined Undefined
output plane for the first
plane.
Distance between output
STEPSIZE planes. This must be Yes Undefined Undefined Undefined
positive.
NUMPLANE Number of output planes. Yes Undefined Undefined Undefined

Controls perimeter
generation (0):

Option Description
Join cell
0
SMOOTH corners; No 0 0,1 0,1
Join the
midpoints of cell
1 sides in order to
smooth the
outline.

Controls internal and

external perimeter
connections.

Option Description
Do not connect
internal and
0 external
perimeter
CONNECT connections. No 1 0,2 0,2
Connect internal
perimeters to
1 external
perimeters as a
single perimeter.
Create only
2 internal
perimeters.

Specifies gap to create

between coincident
segments in bridged
BRADJUST No 0.0 Undefined Undefined
parameters to assist later
evaluation. Only used if
@CONNECT=1

Notes

No additional notes.

Example

!BLKPER &IN(FEMODEL), &OUT(PERIMS), @DIRECT=1, @STARTPOS= -45, @STEPSIZE=10, @NUMPLANE=10, @SMOOTH=0, Fe>46

Reading through the model file -

3185 Model records read

1 perimeter(s) output for plane -45

1 perimeter(s) output for plane -35

1 perimeter(s) output for plane -25

>>> 101 RECORDS IN FILE PERIMS <<<

mk:@MSITStore:C:\Program%20Files%20(x86)\Datamine\Studio3\Help\DatamineStu... 7/03/2019
blkper Page 3 of 3

Error and Warning Messages

Message Description Solution

ERROR : @STARTPOS is not within the
model

ERROR : @DIRECT not in the range 1 to

3

ERROR : @NUMPLANE not +ve

ERROR : @STEPSIZE not +ve

Copyright © CAE Datamine Corporate Limited

mk:@MSITStore:C:\Program%20Files%20(x86)\Datamine\Studio3\Help\DatamineStu... 7/03/2019