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.