Use Case #1 - Create Hydrophone LTSA (Long Term Spectral Averages)
An ONC Data Team member needs to be able to regularly create Long Term Spectral Averages LTSA spectra from for a 1 week's worth hydrophone audio files in wav file format for all of the deployed hydrophone. The software that they use for generating the spectra is in MATLAB, so for ease of use and simplicity, the audio file download must be done in MATLAB as well.
This example requires the MATLAB Client Library
o = onc('YOUR_TOKEN_HERE'); %replace YOUR_TOKEN_HERE with your personal token obtained from the 'Web Services API' tab at http://dmas.uvic.ca/Profile
outPath = 'c:\ONC\data';
locationCode = 'NEP'; % Northeast Pacific Ocean
deviceCategoryCode = 'HYDROPHONE';
beginDT = '2017-07-16T00:00:00.000Z';
endDT = '2017-07-22T23:59:59.999Z';
dataProductCode = 'AD'; % Audio data
extension = 'wav'; % Wave File Format
locations = o.locations(struct('deviceCategoryCode',deviceCategoryCode,...
'locationCode',locationCode,...
'deploymentBegin',beginDT,...
'deploymentEnd',endDT,...
'includeChildren','true'));
for i=1:numel(locations)
locationCode = locations(i).locationCode;
disp(locationCode);
o.outPath = strcat(outPath,'/',locationCode);
ret = o.orderDataProduct({'locationCode',locationCode,...
'deviceCategoryCode',deviceCategoryCode,...
'dataProductCode',dataProductCode,...
'extension',extension,...
'begin',beginDT,...
'end',endDT,...
'dpo_hydrophoneAcquisitionMode','All'},1000,false,true);
end