Qimera Project Sources Dock


Qimera - Project Sources

The Project Sources tab of the Source Files Panel shown in the Source Files Tab figure above shows all of the files currently loaded into a project. If you have loaded directories of files, the directory hierarchy will be preserved in the Source Files Tree.  There are 5 primary root nodes in the tree.  Raw Sonar Files, Processed Point Files, Position & Motion Files, Tide Files and Sound Velocity Profiles. 

Source File Tree Nodes

Raw Sonar Files

These nodes are raw sonar files you have imported for Sound Velocity Correction, Dynamic Surface generation and Swath and 3D Editing operations. A list of supported formats can be found here

Processed Point Files

These nodes are processed point files you have imported for Dynamic Surface generation and 3D Editing operations.  A list of supported formats can be found here

Position & Motion Files

These nodes are either ASCII or binary position and motion files that you have imported to be used during Sound Velocity Correction or Re-Navigation processing.  A list of supported formats can be found here

Tides

Tide nodes represent tidal data brought into the project to support final height determination in the sound velocity correction pipeline or as a Re-Navigation operation. Tide nodes are divided into two categories: tide stations and tide strategies.

Tide stations represent a set of tide measurements all measured at the same location, against the same datum, in the same unit and in the same timezone. Each tide station can contain many tide files, which are shown as its children in the tree. A list of supported tide file formats can be found here.

Tide strategies combine and/or transform the tide data from one or more tide stations to allow for advanced tide modelling. A tide strategy can do weighted interpolation of data between stations or establish a zone inside with station data are offset or scaled. Tide strategies are powerful building blocks from which very complex tide scenarios can be modeled.

Sound Velocity Profiles

These nodes represent imported data or data extracted from raw sonar files during import.  They are displayed here so that you can more easily delete them if they are not needed.  They are used during Sound Velocity Correction.  A list of supported formats can be found here.

Selection and Visibility

When you select a raw sonar file in the tree, the corresponding track line in the 4D Scene will highlight.  Conversely, when you select a track line in the 4D Scene, the associated raw sonar node will highlight. Change the visibility of the node in the 4D Scene by changing the state of the checkbox.  Checked is visible, unchecked is invisible.

Raw Sonar File Processing State

When raw sonar files are added to Qimera, they need to ultimately get converted into QPD files through Sound Velocity Correction.  If a sonar file requires processing, the auto-solve icon will appear at the right side of the window as shown below.  If you hover over the icon, Qimera will tell you exactly which type of processing needs to be accomplished.  Whenever you modify data or settings that affect the line, Qimera will know this using the Dynamic Workflow engine and mark the line as requiring further processing.

 

Pressing the Auto Solve icon will cause the line to be processed.  During processing, you will see the job in the Activity Monitor as well as an indication next to the line as to the remaining duration of it's processing

Right Click Context Menus

Because many actions are available to multiple file types the actions are annotated by a type number 1-6 associated with the menus listed below.

Raw Sonar File Context Menu (type 1)

Processed Point File Context Menu (type 2)

Position & Motion File Context Menu (type 3)

Tide Station and Tide File Context Menu (type 4)

Tide Strategy Context Menu (type 5)

Sound Velocity Context Menu (type 6)

Context Menu Actions

Add Raw Sonar Files (1)

 This action will launch the Qimera Add Raw Sonar Files Dialog dialog to add raw sonar files to your project.

Add Point Sonar Files (2)

This action will launch the Add Point Files dialog to add processed point files to your project.

Load Associated DB File (2)

Shown only for QPD files, this action will attempt to find and load the corresponding DB file, replacing the QPD file in the source tree in the process. This essentially upgrades the line from point cleaning only to being fully reprocessable.

Add Binary Navigation Files (3)

This action will launch the Navigation Import dialog.

Add Tide Files (4)

This action will launch the Add Tide File dialog to start the tide file import process, which is also how tide stations are created.

Edit Tide Station (4)

This action launches the Tide Station dialog to edit the properties of an existing tide station. Note that not all properties are editable after creation.

Create Tide Strategy (5)

This action will launch the Tide Strategy dialog to create a new tide strategy.

Edit Tide Strategy (5)

This action launches the Tide Strategy dialog to edit the properties of an existing tide strategy. Note that not all properties are editable after creation.

SVP Editor (6)

This action will launch the Qimera SVP Editor for the current selection.

Select Associated Source Files (6)

This action will select all of the sonar files that use this SVP. 

This action initiates a "Dry Run" of the refraction engine to determine which files utilize the SVP according to the users processing settings.

Append Lines to a Dynamic Surface (1,2)

This action will launch the Append Lines dialog to append the current selection to a Dynamic Surface.

Remove Lines from a Dynamic Surface (1,2)

This action will launch the Remove Lines dialog to remove the current selection from a Dynamic Surface.

Generate Metadata (2)

This action re-generations the metadata for the processed point file.

Edit File Configuration (2)

This action will launch the File Configuration dialog for the current selection.

Edit TPU Setup (2)

This action will launch the TPU Calculation dialog for the current selection.

Unload Changes (2)

This action will launch the Qimera Unload Processed Point File Dialog for the current selection.

Edit Processing Parameters (1)

This action will launch the Processing Parameters dialog for the current selection.

Edit Vessel Configuration (1)

This action will launch the Vessel Editor for the current line selection.

Edit Modified Flags (1)

This action will launch the Manual Modified Flags dialog allowing the user to manually clear or set processing flags.

Dry Run (1)

This action will launch the Dry Run dialog allowing the user to test run the configuration setup for the processing of the selected lines.

Link Area Selection (1)

This action will link an area selection to the selected line.  See the section on Dynamic Selection Mode in the  4D Scene Toolbar  section for more details.

Select in Area (1)

This action will deselect any line not in overlapping the selected area in the 4D view.

Export (1,2)

Export Processed Points (1,2)

This option will start the  Export Processed Points Dialog for the selected lines.

Export GSF (1)

This option will export the currently selected raw sonar files to GSF files.  The exported data will appear in the project ~/Export sub-directory.

Export FAU (1,2)

This option will export the currently selected raw sonar files to FAU files.  The exported data will appear in the project ~/Export sub-directory.

Export QTR (1,2)

This option will export the currently selected raw sonar files to QTR files.  The exported data will appear in the project ~/Export sub-directory.

Export Tracks to ASCII (1)

This option will export ASCII files containing date/time, x, y, and z for the currently selected raw sonar files.  The exported data will appear in the project ~/Export sub-directory.  A separate file will be exported for the center of gravity and each sonar head.

Add Group (1,2,3,6)

This action will add a custom named group to the tree hierarchy.

Rename Group (1,2,3,6)

This action will launch the Rename Group dialog to change the name of the selected group.

Organize Sub-Menu (1,2,3,6)

Appears when clicking on groups and provides options for (re)organising source files within the group. Alphabetize reorders files and groups to appear in alphabetical order, while preserving any group hierarchy. The Regroup by... actions create a hierarchy of groups and sort the files into them. Different file types support different Regroup by... operations, but the options are: Regroup by Vessel, Regroup by Vessel and Day, Regroup by Day and Vessel, Regroup by Day, Regroup by File Path. Remove All Grouping flattens the hierarchy by removing all groups while preserving file ordering.

Note that Organize menu operations are not automatically reapplied if files are later added to or removed from the project. They are one-off operations to organize the source files according to a particular scheme, but the user still has the option to customize via the creation of custom groups or drag-and-drop reordering.

Remove (1,2,3,4,5,6)

This action will remove the current selection from the project. Using the shortcut key 'Del' will also remove the current selection from the project.

Zoom to Bounds (1,2,3,4,5,6)

This action will zoom the scene to the bounds of the current selection.

File Paths  (1,2,3,4,5)

Open Containing Folder (1,2,3,4,5)

This action opens a file browser showing the folder containing the selected file.

Find New File Location... (1,2,3,4,5)

This actions allows you to point Qimera to the new location of a file that has moved since it was add to the project. Qimera will use this new location to try to find any other missing files.

Find Matching QPD... (1)

This action will allow you to find the matching QPD for a loaded DB file that failed to match during metadata extraction.

Find Matching WCD... (1)

This action will allow you to find the matching WCD file (Kongsberg water column data) for a loaded Kongsberg raw sonar file that failed to match during metadata extraction.

Datagram Viewer (1,2,3)

This action will launch the Datagram Viewer dialog showing key metadata of the selected file.



Return to: Qimera Interface

Return to: Dockable Windows