Setup.cfg: Managing Instrument Configuration Files

The instrument configuration file (setup.cfg) is a critical part of your Rockland instrumentation.  Proper management of the configuration file will ensure successful data acquisition. Here are a few tips and tricks for managing configuration files to make your life easier and help ensure successful data collection.

 

Anatomy of a configuration file:

The first section of a configuration file is known as the root section. The root section determines data acquisition; any changes to this section could create problems with future data collection. We do not advise making changes to the root section, but if you do, please ensure that you test data acquisition on you instrument before deployment. Once you collect data, review it with the ODAS MATLAB Library to confirm successful data acquisition of all channels. Confirming data acquisition is especially important before a glider mission as it may not be possible to modify the setup.cfg file once the glider is at sea. Whenever possible, conduct a short test mission or simulated mission with a modified setup.cfg file before deploying a glider.  We also encourage you to send modified setup.cfg files to the Rockland Support Team for review.

The second section of the configuration file is known as the channel section. It is not critical to have the correct information in this section during data acquisition. The channel section contains all of the coefficients and details required to convert the raw data to physical units during data processing. The contents of this section can be changed after the data has been collected. For example, if you return your shear probes for re-calibration after a deployment, you can insert the new shear probe sensitivity values and re-process the data.

 

Modifying Configuration Files:

 

If you need to modify the configuration file in an existing data file (.p files) you can use the extract_setupstr.m function in the ODAS MATLAB Library to extract the configuration file (setup.cfg). The configuration file can then be edited in an a text editor. Notepad++ is a recommended text editor for Windows operating system. Patch the edited configuration file back in to the .p data file using the patch_setupstr.m function.

Whenever modifying the setup.cfg file it is important to record the change as a comment in the header. Comments can also be made anywhere in the configuration file using the semicolon. For Example:

;2019-09-06 Changed S1 sens value, Rockland Support Team

or

; -----------------
; The shear probe channels
[channel]
; instrument dependent parameters
id = 8 
name = sh1
type = shear
adc_fs = 4.096
adc_bits = 16
diff_gain = 0.962
; sensor dependent parameters
sens = 0.0700 ;Comments like this can also be added as needed
SN = M2000
cal_date =2010-01-01

Naming setup.cfg Files and Loading onto the Instrument:

 

Configuration files can have any name ending with .cfg when they are on your personal computer, however the default name ‘setup.cfg’ must be used when loaded onto the instrument. Rockland has added a new feature to the RSILink software version 4.0.0 to help maintain a configuration file naming convention on your computer. The feature will convert any .cfg file to setup.cfg when it is loaded onto your internally recording instrument. For example: setup_2019_09_06.cfg will be converted to setup.cfg when loaded onto the instrument using RSILink 4.0.0.
Once a modified configuration file has be loaded onto the instrument it is recommended to use the command type setup.cfg in Motocross Terminal to display the contents of the configuration file and check that the modified file has been successfully loaded.
Please contact the Rockland Support team if you have any questions about instrument configuration files or to request a copy of the new version of RSILink.
Sincerely,
Rockland Support Team