About Echocheck

This page covers:

Overview of Echocheck

Echocheck is a stand-alone utility designed to test echosounder data files. Echocheck will scan data files for certain corruptions and problems that could cause Echoview to fail. We recommend running Echocheck on any data files that cause problems with Echoview. In some cases Echoview support may be able to assist you in repairing a damaged file.

Echocheck will process the following types of data files:

Note: Compressed .sm2000 files are not supported by Echocheck, but they can be uncompressed into a supported format using EchozipSM on an earlier version of Echoview.

Installing Echocheck

Echocheck is selected by default when installing Echoview from the download available on the Echoview website, or on an Echoview USB drive.

Using Echocheck

To check one or more files for errors:

  1. Open Echocheck.

  2. Click Select files.

  3. Select the file(s) you wish to check for errors.
    Note:
    If you are checking BI500 files, you should only select the -ping file, Echocheck will automatically check the related -vlog and -info files.

  4. Click Open to display a list of all possible telegram/tuple/datagram types available from the selected file type(s).

  5. Select the telegram/tuple/datagram types you wish to check.
    Note:
    You can select individual types or click All to selected all types. To clear all selections, click None.

  6. Do you want Echocheck to stop checking the file when it detects a certain number of errors and warnings?

  7. If yes, go to the next step.

  8. If no, go to step 11.

  1. On the File menu, click Advanced options ...

  2. In the Limit errors and warnings to box, enter the number of errors and warnings at which Echocheck should stop checking the file.

  3. Set other advanced options as required.
    Note:
    If you do not define a range of telegrams/tuples/datagrams to limit the check to here, the output may be very voluminous.

  4. Click OK.

  5. Click Check.

Results of the check are displayed in the Output box with errors summarized in the Errors box (a Summary window may also appear after the check - see Advanced options). You can copy text from the Output box for pasting into other applications.

Errors and Warnings

Echocheck can report the following types of errors and warnings.

Type

Description

Serious error

There is a serious problem with the structure of the file and Echocheck is unable to access the file's component records (i.e. telegrams, tuples, datagrams, etc.). Echocheck is only able to process the file up to the point where the serious error is detected. Echoview will most likely fail when reading the file.

Error

There is a serious problem within a record. Echocheck can still process the remainder of the file. Echoview will most likely have problems processing this record, and may fail.

Warning

There is a problem within a record where a particular value is outside its expected range. Echoview should not fail, however the results for that record may be suspect.

You can click on any warning or error in the Errors box and Echocheck will highlight the line in the Output box which generated this error.

Advanced Options

You set advanced checking option on the Advanced Options dialog box.

To display the Advanced Options dialog box:

Setting

Description

Display warnings

If selected, warnings are displayed in the Output box and Summary window.

Display summary after check

If selected, the Summary window is displayed when the file has been checked.

Limit errors and warnings

Sets an upper limit to the number of errors and warnings that can be detected before the checking operation is stopped.

Telegram/tuple/datagram range

Defines a range of telegrams/tuples/datagrams to check. To set a range, select the Limit range checked to option and enter values in the Start and End boxes.

Output format

Selects the formatting method applied to the results that are displayed in the Output box. The available options are designed to make it easy to copy and paste data into other applications

See also

Solutions to common problems