Settings to the right override those to the left. For example Data file settings override Default settings. Fileset (aka Global), SourceCal and LocalCal settings are specified in an ECS file.
The Echoview calibration supplement file (ECS file) enables you to change calibration values used in calculations for you data. The ECS file is a text file that is added to a fileset using the Calibration section of the Filesets window. The file can be edited in a plain text editor (like Notepad) and may contain settings that modify Calibration sources. Only acoustic variables that belong to the fileset associated with the ECS file will have access to the calibration settings the ECS file defines.
The Calibration section of the Calibration page of the Variable Properties dialog box is where you can:
Appropriate calibration values, from an ECS file can be applied automatically or specifically, and allow your data to be analyzed quantitatively.
Echoview offers a process in which a templated ECS file is created and tailored to your data; this file can contain (source) Calibration values that are used, and file administration comments.
Notes:
Settings to the right override those to the left. For example Data file settings override Default settings. Fileset (aka Global), SourceCal and LocalCal settings are specified in an ECS file.
|
[a..z], [A...Z], [0...9] Decimal point Punctuation, Braces, other characters |
Calibration setting names are limited to alphanumeric characters. All alphabet text is case insensitive. To improve readability, use words delineated by capitalized initials (CamelCase).
|
| # |
Use # before text to indicate a comment. The file can contain other information as comments (in any language). A comment starts with the comment character #, and continues to the end of the line. A comment can occur on a line by itself or follow text used by Echoview. Comments are ignored by Echoview. For example:
|
| Keywords | Version, SourceCal, LocalCal |
| Calibration source name | Calibration source name |
| Calibration setting name | Calibration settings |
| an equals sign [ = ] | Used between a calibration setting name and the setting's value. |
| a space |
Spaces are ignored unless they break up a name or number. Spaces are also used to separate values in an array. |
| a value |
A calibration setting's value. Often, this is a numerical value but some calibration settings are specified by a string of text. |
The Calibration source for an acoustic variable is listed under the SouceCal in the Calibration section of the Calibration page of the Variable Properties dialog box.
Every raw variable has a source from which it derives its calibration. Calibration sources are derived from data files in the fileset. The name of this source is the familiar description, derived from the transducer and channel names, added to the end of the raw variable name. For example:
The raw variable Sv Ping T1 uses the Calibration source T1.
The ME70 raw variable Sv pings formed beams uses the Calibration source "formed beams".
Even if no calibration data is available in the file, a Calibration source still exists, but it is empty.
A fileset can have more than one (data-derived) Calibration source. Multiple Calibration sources may arise because the data is multiplexed into channels or records more than one frequency.
You can modify calibration with an ECS file in the following ways:
| Echoview Calibration Supplement feature | Action | ||||
|
List of calibration settings at the beginning of the ECS file.
CalibrationName = value
|
Calibration settings that are added to at the start of the ECS file are fileset-level calibration values. Fileset-level settings override settings of the same name in all fileset Calibration sources. For example:
This gives a value for sound speed for all Calibration sources (and hence all variables) in the fileset, even those not named in the ECS file. If values for sound speed are given in the data files they are ignored. The value can be modified again by using SourceCal or LocalCal. Each calibration setting is on a line by itself. The setting consists of a calibration name (which is all one word), an equals, and a value (in this case a number). Calibration names are case insensitive. |
||||
|
SourceCal NameOfExistingSource followed by a list of
CalibrationName = value |
The keyword SourceCal directs Echoview to use the specified calibration values together with the settings in the named Calibration source that are not over-ridden by custom values. For example:
This gives values for absorption to be used with the settings in Calibration source T1. If the data files have values for absorption or pulse length for Calibration source T1, the specified values will override the pre-exisiting values. A warning is given if no such Calibration source is found. The SourceCal declaration is on a line by itself. SourceCal and the Calibration source name are not case sensitive. |
||||
|
followed by a list of
CalibrationName = value |
The keyword LocalCal specifies a group of calibration settings which override a variable's source calibration. The distinction (under LocalCal) is that such settings can be applied in a local way to a single variable. This is in constrast to SourceCal which overrides or supplements values for all variables that use the calibration source. LocalCal names support international characters. For example:
MySet appears under the LocalCal list on the Calibration page of the Variable Properties dialog box. The LocalCal settings respect prior Fileset settings and the SourceCal settings. The LocalCal declaration is on a line by itself. LocalCal and the name are not case sensitive. The use of LocalCal is described in the Example.
|
The calibration settings that Echoview uses can be viewed and modified when you use:
Notes:
Each calibration setting is on a line by itself. The setting consists of a name (which is all one word), an equals, and a value. Calibration setting names are not case sensitive.
Note: Information includes Calibration name, Help file terminology, ECS example, Default value, Decimal places, Minimum value and Maximum value.
A summary of how the calibration settings are used for derived raw variables is available on the following pages:
Keywords: Version
An ECS file created by New on the Filesets window, starts with a version declaration, For example:
Version 1.00
The version number affects error handling.
Echoview may display diagnositic warnings and error messages about the content of an ECS file. Such messages are sent to the Message dialog box. Any errors cause the ECS file to be ignored.
Warnings are of the form:
Calibration file 'FileName', on line N (Cal): Message
where:
Errors are of the form:
Ignored calibration file 'FileName' because on line N (Cal): Message
where:
For variables that use T1:
|
Supplemental calibration settings from |
Calibration settings used |
|
SourceCal T1 |
SourceCal T1 respects the fileset settings and then uses SourceCal T1 values followed by T1 values that have not been over-ridden.
|
|
LocalCal MyCal |
MyCal respects fileset and SourceCal T1 settings and then uses the MyCal values followed by the variable's Calibration Source values that have not been over-ridden.
|
Variables with other calibration sources (e.g., T2) will not be affected by SourceCal T1, but will list MyCal and be influenced by the Fileset calibration settings.
About calibration settings
About entering calibration settings
ECS and new EV files
ECS and pre-version 5.0 EV files
ECS file error handling
Calibration settings for data formats
Calibration settings for virtual variables
