ellipse

Process Help

ELLIPSE - create an ESTIMA search ellipsoid wireframe volume

Process Name	Menu Path	Link to Command Table
ELLIPSE		Click here

Introduction
Files, Fields and Parameters
Notes
Example
Errors

Introduction

This is a Superprocess and running it may have an effect on other Datamine files in the project. More...

This process creates a wireframe ellipsoid.

How to use

The lengths of the axes and the orientation of the ellipsoid can be defined either through a search volume parameter file, as used for input to the ESTIMA process, or by parameter. Although the description here is in terms of a search volume ellipsoid, the ellipsoid could also represent the anisotropic ranges of a variogram model.

The main purpose of creating a wireframe ellipsoid is to display it in GUIDE and GVP in order to verify visually that the lengths of the axes and the orientation are correct. There are three components to the wireframe, each with a different value for field ZONE in the triangle file:

1 - the outside surface of the ellipsoid;

2 - the three planes parallel to the axes of the ellipsoid;

3 - a set of wireframed axes for the world coordinate system.

Each octant of the ellipsoid is created using a different field (1 to 8), and the axes are 13. Therefore you can use the filter-wireframe-triangles (fwt) command in GUIDE to select components of the wireframe:

eg NOT =1 will filter out the first octant.

ZONE=2 will show only the outside of the ellipsoid.

If a search volume parameter file (SRCPARM) is specified, then the definition of the ellipsoid will be taken from this file. If the file contains more than one definition, then the required definition can be selected using the @SREFNUM parameter. If the file only contains one definition, and @SREFNUM is set to absent data (the default), then that definition will be used. Details of the search volume parameter file and its fields can be found in the Reference Manual entry for the process ESTIMA, and in the Grade Estimation User Guide.

If a search volume parameter file is not specified, then the ellipsoid will be defined by the parameters @ANGLEn, @SAXISn and @SDISTn. These parameters have the same definition as the corresponding fields in the search volume parameter file.

The coordinates of the centre of the ellipsoid can be defined using the @XCENTRE, @YCENTRE and @ZCENTRE parameters. The default values of these parameters are zero.

Files, Fields and Parameters

Input Files

Name	Description	I/O Status	Required	Type
SRCPARM	Input search volume parameter file, as used in the ESTIMA process. This file must contains the fields SREFNUM, SANGLE1, SANGLE2, SANGLE3, SAXIS1, SAXIS2, SAXIS3, SDIST1, SDIST2, and SDIST3, which define the orientation and dimensions of the search volume.	Input	No	Undefined

Output Files

Name	I/O Status	Required	Type	Description
WIRETR	Output	Yes	Wireframe Triangle File	Optional output wireframe triangle file. If this file is not specified a file with the name ELTR will be created.
WIREPT	Output	Yes	Wireframe Points File.	Optional output wireframe points file. The wireframe will be created to enclose the limits of the rotated model.

Parameters

Name	Description	Required	Default	Range	Values
SREFNUM	If a search volume parameter file (SRCPARM) is specified, then it must include a field SREFNUM which defines a unique reference number for each search volume. The SREFNUM parameter then defines which search volume will be used. If the SREFNUM parameter is set to absent data (the default), then the first search volume in the file will be used.	No	-	Undefined	Undefined
SANGLE1	First rotation angle clockwise in degrees, around axis SAXIS1 . It must lie between -360.0 and +360.0. A value of zero indicates no rotation.	No	0	-360,360	Undefined
SANGLE2	Second rotation angle clockwise in degrees, around axis SAXIS2 . It must lie between 360.0 and +360.0. A value of zero indicates no rotation.	No	0	-360,360	Undefined
SANGLE3	Third rotation angle clockwise in degrees, around axis SAXIS3 . It must lie between -360.0 and +360.0. A value of zero indicates no rotation.	No	0	-360,360	Undefined
SAXIS1	Axis around which first rotation angle will occur. 0 for no rotation, 1 for X axis, 2 for Y axis, 3 for Z axis.	No	3	0,3	0,1,2,3
SAXIS2	Axis around which second rotation angle will occur. 0 for no rotation, 1 for X axis, 2 for Y axis, 3 for Z axis.	No	1	0,3	0,1,2,3
SAXIS3	Axis around which third rotation angle will occur. 0 for no rotation, 1 for X axis, 2 for Y axis, 3 for Z axis.	No	3	0,3	0,1,2,3
SDIST1	The length of the first axis of the ellipsoid. Initially, before any rotation, SDIST1 is along the X axis.	No	10	Undefined	Undefined
SDIST2	The length of the second axis of the ellipsoid. Initially, before any rotation, SDIST2 is along the Y axis.	No	10	Undefined	Undefined
SDIST3	The length of the third axis of the ellipsoid. Initially, before any rotation, SDIST3 is along the Z axis.	No	10	Undefined	Undefined
XCENTRE	The X coordinate of the centre of the ellipsoid.	No	0	Undefined	Undefined
YCENTRE	The Ycoordinate of the centre of the ellipsoid. .	No	0	Undefined	Undefined
ZCENTRE	The Z coordinate of the centre of the ellipsoid.	No	0	Undefined	Undefined
PRINT	Print flag: =0 for minimum output. =1 for runtime information messages.	No	0	0,1	0,1

Notes

No additional notes.

Example

Create a wireframe ellipsoid corresponding to search volume reference number 7 in file SPAR1:

!ELLIPSE

&SRCPARM(SPAR1), &WIRETR(WTR1), &WIREPT(WPT1),
@SREFNUM=7, @PRINT=0.0

Create a wireframe ellipsoid which is rotated 30o around axis 1 (X), followed by 60o around axis 3 (Z). The lengths of the axes are 100m along axis 1, 50m along axis 2, and 20m along axis 3.

!ELLIPSE

&WIRETR(WTR1), &WIREPT(WPT1), @SANGLE1=30, @SANGLE2=60, @SAXIS1=1, @SAXIS2=3,
@SDIST1=100, @SDIST2=50, @SDIST3=20
@PRINT=0.0

THE WIREFRAME ELLIPSOID HAS BEEN CREATED
----------------------------------------

Wireframe WTR1 , WPT1 contains the ellipsoid for display in GUIDE

The following parameters were used:
Length of X,Y,Z axes: 100, 50, 20
Rotation angles: 30, 60, 0
Rotation axes: 1, 3, 3

There are 3 components to the wireframe, each with a different
value for field ZONE in the triangle file:

the outside surface of the ellipsoid
the three planes orthogonal to the axes of the ellipsoid
a set of wireframed axes for the world coordinate system

Each octant of the ellipsoid is displayed in a different
(1 to 8), and the axes are 13.

Therefore you can use the filter-wireframe-triangles (fwt) command
in GUIDE to select components of the wireframe:
eg NOT =1 will filter out the first octant.
> ZONE=2 will show only the outside of the ellipsoid.

Error and Warning Messages

Message	Description	Solution
ERROR: SRCPARM file FFFFFFFF does not exist.	Search volume parameter file FFFFFFFF has been specified, but it does not exist.

ERROR: No records in SRCPARM file FFFFFFFF.	Search volume parameter file FFFFFFFF has been specified, and it exists, but it does not contain any records.

ERROR: SRCPARM file FFFFFFFF does not include field SREFNUM.	Search volume parameter file FFFFFFFF has been specified, and it exists and contains records, but it does not contain field SREFNUM .

ERROR: file FFFFFFFF does not contain SREFNUM=SSSSSSSS.	Search volume parameter file FFFFFFFF has been specified, and it exists and contains records and has a field SREFNUM, but none of the values for field SREFNUM are equal to SSSSSSSS.

ERROR: one of the following fields is missing from FFFFFFFF. SDIST1, SANGLE1, SAXIS1 SDIST2, SANGLE2, SAXIS2 SDIST3, SANGLE3, SAXIS3	Search volume parameter file FFFFFFFF has been specified, and it exists and contains records, but one or more of the fields shown above are missing.

ERROR: SANGLEn is specified as NNNNNN.NN.	It must lie between -360 and +360.The SANGLEn parameter has been specified with an invalid value.

ERROR: Rotation axis n has been specified as R.	Only values 0, 1, 2 or 3 are permitted.

An invalid value for parameter SAXISn has been specified. ERROR: parameter SDISTn is missing or is less than zero.	All three SDISTn parameters must be specified and must be greater than zero.

ERROR in Process ELLIPSE >>> PRESS <RETURN> TO CONTINUE (OR ! TO TERMINATE) >	An error has occurred. An unidentifiable error has been encountered.	Check data and parameters.