General keywords and variables

There are a number of common general keywords and variables that apply to all the ASCII formats.

For all formats the following general keywords and definitions are used.

General Keywords (the order of these keywords does not matter, except from the OBJECT or PROPERTY keyword – this keyword must always be the first one):

Geometrical objects

Keyword Description Optional? Comment
OBJECT Indicates the start of a new object No

Two values are expected:

1. ObjectType

2. Name of the object

Supported ObjectTypes are:

1. Tri-mesh

2. WELL

3. MARKERSET

4. WELLDESIGN

5. POLYLINESET

6. TSURFACE

7. VOXELGRID

8. MESH3D

9. POINTSET

10. GRID2D

CRS Coordinate Reference System  

Four values are expected:

1. Authority (e.g. EPSG)

2. Code (e.g. 28992)

3. Name (e.g. Amersfoort / RD New)

4. Horizontal unit (e.g. m)

CSYSTEM

Local world position (i.e. the position relative to the one given by CRS)

Yes

Five values are expected:

1. Easting – default = 0.0

2. Northing – default = 0.0

3. TVDSS – default = 0.0

COORDINATES (only for Wells) Local world position (i.e. the position relative to the one given by CRS). Is added to CSYSTEM. Same format as CSYSTEM. Yes

4. Inclination – default = 0.0

5. Azimuth – default = 0.0

When this keyword is not included for the current object, all values are assumed as 0.0

PROPERTY

Indicates the start of a new property

No

Two values are expected:

1. ObjectType

2. Name of the property

Supported ObjectTypes are:

1. WELLBORE

UNITS

Used units for the current object

Yes

Five values are expected:

1. Easting unit

2. Northing unit

3. TVDSS unit

For all possible Easting, Northing and TVDSS units, open the Display Units form (HOME > Settings > Display Units), click 'distance' and go to Selected quantity at the bottom of the form.

4. Inclination unit

5. Azimuth unit

And where Inclination and Azimuth units can be:

1. deg (degrees)– default unit

2. rad (radians)

When this keyword is not included for the current object, all default units are applied.

REFERENCE

Indicates the reference to a geometrical object

No

One value is expected:

1. Object reference name

This is the name of the object where the property belongs.

PTYPE

Indicates the property type and used unit in the file

Yes

Two values are expected:

1. Property Type (default = “Undefined”)

2. Property Unit (default = ““)

If this keyword is not included for the current object, all defaults are applied.

PCLASS

Specifies a property classname, used for discrete logs only

Yes

Six values are expected:

1. ClassName

2. ClassValue (int)

3. Red color value

4. Green color value

5. Blue color value

6. Alpha color value (optional)

If the property template type is a discrete property, without having specified CLASSNAME’s, then classnames are generated based on the log values and default colors are generated.

CATEGORY

Specifies the rate category

Yes

One value is expected:

1. Category name (Default = “”)

When this keyword is not included, the default category name is applied.

SUBCATEGORY

Specifies the rate sub-category

Yes

One value is expected:

1. Sub-category name (Default = “”)

When this keyword is not included, the default sub-category name is applied.

Both geometrical object and properties

Keyword Description Optional? Comment

COLOR

Color of the object

Yes

Four values are expected:

1. Red (0-255)

2. Green (0-255)

3. Blue (0-255)

4. Alpha (0-255 – default = 255)

When this keyword is not included for the current object, a unique color will be sampled for the object

UNKNOWN

Specifies the value for unknown values

Yes

One value is expected:

1. Unknown value (Default = -999.25)

When this keyword is not included for the current object, -999.25 will be used for undefined values

General variables

Variable Description Type Min Max Comment

Name

Name of the object

String

-

-

No spaces allowed

Northing

Northing location relative to the used CRS

double

-

-

-

Easting

Easting location relative to the used CRS

double

-

-

-

TVDSS

Depth location relative to the used CRS

double

-

-

Depth values are positive

Azimuth

Azimuth relative to the north reference

double

0

360 deg

Inclination

Inclination relative to the north reference

double

0

180 deg

Northing Unit

Unit for northing

-

-

-

Default = m

Easting Unit

Unit for easting

-

-

-

Default = m

TVDSS Unit

Unit for depth

-

-

-

Default = m

Azimuth Unit

Unit for azimuth

-

-

-

Default = deg

Inclination Unit

Unit for inclination

-

-

-

Default = deg

Red

Red component of RGB color

Int

0

255

Green

Green component for RGB color

Int

0

255

Blue

Blue component of RGB color

Int

0

255

Alpha

Alpha component of the color

Int

0

255

Default = 255

Unknown Value

Undefined value specification

Double

-

-

Default = -999.25

Reference Name

Name of the object to which the property belongs

String

-

-

Property Type

Name of the property type

String

-

-

Default = "Undefined" the application supports multiple default types, such as ‘Porosity’, ‘Density’, etc.

See the property template documentation for the available types.

Property Unit

Unit of the property values in the file

String

-

-

Default = “”

Each property template uses a certain main property unit, such as ‘Depth’, ‘Time’ etc. Within each main unit, 1 or more units are supported, for example for Depth: meters, feet, etc. See Properties and Units.

ClassName

Name of the property class

String

-

-

ClassValue

Int value of the property class

Int

-

-

ClassRed

Red component of RGB property class color

Int

0

255

ClassGreen

Green component of RGB property class color

Int

0

255

ClassBlue

Blue component of RGB property class color

Int

0

255

ClassAlpha

Alpha component of RGB property class color

Int

0

255

Default = 255

Category

Rate category name

String

-

-

Default= “category”

SubCategory

- Authority

- Code

- Name

- HorizontalUnit

Rate sub-category name

- The authority specifying Spatial Reference System Identifier (SRID) belonging to a CRS-code (such as EPSG specifying EPSG-code or ESRI specifying ESRI-code)

- Spatial Reference System Identifier (SRID)

- CRS Name

- Horizontal unit applicable for the CRS in question (for all supported units, go to HOME > Settings > Display Units), click 'distance' and go to Selected quantity at the bottom of the form).

 

String

-

-

Default= “sub category”

Any additional object specific definitions are described in the corresponding sections on that object type.