https://github.com/apaloczy/adcptools

Beam to Earth coordinate transformations and other utilities for ADCP data.
https://github.com/apaloczy/adcptools

currents doppler observations oceanography physical-oceanography

Last synced: 3 months ago
JSON representation

Beam to Earth coordinate transformations and other utilities for ADCP data.

• Host: GitHub
• URL: https://github.com/apaloczy/adcptools
• Owner: apaloczy
• License: other
• Created: 2018-09-24T17:40:30.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-10-05T22:40:35.000Z (about 2 years ago)
• Last Synced: 2024-01-30T12:56:16.659Z (11 months ago)
• Topics: currents, doppler, observations, oceanography, physical-oceanography
• Language: MATLAB
• Size: 46.9 KB
• Stars: 8
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ADCPtools

Beam to Earth coordinate transformations and other utilities for Acoustic Doppler Current Profiler (ADCP) data.

## Convert profiles of along-beam velocity to Earth coordinates (east-north-up).

Convert raw along-beam velocity (positive toward transducer) time series (ntimes x nbins) to Earth-referenced velocity:

```

[u, v, w, w5] = janus5beam2earth(head, ptch, roll, theta, b1, b2, b3, b4, b5)

```

or, with all optional arguments specified,

```

[u, v, w, w5] = janus5beam2earth(head, ptch, roll, theta, b1, b2, b3, b4, b5, ...

                                 'uvwBeam5', true, 'Gimbaled', true, 'Binmap', 'linear', r, r5)

```

Where

* ```b[1-5]``` are the along-beam velocity time series [ntimes x nbins] (positive toward transducer face).

* ```u```, ```v```, ```w``` are the Earth-referenced (eastward, northward, upward) velocity time series [ntimes x nbins].

* ```w5``` is the vertical velocity calculated from the vertical beam only.

* ```head```, ```ptch``` and ```roll``` are the heading (rotation about the z-axis (beam 5), positive clockwise), pitch (rotation about the x-axis (beam 1), positive clockwise) and roll (rotation about the y-axis (beam 3), positive clockwise) angles measured by the ADCP, in degrees.

* ```theta``` is the beam angle measured from beam 5's direction (vertical if the instrument is level), in degrees.

* ```'uvwBeam5'``` (```true```/```false```) indicates whether to use the vertical beam data to calculate ```u```, ```v``` and ```w```.

* ```'Gimbaled'``` (```true```/```false```) indicates whether the pitch and roll sensors were gimbaled (mounted on a free-swiveling platform as opposed to a rigid frame).

* ```'Binmap'``` (```'none'```/```'nn'```/```'linear'```) indicates whether or not to perform bin-mapping on the raw beam velocities. Bin-mapping here means interpolating the velocities from all beams to the same horizontal plane before converting to instrument and then Earth coordinates. Defaults to ```'none'```, _i.e._, the assumption that pitch and roll are zero at all times. ```'linear'``` and ```'nn'``` specify linear and nearest-neighbor interpolation, respectively.

* ```r``` and ```r5``` are vectors with the along-beam positions of the center of each bin for the Janus (\#1-4) and vertical (\#5) beams. Required only if ```'Binmap'``` is not ```none```.