Processes acoustic backscatter from horizontally profiling ADCP (hADCP). Returns attenuation of sound due to water and suspended-sediment. Applies all corrections to acoustic backscatter detailed in the guideline.
acoustic_backscatter_processing(
Site,
ADCP,
Height,
Sonde,
Echo_Intensity_Beam_1,
Echo_Intensity_Beam_2,
Instrument_Noise_Level = NULL,
Include_Rayleigh = FALSE,
Include_near_field_correction = TRUE
)List with processed data, all variable names and units are written-out in list items, see Livsey (in review) for details of each variable
Data frame with site, local vertical datum, and ADCP elevation information
Site name (string)
Unique site code (string)
Elevation of the ADCP above the bed (m)
Elevation of the ADCP above local gauge datum (m)
Distance from local gauge datum to lower point in cross-section (m)
Installation date of ADCP (time, POSIXct)
Date if/when ADCP is moved vertically (time, POSIXct)
User comment (string)
Data frame with various readings from ADCP
Unique site code (string)
Date and time (time, POSIXct)
Measurment ensemble number (integer)
Acoustic frequency of ADCP (kHz)
Radius of ADCP transducer (m)
Angle of beam relative to normal (degrees)
Ratio of beam radius to beam length (-)
Normal range to bed, optional (m)
Normal range to water surface, optional (m)
Number of measurement cells along beam (integer)
Cell width measured normal to ADCP (m)
Blanking distance measured normal to ADCP (m)
Serial number of ADCP instrument (string)
Serial number of ADCP CPU (string)
Ambient noise level for beam 1, optional (counts)
Ambient noise level for beam 2, optional (counts)
Reported distance normal to ADCP to midpoint of bin/cell (m)
Reported depth of ADCP from vertical beam, optional (m)
Speed of sound used by ADCP in the field (m/s)
Temperature recorded by ADCP (degrees C)
Pressure recorded by ADCP (dBar)
Salinity in PSU recorded or assumed in ADCP data file, optional (PSU)
Distance to water surface reported by vertical beam of ADCP (m)
Power to ADCP (V)
Data frame with timeseries of river height
Date and time (time, POSIXct)
Water surface elevation above gauge datum (m)
Unique site code (string)
Data frame with timeseries of conductivity, temperature, and depth from sonde
Date and time (time, POSIXct)
Temperature (degrees C)
Conductivity (microS/cm)
Pressure (dbar)
Unique site code (string)
Data frame of acoustic backscatter measurements from beam 2
Unique site code (string)
Date and time (time, POSIXct)
Acoustic backscatter in nth cell (counts)
Data frame of acoustic backscatter measurements from beam 2
Unique site code (string)
Date and time (time, POSIXct)
Acoustic backscatter in nth cell (counts)
Estimate of noise level, recommended if ambient noise level is not recorded (counts)
Logical to include data within Rayleigh Distance for processing of acoustic backsactter
Logical to include near-field correction of Downing et al (1995)
Daniel Livsey (2023) ORCID: 0000-0002-2028-6128
Livsey, D.N. (in review). National Industry Guidelines for hydrometric monitoring–Part 12: Application of acoustic Doppler velocity meters to measure suspended-sediment load. Bureau of Meteorology. Melbourne, Australia.
InputData <- realTimeloads::ExampleData
Site <- InputData$Site
ADCP <- InputData$ADCP
Height <- InputData$Height
Sonde <- InputData$Sonde
EIa <- InputData$Echo_Intensity
# example code assumes backscatter is equal across beams
EIb <- InputData$Echo_Intensity
Output <- acoustic_backscatter_processing(Site,ADCP,Height,Sonde,EIa,EIb)
Run the code above in your browser using DataLab