Eye4Software Hydromagic

  Hydrographic Survey Software

Download free demo version

Importing sounding data

The ASCII import function in Hydromagic allows you to import soundings written in ASCII format.
For instance, to import a sounding exported from another Hydromagic project, or created with other software.

Import sounding data using the ASCII import function
The import ASCII sounding dialog which allows you to import (amongst others) sounding data.

Open the "Import ASCII Data" dialog

The dialog can be opened by selecting "File"=>"Import"=>"Import ASCII Data..." from the main menu. Depending on your software configuration there could be a shortcut button in the toolbar as well.

Open the ASCII import function
One way to open the ASCII import tool is via the "File" => "Import" item in the main menu.

Select input file

Click the "Browse..." button to select the file to be imported. All files will be displayed, there is no file extension filter applied.
Some file extensions that are commonly used for ASCII files include: *.ASC, *.TXT, *.LOG and *.CSV.

Since version 9.0, Hydromagic supports reading of ASCII files saved as regular text files (ANSI), UTF8, UTF8-BOM or UNICODE encoding, since the software will automatically detect the file encoding used. When using an older version, make sure the ASCII file is saved as ANSI or UTF8 (which would be the case in most scenarios).

The imported file is never modified by this software. This dialog can also be used to import boundaries, matrices and waypoints.
Make sure that the "Import data as" option has been set to "Sounding" when you want to import a sounding.

Select sounding as import data type
To interpret the selected ASCII file as sounding data, select "Sounding".

Field Separator

This value is set to "Auto" by default, which means that the software will try to detect which character is used to separate the data fields in the ASCII file.
In most cases you do not have to adjust this value. Use only when the automatic setting does not work for you.

Select field separator for the file to be imported
Select the separator used between the values or use "Auto" to detect automatically.

Skipping lines and fields

In cases where the data does not start on the first line of the file (for instance, when header names are present),
you can skip these lines by increasing the "Number of lines to skip from start of file" setting.

The "Number of fields to skip from start of line" option can be used in cases where there are fields before the actual XYZ data, for instance, record id's.
You can use the "View" button to show the contents of the ASCII file to see whether these options apply to your input file.

Coordinate field order

This option is to set the order of the coordinate fields in the file.
The following settings are supported:

When a third field is present in the file, it will be interpreted as depths.
Most software stores soundings in XYZ format, so selecting "Easting, Northing" here would probably work in most cases.

Select coordinate axis order for the file to be imported
Select the order of coordinate fields in the file.

Coordinate field format

When the input files contains values in geographic format (i.e. latitude and longitude), and the coordinates are stored in degrees,
minutes and seconds format, or degrees and minutes format, use this option to select the correct value.

When coordinates are stored in decimal values, leave the default "Decimal" option selected.

Select format of geographic coordinates for the file to be imported
When importing geographic coordinates, select the format used.

Numeric values format

In most cases you will encounter files where floating point values are stored in a format where a dot is used as decimal separator. It is possible, that in some cases the data has been exported by third party software using a different format. For instance a comma could be used as decimal separator, or the minus symbol is behind the value instead of in front of it.

Select format of the floating point values inside the file
Click the "Select..." button next to the "numeric value format" to change the locale.

To define another floating point number format to be used when parsing the ASCII file, click the "Select..." button next to the "Numeric field format" setting so select another format (also called locale). In the dialog box that appears, select the region or locale that was used to generate the file. Examples of the number format will be updated while you browse to the countries.

Use the numeric format dialog box to try out various formats
Use the numeric format dialog box to try out various formats.

Please note that you do not have to select the same locale as was used to generate the ASCII file. As soon as the number format matches you should be good.

Projection and Units

The software needs to now which projection is used in the file (only when Northing and Easting coordinates are used instead of Latitude and Longitude),
so it can be referenced to WGS84 coordinates. When altitude or depth values are present in the file, you also have to select the (vertical) units used.

Select coordinate reference system for the file to be imported
Make sure to select the coordinate reference system used in
the file when different from the current project.

Importing the file

Just click "OK" to start processing the ASCII file. When all parameters were entered correctly, the imported sounding should appear in the "Project Explorer". In case of problems, you can always check the content of the Activity View's "Processing" tab.