pyhydrophone 0.3.0

python package to read and calibrate hydrophone data

pyhydrophone

Package to make it easier to read different hydrophones' output files and extract the information.

pyhydrophone helps keeping together all the information of the recorder.

For more information please visit out readthedocs page

Each class represents a different hydrophone. The available ones now are (others will be added):

• SoundTrap (OceanInstruments)
• uPam (Seiche)
• AMAR (JASCO)
• B&K Nexus (Bruel & Kjaer)
• RTSys (RESEA)
• EARS
• MTE AURAL (Seiche)

They all inherit from the main class Hydrophone. If a hydrophone provides an output different from a regular wav file, functions to read and understand the output are provided. Functions to read the metadata are also provided (which is often encoded in the file name).

Installation

Using pip distribution

pip install pyhydrophone

Using git clone

1. Clone the package

   git clone https://github.com/lifewatch/pyhydrophone.git
   

2. Use poetry to install the project dependencies

   poetry install
   

3. Build the project

   poetry build
   

How to use

pyhydrophone allows to create an object which represents the hydrophone so you can just pass the hydrophone object from one function to another of your analysis without repeating all the parameters.

The object has some extra functions as reading the datetime when it was recorded (usually it is stored in the file name, but sometimes there is an extra metadata file).

The normal use would be to create the hydrophone object and then start reading your files. Every time you want to know the datetime of your file you would do:

hydrophone.get_name_date(path_to_your_file) 

and you would not have to worry about which format the file name has or where the information of the datetime is stored.

For more information about the parameters that each hydrophone takes, see examples folder:

st = pyhy.SoundTrap(name, model, serial_number)

am = pyhy.AmarG3(name, model, sensitivity, preamp_gain, mems_sensitivity, Vpp)

uaural = pyhy.uAural(sensitivity=-180, name='uAural', model='RX', serial_number=1, preamp_gain=12, Vpp=2.0)

bk_test = pyhy.BruelKjaer(name=bk_name, model=bk_model, preamp_gain=preamp_gain, Vpp=bk_Vpp, serial_number=1,
                          type_signal='test')
bk_ref = pyhy.BruelKjaer(name=bk_name, model=bk_model, preamp_gain=preamp_gain, Vpp=bk_Vpp, serial_number=1,
                         type_signal='ref')

upam = pyhy.uPam(name=upam_name, model=upam_name, serial_number=upam_serial_number,
                 sensitivity=upam_sensitivity,
                 preamp_gain=upam_preamp_gain, Vpp=upam_Vpp)

aural = pyhy.MTE(name=aural_name, model=aural_model, serial_number=aural_serial_number,
                 sensitivity=aural_sensitivity,
                 preamp_gain=aural_preamp_gain, Vpp=aural_Vpp, string_format='%y%m%d_%H%M%S')

rtsys = pyhy.RTSys(name=rtsys_name, model=rtsys_model, serial_number=serial_number,
                   sensitivity=rtsys_sensitivity,
                   preamp_gain=rtsys_preamp_gain, Vpp=rtsys_Vpp, mode='lowpower', channel='A')

icListen = pyhy.icListen(name=icListen_name, model=icListen_model, serial_number=icListen_serial_number,
                         sensitivity=icListen_sensitivity, preamp_gain=icListen_preamp_gain, Vpp=icListen_Vpp)

My hydrophone is missing!

If you have a hydrophone which is missing, or a newer model of a hydrophone where some functions become deprecated, please create an issue and let us know!

Hydrophone

It is the base class, which can be used in case the user is only interested in keeping the parameters together.

SoundTrap

Provides two classes, SoundTrap and SoundTrapHF.

The date format of the file is assumed to be: model_name.yymmddHHMMSS.ext

To create a SoundTrap object, sensitiviy and preamp_gain are read from the configuration file. They do not have to be specified by the user. (Gain type "High" or "Low" has to be specified). A routine for reading the xml file is provided (still some parameters missing).

If the serial number is passed, the calibration information will automatically be obtained from http://oceaninstruments.azurewebsites.net/App/#/%23). If when searching for your serial number there are multiple options, it is important that you specify the model of the hydrophone correctly (as listed in the calibration sheet in oceaninstruments) so the right calibration is selected.

SoundTrapHF (inherited from SoundTrap) comes with a routine to read the *.dwv files from SoundTrap and store all the high frequency clicks as a pandas df to be able to work with them.

A folder with several (xml, bcl, dwv) files can be specified and passed to the function.

uPam

For now only provides a method to read the date from the filename as it comes out from the device.

The date format of the file is assumed to be: project_name_yymmdd_HHMMSS_NUM.ext Where project_name and NUM depend on your personal choice.

https://www.seiche.com/underwater-acoustic-products/acoustic-sensors/

Other devices such as Orca will be added.

AMAR

For now only provides a method to read the date from the filename as it comes out from the device.

https://www.jasco.com/

B&K

Provides a method to read the date from the filename (it has to be changed, as the date is not saved in the file). It also provides the calculation of the sensitivity according to the selected amplification. Only [100e-6, 316e-6, 1e-3, 3.16e-3, 10e-3, 31.6e-3, 100e-3, 316e-3, 1.0, 3.16, 10.0] V are valid numbers. A function to change the sensitivity of the hydrophone is provided (update_calibration), which can be used when the test signal is created at the beggining of the file. It has to be specified if it is a "test" signal or a "reference" signal to be used for calibration.

https://www.bksv.com/en/products/transducers/conditioning/microphone/2690-A-0F2

RTSys

Provides a method to read the date from the file name. It has a method to read the header from a wav file recorded using a RESEA recorder. It also adds a method to compute the power consumption and plot it over time. https://rtsys.eu/acoustic-recorders

EARS

Just provides a method to read the date time from the name.

MTE AURAL

Just provides a method to read the date time from the name. http://www.multi-electronique.com/files/AURAL/user/AURAL-M2_USER_GUIDE.pdf

icListen

In development. Just provides a method to read the date time from the name for the moment.

uAural (micoAural)

In development. Just provides a method to read the date time from the name for the moment.

Cite