Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

Introduction

The interface to the UNCLOS specific features There are a few concepts in Geocap are through the use of schemas on datasets and commands. The commands can be found in the Toolbox to the right in the Geocap interface or at the top of the menu which appear when you right click a dataset. Which commands are displayed in the right click menu depend on the schema of the dataset. A Base Line will contain commands appropriate for the Base Line schema, while a Bathymetric Profile will contain different commandswhich are important to understand in order to work efficiently with the software. The main concepts are Actors, Schemas, Geodetic Settings and Commands. These concepts will be explained in this section. In addition to this section also talks about toolbars, color tables and keyboard short cuts.

Exercises

Table of Contents
maxLevel3
minLevel3

Actors

In display context an actor is a graphical term for a visualization unit. A complex display is created by a set of actors. Actors are shown as child's of datasets and are shown in blue text. In Geocap the basic principle is that a display command creates one or several actors. It is possible to remove the actors and the associated display by right clicking and selecting Delete

Image Modified
Visualizations are called actors

Schemas

By default datasets are organized into data types, such as points and lines (polydata), grids (structured points) etc. These are basic geometric types that contain little information about the domain in which they operate. E.g. coast lines, bathymetric profiles and boundary polygons are all lines (polydata), but the way we work with these types of data are very different and so it is only natural to classify them into different categories. This higher level of classification is made possible by schemas

...

The Shelf Module contains several schemas. Some of the schemas used in the Shelf Module are coast linebase linelimit lineseabed surfacesediment thickness. You can define the schema of a dataset in the project by right clicking it, and selecting set schema in the pop-up menu. The choice of a dataset´s schema controls which commands you see in the pop-up menu when you right click the dataset. You may create your own schemas as well as edit existing schemas by selecting schemas under edit in the main menu. You can also edit the commands associated with the schemas.

Commands

Commands are operations which can be performed on a dataset. Commands can for example be used to display a dataset in the display window, or to generate new datasets. You can even create your own scripted commands to cater to your specific needs. You execute a command by right clicking the dataset or folder you want to run it on, and then selecting the relevant command in the pop-up menu.

Commands have two execution modes: Direct and Interactive. If the execution mode is set to Interactive the commands editor with the front menu . You can give different parameters to a command in the command editor. These parameters are stored with the command and used during execution.will be displayed when you execute the command. This allows you to adjust various settings that define how the command works. Depending on the command, the menu will consist of different input settings from simple display settings to complex manipulation options. If the execution mode is set to Direct the command will execute with the last active input settings for the command. It is possible to see the underlying settings for any command by right clicking it in the Toolbox and selecting Edit.Note that some commands does not require input parameters and will therefore display the underlying code when running it in Interactive mode.

Tip

To see if a command is set to Direct or Interactive mode, look behind the command name. If there are ellipsis (...) behind the name, the command is set to Interactive mode.

All commands have a front end panel, and most of them have settings that may be customized.
Image Added 
 An example of a command front end panel

Commands can be stored in three categories:

...

You will find the commands sorted into the different categories in the Toolbox (see illustration below) or  or on the right-click menu of a dataset or a folder. Commands can also be put together in sequence in Workflows to perform visualizations or data operations.All commands have a front end panel, and most of them have settings that may be customized.Image Removed 
 An example of a command front end panel

Item commands

An item command is associated with a single dataset or folder in the project. Item commands are stored along with the project. Therefore, if a project is transferred the item commands will transferred as well. Item commands typically contain settings that pertain specifically to the dataset to which it belongs.

Panel
borderStyle
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercisedashed

Create an item command

  1. Go to 1. Maritime lines / 60M lines and select one of the datasets.
  2. In the Toolbox right click Display and select Edit.
  3. Set Line Width to 4.
  4. Check User defined Color and set the color to Red.
  5. Click the icon in the upper right corner of the menu and observe that the command appears in the Toolbox under Item Commands.
  6. Click Cancel (the settings will not be saved for the schema command).
  7. Right click the Display command under Item Commands and select Rename.
  8. Rename it to Display in red and click OK.
  9. Select the different lines in 1. Maritime lines / 60M lines and observe that the new Display in red command is only available for the one dataset.


Schema Commands
A schema command is stored with a schema. All datasets or folders using the same schema share these commands, which also means that editing these commands will affect all the datasets using this schema. The shared schema commands are listed on the right click menu and in the Toolbox under Schema commands

Panel
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercise
borderStyledashed

Get familiar with schema commands

  • Right click the different datasets in the project, and see how the right click menu changes from schema to schema.
Tip
titleTip

The Pin to Menu check box lets you decide which commands should be available in the right click menu, so it is easy to keep organized.  Try to experiment with this option to manipulate the right click menu.


Shared Commands
Shared Commands are commands which are shared with all datasets and folders. The shared These commands are always available and listed in the Toolbox under Shared commands

...

Default Commands
The default command is the command that is executed when you tick the box next to a dataset in the project. By default a dataset will have one of the schema commands as a default command. This can however be changed to any command.

 

Panel
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercise
borderStyledashed

Change the default display for seabed surfaces

The seabed surfaces has a default command "Map sea" or something similar.

  1. Click on the Seabed datasets in the 2.Seabed / Grids folder.
  2. In the Toolbox right-click another command (i.e LOD Grid Display) and select Set as default command
  3. Tick the checkbox next to the Seabed dataset and notice that the new command is executed.

Geodetic settings

In Geocap it is the responsibility of the user to secure that data have the correct Datum and Coordinate system, also called a Projection or Geodetic settings. Datasets with the same geographical location but with different coordinate system will not be displayed in the same location in the graphical window. Thus, you will need to convert one of the datasets to the other coordinate system.

Panel
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercise

View the geodetic settings of a dataset

  1. Right click any dataset in your project and click Properties
  2. Click on the Geodetics tab
  3. Observe the Geodetic settings of the dataset
  4. Read the warning message
  5. Click Close

You will learn how to convert datasets to other projectons later in this tutorial.

Color Tables

Geocap comes with a set of predefined color tables which can be seen in the toolbox. These color tables are of course customizable, or you can create your own color table from scratch. By default the color tables shown in the lower right corner of Geocap will be used to display a dataset. You can change these color tables by selecting one of them, right-click another color table in the toolbox and select ActivateYou can also use drag and drop to drag a color table tables from the toolbox and drop it onto a displayed dataset in the graphical window.

Panel
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExerciseborderStyledashed

Change the color table on a seabed surface

  1. Visualize a seabed surface

  2. Click on the Color Tables tab in the Toolbox

  3. Click, drag and drop one of the color tables on the seabed surface

...

Sticky Surface

Geocap has a concept where any surface can be set to be sticky. When a surface is sticky, data like points, lines or images may be displayed onto that surface. This is mainly done by re-sampling lines and displaying them a little bit above the sticky surface. When a surface is activated (or set) as a sticky surface, it is copied to workspace under the name sticky_surface. If this dataset is removed from workspace, there is no sticky surface anymore.

Panel
borderStyle
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercisedashed

Display data on the Sticky Surface

  1. Right-click on a Seabed surface dataset and select Image Removed Set as sticky surface
  2. Select a line, e.g. 1. Maritime lines > 200M lines > atlantis Baseline_Atlantis + 200M in your project.
  3. In the Toolbox under Commands > Schema commands right-click Display and click and Edit on the Image Removed Display command.
  4. Check the Glue to Sticky Surface and press Execute to do a .
  5. Investigate the line display.
  6. Uncheck the Glue to Sticky Surface and press Execute again and observe the difference.
Note
titleWarning

Note that points and lines displayed onto a sticky surface are displayed without their original z-values, and this may not be what you intend to do when displaying a foot of slope point or a bathymetric line. Keep that in mind.

Toolbar

Image RemovedImage RemovedImage Removed the so Image Removed
IconsDescription of Main Toolbar icons
Image RemovedImage AddedWill cancel any mouse action that is started but is regretted and should be ended without any operation.
Image RemovedImage AddedStart a mouse action that when clicked on a graphical object will delete that object.
Image RemovedImage AddedStart a mouse action that when clicked on a graphical object can set set appearance parameters  parameters for that object. The The appearence parameters  parameters are: Opacity, Reflection, Diffusion, Ambience.
Image RemovedImage AddedStart a mouse action where the user is supposed to click on a surface that is map with with scalar values values. The mapping range of the scalar values according to the color table can then be adjusted.
Image RemovedImage AddedStart a mouse action that when clicked on a graphical object will highlight the corresponding data object in the project.
Image AddedStart a mouse action where the user can click and draw a rectangle around displayed data and Geocap will list all dataset names and locations.
Image RemovedImage AddedWill delete all graphics in the current viewport or window (if the window holds only one viewport). The corresponding references to actors in the project are deleted. Frequently used in free interactive work.
Image RemovedImage AddedWill delete the last graphical object (also called and actor) that is displayed. Frequently used to erase a graphical object that shall be removed. Note: Redisplaying  Redisplaying data from the project using the same command will erase the previous corresponding actor.
Image RemovedImage AddedWill set the graphical window in 2D mode; i.e. only only pan and  and zoom is  is allowed. The view direction (x, y or z) depends on the corresponding setting. In 2D mode the left button on the mouse is used for immediate cursor response for instance in digitizing.
Image RemovedImage AddedWill set the graphical window in 3D mode; pan, zoom and  and 3D rolling is  is enabled. The default 3D mode renders in in perspective view; i.e. parallel lines are not parallel on the screen, but shows a perspective. The non-perspective isometric 3D mode is found under toolbar View > Perspective > 3D Isometric.
Image RemovedImage AddedWill turn the z direction of the graphical window upwards; i.e. the positive direction of the z axis points upwards.
Image RemovedImage AddedWill turn the z direction of the graphical window downwards; i.e. the positive direction of the z axis points downwards. This is the default case because most surfaces are below the zero level, but still have positive z values.
Image RemovedImage AddedWill show the graphical window as a frame box. It is important to use this icon to check the graphical window or whenever some display comes out weird if the display algorithm uses the graphical window to set display parameters.
Image RemovedImage AddedWill draw default axes for all visible axes directions. No tick marks are display for simplicity, but the exact location of an annotation position starts at the beginning of the annotation.
Image RemovedImage AddedWill open a Navigator which  which is a convenient menu for navigating a 3D graphical scene. To some (especially newbies) it can be difficult to use the mouse buttons to orientate the graphics. Be aware that rotation is around the the focal point which  which also can be set by pointing the cursor mouse at a any location on a solid object and push keyboard keyboard x.
Image RemovedImage AddedWill zoom in towards the the focal point. The graphical window is not changed, although the graphical frame may lie out the visible part of the screen.
Image RemovedImage AddedWill zoom out from the the focal point.
Image RemovedImage AddedWill Will View from above. This icon also contains sub-icons for viewing in other directions.
Image RemovedImage AddedIf several windows are created on the same same Tab, this icon connects the selected windows to the same visual camera. Very useful when different surfaces that shall be compared are displayed in separate windows that are connected and show the same under all graphical movements.
Image RemovedImage AddedWill show the the viewport menu that  that allows for a quick way to create viewports inside a window. The number and layout of the viewports are determined by just double clicking on the lower right frame in the veiwport menu. If the viewports are connected they can also by used for simultaneously display of surfaces or features that shall be compared. Here is an example of a viewport display for presentation purpose. 
Image AddedEnables the light source to be moved around in the graphical scene. Will create shadows and highlight features. Usefull for presentation graphics and detailed studies of special structures.
Image AddedWill scale the graphical scene with all its actor up or down. Very important for selecting a good view. The scaling should also preferable be set in the Project Settings so that the preferred view comes up when loading a project.
Image AddedWill show up a 2D compass in upper right that follows the rotation of the graphical window. Another click on the icon will remove the compass.
Panel
borderStyle
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExercisedashed

Try out the different tools on the toolbar

  • Try out the different tools.

Keyboard shortcuts

Geocap has several keyboard shortcuts or hotkeys. Go Help > Keyboard shortcuts to bring up a list. A selection of the most important keyboard shortcuts:

...

Panel
borderColor#404040
bgColor#F0F0F0
borderWidth1
borderStyledashed
titleExerciseborderStyledashed

Try the different keyboard shortcuts

  • Visualize a seabed surface and test all the above mentioned keyboard shortcuts.