Package: pyhydrophone
pyhydrophonePackage 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 outreadthedocs pageEach 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)EARSMTE 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).InstallationUsing pip distributionpipinstallpyhydrophoneUsing git cloneClone the packagegitclonehttps://github.com/lifewatch/pyhydrophone.gitUse poetry to install the project dependenciespoetryinstallBuild the projectpoetrybuildHow to usepyhydrophone 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)HydrophoneIt is the base class, which can be used in case the user is only interested in keeping the parameters together.SoundTrapProvides two classes, SoundTrap and SoundTrapHF.The date format of the file is assumed to be:model_name.yymmddHHMMSS.extTo 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
fromhttp://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.uPamFor 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.extWhere 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.AMARFor now only provides a method to read the date from the filename as it comes out from the device.https://www.jasco.com/B&KProvides 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-0F2RTSysProvides 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-recordersEARSJust provides a method to read the date time from the name.MTE AURALJust provides a method to read the date time from the name.http://www.multi-electronique.com/files/AURAL/user/AURAL-M2_USER_GUIDE.pdficListenIn 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