Transition for calibration scripting

This details changes in calibration settings from Echoview 4 to Echoview 5.0, and onward.

Verify existing COM scripts you developed for Echoview 4 and earlier, that use these calibration settings.

See also About calibrated data and About automating Echoivew for information about Echoview's current calibration and scripting tools.

Echoview 4 Echoview 5

Virtual variable calibration inheritance accessed by:

  • EvCalibration.UseCalibrationInheritance
  • EvVariablesCollection.UseCalibrationInheritance

EvCalibration.UseCalibrationInheritance and EvVariablesCollection.UseCalibrationInheritance are not supported.

 

Virtual variables inherit their Transducer and SourceCal (Calibration Source) from the first operand. The first operand's LocalCal (from the operand's Calibration page of the Variable Properties dialog box) is not inherited.

As a result, COM support for calibration inheritance is not necessary. However the virtual variable's calibration settings can be set/modified using an ECS file. There are core calibration settings that virtual variables use.

Refer to Calibration for virtual variables for more information.

Access or change calibration settings using EvCalibration properties.

These properties included:

Echoview 4.90 EvCalibration property

Echoview 5.0 Calibration setting name

AbsorptionCoefficient

AbsorptionCoefficient

AbsorptionCoefficientLogging

AbsorptionCoefficientLogging

AdcCorrectionX

HarpAdcCorrectionX

AdcCorrectionY

HarpAdcCorrectionY

Aequip

HtiAequip

ApplyCalibrationCorrection

ApplyCalibrationCorrection

ApplyCalibrationFrom

No longer supported

Bandwidth

SimradBandwidth

CalibrationOffset

CalibrationOffset

ChannelGain

HarpChannelGain

EchosounderConstant

EcholistenerEchosounderConstant

Frequency

Frequency

HeadType

SM2000HeadType

HeadUseDefaults

No longer supported

InheritCalibrationSettings

No longer supported

LoggedDraft

SimradDraftLogging

MajorAxis3dbBeamAngle

MajorAxis3dbBeamAngle

MajorAxisAngleOffset

MajorAxisAngleOffset

MajorAxisAngleSensitivity

MajorAxisAngleSensitivity

MinorAxis3dbBeamAngle

MinorAxis3dbBeamAngle

MinorAxisAngleOffset

MinorAxisAngleOffset

MinorAxisAngleSensitivity

MinorAxisAngleSensitivity

NumberOfBeamsToForm

SM2000BeamsToForm

PdcCorrectionX

HarpPdcCorrectionX

PdcCorrectionY

HarpPdcCorrectionY

PdiCorrectionX

HarpPdiCorrectionX

PdiCorrectionY

HarpPdiCorrectionY

PhaseAngleCorrectionX

HarpPhaseAngleCorrectionX

PhaseAngleCorrectionY

HarpPhaseAngleCorrectionY

Radius

SM2000Radius

SaCorrection

EK60SaCorrection

SampleResolution

SimradSampleResolution

Sector

SM2000Sector

SoundSpeed

SoundSpeed

SoundSpeedLogging

SoundSpeedLogging

SourceLevel

HarpSourceLevel

Spacing

SM2000Spacing

StartSampleRange

SimradStartSampleRange

StaticGain

HarpStaticGain

StThicknessSource

No longer supported. Thickness source can be changed on the Data page.

SvGain

Ek5SvGain,

SvGainLogging

Ek5SvGainLogging

TransmittedPower

TransmittedPower

TransmittedPowerLogging

TransmittedPowerLogging

TransmittedPulseLength

TransmittedPulseLength

TransmittedPulseLengthLogging

TransmittedPulseLengthLogging

TRFactor

KaijoTRFactor

Transducer

Can determine from EvCalibration.Transducer

TsGain

Ek5TsGain

TsGainLogging

Ek5TsGainLogging

TvgRangeCorrection

TvgRangeCorrection

TvgRangeCorrectionOffset

TvgRangeCorrectionOffset

TwoWayBeamAngle

TwoWayBeamAngle

TwoWayBeamAngleLogging

TwoWayBeamAngleLogging

WaveLength

Wavelength

WaveLengthLogging

WavelengthLogging

EvCalibration methods and properties are simplified.

Access or change calibration settings in an ECS file that is added to a fileset in an EV file using:

  • EvFileset allows you to specify the ECS file and variable
  • EvCalibration allows you to read values and specify calibration settings and LocalCal

The Echoview 5 calibration setting names have changed (slightly) and many, but not all, of the Echoview 4.90 EvCalibration properties are supported by analogs in Echoview 5.

Current calibration setting names (and other defining information) that you can use with COM scripting are found in:

Alternatively, Echoview's current calibration setting name list is available via the Calibration Information dialog box.

 

Under EvCalibration, calibration settings are referred to by the calibration setting name expressed as a string in a script.

 

New Echoview 5.0 calibration setting names include:

BeamOffsets
Dt4PowerSetting
Ek60TransducerGain
SamplingFrequency
SimradPulseLength
TvgRangeCoefficient
WedgeVolumeBeamAngle

For more information refer to the calibration example script and its annotated partner.

 

 

 

 

 

 

 

 

See also

Getting started with scripting
EvFileset
EvCalibration
Entering calibration settings
COM object hierarchy