author | A.M. Thurnherr <athurnherr@yahoo.com> |
Wed, 03 Mar 2021 14:50:51 -0500 | |
changeset 54 | 21cf468fa8e0 |
parent 52 | 5b07a9b89aee |
child 55 | 540d6574caca |
permissions | -rw-r--r-- |
14 | 1 |
#====================================================================== |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
2 |
# R D I _ P D 0 _ I O . P L |
14 | 3 |
# doc: Sat Jan 18 14:54:43 2003 |
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
4 |
# dlm: Tue Apr 14 21:43:23 2020 |
14 | 5 |
# (c) 2003 A.M. Thurnherr |
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
6 |
# uE-Info: 126 73 NIL 0 0 72 0 2 4 NIL ofnI |
14 | 7 |
#====================================================================== |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
8 |
|
37 | 9 |
# Read RDI PD0 binary data files (*.[0-9][0-9][0-9]) |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
10 |
|
14 | 11 |
# HISTORY: |
12 |
# Jan 18, 2003: - incepted aboard the Aurora Australis (KAOS) |
|
13 |
# Jan 19, 2003: - continued |
|
14 |
# Jan 20, 2003: - replaced INTENSITY by AMPLITUDE |
|
15 |
# Jan 21, 2003: - changed heading-correction field names |
|
16 |
# Jan 27, 2003: - cosmetics |
|
17 |
# Feb 14, 2003: - moved BT setup into header |
|
18 |
# Mar 15, 2003: - moved 10th xmit voltage into header as BATTERY field |
|
19 |
# - removed again, because values are not meaningful |
|
20 |
# Feb 24, 2004: - continued aboard Nathaniel B. Palmer (Anslope II) |
|
21 |
# - BUG: ensemble # was wrong on error messages |
|
22 |
# Feb 26, 2004: - removed ESW_ERROR and bitmasking of ERROR_STATUS_WORD |
|
23 |
# Feb 27, 2004: - removed some unused (commented-out) baggage |
|
24 |
# Mar 11, 2004: - BUG: renamed ACD -> ADC |
|
25 |
# Mar 18, 2004: - cosmetics |
|
26 |
# Mar 30, 2004: - rewrote to speed up reading; new version takes |
|
27 |
# ~40% less time |
|
28 |
# Sep 14, 2005: - made BT data optional (NUMBER_OF_DATA_TYPES) |
|
29 |
# - added DATA_FORMAT |
|
30 |
# Sep 15, 2005: - debugged |
|
31 |
# - implement checksum to robustly find EOF |
|
32 |
# - renamed to RDI_BB_Read.pl |
|
33 |
# - BUG: had used POSIX::mktime with wrong month def! |
|
34 |
# Oct 30, 2005: - added WH300 FW16.27 file format |
|
35 |
# - added DATA_FORMAT_VARIANT |
|
36 |
# - changed semantics so that first valid ensemble is |
|
39 | 37 |
# in E[0] (instead of E[$ensNo-1]) |
14 | 38 |
# Nov 8, 2005: - replaced UNIXTIME by UNIX_TIME |
39 |
# - added SECNO |
|
40 |
# Aug 31: 2006: - added DAYNO |
|
41 |
# Aug 1, 2007: - BUG: typo in monthLength() |
|
42 |
# Sep 18, 2007: - modified readHeader() readDta() WBRhdr() WBRens() to |
|
43 |
# conserve memory (no large arrays as retvals) |
|
44 |
# Jun 4, 2008: - BUG: BB150 code was not considered on Sep 18, 2007 |
|
45 |
# Aug 15, 2010: - downgraded "unexpected number of data types" from error to warning |
|
46 |
# - BUG: WBRcfn had not been set correctly |
|
47 |
# - modified to allow processing files without time info |
|
48 |
# May 12, 2011: - added code to report built-in-test errors |
|
49 |
# Mar 19, 2013: - added support for WH600 data file (58 fixed leader bytes) |
|
50 |
# Mar 20, 2013: - removed DATA_FORMAT stuff |
|
51 |
# - added support for BT data in subset of ensembles |
|
52 |
# Apr 29, 2013: - changed semantics to assume EOF when unexpected number of data types |
|
53 |
# are present in an ensemble |
|
54 |
# Nov 25, 2013: - renamed from [RDI_BB_Read.pl] |
|
55 |
# - begin implementing WBWens() |
|
56 |
# - checkEnsemble() expunged |
|
18 | 57 |
# Mar 3, 2014: - BUG: WBPens() did not handle incomple ensembles at EOF correctly |
58 |
# Mar 4, 2014: - added support for DATA_SOURCE_ID |
|
59 |
# Apr 24, 2014: - added debug statements to log %-GOOD values |
|
60 |
# May 6, 2014: - loosened input format checks |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
61 |
# May 7, 2014: - removed BT_PRESENT flag |
21 | 62 |
# Sep 6, 2014: - adapted WBRhdr to >7 data types |
63 |
# Oct 15, 2014: - implemented work-around for readData() not recognizing |
|
64 |
# incomplete ensemble at the end, which seems to imply that there is |
|
39 | 65 |
# a garbage final ensemble that passes the checksum test??? |
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
66 |
# Oct 2, 2015: - added &skip_initial_trash() |
28 | 67 |
# Dec 18, 2015: - added most data types to WBPofs() |
68 |
# - BUG: WBPens() requires round() for scaled values |
|
31 | 69 |
# Jan 9, 2016: - removed system() from writeData() |
70 |
# - BUG: WBRhdr() did not set DATA_SOURCE_ID |
|
29 | 71 |
# - added PRODUCER |
31 | 72 |
# - BUG: writeData() did not work correctly for ECOGIG OC26 moored data (spaces in filename?) |
73 |
# - added support for patching coordinate system |
|
32 | 74 |
# Feb 16, 2016: - added transducer orientation to WBPens() |
75 |
# - BUG: most WBPens() error messages used wrong file name |
|
76 |
# Feb 23, 2016: - changed WBRhdr() to use 2nd ensemble (with correct data-source id) |
|
77 |
# Feb 26, 2016: - added basic BT data to WBPens(); not BT_RL_* and BT_SIGNAL_STRENGTH |
|
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
78 |
# Feb 29, 2016: - LEAP DAY: actually got BT data patching to work |
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
79 |
# Jul 30, 2016: - BUG: incomplete last ensemble with garbage content was returned on reading |
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
80 |
# WH300 data |
37 | 81 |
# Aug 5, 2016: - cosmetics |
82 |
# Aug 23, 2016: - added &clearEns() |
|
83 |
# Nov 9, 2016: - made WBRhdr() return undef on "empty" files |
|
84 |
# Nov 18, 2016: - BUG: ensNo was not reported correctly in format errors |
|
85 |
# Nov 23, 2016: - no longer set pitch/roll/heading to undef in clearEns() |
|
86 |
# Mar 7, 2016: - renamed round() to stop clashing with ANTSLIB |
|
39 | 87 |
# May 18, 2017: - maded readHeader() more permissive (checkFmt flag) |
88 |
# - added partial support for Ocean Surveyor data |
|
89 |
# Aug 1, 2017: BUG: minor typo in ocean surveyor code (err check not done?) |
|
90 |
# Aug 7, 2017: - added LAG_LENGTH |
|
91 |
# - added SPEED_OF_SOUND to header |
|
92 |
# Aug 8, 2017: - replaced croak() by die() |
|
93 |
# - added actual transducer frequencies |
|
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
94 |
# Nov 22, 2017: - BUG: dayNo() and monthLength() clashed with [libconv.pl] |
42 | 95 |
# - added support for RDI_PD0_IO::IGNORE_Y2K_CLOCK |
96 |
# Dec 7, 2017: - added suppress_error to readHeader() |
|
97 |
# Dec 23, 2017: - BUG: could no longer read Anslope II raw files |
|
98 |
# - added support for patching ADCP time data |
|
99 |
# - added support for RDI_PD0_IO::OVERRIDE_Y2K_CLOCK |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
100 |
# Feb 6, 2018: - added supprort for first_ens, last_ens in readData() |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
101 |
# Feb 7, 2018: - BUG: new params were not optional |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
102 |
# - made read routines more permissive by allowing |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
103 |
# garbage between ensembles |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
104 |
# Mar 15, 2018: - BUG: WBPens() did not work for files with garbage |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
105 |
# Mar 16, 2018: - added skipped garbage warning |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
106 |
# - BUG: garbage skipping did not work correctly for files w/o BT |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
107 |
# Mar 20, 2018: - BUG: garbage skipping STILL did not work correctly for files w/o BT |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
108 |
# Apr 9, 2018: - added last_bin argument to readData() |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
109 |
# Apr 10, 2018: - slight improvement (parameter range check) |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
110 |
# Apr 23, 2018: - make WBRens() work (again?) with BB150 data froim 1996 |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
111 |
# Apr 24, 2018: - BUG: undefined lat_bin argument to readData() did not work |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
112 |
# Apr 30, 2018: - added support for repeated ensembles |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
113 |
# - added warning on wrong ensemble length |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
114 |
# Jun 9, 2018: - removed double \n from warnings |
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
115 |
# Jun 12, 2018: - BUG: IMPed files did not pass the garbage detection |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
116 |
# Jun 13, 2019: - adapted reading routines to RTI files (free order of data types) |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
117 |
# - removed old BT_PRESENT code |
50 | 118 |
# Jun 28, 2019: - renamed SECONDS to SECOND for consistency |
119 |
# Jun 30, 2019: - added dirty flag to prevent bad PD0 patching |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
120 |
# - added $show_progress |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
121 |
# Feb 13, 2020: - added support for $readDataProgress (to Jun 13 version) |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
122 |
# Apr 12, 2020: - merged laptop and whoosher versions which both implemented |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
123 |
# progreass; not sure whether this merge is successful |
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
124 |
# - disabled duplicate ens detection, which turns reading into |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
125 |
# O(N^2) process |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
126 |
# Apr 14, 2020: - BUG: WBPens did not work for ens# > 65535 (high byte) |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
127 |
|
14 | 128 |
# FIRMWARE VERSIONS: |
129 |
# It appears that different firmware versions generate different file |
|
130 |
# structures. Currently (Sep 2005) these routines have been tested |
|
131 |
# with the following firmware versions (as reported by [listHdr]): |
|
132 |
# |
|
39 | 133 |
# Firmw. DATA_FORMAT(_VARIANT) Owner Cruise FIXED_LEADER_LENGTH |
14 | 134 |
#------------------------------------------------------------ |
39 | 135 |
# 05.52 BB150 (1) UH CLIVAR/P16S 42 |
14 | 136 |
# 16.12 WH300 (1) FSU A0304 53 |
39 | 137 |
# 16.21 WH300 (1) LDEO NBP0402 53 |
138 |
# 16.27 WH300 (2) Nash ? 59 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
139 |
|
29 | 140 |
# PD0 FILE FORMAT EXTENSIONS: |
141 |
# |
|
32 | 142 |
# - file creator encoded in DATA_SOURCE_ID |
143 |
# |
|
144 |
# - first ensemble uses default RDI DATA_SOURCE_ID because the LDEO_IX |
|
145 |
# software assumes this |
|
146 |
# |
|
39 | 147 |
# - DATA_SOURCE_ID = 0x7F original TRDI PD0 file |
29 | 148 |
# |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
149 |
# - DATA_SOURCE_ID = 0xA0 | PATCHED_MASK produced by IMP+LADCP, KVH+LADCP |
29 | 150 |
# PATCHED_MASK & 0x04: pitch value has been patched |
151 |
# PATCHED_MASK & 0x02: roll value has been patched |
|
152 |
# PATCHED_MASK & 0x01: heading value has been patched |
|
153 |
# - PITCH & ROLL can be missing (0x8000 badval as in velocities) |
|
154 |
# - HEADING can be missing (0xF000 badval, as 0x8000 is valid 327.68 heading) |
|
155 |
# |
|
31 | 156 |
# - DATA_SOURCE_ID = 0xE0 produced by editPD0 |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
157 |
|
14 | 158 |
# NOTES: |
159 |
# - RDI stores data in VAX/Intel byte order (little endian) |
|
160 |
# - the output data structure does not exactly mirror the file data |
|
161 |
# structure; the header is not stored at all and the fixed leader |
|
162 |
# data are not duplicated in every ensemble |
|
163 |
# - in the RDI files some fields that logically belong into the header |
|
164 |
# or the fixed leader (e.g. BT_MIN_CORRELATION) appear in the |
|
165 |
# ensemble data --- these are not read on input |
|
166 |
# - the field names are generally unabbreviated except for |
|
167 |
# BT (= Bottom Track), RL (= Reference Layer), MIN and MAX |
|
168 |
# - all arrays are 0-referenced, but the ensemble number is not! |
|
169 |
# - a list of filenames can be be passed to readData() so that |
|
170 |
# files split onto several memory cards (typically .000 .001 &c) |
|
171 |
# can be read --- not sure if this works, actually |
|
172 |
# - the RDI manuals are not entirely clear everywhere; I have made |
|
173 |
# guesses in some cases, but they should not affect the main |
|
174 |
# fields of interest |
|
175 |
# - some fields in the fixed leader are not really fixed in a LADCP |
|
176 |
# setting (e.g. xducer orientation); I'v made an educated guess |
|
177 |
# as to which fields to move to the ENS array |
|
178 |
# - all units except pressure are SI, i.e. in m and m/s |
|
179 |
# - I don't understand the ERROR_STATUS_WORD; here's what 3 different |
|
180 |
# instruments returned: |
|
39 | 181 |
# 0x88000100 FSU instrument during A0304 (Firmware 16.12) |
14 | 182 |
# 0x88008180 LDEO uplooker (slave) during NBP0402 (Firmware 16.21) |
183 |
# 0x00008180 LDEO downlooker (master) during NBP0402 (Firmware 16.21) |
|
184 |
# According to the manual (January 2001 version) this would, for example, |
|
185 |
# indicate power failures on both FSU and LDEO slave instruments... |
|
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
186 |
# - defining the variable "$RDI_PD0_IO::IGNORE_Y2K_CLOCK" before calling &readData() |
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
187 |
# makes the code ignore the Y2K clock and use the old clock instead; this |
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
188 |
# is used for Dan Torres' KVH system |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
189 |
|
14 | 190 |
# &readData() returns perl obj (ref to anonymous hash) with the following |
191 |
# structure: |
|
192 |
# |
|
18 | 193 |
# DATA_SOURCE_ID scalar 0x7f (Workhorse, also DVL) |
14 | 194 |
# NUMBER_OF_DATA_TYPES scalar 6 (no BT) or 7 |
195 |
# ENSEMBLE_BYTES scalar ?, number of bytes w/o checksum |
|
196 |
# HEADER_BYTES scalar ? |
|
197 |
# FIXED_LEADER_BYTES scalar 42 for BB150; 53 for WH300, 58 for WH600, 59 for WH300(Nash) |
|
198 |
# VARIABLE_LEADER_BYTES scalar ? |
|
39 | 199 |
# VELOCITY_DATA_BYTES scalar ? |
14 | 200 |
# CORRELATION_DATA_BYTES scalar ? |
201 |
# ECHO_INTENSITY_DATA_BYTES scalar ? |
|
39 | 202 |
# PERCENT_GOOD_DATA_BYTES scalar ? |
14 | 203 |
# CPU_FW_VER scalar 0--255 |
204 |
# CPU_FW_REV scalar 0--255 |
|
205 |
# BEAM_FREQUENCY scalar 75, 150, 300, 600, 1200, 2400 [kHz] |
|
39 | 206 |
# LAG_LENGTH scalar ??? |
207 |
# CONVEX_BEAM_PATTERN bool undefined, 1 |
|
14 | 208 |
# CONCAVE_BEAM_PATTERN bool undefined, 1 |
209 |
# SENSOR_CONFIG scalar 1--3 |
|
210 |
# XDUCER_HEAD_ATTACHED bool undefined, 1 |
|
211 |
# BEAM_ANGLE scalar 15,20,30,undefined=other [deg] |
|
39 | 212 |
# N_BEAMS scalar 4--5 |
14 | 213 |
# N_DEMODS scalar 2--3(???),undefined=n/a |
214 |
# N_BINS scalar 1--128 |
|
215 |
# PINGS_PER_ENSEMBLE scalar 0--16384 |
|
216 |
# BIN_LENGTH scalar 0.01--64 [m] |
|
217 |
# BLANKING_DISTANCE scalar 0-99.99 [m] |
|
39 | 218 |
# MIN_CORRELATION scalar 0--255 |
14 | 219 |
# N_CODE_REPETITIONS scalar 0--255 |
220 |
# MIN_PERCENT_GOOD scalar 1--100 [%] |
|
221 |
# MAX_ERROR_VELOCITY scalar 0--5 [m/s] |
|
222 |
# TIME_BETWEEN_PINGS scalar 0--? [s] |
|
223 |
# BEAM_COORDINATES bool undefined,1 |
|
224 |
# INSTRUMENT_COORDINATES bool undefined,1 |
|
225 |
# SHIP_COORDINATES bool undefined,1 |
|
226 |
# EARTH_COORDINATES bool undefined,1 |
|
39 | 227 |
# PITCH_AND_ROLL_USED bool undefined,1 |
14 | 228 |
# USE_3_BEAM_ON_LOW_CORR bool undefined,1 |
39 | 229 |
# BIN_MAPPING_ALLOWED bool undefined,1 |
230 |
# HEADING_ALIGNMENT scalar -179.99..180 [deg] |
|
231 |
# HEADING_BIAS scalar -179.99..180 [deg] |
|
14 | 232 |
# CALCULATE_SPEED_OF_SOUND bool undefined,1 |
39 | 233 |
# USE_PRESSURE_SENSOR bool undefined,1 |
234 |
# USE_COMPASS bool undefined,1 |
|
14 | 235 |
# USE_PITCH_SENSOR bool undefined,1 |
39 | 236 |
# USE_ROLL_SENSOR bool undefined,1 |
237 |
# USE_CONDUCTIVITY_SENSOR bool undefined,1 |
|
14 | 238 |
# USE_TEMPERATURE_SENSOR bool undefined,1 |
239 |
# SPEED_OF_SOUND_CALCULATED bool undefined,1 |
|
240 |
# PRESSURE_SENSOR_AVAILABLE bool undefined,1 |
|
241 |
# COMPASS_AVAILABLE bool undefined,1 |
|
242 |
# PITCH_SENSOR_AVAILABLE bool undefined,1 |
|
243 |
# ROLL_SENSOR_AVAILABLE bool undefined,1 |
|
244 |
# CONDUCTIVITY_SENSOR_AVAILABLE bool undefined,1 |
|
245 |
# TEMPERATURE_SENSOR_AVAILABLE bool undefined,1 |
|
39 | 246 |
# DISTANCE_TO_BIN1_CENTER scalar 0--655.35 [m] |
14 | 247 |
# TRANSMITTED_PULSE_LENGTH scalar 0--655.35 [m] |
248 |
# RL_FIRST_BIN scalar 1--128 |
|
39 | 249 |
# RL_LAST_BIN scalar 1--128 |
14 | 250 |
# FALSE_TARGET_THRESHOLD scalar 0--254, undefined=disabled |
39 | 251 |
# LOW_LATENCY_SETTING scalar 0--5(???) |
14 | 252 |
# TRANSMIT_LAG_DISTANCE scalar 0--655.35 [m] |
253 |
# CPU_SERIAL_NUMBER scalar undefined, 0--65535 if WH300 |
|
254 |
# NARROW_BANDWIDTH bool undefined,1 (only set if WH300) |
|
255 |
# WIDE_BANDWIDTH bool undefined,1 (only set if WH300) |
|
256 |
# TRANSMIT_POWER scalar undefined, 0--255(high) if WH300 |
|
39 | 257 |
# TRANSMIT_POWER_HIGH bool undefined,1 (only set if WH300) |
14 | 258 |
# BT_PINGS_PER_ENSEMBLE scalar 0--999 |
259 |
# BT_DELAY_BEFORE_REACQUIRE scalar 0--999 |
|
260 |
# BT_MIN_CORRELATION scalar 0--255 |
|
261 |
# BT_MIN_EVAL_AMPLITUDE scalar 0--255 |
|
39 | 262 |
# BT_MIN_PERCENT_GOOD scalar 0--100 [%] |
263 |
# BT_MODE scalar 4,5,6(?) |
|
14 | 264 |
# BT_MAX_ERROR_VELOCITY scalar 0--5 [m/s], undef=not screened |
265 |
# BT_RL_MIN_SIZE scalar 0--99.9 [m] |
|
266 |
# BT_RL_NEAR scalar 0--999.9 [m] |
|
267 |
# BT_RL_FAR scalar 0--999.9 [m] |
|
268 |
# BT_MAX_TRACKING_DEPTH scalar 8--999.9 [m] |
|
39 | 269 |
# ENSEMBLE[ensemble_no-1] array ensemble info |
14 | 270 |
# XDUCER_FACING_UP bool undefined, 1 |
271 |
# XDUCER_FACING_DOWN bool undefined, 1 |
|
272 |
# N_BEAMS_USED scalar 3,4,5(?) |
|
273 |
# NUMBER scalar 1--16777215 |
|
39 | 274 |
# BUILT_IN_TEST_ERROR scalar ?,undefined=none |
14 | 275 |
# SPEED_OF_SOUND scalar 1400--1600 [m/s] |
276 |
# XDUCER_DEPTH scalar 0.1--999.9 [m] |
|
39 | 277 |
# HEADING scalar 0--359.99 [deg] --- IMP EXTENSION: undef |
18 | 278 |
# PITCH scalar -20.00-20.00 [deg] --- IMP EXTENSION: undef |
279 |
# ROLL scalar -20.00-20.00 [deg] --- IMP EXTENSION: undef |
|
14 | 280 |
# SALINITY scalar 0-40 [psu] |
39 | 281 |
# TEMPERATURE scalar -5.00--40.00 [deg] |
14 | 282 |
# MIN_PRE_PING_WAIT_TIME scalar ? [s] |
283 |
# HEADING_STDDEV scalar 0-180 [deg] |
|
284 |
# PITCH_STDDEV scalar 0.0-20.0 [deg] |
|
39 | 285 |
# ROLL_STDDEV scalar 0.0-20.0 [deg] |
14 | 286 |
# ADC_XMIT_CURRENT scalar 0--255 |
287 |
# ADC_XMIT_VOLTAGE scalar 0--255 |
|
39 | 288 |
# ADC_AMBIENT_TEMPERATURE scalar 0--255 |
14 | 289 |
# ADC_PRESSURE_PLUS scalar 0--255 |
290 |
# ADC_PRESSURE_MINUS scalar 0--255 |
|
291 |
# ADC_ATTITUDE_TEMPERATURE scalar 0--255 |
|
292 |
# ADC_ATTITUDE scalar 0--255 |
|
293 |
# ADC_CONTAMINATION scalar 0--255 |
|
294 |
# ERROR_STATUS_WORD scalar undefined, ? (only set if WH300) |
|
295 |
# PRESSURE scalar undefined, ?-? [dbar] (only set if WH300) |
|
39 | 296 |
# PRESSURE_STDDEV scalar undefined, ?-? [dbar] (only set if WH300) |
14 | 297 |
# DATE string MM/DD/YYYY |
298 |
# YEAR scalar ? |
|
299 |
# MONTH scalar 1--12 |
|
39 | 300 |
# DAY scalar 1--31 |
14 | 301 |
# TIME string HH:MM:SS.hh |
302 |
# HOUR scalar 0--23 |
|
303 |
# MINUTE scalar 0--59 |
|
50 | 304 |
# SECOND scalar 0--59.99 |
14 | 305 |
# UNIX_TIME scalar 0--? |
306 |
# SECNO scalar 0--? (number of seconds since daystart) |
|
307 |
# DAYNO double fractional day number since start of current year (1.0 is midnight Jan 1st) |
|
39 | 308 |
# VELOCITY[bin][beam] scalars -32.767--32.768 [m/s], undef=bad |
309 |
# CORRELATION[bin][beam] scalars 1--255, undefined=bad |
|
310 |
# ECHO_AMPLITUDE[bin][beam] scalars 0--255 |
|
311 |
# PERCENT_GOOD[bin][beam] scalars 0--255 |
|
312 |
# BT_RANGE[beam] scalars tons [m] |
|
313 |
# BT_VELOCITY[beam] scalars see VELOCITY |
|
314 |
# BT_CORRELATION[beam] scalars see CORRELATION |
|
315 |
# BT_EVAL_AMPLITUDE[beam] scalars 0--255 |
|
316 |
# BT_PERCENT_GOOD[beam] scalars see PERCENT_GOOD |
|
317 |
# BT_RL_VELOCITY[beam] scalars see VELOCITY |
|
318 |
# BT_RL_CORRELATION[beam] scalars see CORRELATION |
|
319 |
# BT_RL_ECHO_AMPLITUDE[beam] scalars see ECHO_AMPLITUDE |
|
320 |
# BT_RL_PERCENT_GOOD[beam] scalars see PERCENT_GOOD |
|
321 |
# BT_SIGNAL_STRENGTH[beam] scalars 0--255 |
|
14 | 322 |
# HIGH_GAIN bool 1, undefined |
323 |
# LOW_GAIN bool 1, undefined |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
324 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
325 |
use strict; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
326 |
use Time::Local; # timegm() |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
327 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
328 |
$RDI_PD0_IO::show_progress = 0; # when set, print . every 1000 ens read |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
329 |
|
14 | 330 |
#---------------------------------------------------------------------- |
331 |
# Time Conversion Subroutines |
|
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
332 |
# - prepended with _ to avoid conflicts with [libconv.pl] |
14 | 333 |
#---------------------------------------------------------------------- |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
334 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
335 |
sub _monthLength($$) # of days in month |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
336 |
{ |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
337 |
my($Y,$M) = @_; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
338 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
339 |
return 31 if ($M==1 || $M==3 || $M==5 || $M==7 || |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
340 |
$M==8 || $M==10 || $M==12); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
341 |
return 30 if ($M==4 || $M==6 || $M==9 || $M==11); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
342 |
return 28 if ($Y%4 != 0); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
343 |
return 29 if ($Y%100 != 0); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
344 |
return 28 if ($Y%400 > 0); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
345 |
return 29; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
346 |
} |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
347 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
348 |
{ my($epoch,$lM,$lD,$lY,$ldn); # static scope |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
349 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
350 |
sub _dayNo($$$$$$) |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
351 |
{ |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
352 |
my($Y,$M,$D,$h,$m,$s) = @_; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
353 |
my($dn); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
354 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
355 |
if ($Y==$lY && $M==$lM && $D==$lD) { # same day as last samp |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
356 |
$dn = $ldn; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
357 |
} else { # new day |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
358 |
$epoch = $Y unless defined($epoch); # 1st call |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
359 |
$lY = $Y; $lM = $M; $lD = $D; # store |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
360 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
361 |
for ($dn=0,my($cY)=$epoch; $cY<$Y; $cY++) { # multiple years |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
362 |
$dn += 337 + &_monthLength($Y,$M); |
14 | 363 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
364 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
365 |
$dn += $D; # day in month |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
366 |
while (--$M > 0) { # preceding months |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
367 |
$dn += &_monthLength($Y,$M); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
368 |
} |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
369 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
370 |
$ldn = $dn; # store |
14 | 371 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
372 |
return $dn + $h/24 + $m/24/60 + $s/24/3600; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
373 |
} |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
374 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
375 |
} # static scope |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
376 |
|
14 | 377 |
#---------------------------------------------------------------------- |
378 |
# Read Data |
|
379 |
#---------------------------------------------------------------------- |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
380 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
381 |
my($WBRcfn,$WBPcfn); # current file names for reading/patching |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
382 |
my($BIT_errors) = 0; # built-in-test errors |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
383 |
|
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
384 |
my($FmtErr) = "%s: illegal %s Id 0x%04x at ensemble %d"; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
385 |
|
14 | 386 |
#---------------------------------------------------------------------- |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
387 |
# skip to next valid start of ensemble (skip over garbage) |
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
388 |
#---------------------------------------------------------------------- |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
389 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
390 |
sub goto_next_ens(@) |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
391 |
{ |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
392 |
my($fh,$return_skipped) = @_; # if return_skipped not set, return file pos |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
393 |
my($buf,$dta); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
394 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
395 |
my($found) = 0; # zero consecutive 0x7f found |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
396 |
my($skipped) = 0; my($garbage_start); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
397 |
while ($found < 2) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
398 |
sysread($fh,$buf,1) == 1 || last; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
399 |
($dta) = unpack('C',$buf); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
400 |
if ($dta == 0x7f) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
401 |
$found++; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
402 |
} elsif ($found==1 && |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
403 |
($dta==0xE0 || # from editPD0 |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
404 |
(($dta&0xF0)==0xA0 && ($dta&0x0F)<8))) { # from IMP+LADCP or KVH+LADCP |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
405 |
$found++; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
406 |
} elsif ($found == 0) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
407 |
$garbage_start = sysseek($fh,0,1)-1 unless defined($garbage_start); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
408 |
$skipped++; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
409 |
} else { # here, found == 1 but 2nd byte was not found |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
410 |
$garbage_start = sysseek($fh,0,1)-$found unless defined($garbage_start); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
411 |
$skipped += $found; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
412 |
$found = 0; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
413 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
414 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
415 |
my($fpos) = ($found < 2) ? undef : sysseek($fh,-2,1); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
416 |
return $skipped if ($return_skipped); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
417 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
418 |
if ($skipped) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
419 |
if (eof($fh)) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
420 |
# 04/18/18: disabled the following line of code because it is very common at |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
421 |
# least with the older RDI instruments I am looking at in the context |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
422 |
# of the SR1b repeat section analysis |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
423 |
# print(STDERR "WARNING (RDI_PD0_IO): PD0 file ends with $skipped garbage bytes\n"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
424 |
} elsif ($garbage_start == 0) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
425 |
print(STDERR "WARNING (RDI_PD0_IO): PD0 file starts with $skipped garbage bytes\n"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
426 |
} else { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
427 |
print(STDERR "WARNING (RDI_PD0_IO): $skipped garbage bytes in PD0 file beginning at byte $garbage_start\n"); |
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
428 |
} |
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
429 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
430 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
431 |
return $fpos; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
432 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
433 |
|
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
434 |
#---------------------------------------------------------------------- |
14 | 435 |
# readHeader(file_name,^dta) WBRhdr(^data) |
436 |
# - read header data |
|
437 |
# - also includes some data from 1st ens |
|
438 |
#---------------------------------------------------------------------- |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
439 |
|
14 | 440 |
sub readHeader(@) |
441 |
{ |
|
42 | 442 |
my($fn,$dta,$suppress_error) = @_; |
14 | 443 |
$WBRcfn = $fn; |
39 | 444 |
open(WBRF,$WBRcfn) || die("$WBRcfn: $!"); |
42 | 445 |
if (WBRhdr($dta)) { |
446 |
return 1; |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
447 |
} elsif ($suppress_error) { |
42 | 448 |
return undef; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
449 |
} else { |
42 | 450 |
die("$WBRcfn: Insufficient data\n"); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
451 |
} |
14 | 452 |
} |
453 |
||
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
454 |
sub WBRhdr($) |
14 | 455 |
{ |
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
456 |
my($dta) = @_; |
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
457 |
my($start_ens,$buf,$hid,$did,$Ndt,$B,$W,$i,$dummy,$id,@WBRofs); |
14 | 458 |
my($B1,$B2,$B3,$B4,$B5,$B6,$B7,$W1,$W2,$W3,$W4,$W5); |
39 | 459 |
my($BT_dt); |
460 |
||
14 | 461 |
#-------------------- |
462 |
# HEADER |
|
463 |
#-------------------- |
|
464 |
||
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
465 |
my($skipped) = goto_next_ens(\*WBRF,1); |
50 | 466 |
if ($skipped > 0) { |
467 |
$RDI_PD0_IO::File_Dirty = 1; |
|
468 |
printf(STDERR "WARNING: %d bytes of initial garbage\n",$skipped); |
|
469 |
} |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
470 |
|
37 | 471 |
sysread(WBRF,$buf,6) == 6 || return undef; |
32 | 472 |
($hid,$did,$dta->{ENSEMBLE_BYTES},$dummy,$dta->{NUMBER_OF_DATA_TYPES}) |
473 |
= unpack('CCvCC',$buf); |
|
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
474 |
$hid == 0x7f || die(sprintf($FmtErr,$WBRcfn,"Header (hid)",$hid,0)); |
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
475 |
$did == 0x7f || die(sprintf($FmtErr,$WBRcfn,"Header (did)",$did,0)); |
32 | 476 |
|
37 | 477 |
$start_ens = sysseek(WBRF,$dta->{ENSEMBLE_BYTES}-6+2,1) || return undef; |
478 |
sysread(WBRF,$buf,6) == 6 || return undef; |
|
14 | 479 |
($hid,$did,$dta->{ENSEMBLE_BYTES},$dummy,$dta->{NUMBER_OF_DATA_TYPES}) |
480 |
= unpack('CCvCC',$buf); |
|
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
481 |
$hid == 0x7f || die(sprintf($FmtErr,$WBRcfn,"Header (hid2)",$hid,0)); |
29 | 482 |
$dta->{DATA_SOURCE_ID} = $did; |
483 |
if ($did == 0x7f) { |
|
484 |
$dta->{PRODUCER} = 'TRDI ADCP'; |
|
31 | 485 |
} elsif (($did&0xF0) == 0xA0) { |
486 |
$dta->{PRODUCER} = 'IMP+LADCP (Thurnherr software)'; |
|
487 |
} elsif (($did&0xF0) == 0xE0) { |
|
488 |
$dta->{PRODUCER} = 'editPD0 (Thurnherr software)'; |
|
29 | 489 |
} else { |
31 | 490 |
$dta->{PRODUCER} = sprintf('unknown (0x%02X)'); |
29 | 491 |
} |
492 |
||
14 | 493 |
sysread(WBRF,$buf,2*$dta->{NUMBER_OF_DATA_TYPES}) |
494 |
== 2*$dta->{NUMBER_OF_DATA_TYPES} |
|
495 |
|| die("$WBRcfn: $!"); |
|
496 |
@WBRofs = unpack("v$dta->{NUMBER_OF_DATA_TYPES}",$buf); |
|
497 |
# for ($i=0; $i<$dta->{NUMBER_OF_DATA_TYPES}; $i++) { |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
498 |
# printf(STDERR "WBRofs[$i] = %d",$WBRofs[$i]); |
14 | 499 |
# } |
500 |
||
39 | 501 |
|
502 |
$dta->{HEADER_BYTES} = $WBRofs[0]; |
|
503 |
$dta->{FIXED_LEADER_BYTES} = $WBRofs[1] - $WBRofs[0]; |
|
504 |
$dta->{VARIABLE_LEADER_BYTES} = $WBRofs[2] - $WBRofs[1]; |
|
505 |
||
506 |
if ($dta->{FIXED_LEADER_BYTES} == 42) { # Eric Firing's old instrument I used in 2004 |
|
507 |
$dta->{INSTRUMENT_TYPE} = 'BB150'; |
|
508 |
} elsif ($dta->{FIXED_LEADER_BYTES} == 53) { # old firmware: no serial numbers |
|
509 |
$dta->{INSTRUMENT_TYPE} = 'Workhorse'; |
|
510 |
} elsif ($dta->{FIXED_LEADER_BYTES} == 59) { # new firmware: with serial numbers |
|
511 |
$dta->{INSTRUMENT_TYPE} = 'Workhorse'; |
|
512 |
} elsif ($dta->{FIXED_LEADER_BYTES} == 58) { # DVL |
|
513 |
$dta->{INSTRUMENT_TYPE} = 'Explorer'; |
|
514 |
} elsif ($dta->{FIXED_LEADER_BYTES} == 60) { # OS75 |
|
515 |
$dta->{INSTRUMENT_TYPE} = 'Ocean Surveyor'; |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
516 |
} else { |
39 | 517 |
$dta->{INSTRUMENT_TYPE} = 'unknown'; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
518 |
} |
39 | 519 |
|
520 |
#-------------------------------- |
|
521 |
# Variable Leader: SPEED_OF_SOUND |
|
522 |
#-------------------------------- |
|
14 | 523 |
|
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
524 |
sysseek(WBRF,$start_ens+$WBRofs[1],0) || die("$WBRcfn: $!"); |
14 | 525 |
sysread(WBRF,$buf,2) == 2 || die("$WBRcfn: $!"); |
526 |
$id = unpack('v',$buf); |
|
39 | 527 |
if ($dta->{INSTRUMENT_TYPE} eq 'Ocean Surveyor') { |
528 |
$id == 0x0081 || printf(STDERR $FmtErr."\n",$WBRcfn,"Variable Leader",$id,1); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
529 |
} else { |
39 | 530 |
$id == 0x0080 || printf(STDERR $FmtErr."\n",$WBRcfn,"Variable Leader",$id,1); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
531 |
} |
39 | 532 |
sysseek(WBRF,12,1) || die("$WBRcfn: $!"); # skip up to speed of sound |
14 | 533 |
sysread(WBRF,$buf,2) == 2 || die("$WBRcfn: $!"); |
39 | 534 |
$dta->{SPEED_OF_SOUND} = unpack('v',$buf); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
535 |
|
14 | 536 |
#-------------------- |
537 |
# FIXED LEADER |
|
538 |
#-------------------- |
|
539 |
||
26
02776c168135
made RDI_BB_IO work with files containing leading garbage
A.M. Thurnherr <ant@ldeo.columbia.edu>
parents:
24
diff
changeset
|
540 |
sysseek(WBRF,$start_ens+$WBRofs[0],0) || die("$WBRcfn: $!"); |
14 | 541 |
sysread(WBRF,$buf,42) == 42 || die("$WBRcfn: $!"); |
39 | 542 |
($id,$dta->{CPU_FW_VER},$dta->{CPU_FW_REV},$B1,$B2,$dummy, |
543 |
$dta->{LAG_LENGTH},$dummy, |
|
14 | 544 |
$dta->{N_BINS},$dta->{PINGS_PER_ENSEMBLE},$dta->{BIN_LENGTH}, |
545 |
$dta->{BLANKING_DISTANCE},$dummy,$dta->{MIN_CORRELATION}, |
|
546 |
$dta->{N_CODE_REPETITIONS},$dta->{MIN_PERCENT_GOOD}, |
|
547 |
$dta->{MAX_ERROR_VELOCITY},$dta->{TIME_BETWEEN_PINGS},$B3,$B4,$B5, |
|
548 |
$dta->{HEADING_ALIGNMENT},$dta->{HEADING_BIAS},$B6,$B7, |
|
549 |
$dta->{DISTANCE_TO_BIN1_CENTER},$dta->{TRANSMITTED_PULSE_LENGTH}, |
|
550 |
$dta->{REF_LAYER_FIRST_BIN},$dta->{REF_LAYER_LAST_BIN}, |
|
551 |
$dta->{FALSE_TARGET_THRESHOLD},$dta->{LOW_LATENCY_SETTING}, |
|
552 |
$dta->{TRANSMIT_LAG_DISTANCE}) = |
|
553 |
unpack('vCCCCC3CvvvCCCCvCCCCvvCCvvCCCCv',$buf); |
|
554 |
||
39 | 555 |
if ($dta->{INSTRUMENT_TYPE} eq 'Ocean Surveyor') { |
556 |
$id == 0x0001 || printf(STDERR $FmtErr."\n",$WBRcfn,"Fixed Leader",$id,0); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
557 |
} else { |
39 | 558 |
$id == 0x0000 || printf(STDERR $FmtErr."\n",$WBRcfn,"Fixed Leader",$id,0); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
559 |
} |
14 | 560 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
561 |
# $dta->{BEAM_FREQUENCY} = 2**($B1 & 0x07) * 75; # nominal |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
562 |
if (($B1&0x07) == 0b000) { $dta->{BEAM_FREQUENCY} = 76.8; } # actual |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
563 |
elsif (($B1&0x07) == 0b001) { $dta->{BEAM_FREQUENCY} = 153.6; } |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
564 |
elsif (($B1&0x07) == 0b010) { $dta->{BEAM_FREQUENCY} = 307.2; } |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
565 |
elsif (($B1&0x07) == 0b011) { $dta->{BEAM_FREQUENCY} = 614.4; } |
39 | 566 |
elsif (($B1&0x07) == 0b100) { $dta->{BEAM_FREQUENCY} = 1228.8; } |
567 |
elsif (($B1&0x07) == 0b101) { $dta->{BEAM_FREQUENCY} = 2457.6; } |
|
568 |
else { die(sprintf("$WBRcfn: cannot decode BEAM_FREQUENCY (%03b)\n",$B1&0x07)); } |
|
569 |
||
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
570 |
$dta->{CONVEX_BEAM_PATTERN} = 1 if ($B1 & 0x08); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
571 |
$dta->{CONCAVE_BEAM_PATTERN} = 1 if (!($B1 & 0x08)); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
572 |
$dta->{SENSOR_CONFIG} = ($B1 & 0x30) >> 4; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
573 |
$dta->{XDUCER_HEAD_ATTACHED} = 1 if ($B1 & 0x40); |
14 | 574 |
|
575 |
if (($B2 & 0x03) == 0x00) { $dta->{BEAM_ANGLE} = 15; } |
|
576 |
elsif (($B2 & 0x03) == 0x01) { $dta->{BEAM_ANGLE} = 20; } |
|
577 |
elsif (($B2 & 0x03) == 0x02) { $dta->{BEAM_ANGLE} = 30; } |
|
578 |
if (($B2 & 0xF0) == 0x40) { $dta->{N_BEAMS} = 4; } |
|
579 |
elsif (($B2 & 0xF0) == 0x50) { $dta->{N_BEAMS} = 5; $dta->{N_DEMODS} = 3; } |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
580 |
elsif (($B2 & 0xF0) == 0xF0) { $dta->{N_BEAMS} = 5; $dta->{N_DEMODS} = 2; } |
14 | 581 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
582 |
$dta->{BIN_LENGTH} /= 100; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
583 |
$dta->{BLANKING_DISTANCE} /= 100; |
14 | 584 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
585 |
$dta->{MAX_ERROR_VELOCITY} /= 1000; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
586 |
$dta->{TIME_BETWEEN_PINGS} *= 60; |
14 | 587 |
$dta->{TIME_BETWEEN_PINGS} += $B3 + $B4/100; |
588 |
||
589 |
$dta->{BEAM_COORDINATES} = 1 if (($B5 & 0x18) == 0x00); |
|
590 |
$dta->{INSTRUMENT_COORDINATES} = 1 if (($B5 & 0x18) == 0x08); |
|
591 |
$dta->{SHIP_COORDINATES} = 1 if (($B5 & 0x18) == 0x10); |
|
592 |
$dta->{EARTH_COORDINATES} = 1 if (($B5 & 0x18) == 0x18); |
|
593 |
$dta->{PITCH_AND_ROLL_USED} = 1 if ($B5 & 0x04); |
|
594 |
$dta->{USE_3_BEAM_ON_LOW_CORR} = 1 if ($B5 & 0x02); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
595 |
$dta->{BIN_MAPPING_ALLOWED} = 1 if ($B5 & 0x01); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
596 |
|
14 | 597 |
$dta->{HEADING_ALIGNMENT} = |
598 |
($dta->{EARTH_COORDINATES} || $dta->{SHIP_COORDINATES}) ? |
|
599 |
$dta->{HEADING_ALIGNMENT} / 100 : undef; |
|
600 |
$dta->{HEADING_BIAS} = |
|
601 |
($dta->{EARTH_COORDINATES} || $dta->{SHIP_COORDINATES}) ? |
|
602 |
$dta->{HEADING_BIAS} / 100 : undef; |
|
603 |
||
604 |
$dta->{CALCULATE_SPEED_OF_SOUND} = 1 if ($B6 & 0x40); |
|
605 |
$dta->{USE_PRESSURE_SENSOR} = 1 if ($B6 & 0x20); |
|
606 |
$dta->{USE_COMPASS} = 1 if ($B6 & 0x10); |
|
607 |
$dta->{USE_PITCH_SENSOR} = 1 if ($B6 & 0x08); |
|
608 |
$dta->{USE_ROLL_SENSOR} = 1 if ($B6 & 0x04); |
|
609 |
$dta->{USE_CONDUCTIVITY_SENSOR} = 1 if ($B6 & 0x02); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
610 |
$dta->{USE_TEMPERATURE_SENSOR} = 1 if ($B6 & 0x01); |
14 | 611 |
|
612 |
$dta->{SPEED_OF_SOUND_CALCULATED} = 1 if ($B7 & 0x40); |
|
613 |
$dta->{PRESSURE_SENSOR_AVAILABLE} = 1 if ($B7 & 0x20); |
|
614 |
$dta->{COMPASS_AVAILABLE} = 1 if ($B7 & 0x10); |
|
615 |
$dta->{PITCH_SENSOR_AVAILABLE} = 1 if ($B7 & 0x08); |
|
616 |
$dta->{ROLL_SENSOR_AVAILABLE} = 1 if ($B7 & 0x04); |
|
617 |
$dta->{CONDUCTIVITY_SENSOR_AVAILABLE} = 1 if ($B7 & 0x02); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
618 |
$dta->{TEMPERATURE_SENSOR_AVAILABLE} = 1 if ($B7 & 0x01); |
14 | 619 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
620 |
$dta->{DISTANCE_TO_BIN1_CENTER} /= 100; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
621 |
$dta->{TRANSMITTED_PULSE_LENGTH} /= 100; |
14 | 622 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
623 |
$dta->{FALSE_TARGET_THRESHOLD} = undef |
14 | 624 |
if ($dta->{FALSE_TARGET_THRESHOLD} == 255); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
625 |
$dta->{TRANSMIT_LAG_DISTANCE} /= 100; |
14 | 626 |
|
627 |
if ($dta->{INSTRUMENT_TYPE} eq 'Workhorse') { |
|
628 |
sysread(WBRF,$buf,11) == 11 || die("$WBRcfn: $!"); |
|
629 |
($W1,$W2,$W3,$W4,$W5,$dta->{TRANSMIT_POWER}) = |
|
630 |
unpack('vvvvvC',$buf); |
|
631 |
||
632 |
$dta->{CPU_SERIAL_NUMBER} = sprintf("%04X%04X%04X%04X",$W1,$W2,$W3,$W4); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
633 |
|
14 | 634 |
$dta->{NARROW_BANDWIDTH} = ($W5 == 1); |
635 |
$dta->{WIDE_BANDWIDTH} = ($W5 == 0); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
636 |
$dta->{TRANSMIT_POWER_HIGH} = ($dta->{TRANSMIT_POWER} == 255); |
14 | 637 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
638 |
if ($dta->{FIXED_LEADER_BYTES} == 59) { # new style with serial number |
14 | 639 |
sysread(WBRF,$buf,6) == 6 || die("$WBRcfn: $!"); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
640 |
($dummy,$dta->{SERIAL_NUMBER},$dummy) = # last bytes is beam angle, but that info has |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
641 |
unpack('CVC',$buf); # already been provided above |
14 | 642 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
643 |
} |
14 | 644 |
|
645 |
if ($dta->{INSTRUMENT_TYPE} eq 'Explorer') { |
|
646 |
sysread(WBRF,$buf,16) == 16 || die("$WBRcfn: $!"); |
|
647 |
($dummy,$dummy,$W5,$dummy,$dta->{SERIAL_NUMBER}) = |
|
648 |
unpack('VVvvV',$buf); |
|
649 |
$dta->{NARROW_BANDWIDTH} = ($W5 == 1); |
|
650 |
$dta->{WIDE_BANDWIDTH} = ($W5 == 0); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
651 |
} |
14 | 652 |
|
653 |
#----------------------- |
|
654 |
# 1st ENSEMBLE, BT Setup |
|
655 |
#----------------------- |
|
656 |
||
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
657 |
# CODE DISABLED BECAUSE BT_PRESENT FLAG WAS REMOVED. WITHOUT THIS CODE, |
49 | 658 |
# [listHdr] DOES NOT LIST ANY BT INFO |
659 |
# |
|
660 |
# if ($dta->{BT_PRESENT}) { |
|
661 |
# sysseek(WBRF,$start_ens+$WBRofs[$BT_dt],0) || die("$WBRcfn: $!"); |
|
662 |
# sysread(WBRF,$buf,12) == 12 || die("$WBRcfn: $!"); |
|
663 |
# ($id,$dta->{BT_PINGS_PER_ENSEMBLE},$dta->{BT_DELAY_BEFORE_REACQUIRE}, |
|
664 |
# $dta->{BT_MIN_CORRELATION},$dta->{BT_MIN_EVAL_AMPLITUDE}, |
|
665 |
# $dta->{BT_MIN_PERCENT_GOOD},$dta->{BT_MODE}, |
|
666 |
# $dta->{BT_MAX_ERROR_VELOCITY}) = unpack('vvvCCCCv',$buf); |
|
667 |
# |
|
668 |
# $id == 0x0600 || |
|
669 |
# printf(STDERR $FmtErr."\n",$WBRcfn,"Bottom Track",$id,0,tell(WBRF)); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
670 |
# |
49 | 671 |
# $dta->{BT_MAX_ERROR_VELOCITY} = |
672 |
# $dta->{BT_MAX_ERROR_VELOCITY} ? $dta->{BT_MAX_ERROR_VELOCITY} / 1000 |
|
673 |
# : undef; |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
674 |
# |
49 | 675 |
# sysseek(WBRF,28,1) || die("$WBRcfn: $!"); |
676 |
# sysread(WBRF,$buf,6) == 6 || die("$WBRcfn: $!"); |
|
677 |
# ($dta->{BT_RL_MIN_SIZE},$dta->{BT_RL_NEAR},$dta->{BT_RL_FAR}) |
|
678 |
# = unpack('vvv',$buf); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
679 |
# |
49 | 680 |
# $dta->{BT_RL_MIN_SIZE} /= 10; |
681 |
# $dta->{BT_RL_NEAR} /= 10; |
|
682 |
# $dta->{BT_RL_FAR} /= 10; |
|
683 |
# |
|
684 |
# sysseek(WBRF,20,1) || die("$WBRcfn: $!"); # skip data |
|
685 |
# sysread(WBRF,$buf,2) == 2 || die("$WBRcfn: $!"); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
686 |
# $dta->{BT_MAX_TRACKING_DEPTH} = unpack('v',$buf) / 10; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
687 |
# } |
14 | 688 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
689 |
return $dta; |
14 | 690 |
} |
691 |
||
692 |
#---------------------------------------------------------------------- |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
693 |
# readData(file_name,^data[,first_ens,last_ens[,last_bin]]) |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
694 |
# - read ensembles |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
695 |
# - read all ensembles unless first_ens and last_ens are given |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
696 |
# - read all bins unless last_bin is given |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
697 |
# - NB: CODE GETS PROGRESSIVELY SLOWER => HUGE PAIN FOR LARGE FILES |
14 | 698 |
#---------------------------------------------------------------------- |
699 |
||
700 |
sub readData(@) |
|
701 |
{ |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
702 |
my($fn,$dta,$fe,$le,$lb) = @_; |
14 | 703 |
$WBRcfn = $fn; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
704 |
open(WBRF,$WBRcfn) || die("$WBRcfn: $!\n"); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
705 |
WBRhdr($dta) || die("$WBRcfn: Insufficient Data\n"); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
706 |
$lb = $dta->{N_BINS} |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
707 |
unless (numberp($lb) && $lb>=1 && $lb<=$dta->{N_BINS}); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
708 |
WBRens($lb,$dta->{FIXED_LEADER_BYTES},\@{$dta->{ENSEMBLE}},$fe,$le); |
14 | 709 |
print(STDERR "$WBRcfn: $BIT_errors built-in-test errors\n") |
710 |
if ($BIT_errors); |
|
711 |
} |
|
712 |
||
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
713 |
sub WBRens(@) |
14 | 714 |
{ |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
715 |
my($nbins,$fixed_leader_bytes,$E,$fe,$le) = @_; |
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
716 |
my($B1,$B2,$B3,$B4,$I,$bin,$beam,$dummy,@dta,$i,$cs); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
717 |
my($ens,$ensNo,$dayStart,$ens_length,$hid,$did,$el); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
718 |
local our($ndt,$buf,$id,$start_ens,@WBRofs); |
14 | 719 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
720 |
sysseek(WBRF,0,0) || die("$WBRcfn: $!"); |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
721 |
ENSEMBLE: |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
722 |
for ($ens=0; 1; $ens++) { |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
723 |
print(STDERR '.') if ($RDI_PD0_IO::show_progress && $ens % 1000 == 0); |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
724 |
$start_ens = goto_next_ens(\*WBRF); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
725 |
last unless defined($start_ens); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
726 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
727 |
#---------------------------------------- |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
728 |
# Handle first_ens and last_ens |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
729 |
#---------------------------------------- |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
730 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
731 |
if (defined($fe) && $ens>0 && ${$E}[$ens-1]->{NUMBER}<$fe) { # delete previous ensemble |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
732 |
pop(@{$E}); $ens--; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
733 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
734 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
735 |
if (defined($le) && $ens>0 && ${$E}[$ens-1]->{NUMBER}>$le) { # delete previous ensemble and finish |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
736 |
pop(@{$E}); $ens--; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
737 |
last; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
738 |
} |
14 | 739 |
|
740 |
#---------------------------------------- |
|
741 |
# Get ensemble length and # of data types |
|
742 |
#---------------------------------------- |
|
743 |
||
744 |
sysseek(WBRF,$start_ens,0) || die("$WBRcfn: $!"); |
|
745 |
sysread(WBRF,$buf,6) == 6 || last; |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
746 |
($hid,$did,$el,$dummy,$ndt) = unpack('CCvCC',$buf); |
37 | 747 |
$hid == 0x7f || die(sprintf($FmtErr,$WBRcfn,"Header",$hid,defined($ensNo)?$ensNo+1:0)); |
29 | 748 |
${$E}[$ens]->{DATA_SOURCE_ID} = $did; |
749 |
if ($did == 0x7f) { |
|
750 |
${$E}[$ens]->{PRODUCER} = 'TRDI ADCP'; |
|
751 |
} elsif ($did&0xF0 == 0xA0) { |
|
752 |
${$E}[$ens]->{PRODUCER} = 'IMP+LADCP (Thurnherr software)'; |
|
31 | 753 |
} elsif ($did&0xF0 == 0xE0) { |
29 | 754 |
${$E}[$ens]->{PRODUCER} = 'editPD0 (Thurnherr software)'; |
755 |
} else { |
|
756 |
${$E}[$ens]->{PRODUCER} = 'unknown'; |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
757 |
} |
29 | 758 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
759 |
if (defined($ens_length) && ($el != $ens_length)) { |
50 | 760 |
$RDI_PD0_IO::File_Dirty = 1; |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
761 |
print(STDERR "WARNING (RDI_PD0_IO): ensemble ${$E}[$#{$E}]->{NUMBER} skipped (unexpected length)\n"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
762 |
pop(@{$E}); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
763 |
$ens--; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
764 |
next; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
765 |
} |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
766 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
767 |
$ens_length = $el; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
768 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
769 |
## printf(STDERR "$WBRcfn: WARNING: unexpected number of data types (%d, ens=$ens)\n",$ndt),last |
18 | 770 |
## unless ($ndt == 6 || $ndt == 7); |
50 | 771 |
my($nread) = sysread(WBRF,$buf,2*$ndt); # 2019 EPR test |
772 |
if ($nread != 2*$ndt) { |
|
773 |
printf(STDERR "$WBRcfn: WARNING: expected to read %d bytes, got only %d in ensemble %d\n", |
|
774 |
2*$ndt,$nread,${$E}[$ens]->{NUMBER}); |
|
775 |
last; |
|
776 |
} |
|
777 |
||
778 |
||
14 | 779 |
@WBRofs = unpack("v$ndt",$buf); |
780 |
$fixed_leader_bytes = $WBRofs[1] - $WBRofs[0]; |
|
781 |
# print(STDERR "@WBRofs\n"); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
782 |
|
14 | 783 |
#------------------------------- |
784 |
# Make Sure Ensemble is Complete |
|
785 |
#------------------------------- |
|
786 |
||
787 |
# UH BB150 writes incomplete ensembles (i.e. short read |
|
788 |
# indicates EOF). FSU WH300 has bogus data in incomplete |
|
789 |
# final ensemble. |
|
790 |
||
791 |
sysseek(WBRF,$start_ens,0) || die("$WBRcfn: $!"); |
|
37 | 792 |
unless ((sysread(WBRF,$buf,$ens_length) == $ens_length) && # incomplete ensemble |
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
793 |
(sysread(WBRF,$cs,2) == 2)) { |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
794 |
# print(STDERR "INCOMPLETE ENSEMBLE\n"); |
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
795 |
pop(@{$E}); |
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
796 |
last; |
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
797 |
} |
14 | 798 |
|
37 | 799 |
unless (unpack('%16C*',$buf) == unpack('v',$cs)) { # bad checksum |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
800 |
# print(STDERR "BAD CHECKSUM\n"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
801 |
pop(@{$E}); $ens--; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
802 |
next; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
803 |
} |
14 | 804 |
|
805 |
#------------------------------ |
|
806 |
# Variable Leader |
|
807 |
#------------------------------ |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
808 |
|
37 | 809 |
my($lastEns) = $ensNo; |
14 | 810 |
sysseek(WBRF,$start_ens+$WBRofs[1],0) || die("$WBRcfn: $!"); |
811 |
sysread(WBRF,$buf,4) == 4 || die("$WBRcfn: $!"); |
|
37 | 812 |
($id,$ensNo) = unpack("vv",$buf); # only lower two bytes!!! |
14 | 813 |
|
39 | 814 |
if (${$E}[$ens]->{INSTRUMENT_TYPE} eq 'Ocean Surveyor') { |
815 |
$id == 0x0081 || |
|
816 |
die(sprintf($FmtErr,$WBRcfn,"Variable Leader",$id,$ensNo + ($lastEns - ($lastEns & 0xFFFF)))); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
817 |
} else { |
39 | 818 |
$id == 0x0080 || |
819 |
die(sprintf($FmtErr,$WBRcfn,"Variable Leader",$id,$ensNo + ($lastEns - ($lastEns & 0xFFFF)))); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
820 |
} |
14 | 821 |
|
42 | 822 |
# if ($fixed_leader_bytes==42 || $fixed_leader_bytes==58) { # BB150 & Explorer DVL (if DISABLED!) |
823 |
sysread(WBRF,$buf,7) == 7 || die("$WBRcfn: $!"); # always read pre-Y2K clock |
|
14 | 824 |
(${$E}[$ens]->{YEAR},${$E}[$ens]->{MONTH}, |
825 |
${$E}[$ens]->{DAY},${$E}[$ens]->{HOUR},${$E}[$ens]->{MINUTE}, |
|
50 | 826 |
${$E}[$ens]->{SECOND},$B4) = unpack('CCCCCCC',$buf); |
827 |
${$E}[$ens]->{SECOND} += $B4/100; |
|
14 | 828 |
${$E}[$ens]->{YEAR} += (${$E}[$ens]->{YEAR} > 80) ? 1900 : 2000; |
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
829 |
# } else { |
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
830 |
# sysseek(WBRF,7,1) || die("$WBRcfn: $!"); # use Y2K RTC instead |
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
831 |
# } |
14 | 832 |
|
833 |
sysread(WBRF,$buf,1) == 1 || die("$WBRcfn: $!"); |
|
834 |
$ensNo += unpack('C',$buf) << 16; |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
835 |
|
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
836 |
## CODE DISABLED BECAUSE IT TAKES TOO MUCH TIME ON LARGE FILES. |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
837 |
## NOT SURE HOW COMMON DUPLICATE ENSEMBLES ARE. |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
838 |
## |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
839 |
## for (my($i)=$ens; $i>0; $i--) { # check for duplicate ens; e.g. 2018 S4P 24UL |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
840 |
## if (${$E}[$i]->{NUMBER} == $ensNo) { |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
841 |
## $RDI_PD0_IO::File_Dirty = 1; |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
842 |
## print(STDERR "WARNING (RDI_PD0_IO): duplicate ensemble $ensNo skipped\n"); |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
843 |
## pop(@{$E}); |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
844 |
## $ens--; |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
845 |
## next ENSEMBLE; |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
846 |
## } |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
847 |
## } |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
848 |
|
14 | 849 |
${$E}[$ens]->{NUMBER} = $ensNo; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
850 |
|
14 | 851 |
sysread(WBRF,$buf,30) == 30 || die("$WBRcfn: $!"); |
852 |
(${$E}[$ens]->{BUILT_IN_TEST_ERROR},${$E}[$ens]->{SPEED_OF_SOUND}, |
|
853 |
${$E}[$ens]->{XDUCER_DEPTH},${$E}[$ens]->{HEADING}, |
|
854 |
${$E}[$ens]->{PITCH},${$E}[$ens]->{ROLL}, |
|
855 |
${$E}[$ens]->{SALINITY},${$E}[$ens]->{TEMPERATURE}, |
|
856 |
${$E}[$ens]->{MIN_PRE_PING_WAIT_TIME},$B1,$B2, |
|
857 |
${$E}[$ens]->{HEADING_STDDEV},${$E}[$ens]->{PITCH_STDDEV}, |
|
858 |
${$E}[$ens]->{ROLL_STDDEV},${$E}[$ens]->{ADC_XMIT_CURRENT}, |
|
859 |
${$E}[$ens]->{ADC_XMIT_VOLTAGE},${$E}[$ens]->{ADC_AMBIENT_TEMPERATURE}, |
|
860 |
${$E}[$ens]->{ADC_PRESSURE_PLUS},${$E}[$ens]->{ADC_PRESSURE_MINUS}, |
|
861 |
${$E}[$ens]->{ADC_ATTITUDE_TEMPERATURE},${$E}[$ens]->{ADC_ATTITUDE}, |
|
862 |
${$E}[$ens]->{ADC_CONTAMINATION}) |
|
863 |
= unpack('vvvvvvvvCCCCCCCCCCCCCC',$buf); |
|
864 |
||
865 |
${$E}[$ens]->{BUILT_IN_TEST_ERROR} = undef |
|
866 |
unless (${$E}[$ens]->{BUILT_IN_TEST_ERROR}); |
|
867 |
$BIT_errors++ if (${$E}[$ens]->{BUILT_IN_TEST_ERROR}); |
|
868 |
||
869 |
${$E}[$ens]->{XDUCER_DEPTH} /= 10; |
|
18 | 870 |
|
871 |
#------------------------------------------------- |
|
872 |
# IMP EXTENSION: PITCH/ROLL/HEADING CAN BE MISSING |
|
873 |
#------------------------------------------------- |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
874 |
|
18 | 875 |
${$E}[$ens]->{HEADING} = (${$E}[$ens]->{HEADING} == 0xF000) |
876 |
? undef |
|
877 |
: ${$E}[$ens]->{HEADING} / 100; |
|
878 |
${$E}[$ens]->{PITCH} = (${$E}[$ens]->{PITCH} == 0x8000) |
|
879 |
? undef |
|
880 |
: unpack('s',pack('S',${$E}[$ens]->{PITCH})) / 100; |
|
881 |
${$E}[$ens]->{ROLL} = (${$E}[$ens]->{ROLL} == 0x8000) |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
882 |
? undef |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
883 |
: unpack('s',pack('S',${$E}[$ens]->{ROLL})) / 100; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
884 |
|
18 | 885 |
${$E}[$ens]->{TEMPERATURE} = unpack('s',pack('S',${$E}[$ens]->{TEMPERATURE})) / 100; |
14 | 886 |
${$E}[$ens]->{MIN_PRE_PING_WAIT_TIME} *= 60; |
887 |
${$E}[$ens]->{MIN_PRE_PING_WAIT_TIME} += $B1 + $B2/100; |
|
888 |
${$E}[$ens]->{PITCH_STDDEV} /= 10; |
|
889 |
${$E}[$ens]->{ROLL_STDDEV} /= 10; |
|
890 |
||
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
891 |
if (($fixed_leader_bytes==53 || $fixed_leader_bytes==59) && # Workhorse instruments |
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
892 |
!defined($RDI_PD0_IO::IGNORE_Y2K_CLOCK)) { |
14 | 893 |
sysread(WBRF,$buf,23) == 23 || die("$WBRcfn: $!"); |
894 |
(${$E}[$ens]->{ERROR_STATUS_WORD}, |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
895 |
$dummy,${$E}[$ens]->{PRESSURE},${$E}[$ens]->{PRESSURE_STDDEV}, |
14 | 896 |
$dummy,${$E}[$ens]->{YEAR},$B3,${$E}[$ens]->{MONTH}, |
897 |
${$E}[$ens]->{DAY},${$E}[$ens]->{HOUR},${$E}[$ens]->{MINUTE}, |
|
50 | 898 |
${$E}[$ens]->{SECOND},$B4) |
14 | 899 |
= unpack('VvVVCCCCCCCCC',$buf); |
900 |
||
901 |
${$E}[$ens]->{PRESSURE} /= 1000; |
|
902 |
${$E}[$ens]->{PRESSURE_STDDEV} /= 1000; |
|
903 |
${$E}[$ens]->{YEAR} *= 100; ${$E}[$ens]->{YEAR} += $B3; |
|
50 | 904 |
${$E}[$ens]->{SECOND} += $B4/100; |
14 | 905 |
} |
906 |
||
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
907 |
# THE FOLLOWING LINE OF CODE WAS REMOVED 7/30/2016 WHEN I ADDED A POP |
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
908 |
# TO THE last STATEMENT ABOVE (INCOMPLETE ENSEMBLE) |
42 | 909 |
# THE LINE WAS RE-ENABLED ON 12/23/2017 BECAUSE OTHERWISE THE |
910 |
# ANSLOPE II PROFILES IN THE HOWTO CANNOT BE READ. |
|
911 |
pop(@{$E}),last if (${$E}[$ens]->{MONTH}>12); # 10/15/2014; IWISE#145 UL ??? |
|
21 | 912 |
|
14 | 913 |
if ($fixed_leader_bytes == 58) { # Explorer DVL |
914 |
sysread(WBRF,$buf,14) == 14 || die("$WBRcfn: $!"); |
|
915 |
(${$E}[$ens]->{ERROR_STATUS_WORD}, |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
916 |
$dummy,${$E}[$ens]->{PRESSURE},${$E}[$ens]->{PRESSURE_STDDEV}) |
14 | 917 |
= unpack('VvVV',$buf); |
918 |
${$E}[$ens]->{PRESSURE} /= 1000; |
|
919 |
${$E}[$ens]->{PRESSURE_STDDEV} /= 1000; |
|
920 |
} |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
921 |
|
14 | 922 |
${$E}[$ens]->{DATE} |
923 |
= sprintf("%02d/%02d/%d",${$E}[$ens]->{MONTH}, |
|
924 |
${$E}[$ens]->{DAY}, |
|
925 |
${$E}[$ens]->{YEAR}); |
|
926 |
${$E}[$ens]->{TIME} |
|
927 |
= sprintf("%02d:%02d:%05.02f",${$E}[$ens]->{HOUR}, |
|
928 |
${$E}[$ens]->{MINUTE}, |
|
50 | 929 |
${$E}[$ens]->{SECOND}); |
14 | 930 |
${$E}[$ens]->{DAYNO} |
40
6a46e9d31106
after Hamburg visit
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
39
diff
changeset
|
931 |
= &_dayNo(${$E}[$ens]->{YEAR},${$E}[$ens]->{MONTH},${$E}[$ens]->{DAY}, |
50 | 932 |
${$E}[$ens]->{HOUR},${$E}[$ens]->{MINUTE},${$E}[$ens]->{SECOND}); |
14 | 933 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
934 |
# when analyzing an STA file from an OS75 SADCP (Poseidon), |
14 | 935 |
# I noticed that there is no time information. This causes |
936 |
# timegm to bomb. |
|
937 |
if (${$E}[$ens]->{MONTH} == 0) { # no time info |
|
938 |
${$E}[$ens]->{UNIX_TIME} = 0; |
|
939 |
${$E}[$ens]->{SECNO} = 0; |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
940 |
} else { |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
941 |
# print(STDERR "[$ens]->${$E}[$ens]->{MINUTE}:${$E}[$ens]->{HOUR},${$E}[$ens]->{DAY},${$E}[$ens]->{MONTH},${$E}[$ens]->{YEAR}-<\n"); |
14 | 942 |
${$E}[$ens]->{UNIX_TIME} |
943 |
= timegm(0,${$E}[$ens]->{MINUTE}, |
|
944 |
${$E}[$ens]->{HOUR}, |
|
945 |
${$E}[$ens]->{DAY}, |
|
946 |
${$E}[$ens]->{MONTH}-1, # timegm jan==0!!! |
|
947 |
${$E}[$ens]->{YEAR}) |
|
50 | 948 |
+ ${$E}[$ens]->{SECOND}; |
14 | 949 |
|
950 |
$dayStart = timegm(0,0,0,${$E}[$ens]->{DAY}, |
|
951 |
${$E}[$ens]->{MONTH}-1, |
|
952 |
${$E}[$ens]->{YEAR}) |
|
953 |
unless defined($dayStart); |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
954 |
${$E}[$ens]->{SECNO} = ${$E}[$ens]->{UNIX_TIME} - $dayStart; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
955 |
} |
14 | 956 |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
957 |
sysseek(WBRF,$start_ens+$WBRofs[0]+4,0) # System Config / Fixed Leader |
14 | 958 |
|| die("$WBRcfn: $!"); |
959 |
||
960 |
sysread(WBRF,$buf,5) == 5 || die("$WBRcfn: $!"); |
|
961 |
($B1,$dummy,$dummy,$dummy,${$E}[$ens]->{N_BEAMS_USED}) |
|
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
962 |
= unpack('CCCCC',$buf); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
963 |
${$E}[$ens]->{XDUCER_FACING_UP} = 1 if ($B1 & 0x80); |
14 | 964 |
${$E}[$ens]->{XDUCER_FACING_DOWN} = 1 unless ($B1 & 0x80); |
965 |
||
966 |
#-------------------- |
|
967 |
# Velocity Data |
|
968 |
#-------------------- |
|
969 |
||
970 |
my($ndata) = $nbins * 4; |
|
971 |
||
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
972 |
my($vel_di) = WBRdtaIndex(0x0100); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
973 |
die("no velocity data in ensemble #$ensNo\n") |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
974 |
unless defined($vel_di); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
975 |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
976 |
sysseek(WBRF,$start_ens+$WBRofs[$vel_di],0) || die("$WBRcfn: $!"); |
14 | 977 |
sysread(WBRF,$buf,2+$ndata*2) == 2+$ndata*2 || die("$WBRcfn: $!"); |
978 |
($id,@dta) = unpack("vv$ndata",$buf); |
|
979 |
||
980 |
for ($i=0,$bin=0; $bin<$nbins; $bin++) { |
|
981 |
for ($beam=0; $beam<4; $beam++,$i++) { |
|
982 |
${$E}[$ens]->{VELOCITY}[$bin][$beam] = |
|
983 |
unpack('s',pack('S',$dta[$i])) / 1000 |
|
984 |
if ($dta[$i] != 0x8000); |
|
985 |
} |
|
986 |
} |
|
987 |
||
988 |
#-------------------- |
|
989 |
# Correlation Data |
|
990 |
#-------------------- |
|
991 |
||
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
992 |
my($corr_di) = WBRdtaIndex(0x0200); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
993 |
die("no correlation data in ensemble #$ensNo\n") |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
994 |
unless defined($corr_di); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
995 |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
996 |
sysseek(WBRF,$start_ens+$WBRofs[$corr_di],0) || die("$WBRcfn: $!"); |
14 | 997 |
sysread(WBRF,$buf,2+$ndata) == 2+$ndata || die("$WBRcfn: $!"); |
998 |
($id,@dta) = unpack("vC$ndata",$buf); |
|
999 |
||
1000 |
for ($i=0,$bin=0; $bin<$nbins; $bin++) { |
|
1001 |
for ($beam=0; $beam<4; $beam++,$i++) { |
|
1002 |
${$E}[$ens]->{CORRELATION}[$bin][$beam] = $dta[$i] |
|
1003 |
if ($dta[$i]); |
|
1004 |
} |
|
1005 |
} |
|
1006 |
||
1007 |
#-------------------- |
|
1008 |
# Echo Intensity Data |
|
1009 |
#-------------------- |
|
1010 |
||
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1011 |
my($echo_di) = WBRdtaIndex(0x0300); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1012 |
die("no echo intensity data in ensemble #$ensNo\n") |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1013 |
unless defined($echo_di); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1014 |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1015 |
sysseek(WBRF,$start_ens+$WBRofs[$echo_di],0) || die("$WBRcfn: $!"); |
14 | 1016 |
sysread(WBRF,$buf,2+$ndata) == 2+$ndata || die("$WBRcfn: $!"); |
1017 |
($id,@dta) = unpack("vC$ndata",$buf); |
|
1018 |
||
1019 |
$id == 0x0300 || |
|
37 | 1020 |
die(sprintf($FmtErr,$WBRcfn,"Echo Intensity",$id,$ensNo)); |
14 | 1021 |
|
1022 |
for ($i=0,$bin=0; $bin<$nbins; $bin++) { |
|
1023 |
for ($beam=0; $beam<4; $beam++,$i++) { |
|
1024 |
${$E}[$ens]->{ECHO_AMPLITUDE}[$bin][$beam] = $dta[$i]; |
|
1025 |
} |
|
1026 |
} |
|
1027 |
||
1028 |
#-------------------- |
|
1029 |
# Percent Good Data |
|
1030 |
#-------------------- |
|
1031 |
||
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1032 |
my($pctg_di) = WBRdtaIndex(0x0400); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1033 |
die("no percent good data in ensemble #$ensNo\n") |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1034 |
unless defined($pctg_di); |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1035 |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1036 |
sysseek(WBRF,$start_ens+$WBRofs[$pctg_di],0) || die("$WBRcfn: $!"); |
14 | 1037 |
sysread(WBRF,$buf,2+$ndata) == 2+$ndata || die("$WBRcfn: $!"); |
1038 |
($id,@dta) = unpack("vC$ndata",$buf); |
|
1039 |
||
1040 |
$id == 0x0400 || |
|
37 | 1041 |
die(sprintf($FmtErr,$WBRcfn,"Percent-Good Data",$id,$ensNo)); |
14 | 1042 |
|
1043 |
for ($i=0,$bin=0; $bin<$nbins; $bin++) { |
|
1044 |
for ($beam=0; $beam<4; $beam++,$i++) { |
|
1045 |
${$E}[$ens]->{PERCENT_GOOD}[$bin][$beam] = $dta[$i]; |
|
1046 |
} |
|
1047 |
} |
|
1048 |
||
18 | 1049 |
#----------------------------------------- |
14 | 1050 |
# Bottom-Track Data |
18 | 1051 |
# - scan through remaining data types |
1052 |
#----------------------------------------- |
|
14 | 1053 |
|
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1054 |
my($bt_di) = WBRdtaIndex(0x0600); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1055 |
unless (defined($pctg_di)) { # no BT found => next ens |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1056 |
sysseek(WBRF,$start_ens+$ens_length+2,0) || die("$WBRcfn: $!"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1057 |
next; |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1058 |
} |
18 | 1059 |
|
32 | 1060 |
sysseek(WBRF,14,1) || die("$WBRcfn: $!"); # BT range, velocity, corr, %-good, ... |
18 | 1061 |
sysread(WBRF,$buf,28) == 28 || die("$WBRcfn: $!"); |
1062 |
@dta = unpack('v4v4C4C4C4',$buf); |
|
1063 |
for ($beam=0; $beam<4; $beam++) { |
|
32 | 1064 |
${$E}[$ens]->{BT_RANGE}[$beam] = $dta[$beam] / 100 # lower 2 bytes only! |
1065 |
if ($dta[$beam]); # (see below for high bytes) |
|
18 | 1066 |
} |
1067 |
for ($beam=0; $beam<4; $beam++) { |
|
1068 |
${$E}[$ens]->{BT_VELOCITY}[$beam] = |
|
1069 |
unpack('s',pack('S',$dta[4+$beam])) / 1000 |
|
1070 |
if ($dta[4+$beam] != 0x8000); |
|
1071 |
} |
|
1072 |
for ($beam=0; $beam<4; $beam++) { |
|
1073 |
${$E}[$ens]->{BT_CORRELATION}[$beam] = $dta[8+$beam] |
|
1074 |
if ($dta[8+$beam]); |
|
1075 |
} |
|
32 | 1076 |
for ($beam=0; $beam<4; $beam++) { # BT filter parameter |
18 | 1077 |
${$E}[$ens]->{BT_EVAL_AMPLITUDE}[$beam] = $dta[12+$beam]; |
1078 |
} |
|
1079 |
for ($beam=0; $beam<4; $beam++) { |
|
1080 |
${$E}[$ens]->{BT_PERCENT_GOOD}[$beam] = $dta[16+$beam]; |
|
1081 |
} |
|
1082 |
||
32 | 1083 |
sysseek(WBRF,6,1) || die("$WBRcfn: $!"); # BT ref level stuff |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1084 |
if (sysread(WBRF,$buf,20) != 20) { # EN642/PITA1 |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1085 |
pop(@{$E}); |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1086 |
last; |
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1087 |
} |
18 | 1088 |
@dta = unpack('v4C4C4C4',$buf); |
1089 |
for ($beam=0; $beam<4; $beam++) { |
|
1090 |
${$E}[$ens]->{BT_RL_VELOCITY}[$beam] = |
|
1091 |
unpack('s',pack('S',$dta[$beam])) / 1000 |
|
1092 |
if ($dta[$beam] != 0x8000); |
|
1093 |
} |
|
1094 |
for ($beam=0; $beam<4; $beam++) { |
|
1095 |
${$E}[$ens]->{BT_RL_CORRELATION}[$beam] = $dta[4+$beam] |
|
1096 |
if ($dta[4+$beam]); |
|
1097 |
} |
|
1098 |
for ($beam=0; $beam<4; $beam++) { |
|
1099 |
${$E}[$ens]->{BT_RL_ECHO_AMPLITUDE}[$beam] = $dta[8+$beam]; |
|
1100 |
} |
|
1101 |
for ($beam=0; $beam<4; $beam++) { |
|
1102 |
${$E}[$ens]->{BT_RL_PERCENT_GOOD}[$beam] = $dta[12+$beam]; |
|
1103 |
} |
|
1104 |
||
32 | 1105 |
sysseek(WBRF,2,1) || die("$WBRcfn: $!"); # BT signal strength & BT range high bytes |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1106 |
# sysread(WBRF,$buf,9) == 9 || die("$WBRcfn: $!"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1107 |
if (sysread(WBRF,$buf,9) == 9) { # SR1b JR16 BB150 data files require this |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1108 |
@dta = unpack('C4CC4',$buf); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1109 |
for ($beam=0; $beam<4; $beam++) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1110 |
${$E}[$ens]->{BT_SIGNAL_STRENGTH}[$beam] = $dta[$beam]; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1111 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1112 |
${$E}[$ens]->{HIGH_GAIN} if ($dta[4]); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1113 |
${$E}[$ens]->{LOW_GAIN} unless ($dta[4]); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1114 |
for ($beam=0; $beam<4; $beam++) { # high bytes (1 byte per beam) |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1115 |
${$E}[$ens]->{BT_RANGE}[$beam] += $dta[5+$beam] * 655.36 |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1116 |
if ($dta[5+$beam]); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1117 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1118 |
# sysseek(WBRF,8,1) || die("$WBRcfn: $!"); # remainder of ensemble |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1119 |
} |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1120 |
sysseek(WBRF,$start_ens+$ens_length+2,0) || die("$WBRcfn: $!"); |
14 | 1121 |
} # ens loop |
51
148c092b3a09
after somewhat suspicous RDI_PD0_IO.pl merge and just before adding
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
50
diff
changeset
|
1122 |
print(STDERR "\n") if ($RDI_PD0_IO::show_progress); |
14 | 1123 |
} |
1124 |
||
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
1125 |
sub WBRdtaIndex($) # return index of particular data type |
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
1126 |
{ # where index refers to data sections inside PD0 files |
48
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1127 |
my($trgid) = @_; |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1128 |
our($ndt,$buf,$id,$start_ens,@WBRofs); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1129 |
|
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1130 |
for (my($di)=2; $di<$ndt; $di++) { |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1131 |
sysseek(WBRF,$start_ens+$WBRofs[$di],0) || die("$WBRcfn: $!"); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1132 |
sysread(WBRF,$buf,2) == 2 || die("$WBRcfn: $!"); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1133 |
$id = unpack('v',$buf); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1134 |
return $di if ($id == $trgid); |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1135 |
} |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1136 |
return undef; |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1137 |
} |
cdc74ebada81
after partial adaptation to RTI files
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
45
diff
changeset
|
1138 |
|
14 | 1139 |
#---------------------------------------------------------------------- |
28 | 1140 |
# writeData(output_file_name,^data) WBPens(nbins,fixed_leader_bytes,^data) |
1141 |
# - writeData() copies file previously read with readData() to output_file_name |
|
1142 |
# - WBPens() patches new PD0 file with ^data |
|
1143 |
# - ^data is modified!!!! |
|
1144 |
# - output file must already exist and have correct structure |
|
1145 |
# - only subset of data structure is patched: |
|
1146 |
# - Header: Data Source Id |
|
1147 |
# - Var Ldr: Soundspeed, Depth, Heading, Pitch, Roll, Temp, Salin |
|
1148 |
# - Data: Velocity, Correlation, Echo Amp, %-Good, |
|
14 | 1149 |
#---------------------------------------------------------------------- |
1150 |
||
1151 |
sub writeData(@) |
|
1152 |
{ |
|
1153 |
my($fn,$dta) = @_; |
|
1154 |
||
50 | 1155 |
die("writeData() needs \$WBRcfn from previous readData()\n") |
31 | 1156 |
unless (length($WBRcfn) > 0); |
50 | 1157 |
die("writeData() only works with clean PD0 files\n") |
1158 |
if ($RDI_PD0_IO::File_Dirty); |
|
31 | 1159 |
|
1160 |
sysseek(WBRF,0,0) || die("$WBRcfn: $!"); # rewind input file |
|
1161 |
$WBPcfn = $fn; # set patch file name for error messages |
|
1162 |
open(WBPF,"+>$WBPcfn") || die("$WBPcfn: $!"); # open patch file for r/w |
|
14 | 1163 |
|
31 | 1164 |
while (1) { # copy input file to patch file |
1165 |
my($buf); |
|
1166 |
my($nread) = sysread(WBRF,$buf,100*1024); |
|
1167 |
die("$WBRcfn: $!\n") if ($nread < 0); |
|
1168 |
last if ($nread == 0); |
|
1169 |
my($nwritten) = syswrite(WBPF,$buf,100*1024); |
|
1170 |
die("$WBPcfn: $! ($nwritten of $nread written)\n") |
|
1171 |
unless ($nwritten = $nread); |
|
1172 |
} |
|
1173 |
sysseek(WBPF,0,0) || die("$WBPcfn: $!"); # rewind patch file |
|
1174 |
||
1175 |
WBPens($dta->{N_BINS},$dta->{FIXED_LEADER_BYTES},$dta); |
|
14 | 1176 |
} |
1177 |
||
37 | 1178 |
sub _round(@) |
28 | 1179 |
{ |
1180 |
return $_[0] >= 0 ? int($_[0] + 0.5) |
|
1181 |
: int($_[0] - 0.5); |
|
1182 |
} |
|
1183 |
||
1184 |
||
14 | 1185 |
sub WBPens($$$) |
1186 |
{ |
|
31 | 1187 |
my($nbins,$fixed_leader_bytes,$dta) = @_; |
14 | 1188 |
my($start_ens,$B1,$B2,$B3,$B4,$I,$id,$bin,$beam,$buf,$dummy,@dta,$i,$cs,@WBPofs); |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1189 |
my($ens,$dayStart,$ens_length,$hid,$ndt,$el); |
14 | 1190 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1191 |
# for ($ens=$start_ens=0; $ens<=$#{$dta->{ENSEMBLE}}; $ens++,$start_ens+=$ens_length+2) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1192 |
for ($ens=0; $ens<=$#{$dta->{ENSEMBLE}}; $ens++) { |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1193 |
$start_ens = goto_next_ens(\*WBPF); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1194 |
die("ens = $ens\n") unless defined($start_ens); |
14 | 1195 |
|
18 | 1196 |
#------------------------------ |
1197 |
# Patch Header (Data Source Id) |
|
1198 |
#------------------------------ |
|
14 | 1199 |
|
1200 |
sysseek(WBPF,$start_ens,0) || die("$WBPcfn: $!"); |
|
18 | 1201 |
sysread(WBPF,$buf,1) || die("$WBPcfn: unexpected EOF"); |
1202 |
($hid) = unpack('C',$buf); |
|
1203 |
$hid == 0x7f || die(sprintf($FmtErr,$WBPcfn,"Header",$hid,$ens)); |
|
1204 |
||
31 | 1205 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{DATA_SOURCE_ID}); |
18 | 1206 |
my($nw) = syswrite(WBPF,$buf,1); |
1207 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1208 |
||
1209 |
sysread(WBPF,$buf,4) == 4 || die("$WBPcfn: unexpected EOF"); |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1210 |
($el,$dummy,$ndt) = unpack('vCC',$buf); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1211 |
$ens--,next if (defined($ens_length) && ($el != $ens_length)); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1212 |
$ens_length = $el; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1213 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1214 |
printf(STDERR "$WBPcfn: WARNING: unexpected number of data types (%d, ens=$ens)\n",$ndt),last |
14 | 1215 |
unless ($ndt == 6 || $ndt == 7); |
18 | 1216 |
|
14 | 1217 |
sysread(WBPF,$buf,2*$ndt) == 2*$ndt || die("$WBPcfn: $!"); |
1218 |
@WBPofs = unpack("v$ndt",$buf); |
|
1219 |
$fixed_leader_bytes = $WBPofs[1] - $WBPofs[0]; |
|
31 | 1220 |
|
1221 |
#-------------------- |
|
1222 |
# Fixed Leader |
|
1223 |
#-------------------- |
|
14 | 1224 |
|
32 | 1225 |
sysseek(WBPF,$start_ens+$WBPofs[0]+4,0) # system config (transducer orientation) |
1226 |
|| die("$WBPcfn: $!"); |
|
1227 |
sysread(WBPF,$buf,1) == 1 || die("$WBPcfn: $!"); |
|
1228 |
$B1 = unpack('C',$buf); |
|
1229 |
$B1 |= 0x80 if ($dta->{ENSEMBLE}[$ens]->{XDUCER_FACING_UP}); |
|
1230 |
$B1 &= 0x7F if ($dta->{ENSEMBLE}[$ens]->{XDUCER_FACING_DOWN}); |
|
1231 |
$buf = pack('C',$B1); |
|
1232 |
sysseek(WBPF,$start_ens+$WBPofs[0]+4,0) |
|
1233 |
|| die("$WBPcfn: $!"); |
|
1234 |
syswrite(WBPF,$buf,1) == 1 || die("$WBPcfn: $!"); |
|
1235 |
||
1236 |
sysseek(WBPF,$start_ens+$WBPofs[0]+25,0) || die("$WBPcfn: $!"); # EX / coord-transformation |
|
31 | 1237 |
sysread(WBPF,$buf,1) == 1 || die("$WBPcfn: $!"); |
1238 |
my($EX) = unpack('C',$buf); |
|
1239 |
if ($dta->{BEAM_COORDINATES}) { |
|
1240 |
$EX &= ~0x18; |
|
1241 |
} elsif ($dta->{EARTH_COORDINATES}) { |
|
1242 |
$EX |= 0x18; |
|
1243 |
} else { |
|
1244 |
die("$WBPcfn: only beam- and earth coordinates are supported (implementation restriction)\n"); |
|
1245 |
} |
|
1246 |
$buf = pack('C',$EX); |
|
1247 |
sysseek(WBPF,$start_ens+$WBPofs[0]+25,0) || die("$WBPcfn: $!"); |
|
1248 |
syswrite(WBPF,$buf,1) == 1 || die("$WBPcfn: $!"); |
|
1249 |
||
42 | 1250 |
#---------------------------------------------------------------------- |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1251 |
# Variable Leader #0 |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1252 |
# - read ensNo for debugging purposes |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1253 |
#---------------------------------------------------------------------- |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1254 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1255 |
sysseek(WBPF,$start_ens+$WBPofs[1]+2,0) || die("$WBPcfn: $!"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1256 |
sysread(WBPF,$buf,2) == 2 || die("$WBPcfn: $!"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1257 |
my($ensNo) = unpack("v",$buf); # only lower two bytes!!! |
52
5b07a9b89aee
- adapted to work with IMPed moored ADCP data
Andreas Thurnherr <ant@ldeo.columbia.edu>
parents:
51
diff
changeset
|
1258 |
sysseek(WBPF,$start_ens+$WBPofs[1]+11,0) || die("$WBPcfn: $!"); # jump to high byte |
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1259 |
sysread(WBPF,$buf,1) == 1 || die("$WBPcfn: $!"); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1260 |
$ensNo += unpack('C',$buf) << 16; |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1261 |
die("ensNo = $ensNo (should be $dta->{ENSEMBLE}[$ens]->{NUMBER})\n") |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1262 |
unless ($ensNo == $dta->{ENSEMBLE}[$ens]->{NUMBER}); |
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1263 |
|
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1264 |
#---------------------------------------------------------------------- |
42 | 1265 |
# Variable Leader #1 |
1266 |
# - if $RDI_PD0_IO::OVERRIDE_Y2K_CLOCK is set, the data from the pre-Y2K |
|
1267 |
# clock are used to override the ADCP clock values; this allows |
|
1268 |
# a better time to be recorded by the data acquisition system |
|
1269 |
# without overwriting the main instrument clock data |
|
1270 |
#---------------------------------------------------------------------- |
|
31 | 1271 |
|
42 | 1272 |
if ($RDI_PD0_IO::OVERRIDE_Y2K_CLOCK) { |
1273 |
sysseek(WBPF,$start_ens+$WBPofs[1]+4,0) || die("$WBPcfn: $!"); # jump to RTC_YEAR |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1274 |
sysread(WBPF,$buf,7) == 7 || die("$WBPcfn: $!"); # read pre-Y2K clock |
42 | 1275 |
($dta->{ENSEMBLE}[$ens]->{YEAR}, |
1276 |
$dta->{ENSEMBLE}[$ens]->{MONTH}, |
|
1277 |
$dta->{ENSEMBLE}[$ens]->{DAY}, |
|
1278 |
$dta->{ENSEMBLE}[$ens]->{HOUR}, |
|
1279 |
$dta->{ENSEMBLE}[$ens]->{MINUTE}, |
|
50 | 1280 |
$dta->{ENSEMBLE}[$ens]->{SECOND},$B4) = |
42 | 1281 |
unpack('CCCCCCC',$buf); |
50 | 1282 |
$dta->{ENSEMBLE}[$ens]->{SECOND} += $B4/100; |
42 | 1283 |
$dta->{ENSEMBLE}[$ens]->{YEAR} += ($dta->{ENSEMBLE}[$ens]->{YEAR} > 80) ? 1900 : 2000; |
1284 |
} |
|
1285 |
||
1286 |
#---------------------------------------------------------------------- |
|
1287 |
# Variable Leader #2 |
|
43
b63fa355644c
commit to merge with changes from EN620
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
42
diff
changeset
|
1288 |
# - read ensemble number for debugging purposes |
42 | 1289 |
# - patch everything from SPEED_OF_SOUND to TEMPERATURE |
1290 |
# - at one stage, IMP allowed for missing values in pitch/roll and heading; |
|
1291 |
# on 12/23/2017 the corresponding code was disabled (replaced by assertion) |
|
1292 |
#---------------------------------------------------------------------- |
|
1293 |
||
1294 |
sysseek(WBPF,$start_ens+$WBPofs[1]+14,0) || die("$WBPcfn: $!"); # jump to SPEED_OF_SOUND |
|
14 | 1295 |
|
37 | 1296 |
$dta->{ENSEMBLE}[$ens]->{XDUCER_DEPTH} = _round($dta->{ENSEMBLE}[$ens]->{XDUCER_DEPTH}*10); |
18 | 1297 |
|
42 | 1298 |
# $dta->{ENSEMBLE}[$ens]->{HEADING} = defined($dta->{ENSEMBLE}[$ens]->{HEADING}) |
1299 |
# ? _round($dta->{ENSEMBLE}[$ens]->{HEADING}*100) |
|
1300 |
# : 0xF000; |
|
1301 |
# $dta->{ENSEMBLE}[$ens]->{PITCH} = defined($dta->{ENSEMBLE}[$ens]->{PITCH}) |
|
1302 |
# ? unpack('S',pack('s',_round($dta->{ENSEMBLE}[$ens]->{PITCH}*100))) |
|
1303 |
# : 0x8000; |
|
1304 |
# $dta->{ENSEMBLE}[$ens]->{ROLL} = defined($dta->{ENSEMBLE}[$ens]->{ROLL}) |
|
1305 |
# ? unpack('S',pack('s',_round($dta->{ENSEMBLE}[$ens]->{ROLL}*100))) |
|
1306 |
# : 0x8000; |
|
28 | 1307 |
|
42 | 1308 |
croak("$0: assertion failed") unless defined($dta->{ENSEMBLE}[$ens]->{HEADING}) && |
1309 |
defined($dta->{ENSEMBLE}[$ens]->{PITCH}) && |
|
1310 |
defined($dta->{ENSEMBLE}[$ens]->{ROLL}); |
|
1311 |
$dta->{ENSEMBLE}[$ens]->{HEADING} = _round($dta->{ENSEMBLE}[$ens]->{HEADING}*100); |
|
1312 |
$dta->{ENSEMBLE}[$ens]->{PITCH} = unpack('S',pack('s',_round($dta->{ENSEMBLE}[$ens]->{PITCH}*100))); |
|
1313 |
$dta->{ENSEMBLE}[$ens]->{ROLL} = unpack('S',pack('s',_round($dta->{ENSEMBLE}[$ens]->{ROLL}*100))); |
|
1314 |
$dta->{ENSEMBLE}[$ens]->{TEMPERATURE} = unpack('S',pack('s',_round($dta->{ENSEMBLE}[$ens]->{TEMPERATURE}*100))); |
|
14 | 1315 |
|
1316 |
$buf = pack('vvvvvvv', |
|
31 | 1317 |
$dta->{ENSEMBLE}[$ens]->{SPEED_OF_SOUND}, |
1318 |
$dta->{ENSEMBLE}[$ens]->{XDUCER_DEPTH},$dta->{ENSEMBLE}[$ens]->{HEADING}, |
|
1319 |
$dta->{ENSEMBLE}[$ens]->{PITCH},$dta->{ENSEMBLE}[$ens]->{ROLL}, |
|
1320 |
$dta->{ENSEMBLE}[$ens]->{SALINITY},$dta->{ENSEMBLE}[$ens]->{TEMPERATURE}); |
|
14 | 1321 |
|
1322 |
my($nw) = syswrite(WBPF,$buf,14); |
|
1323 |
$nw == 14 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1324 |
||
28 | 1325 |
|
42 | 1326 |
#---------------------------------------------------------------------- |
1327 |
# Variable Leader #3 |
|
1328 |
# - patch Y2K RTC |
|
1329 |
#---------------------------------------------------------------------- |
|
1330 |
||
1331 |
sysseek(WBPF,$start_ens+$WBPofs[1]+57,0) || die("$WBPcfn: $!"); # jump to RTC_CENTURY |
|
1332 |
||
1333 |
my($century) = int($dta->{ENSEMBLE}[$ens]->{YEAR} / 100); |
|
1334 |
my($year) = $dta->{ENSEMBLE}[$ens]->{YEAR} % 100; |
|
50 | 1335 |
my($seconds) = int($dta->{ENSEMBLE}[$ens]->{SECOND}); |
1336 |
my($hundredths) = 100 * ($dta->{ENSEMBLE}[$ens]->{SECOND} - $seconds); |
|
42 | 1337 |
$buf = pack('CCCCCCCC',$century,$year,$dta->{ENSEMBLE}[$ens]->{MONTH}, |
1338 |
$dta->{ENSEMBLE}[$ens]->{DAY},$dta->{ENSEMBLE}[$ens]->{HOUR}, |
|
1339 |
$dta->{ENSEMBLE}[$ens]->{MINUTE},$seconds,$hundredths); |
|
1340 |
my($nw) = syswrite(WBPF,$buf,8); |
|
1341 |
$nw == 8 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1342 |
||
28 | 1343 |
#-------------------- |
1344 |
# Velocity Data |
|
1345 |
#-------------------- |
|
1346 |
||
32 | 1347 |
sysseek(WBPF,$start_ens+$WBPofs[2]+2,0) || die("$WBPcfn: $!"); # skip velocity data id (assume it is correct) |
28 | 1348 |
for ($bin=0; $bin<$nbins; $bin++) { |
1349 |
for ($beam=0; $beam<4; $beam++) { |
|
31 | 1350 |
$dta->{ENSEMBLE}[$ens]->{VELOCITY}[$bin][$beam] = defined($dta->{ENSEMBLE}[$ens]->{VELOCITY}[$bin][$beam]) |
37 | 1351 |
? _round($dta->{ENSEMBLE}[$ens]->{VELOCITY}[$bin][$beam]*1000) |
28 | 1352 |
: 0x8000; |
31 | 1353 |
$buf = pack('v',unpack('S',pack('s',$dta->{ENSEMBLE}[$ens]->{VELOCITY}[$bin][$beam]))); |
28 | 1354 |
my($nw) = syswrite(WBPF,$buf,2); |
1355 |
$nw == 2 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1356 |
} |
|
1357 |
} |
|
1358 |
||
1359 |
#-------------------- |
|
1360 |
# Correlation Data |
|
1361 |
#-------------------- |
|
1362 |
||
32 | 1363 |
sysseek(WBPF,$start_ens+$WBPofs[3]+2,0) || die("$WBPcfn: $!"); |
28 | 1364 |
for ($bin=0; $bin<$nbins; $bin++) { |
1365 |
for ($beam=0; $beam<4; $beam++) { |
|
31 | 1366 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{CORRELATION}[$bin][$beam]); |
28 | 1367 |
my($nw) = syswrite(WBPF,$buf,1); |
1368 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1369 |
} |
|
1370 |
} |
|
1371 |
||
1372 |
#-------------------- |
|
1373 |
# Echo Intensity Data |
|
1374 |
#-------------------- |
|
1375 |
||
32 | 1376 |
sysseek(WBPF,$start_ens+$WBPofs[4]+2,0) || die("$WBPcfn: $!"); |
28 | 1377 |
|
1378 |
for ($bin=0; $bin<$nbins; $bin++) { |
|
1379 |
for ($beam=0; $beam<4; $beam++) { |
|
31 | 1380 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{ECHO_AMPLITUDE}[$bin][$beam]); |
28 | 1381 |
my($nw) = syswrite(WBPF,$buf,1); |
1382 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1383 |
} |
|
1384 |
} |
|
1385 |
||
1386 |
#-------------------- |
|
1387 |
# Percent Good Data |
|
1388 |
#-------------------- |
|
1389 |
||
32 | 1390 |
sysseek(WBPF,$start_ens+$WBPofs[5]+2,0) || die("$WBPcfn: $!"); |
28 | 1391 |
|
1392 |
for ($i=0,$bin=0; $bin<$nbins; $bin++) { |
|
1393 |
for ($beam=0; $beam<4; $beam++,$i++) { |
|
31 | 1394 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{PERCENT_GOOD}[$bin][$beam]); |
28 | 1395 |
my($nw) = syswrite(WBPF,$buf,1); |
1396 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1397 |
} |
|
1398 |
} |
|
1399 |
||
1400 |
#----------------------------------------- |
|
1401 |
# Bottom-Track Data |
|
1402 |
# - scan through remaining data types |
|
1403 |
#----------------------------------------- |
|
1404 |
||
1405 |
my($nxt); |
|
1406 |
for ($nxt=6; $nxt<$ndt; $nxt++) { # scan until BT found |
|
32 | 1407 |
sysseek(WBPF,$start_ens+$WBPofs[$nxt],0) || die("$WBPcfn: $!"); |
36
515b06dae59c
version at end of ECOGIG EN586 cruise
A.M. Thurnherr <athurnherr@yahoo.com>
parents:
32
diff
changeset
|
1408 |
sysread(WBPF,$buf,2) == 2 || die("$WBPcfn: $! [ens=$ens]"); |
28 | 1409 |
$id = unpack('v',$buf); |
1410 |
last if ($id == 0x0600); |
|
1411 |
} |
|
1412 |
||
1413 |
unless ($nxt == $ndt) { # BT found |
|
32 | 1414 |
sysseek(WBPF,14,1) || die("$WBPcfn: $!"); # skip BT config |
1415 |
for ($beam=0; $beam<4; $beam++) { # BT range low bytes (2 per beam) |
|
37 | 1416 |
$buf = pack('v',_round($dta->{ENSEMBLE}[$ens]->{BT_RANGE}[$beam] * 100) & 0xFFFF); |
32 | 1417 |
my($nw) = syswrite(WBPF,$buf,2); |
1418 |
$nw == 2 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1419 |
} |
|
1420 |
||
1421 |
for ($beam=0; $beam<4; $beam++) { # BT velocities |
|
1422 |
$buf = pack('v',unpack('S',pack('s', |
|
1423 |
defined($dta->{ENSEMBLE}[$ens]->{BT_VELOCITY}[$beam]) |
|
37 | 1424 |
? _round($dta->{ENSEMBLE}[$ens]->{BT_VELOCITY}[$beam]*1000) |
32 | 1425 |
: 0x8000))); |
1426 |
my($nw) = syswrite(WBPF,$buf,2); |
|
1427 |
$nw == 2 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1428 |
} |
|
1429 |
||
1430 |
for ($beam=0; $beam<4; $beam++) { # BT correlation |
|
1431 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{BT_CORRELATION}[$beam]); |
|
1432 |
my($nw) = syswrite(WBPF,$buf,1); |
|
1433 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1434 |
} |
|
1435 |
||
1436 |
for ($beam=0; $beam<4; $beam++) { # BT evaluation amp of matching filter |
|
1437 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{BT_EVAL_AMPLITUDE}[$beam]); |
|
1438 |
my($nw) = syswrite(WBPF,$buf,1); |
|
1439 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1440 |
} |
|
1441 |
||
1442 |
for ($beam=0; $beam<4; $beam++) { # BT percent good |
|
1443 |
$buf = pack('C',$dta->{ENSEMBLE}[$ens]->{BT_PERCENT_GOOD}[$beam]); |
|
1444 |
my($nw) = syswrite(WBPF,$buf,1); |
|
1445 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1446 |
} |
|
28 | 1447 |
|
32 | 1448 |
sysseek(WBPF,33,1) || die("$WBPcfn: $!"); # BT range high bytes (1 per beam) |
1449 |
for ($beam=0; $beam<4; $beam++) { |
|
37 | 1450 |
$buf = pack('C',(_round($dta->{ENSEMBLE}[$ens]->{BT_RANGE}[$beam]*100) & 0xFF0000) >> 16); |
32 | 1451 |
my($nw) = syswrite(WBPF,$buf,1); |
1452 |
$nw == 1 || die("$WBPcfn: $nw bytes written ($!)"); |
|
1453 |
} |
|
1454 |
||
1455 |
} # if BT found |
|
28 | 1456 |
|
14 | 1457 |
#---------------- |
1458 |
# Update Checksum |
|
1459 |
#---------------- |
|
1460 |
||
1461 |
sysseek(WBPF,$start_ens,0) || die("$WBPcfn: $!"); |
|
1462 |
sysread(WBPF,$buf,$ens_length) == $ens_length || die("$WBPcfn: $!"); |
|
1463 |
$cs = unpack('%16C*',$buf); |
|
1464 |
$buf = pack('v',$cs); |
|
1465 |
$nw = syswrite(WBPF,$buf,2); |
|
1466 |
$nw == 2 || die("$WBPcfn: $nw bytes written, ens=$ens ($!)"); |
|
1467 |
||
1468 |
} # ens loop |
|
1469 |
} |
|
1470 |
||
37 | 1471 |
#---------------------------------------------------------------------- |
1472 |
# &clearEns(^data,ens-index) |
|
1473 |
# - undefine all velocities in ensemble, including BT |
|
1474 |
# - this is required for the LDEO_IX software, |
|
1475 |
# which does not recognize missing attitude values |
|
1476 |
# - set percent good to zero |
|
1477 |
# - this is done for consistency |
|
1478 |
# - DO NOT undef heading, pitch and roll |
|
1479 |
# - the LDEO software does not recognize missing attitude vals |
|
1480 |
# and, therefore, misinterprets those |
|
1481 |
# - while this should not matter because all the velocities are |
|
1482 |
# also deleted, it was found that setting only the heading to |
|
1483 |
# undef'd and leaving pitch and roll unchanged causes |
|
1484 |
# significant errors in GPS velocity referencing! This |
|
1485 |
# must be a bug |
|
1486 |
# - also, if attitudes are undef'd the LDEO software |
|
1487 |
# cannto determine the instrument offset from pitch/roll |
|
1488 |
# and the pitch/roll DL vs UL plots are bogus |
|
1489 |
#---------------------------------------------------------------------- |
|
1490 |
||
1491 |
sub clearEns($$) |
|
1492 |
{ |
|
1493 |
my($dta,$ens) = @_; |
|
39 | 1494 |
die("clearEns: ens-index $ens out of range\n") |
37 | 1495 |
unless ($ens>=0 && $ens<=$#{$dta->{ENSEMBLE}}); |
1496 |
for (my($bin)=0; $bin<$dta->{N_BINS}; $bin++) { |
|
1497 |
undef(@{$dta->{ENSEMBLE}[$ens]->{VELOCITY}[$bin]}); |
|
1498 |
@{$dta->{ENSEMBLE}[$ens]->{PERCENT_GOOD}[$bin]} = (0,0,0,0); |
|
1499 |
} |
|
1500 |
undef(@{$dta->{ENSEMBLE}[$ens]->{BT_VELOCITY}}); |
|
1501 |
@{$dta->{ENSEMBLE}[$ens]->{BT_PERCENT_GOOD}} = (0,0,0,0); |
|
1502 |
# undef($dta->{ENSEMBLE}[$ens]->{HEADING}); |
|
1503 |
# undef($dta->{ENSEMBLE}[$ens]->{PITCH}); |
|
1504 |
# undef($dta->{ENSEMBLE}[$ens]->{ROLL}); |
|
1505 |
} |
|
1506 |
||
14 | 1507 |
1; # return true for all the world to see |