C

Process Help

TRIVOL - report wireframe model volume and statistics

 

Process Name

Menu Path

Link to Command Table

TRIVOL

ribbon | Operations | Volume from File

ribbon | Process | Volume

 

Click here

 

Introduction

Reports volume and other statistics of a wireframe model.

Note that the NOSID parameter will have an effect on wireframe volume calculations.

note.gif (1017 bytes)

TRIVOL supports the following recently-added parameters:

  • NOSID: This can be set to 1 to disable the checking of internal surfaces. This can be used on verified wireframes or DTMs, even if the triangle file does not contain the fields NORMAL-X, NORMAL-Y and NORMAL-Z.

    Using a value of NOSID on a previously verified wireframe makes processing much faster.

    If the fields NORMAL-X, NORMAL-Y and NORMAL-Z are present in the triangle file they will be used for detection of internal surfaces in preference to the NOSID parameter. These fields can be optionally output when using the wireframe-verify command.
  • DTM: This can be set to 1 to make the processing time faster if you are confident that the input wireframe is a DTM with no overlaps.

The ZONE field

--------------------

TRIVOL now supports alpha ZONE fields of up to 10 characters long. Records with absent ZONE values are counted and reported as a warning but a volume is still calculated for absent ZONES.

The name of the input triangle file to TRIVOL is now recorded in an implicit field in the output results file produced by TRIVOL.

 


Files, Fields and Parameters

Input Files

Name

Description

I/O Status

Required

Type

WIRETR

Input wireframe triangle file.

Input

Yes

Wireframe Triangle

WIREPT

Input wireframe point file.

Input

Yes

Wireframe Points

PERIMIN

Optional input perimeter file containing XP,YP,ZP fields, defining perimeter(s) within which volume is to be computed.

Input

No

String

Output Files

Name

I/O Status

Required

Type

Description

OUT

Output

No

Undefined

Optional output file, which will contain the fields VOLUME, UPPERVOL, LOWAREA, UPAREA, TOTAREA, MINZ, MAXZ, MINX, MAXX, MINY, MAXY, MINDIP, MAXDIP, NUMTRI, and the optional zone definition file, if one is specified.

Fields

Name

Description

Source

Required

Type

Default

ZONE

Zone definition field in triangle file.

WIRETR

No

Any

Undefined

Parameters

Name

Description

Required

Default

Range

Values

ZBASE

Base elevation above which volumes are computed.

Yes

Undefined

Undefined

Undefined

NOSID

 

Option

Description

1

Disables checking of SIDs for increased speed. Use for single surfaces only.

No

1

0,1

0,1

DTM

 

Option

Description

1

Disables checking of overlaps for specified DTM input files (quicker)

No

1

0,1

0,1


Notes

The information output includes:

  • Total volume above minimum elevation

  • Volume above @ZBASE value

  • Projected lower area

  • Projected upper area

  • Total surface area

  • Minimum elevation

  • Maximum elevation

  • Minimum X co-ordinate

  • Maximum X co-ordinate

  • Minimum Y co-ordinate

  • Maximum Y co-ordinate

  • Minimum surface dip

  • Maximum surface dip

  • Number of triangles


Example

!TRIVOL  &WIREPT(TOPOPT),&WIRETR(TOPOTR),*ZONE(ROCK),@ZONE=1,
         @ZBASE=110.0


Error and Warning Messages

Message

Description

Solution

>>> NO DATA IN INPUT FILE <<<

>>> ERR 136 <<< ( n) IN TRIVOL

The input wireframe point data file has no data. Fatal; the process is exited.

 

 

 

 

>>> MISSING OR ALPHA FIELDS IN PERIMETER FILE <<<

>>> ERR 143 <<< ( n) IN TRIVOL

Fatal; the process is exited.

 

 

 

 

>>> MISSING OR ALPHA FIELDS IN WIREPT FILE <<<

>>> ERR 145 <<< ( n) IN TRIVOL

Fatal; the process is exited.

 

 

 

 

>>> MISSING OR ALPHA FIELDS IN WIRETR FILE <<<

>>> ERR 146 <<< ( n) IN TRIVOL

Fatal; the process is exited.