Copyright © 1997-2008 Myriax Software Pty. Ltd.

Features of Scripting module

The Scripting module allows you to run Echoview using scripts that automatically perform multiple commands on new or existing EV files. It is designed to speed up processing tasks in Echoview. The module supports the automation of export tasks from Echoview and the more versatile interactive automation of Echoview (COM scripting). The Scripting module is under constant development, see the Echoview help file for details on using the Scripting module and example scripts.

Key features

• The Echoview export tasks that can be included in a script include exporting analyses (integrations, single targets, fish tracks), exporting lines, and exporting data.
• Scripting also allows access to a large subset of properties within EV (Echoview) files. For example, the same export could be run for many different values of data threshold to provide information about the response of key analysis variables to changes in threshold.
• Operations such as detection of fish tracks or schools, import and export of multiple file types, and the creation of EV files can be scripted, yielding a powerful time-saving tool.
• Any combination of the exports can be scripted for any number of EV files and for multiple 
  variables within each EV file. Example scripts are described and a number working scripts are provided when Echoview is installed from CD.

COM scripting

With Echoview COM automation, control can come from a script, web page or other program and interaction between the script, the user and Echoview is possible.

• A subset of COM objects emulate all the commands of automated export scripting.
• Other COM objects give you access to further Echoview features, EV file settings and raw variable property settings.

The advantages of COM object scripting over export task scripting are:

• The COM object can query Echoview as it runs. This allows you to make informed decisions.
• Operations can be easily performed on multiple objects, or an entire collection.
• Commands are executed serially.
• The object is immediately informed of the failure of a procedure call. This makes it easier to find the source of a failed export or an unexpected result.
• Echoview does not have to initialize and terminate for each script. This has the potential to make small scripts run faster.
• It is easier to extend to support new functionality.

Automation of export tasks scripting

This static set of script commands is a powerful time-saving tool. The same export could be run for many different values of data threshold to provide information about the response of key analysis variables to changes in threshold. Any combination of the exports can be scripted for any number of EV files and for multiple variables within each EV file.

• Export analyses (integrations, single targets, fish tracks)
• Export lines
• Export data
• Create and EV file from a template
• Set parameters
• Specify a line
• Specify pings
• Specify a region
• Specify a region class
• Specify a 3D object
• Specify a scene
• Execute preactions
• Add or remove data files from an EV file
• Import a file into an EV file
• Create or detect objects in echogram data
• Set EV file and variable properties