Qimera Export Soundings to ASCII Dialog

How to Start

  1. to ASCII... option of the Export→Raw Sonar File sub-menu of the Main Menu toolbar. 
  2. to ASCII... option of the Export→Processed Point File sub-menu of the Main Menu toolbar. 
  3. to ASCII... option of the Source→Export sub-menu when selecting a file in the Project Sources window. 


What it Does

This dialog is used to Export Soundings to ASCII format with user configurable fields. 


General Description

This dialog can be used to export user configurable ASCII files on a per file basis or merged into a single dataset. If you have created a dynamic or static surface and selected an area in the main work area you can limit the export to that region. 


Fields

Each field can be enabled or disabled by clicking the checkbox for the corresponding item. The fields can be moved by drag and drop or by selecting the desired field and using the Move Up and Move Down buttons. Global checking and unchecking can be performed using the corresponding buttons Check All and Uncheck All. The initial ordering of the Fields List is aphabetical and can be re-applied using Reset Order button. Once selection and ordering are completed the configuration will be saved when the Ok button is clicked. This configuration will automatically be loaded when the dialog is launched. 


Format Options

Selecting the Include Header checkbox will result in the final output file containing a header reflecting the selection in the Fields Group. The Header text will be preceded by '#' and include the selected Separator between the fields. 

The Separator combobox allows the user to choose from a pre-set list or enter a custom, single character, separator. When selecting the Custom option a Textfield is displayed allowing the user to enter their desired separator. 

The Time Format can be modified when the Date Time field is selected in the Fields list. There are several predefined formats that can be selected or the user can enter their own format in the combobox. An ASCII example of the selected format output is displayed below the Time Format combobox.  The Time Format expression can be separated by any ASCII character the user chooses. The last used Time Format will be saved and loaded by default when the user selects 'OK' to start the export. 

The following formatting options can be used when manually creating a Time Format

ExpressionOutput
hthe hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
hhthe hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
mthe minute without a leading zero (0 to 59)
mmthe minute with a leading zero (00 to 59)
sthe second without a leading zero (0 to 59)
ssthe second with a leading zero (00 to 59)
zthe milliseconds without a leading zero (0 to 999)
zzzthe milliseconds with leading zeros (000 to 999)
AP or AAM/PM display (upper-case)
ap or aam/pm display (lower-case)
ExpressionOutput
dthe day as number without a leading zero (1 to 31)
ddthe day as number with a leading zero (01 to 31)
dddthe abbreviated day name (Mon to Sun)
ddddthe full day name (Monday to Sunday)
Mthe month as a number without a leading zero (1-12)
MMthe month as a number with a leading zero (01-12)
MMMthe abbreviated month name (Jan to Dec)
MMMMthe full month name (January to December)
yythe year as two digit number (00 - 99)
yyyythe year as a four digit number (2018)


Data Options

Selecting the Invert Z option will invert all height values. Currently this corresponds to Footprint Z, Transducer Z and Vessel Z. 

Selecting the Filter Soundings... Button allows additional filtering options by launching the Filter Dialog.

Filter Dialog

The Filter dialog allows filtering of the of data prior to exporting. All user selections will be saved on export excluding the Scope of Record and Systems list for all future exports. 

Scope Of Record

If a selection is made using one of the selection tools in the main work area, this option will allow the user to export based on that selection or the entire area. If the scope of record option is not visible, your selection may have been cleared prior to launching the dialog.

Base Record Selection On

Filter soundings based on All Soundings, Accepted Soundings or Rejected Soundings. 

Refine Selection

Filter soundings based on flags applied by the user at a previous processing stage.

Systems

In the case of a multi device systems, a filter can be used to remove additional data collection systems by unticking the corresponding system box.  


Output coordinate System

The output coordinate system allows the user to change the coordinate system that the resulting output will be referenced to. By default the project system will be set on launch. 

Export Options

If multiple files are selected for export these can be merged into one single export file using the Merge radio button or written to individual files using the Convert each file individually radio button. Folders and files can be created using the corresponding browse buttons or entering text into the fields following your operating system convention. 


Return to: Qimera Interface

Return to: Wizards and Dialogs