Software Settings Files

Settings Files

The Swath Processor program can be configured to work in many different configurations. The configuration details are stored in several different files, as appropriate to the configuration information stored. These are:

  • The Bathyswath settings file, which has the file extension ‘.sxs’. This stores the details of a survey ‘session’, including:
  • The sonar settings (transmit power, ping length, etc.)
  • The auxiliary system settings (serial port number and baud rate, data format, use of auxiliary systems for creating attitude data)
  • Positions and angles for all of the system components
  • Correction offsets and multipliers for all data types
  • Filter settings
  • Location and settings of display windows
  • The Windows registry: this stores information such as the previous files and directories used, so that the user does not have to search the whole directory tree each time a new file is used. Use of this file is automatic, and is not intended for editing by the user.
  • The swath processor initiation file. This stores information about the context of the computing system and other such start-up information. This file is not intended for the use of the general user, but rather is for installation and maintenance engineers.  This file is always called ‘swathprocconfig.txt’.
  • The Configuration file. This file stores the sub-set of data in the Swath settings file that concern the configuration of the sonar system, and is only used to transfer such information to and from external utility software.

Swath processor initiation file

This file stores ‘fixed’ information about the context of the computing system. This file is not intended for the use of the general user, but rather is for installation and maintenance engineers. Entering the wrong parameters into this file can cause the system to work incorrectly or not start up at all.  If in doubt, do not edit this file. This file is always called ‘swathprocconfig.txt’, and is stored in the same location as the swath processor executable, ‘swath.exe’. Note: in some Windows versions, file-protection settings may make it necessary to take a copy of ‘swathprocconfig.txt’ in another location, edit it there, and then copy the edited file back into the ‘Program Files’ location.

The swath processor initiation file is an ASCII text file. It consists of a set of entries, each entry being on one line of the file. A typical entry line consists of three words, separated by white space (spaces and tabs). The first word is the entry group, the next specifies the entry item, and the third gives its value.

The entries do not need to be in any particular location in the file, but if an entry type is repeated, then the information in the latest one in the file over-writes the information in any earlier ones.

A typical entry is:

sonar       hardwareFitted                1    

The group is ‘sonar’; there may be other entries that define the sonar settings.

The entry is ‘hardwareFitted’; this particular item tells the software whether to expect Bathyswath TEMs to be accessible to it. The third item is set to ‘1’, meaning in this case that the hardware is expected. If no hardware is expected, set this item to ‘0’ (zero). This particular setting can be useful when the Swath Processor is installed on a system that is only used for post-processing, and it prevents the software from issuing a warning when it cannot find any Bathyswath hardware on start-up.

Other useful settings include:

  • The ‘preset’ group: this defines the pre-set filter settings used in the first window of the bathymetry filter dialogs. The meaning of each setting should be obvious in comparison with the bathymetry filter dialog items.
  • The ‘synchsocket’ group is used to set up systems where two copies of the Swath Processor are used on two computers connected by a TCP/IP link, for example over an Ethernet cable or wireless link. Typically, the first system gathers the data from a sonar, and the second is used for processing and display.
  • The ‘F180socket’ group sets up the TCP/IP data for an attitude system that provides its data over a TCP/IP link.
  • The ‘buffer’ group defines the size of data buffers used for storing system data. In rare cases, it can be necessary to increase a buffer size for an auxiliary sensor that is providing its data at an unusually high rate. Conversely, if it is necessary to reduce the memory load of the application to allow it to run on a computer with limited capacity (perhaps on a remote platform), then these buffers could be reduced in size (but make sure that the system is thoroughly tested after doing so).