Glossary

Data Window

The Geocap data window is the bounding box or area-of-interest visible in the graphics window.

Database driver

A software layer provided by the database vendor to allow other parties to connect the database. For Geocap to be able to communicate with a database a driver for that database must be present on the machine on which Geocap is running. A notable exception is theSqlite database, a small but powerful database embedded in Geocap that uses only a local file.

Joystick Mode

Mouse interaction is set to mimic that of a joystick device. A graphical object will move as long as one of mouse buttons are pressed; moving the mouse is not necessary. The rotation speed depends on the distance from the objects point of rotation and the mouse cursor.

Linear Translation

A uniform movement along a straight path. All elements of the moving body are displaced along the same distance and direction. There is no rotation or scaling.

Trackball Mode

Mouse interaction is set to mimic that of a trackball device. In trackball mode, there will be a one-to-one connection between mouse movement and rotation of graphical objects when pushing the left mouse button. Rotation will stop when the mouse is no longer moved.

QTcl

scope

A part of the program where a given set of names are visible. A name may be a procedure or a variable, including state machine variables. The program is said to enter or leave scope when a set of visible names are made invisible in exchange for a new set of names. A variable may be visible in several scopes.

In Tcl a scope is delimited by a '{...}' block. The program enters or leaves scope when entering or leaving this block. When the program enters a new scope owned by a command that created a parent widget, all state machine variables are nullified, except Parent, which holds the parent that owns the block. When the program leaves the block all state machine variables are reset to their value from before entering the block, except the Widget variable, which is assigned the parent widget that owned the block just exited.

block

A brace delimited Tcl list with elements separated by newlines. There are two kinds of blocks in QTcl: Parent-child blocks and callback function blocks.

deleteonclose

A flag passed to qwidget upon creation. This flag ensures that the widget is deleted when closed.

current widget

The widget pointed to by the Widget state machine variable. A widget automatically becomes the current widget upon creation.

current layout

The layout current present in the QTcl state.

state machine

A set of variables that constitutes QTcls state.

child widget

A widget that plays the role of child in a parent-child relationship. A widget has one parent and 0 or more children. Child widgets are created in a parent-child block. See parent widget.

current item

A QListViewItem object in a QListView that has status of being current. Most commands related to QListView operate on the current item.

modal

A modal dialog graps the event, thus halting program execution until the dialog closes. File and information dialogs are examples of modal dialogs.

tracking

A widget that has tracking enabled will respond in a continuous manner to continuous user input. This applies to widgets that naturally lend themselves to this kind of input, such a sliders. The input is typically the dragging of the mouse. If the widget that receives the drag events has tracking enabled, any callbacks connected to mouse drag will be called continuously throughout the drag. If tracking is disabled, callback commands are called only at the end of the input session, such as when the user releases the mouse button.

parent widget

A widget that plays the role of parent in a parent-child relationship. A widget has one parent and 0 or more children.

A widget will automatically become a child of the widget pointed to by the Parent state machine variable when it is created. This relationship is usually enforced by creating the child widget in a brace-delimited block owned by the parent, as shown in the following example :

qwidget {
	...
	qwidget ...  ; # Child widget
}

Command Objects

Appearance Parameters

The parameters that control the appearance of a surface are:

Opacity
If reduced, the user can see through the surface, i.e. becomes transparrent

Reflection
If increased, the surface becomes lighter

Diffusion
If reduced, the surface becomes darker

Opacity
If increased, the surface becomes more brilliant

Command Execution

Geocap contains many command objects. Sometimes, a user wishes a command only to be executed on a certain type of folder or data, or for data which have a certain data name. Geocap allows the user to set command-filter-options so that a command is only executed when the Execute filter criteria are met. Geocap filters using the following Filter Options.

Command Language

Geocap comes with approximately 150 basic commands. Each command has many parameters. The commands are documented in the Geocap Command Reference Manual. Together with TCL syntax, and the Qtcl menu-builder, the user easily can construct menu-driven user specific commands to work on their data. Such commands can be executed on dataset as Command Objects. Many Geocap Command Objects are based on the Geocap Command Language (script based).

Command Object Standard Settings

Each Geocap Command Object is delivered with a set of standard settings. For example, the Display command is set to cycle the color between each execution according to the Geocap Cyclic Color Table, and with a line width of 2. To see the standard settings of a command object, Select Edit->Shared commands from the top menu bar. Then select New Command (upper left icon). Then select the "Display" Command - a bit down on the list. Click on the Display command and select the "Edit Command" icon (second from the left icon on the top).

Command Objects

In Geocap commands often are executed directly on dataset or on folders containing dataset. Such commands are command objects. A command object often has parameter-settings which control the execution. A full list of the Geocap Command Object is given in theGeocap Command Object Dictionary. Another way to interact with the data is through the Geocap Command Language. The user writes commands into a sequence of execution scripts which can be executed on data in the memory. Scripts can also be executed on data in the Project Manager as command objects.

Command_Visibility

Geocap contains many command objects. Not all command objects are relevant to all Geocap data and operations. For this reason Geocap filters the command object visibility on data. For instance, the command object "Display 2D Line" is only relevant to data of type "Seismic Lines". Geocap allows the user to create new command objects. Geocap allows the user to define visibility for new command objects as well as to modify the visibility settings for system commands. Command objects will only be visible for those data/folders that satisfy the visibility filter criteria for that command object. Geocap uses the following Filter Options.

Cyclic Color Table

The Geocap color cycle is: Green, Blue, Yellow, Light Blue, Violet, Pale Blue, Brown, Indigo, White, and Red.

Data Name

Every Dataset in Geocap has a name, Right-click on the dataset and select "rename" to give the dataset a new name

Data Property

Every dataset in Geocap have many data properties. Right click on the dataset and select "Properties" to open the Data Property Dialog.

Data Property Dialogue

The following data properties can be viewed:

1) General, holding general information about the dataset

2) Dimension, geographic dimensions of the dataset

3) History, showing where the dataset is coming from, e.g. import from disk

The following data properties can be set by the user:

1) Geodetics. If not set by the program, the user should set the geodetic properties to that of the dataset

2) Custom. The user can here define fields with values. For instance, if the dataset is a well, the user could define a field called Reserves and add the reserve values for that field

If a custom property is set on a folder, the user can populate the property down onto all folders/dataset under that folder. The advantage with properties is that the property can be used to filter the visibility and execution of Command Objects.

Data Types

The Geocap datatypes are :

Polydata: Points, lines and triangle strips.

Image Data: Grids and Images.

Seismic Lines: Seismic lines.

Well: Wells with general well info as geographic location, TD, Tops, and Deviation, and time-depth relationship.

Logs: Well Logs (attached to a well).

Ihorizon: Interpreted seismic horizon.

Color Table: A color table.

Camera: A camera position.

Script: A tcl script/program (code in text format, but executable from within Geocap).

Image: An image, e.g. png, bmp or tiff format.

Digitize

It is sometimes necessary for the user to interact with the data in the project by digitizing points/lines. Some examples of need to digitizing are:

Seismic interpretation
The user digitizes along a seismic reflector. Such digitizing is performed in 3D mode. The seismic interpretation later normally serves as input to gridding of surfaces

Reference Grid
If the user wants to control where the gridding algorithm is done, this is normally done by digitizing a reference grid. Such digitizing is performed in 2D mode.

Contours
If the user wants to convert a normal paper map to a digital model, this is done by digitizing the contours with correct contour values after the map has been calibrated and is displayed in its correct position. Such digitizing is performed in 2D mode.

Cultural Data
Examples of such are licenses boundaries or political boundaries. The input could be a calibrated map. Such digitizing is performed in 2D mode

Field Data

The user is free to import data with more information per data point than that of z and the scalar value. Such extra fields can be of types text or number. An example of field data could be the Line name and depth to seabed, in a navigation dataset. Another example is for stacking velocities with the following fields X(Longitude) Y(Latitude) Z(Depth in time) S(Shot Point) Vel(Stacking Velocity). An example is that each point in a dataset is a city with number of citizens in S and the city name is in a Field Data called City. This will give the user the ability to plot city names next to the points. Data with Field data are often suitable for Shape Export.

Filter Options

There are 4 main filter options

Data Name: Only visible when the name is matched. Wild Card is supported.
Data Type: Only visible for the selected data types.
Data Property: The user is allowed to define certain data properties. This is a very powerful tool. For instance the user can set all surfaces from Gregory in a folder to have property "SurfaceSource"="Gregory". The user can then use this property to ensure that a certain command is only executed on the surfaces which have this property.
Data Schema: Geocap user schema to control the relationship between data and commands. Commands in a certain schema will only be visible for in folders, and for data which are set to that schema.

Filter on Name

The command object will only be executed on/ visible to Project Manager Entities which satisfy the criteria given in this section. If the user wants the Command object to only be visible for data which have "GAD" in the data name, the user would specify this by setting the Filter by Name - field to "GAD" , and selecting the "Wildcards" as filter Method.

Filter on Type

The command object will only be executed-on/ visible-to Project Manager Entities.which satisfy the criteria given in this section. To select entities, toggle the filter-by-type on, and select Add.

Filters

Each Command Object in Geocap has a filter. The filter controls the command visibility and Execution of the commands. Each Command Object comes with standard filter settings under the tab called System. In the User filter tab, the user is allowed to customize a Command Object's filter options

Folder Types

Geocap data is stored in the following types of folders:>

Collection
Colour Tables
Commands
Generic. Holds most standard datatypes, e.g. images, grids, points, and lines.
Horizons
Interpretation. Holds seismic interpretations including seismic horizons, faults, and user observations. Read about seismic interpretation to learn more.
Models. These folders hold surfaces used in volumetric calculations. Parameter grids (porosity, permeability, and net-gross) are also stored in these folders. Read about Volumetric Calculations/Reservoir to learn more about this subject.
Scripts. The user can store scripts/programs in these folders. the scripts can be executed by right clicking on them and selecting Execute
Seismic Lines
Wells. Holds basic well information including, basic well info, deviations, time-depth relationship, well tops, and well logs.

Geocalibration

It is possible to calibrate section and maps into Geocap.

Geocap Command Language

Geocap comes with a library of 200 commands which gives the user lots of flexibility and power with respect to data management. The user can load the data into the Geocap memory / Workspace ] and perform operations directly on the data in memory. If desired, data in workspace can be copied into the Project Manager for storage.

Geocap Command Objects Dictionary

The commands (or command objects) reside in a repository that is visible when one right click in the Commands toolbox and ask for a new command. Like wise the commands will be listed when doing: Toolbar Exit > Schemas .

Geocap Command Reference Manual

Link to the Command Reference Manual

Geocap Workspace

Geocap can handle many dataset in memory = workspace locations. To move a dataset into memory, simply right click and select copy to workspace. The memory location will by default inherit the data name in the project manager. To move data from workspace to the project manager, simply right click on the target project folder and select copy from workspace. Workspace is deleted upon shutdown of Geocap. It is also possible to store an entire workspace session in the project manager. Click on a folder of type Workspace, right-click and select store workspace session

Geocap color numbers

0 is Black, 1 is Red

Graphic Window

The user is free to create several graphical windows. The windows can be used independently of each other. Only one window can ba active at one time. To activate a window click on its frame. To create a new graphical window, select File > New > Graphics Window. To Cascade or tile, select Window > Cascade or Window > Tile.

Grid

A framework of crisscrossed or parallel bars; a grating or mesh.2. Something resembling a framework of crisscrossed parallel bars, as in rigidity or organization: The city's streets form a grid.3. A pattern of regularly spaced horizontal and vertical lines forming squares on a map, a chart, an aerial photograph, or an optical device, used as a reference for locating points.

Gridding

The process of forming a uniform grid, often from a non-uniform distribution of points. A grid surface will has a regular distribution of the grid nodes in 2D, i.e. Rows x Columns. Each grid node holds the Z position of the surface. Each node can hold more than one property, e.g. porosity, tangent of slope, or velocity. A grid cube contains nodes regularly spaced in 3D, e.g. Rows x Columns X Layers. Each cube node can hold multiple attributes, e.g. reservoir attributes.

Indirect Mode

When a Command Object is set to indirect mode, the Command Object Parameter-Setting Dialogue opens up before command execution. This gives the user the ability to trip command parameters in advance of execution.

Point Limit

To ensure that the graphical display can cope, Geocap has an upper limit for advanced point display set to 30000.

Project Folders

Hold the project data. Sub folders are supported. Different types of data are stored in different Folder Types.

Project Manager

Is the place where the user(s) store all the project data. In the project manager, the data is organized in Project Folders.

Project Manager Entities

Dataset or folders in the Project Manager.

2 types of dataset and folders are recognized

Folders. There are many categories of folders in Geocap. The folder category tells something about what type of dataset a folder contains. For instance, a seismic 2D line will be held in a folder of type Seismic Lines. For more folder types: Geocap Folder List . It is possible to filter commands on folders, i.e. to tell Geocap that a certain command should only be visible on folders of a certain type.
Data Types. All data in the Project Manager belong to a Geocap Data Type. It is possible to filter commands on folders, i.e. to tell Geocap that a certain command should only be visible on folders of a certain type.

Reference Grid

A reference grid is used to control the gridding process. When a reference grid is used, the result grid will always be the same as the reference grid, but with grid nodes with values. The reference grid has zero value in all grid cells. A reference grid is normally constructed within digitized polygon(s) and contain no values.

Scalar Value

All data in Geocap have a scalar value field. Whist the X, Y, and Z determine the geographical position of a data point, the scalar value can hold some other parameter, e.g. porosity, or degree of slope, or shot point number at a point. Note that all also grid values have a scalar field which can hold a value. When the scalar value is not used, it is often set to 0 or to that of the Z field. If more than 1 numeric extra field is required, Geocap allows the user to construct Field Data fields in addition to the scalar field.

Schema Types

Dataset in Geocap can be assigned a schema type. The schema type tells Geocap that a dataset is of a certain type. The schema type therefore tells Geocap which object commands that are relevant for that dataset. The see the Geocap schema types, go to the top pull-down menu of Geocap. Select Edit - > Type Schemas. The window coming up will list all the type schemas on the left hand side. By clicking on a type schema, e.g. Seismic 2D line Geocap will in the lower right hand side of the window list the command objects which will pop-up as default when the user right clicks on a dataset set to this schema type. Please note that if the user marks a command, say "Display Seismic" and marks this by clicking on the green check box above, the Display seismic command will be set to Default Execution Command for this schema type. This means that if the user double-clicks on any seismic line in the project manager, Geocap will execute the Display command on this line, i.e. display the line. The user is free to add commands to a type schema command list. The user can change the default execute command for a type schema.

Script

A sequence of Geocap commands in the syntax of TCL. Geocap TCL-command language has full support of menu building, through the usage of Qtcl. For more information, see Geocap Command Language. and Script Example Library

Script Example Library

Script Example Library. To see script examples go to the Geocap installation and look into the script folder.

Shape Export

Geocap supports shape export.

Smoothing

Smoothing is the process of making grid values more uniform (alike). Smoothing used with care will remove unwanted noise from a dataset. Smoothing used carelessly will even out the data to such an extent that real data is lost. Smoothing is commonly used iteratively, where one obtains a larger degree of smoothing with an increasing step of runs.

Standard Color Table

At all times, Geocap operates with 2 standard color tables, "Seismic" (used for seismic display) and "Standard" (used for surface display). The user can view which color tables are active by examining the combo box present in the lower right hand corner of the Geocap window frame. To change standard color table, open the Geocap toolbox by selecting View > Toolbox from the Geocap pull-down menu system. Then, in the toolbox, click on the "Color Tables" tab. To set a table as standard, right click on the desired color table and select "Activate".

Window Tab

The user is free to create several window tabs. Each tab can function independently of each other, and can hold several Graphic Windows. To create a new tab, use the top buttons in the upper right (create new) and upper left (delete tab) corners of the graphical space.

Z value

Normally the Z value of Geocap data determines where the data is located on the Z axis. Not that in Geocap, the user decides the display direction of the Z-axis (positive up or down)