Using BBSub

BBSub is a raw data file subsectioning utility.  This allows you to save a portion of a large raw data file as a separate raw data file.  BBSub starts copying ensembles from the input file to the output file starting with the ensemble specified by the Start Ensemble Number.  If the Start Ensemble Number is specified to zero, BBSub starts copying from the first read ensemble.  BBSub will continue copying ensembles until it reaches ensemble number End Ensemble Number.  If the End Ensemble Number is specified to zero, it copies until the end of the file.  Only ensembles with valid checksum are copied.

To subsection a file, do the following.

1.	Enter the name and path of the BroadBand ADCP raw data in the BB Input File Name box or use the browse button to locate the file.  BBSub "remembers" the input and output directory if the Browse button "..." is selected.

2.	Enter the name and path of the subsectioned file in the BB Output File Name box or use the browse button to locate the file.

3.	Enter the Start Ensemble Number.

4.	Enter the End Ensemble Number.

5.	Select the method to filter the data:

a.  Do not Filter Data – No filtering is done.

b.  Extract only Down-Looking Data – Only ensembles with orientation sensor pointing down will be copied.

c.  Extract only Up-Looking Data – Only ensembles with orientation sensor pointing up will be copied.

d.  Force Sensor to be Down-Looking – All the ensembles will have the orientation sensor pointing down.

e.  Extract OS NarrowBand Data – If both the BroadBand and NarrowBand data are recorded (Ocean Surveyor) this option extracts the NarrowBand data.  This makes the data compatible with RDI’s standard software.

f.  Redo Ensemble Numbers – Ensembles will be renumbered starting with ensemble number 1.

g.  Resample Data – Every n-th ensemble can be extracted to a new binary data file.

6.	Press the Subsection button to begin.

7.	Press the Exit button to exit BBSub.

You can run BBSub in the batch mode by writing a simple DOS *.bat file that contains command lines with the files that you want to process.  For each file to be processed, add a line to the batch file specifying the name of the raw data file to be subsectioned, the name of the output file, and the starting and ending ensemble numbers.  For unattended operation, make sure that output file does not exist; otherwise the batch file will pause to confirm overwriting the file.

Sample Batch file

start /w "C:\Program Files\RD Instruments\BBSub.exe" -in:InputFile  -out:OutputFile -start:StartEns -end:EndEns