hydrac.instruments.mod_deployment

Deployment Strategy definition (hydrac.instruments.mod_deployment)

Derived class for acoustic data processing.

class hydrac.instruments.mod_deployment.ModeDeployment(obj, mode_depl=None, force=None)

Bases: object

Deployment Strategy Class.

The ModeDeployment class changes the data configuration of the both hydroacoustic data and environmental data. For instance, if the instrument is deployed from the surface like an echosounder, the range variable becomes the depth. To the difference, if an instrument is deployed in a cast, the range variable is not to be considered as the depth. This information is crucial to average HAC data or resample environmental data, for example pass from a time series sapling at different depths to one single depth average profile with no temporal information (see :class: hydrac.calcul.resample.Resample). Among the different possibilities :

1 - Mooring : The instrument is either fixed to the sea/riverbed and records timeseries of HAC or environmental data.

2 - Cast : The instrument is cast down the water column and samples at different depths. For HAC data, the orientation of the transducers is to be horizontal. Also, for the case of HAC data, the user is promted to indicate whether the current files consist on one profile each or an continuous ensemble of multiple profiles that need to be split.

3 - Survey : The instrument is positioned at the air-water interface and records spatial geolocalized HAC or environmental data (To do).

The class contains methods dedicated to HAC (:func: acoustic_depl) or environmental (:func: multiparam_depl) data handling. The user will be prompted to know whether and how he wishes to resample the data (HAC data necessitate to be resampled most of the time to ensure incoherent scattering and better converge towards a Rayleigh distribution of the acoustic signal). If no reampling is needed, answering 0 does the trick.

For an example see hydrac.instruments.acoustique.Acoustic.preproc_acoustic_data()

Classes

ModeDeployment(obj[, mode_depl, force])

Deployment Strategy Class.