Package ltsa

Class LtsaDataBlock

java.lang.Object

PamguardMVC.PamObservable

PamguardMVC.PamDataBlock<FFTDataUnit>

PamguardMVC.AcousticDataBlock<FFTDataUnit>

PamguardMVC.DataBlock2D<FFTDataUnit>

fftManager.FFTDataBlock

ltsa.LtsaDataBlock

public class LtsaDataBlock
extends FFTDataBlock

Field Summary

Fields inherited from class PamguardMVC.PamDataBlock

ITERATOR_END, MATCH_AFTER, MATCH_BEFORE, MATCH_EXACT, MIX_DONOTHING, MIX_INTODATABASE, MIX_OUTOFDATABASE, naturalLifetime, NOTIFY_NEW_DATA, NOTIFY_UPDATE_DATA, pamDataUnits, parentProcess, POSITION_AFTER, POSITION_BEFORE, REFERENCE_ABSOLUTE, REFERENCE_CURRENT, REQUEST_DATA_LOADED, REQUEST_DATA_PARTIAL_LOAD, REQUEST_EXCEPTION, REQUEST_INTERRUPTED, REQUEST_NO_DATA, REQUEST_SAME_REQUEST, unitsAdded, unitsRemoved, unitsUpdated

Fields inherited from class PamguardMVC.PamObservable

masterClockSample, objectChanged, overlayDraw, pamProfiler

Constructor Summary

Constructors

Constructor	Description
LtsaDataBlock(String dataName, PamProcess parentProcess, boolean moreAveraged)

Method Summary

Modifier and Type	Method	Description
double	getDataGain(int iChan)	Override the normal FFTDataBlock getDataGain method here and just return 1.
int	getOfflineData(OfflineDataLoadInfo offlineLoadDataInfo)	Gets data for offline display, playback, etc.
void	orderOfflineData(PamObserver dataObserver, LoadObserver loadObserver, long startMillis, long endMillis, int loadKeepLayers, int interrupt, boolean allowRepeats)	Similar functionality to getOfflineData, but this will launch a separate worker thread to do the actual work getting the data.

Methods inherited from class fftManager.FFTDataBlock

clearAll, dumpBlockContents, getChannelMap, getComplexArray, getDataBlockXML, getDataWidth, getFftHop, getFftLength, getHopSamples, getLongDataName, getMaxDataValue, getMinDataValue, getOldLongDataName, getScaleInfo, isRecycle, recycleComplexArray, setFftHop, setFftLength, setRecycle, setWindowGain

Methods inherited from class PamguardMVC.AcousticDataBlock

findParentSource, getChannelListManager, getParentSourceData, notifyModelChanged, prepareAmplitudeCalculations, prepareChannelLists

Methods inherited from class PamguardMVC.PamDataBlock

addDataAnnotationType, addLocalisationContents, addObserver, addObserver, addOfflineDataMap, addOldPamData, addPamData, addPamData, autoEffortProvider, autoSetDataBlockMixMode, cancelDataOrder, cancelDataOrder, checkOfflineDataUIDs, clearAll, clearChannelIterators, clearDeletedList, clearOnViewerLoad, copyDataList, createProcessAnnotations, createProcessAnnotations, dispose, dumpBufferStatus, findAnnotation, findAnnotation, findByDatabaseIndex, findDataUnit, findDataUnit, findFirstUnitAfter, findLastUnitBefore, findUnitByUIDandUTC, findUnitsinInterval, getAbsoluteDataUnit, getAnnotationHandler, getARealChannel, getBackgroundManager, getBespokeDataMapGraphic, getBinaryDataSource, getCanLog, getChannelIterator, getChannelIteratorCount, getChannelsForSequenceMap, getClosestUnitMillis, getClosestUnitMillis, getClosestUnitMillisUsingSeq, getCrossReferenceInformation, getCumulativeGain, getCurrentViewDataEnd, getCurrentViewDataStart, getDataAutomationInfo, getDatablockSpeciesManager, getDataCopy, getDataCopy, getDataCopy, getDataCopy, getDataCopyFromEnd, getDataCopyFromStart, getDatagrammedMap, getDatagramProvider, getDataName, getDataSelectCreator, getDataSelector, getDataSelector, getDataSelector, getDataUnit, getDataUnitMenuItems, getDataUnitPopupMenu, getDurationRange, getEffortProvider, getFirstRawSourceDataBlock, getFirstUnit, getFirstUnit, getFirstUnitAfter, getFirstViewerUID, getFrequencyRange, getHydrophoneMap, getJSONDataSource, getLastUnit, getLastUnit, getLastUnitMillis, getLastViewerUID, getListIterator, getListIterator, getListIteratorFromEnd, getListIteratorFromStart, getLocalisationAlgorithm, getLocalisationContents, getLogging, getLoggingName, getMixedDirection, getMyDataUnits, getNanoTimeCalculator, getNaturalLifetime, getNaturalLifetimeMillis, getNextDataStart, getNextUnit, getNextUnit, getNumOfflineDataMaps, getNumRequiredBeforeLoadTime, getOfflineDataMap, getOfflineDataMap, getPamConfiguration, getPamSymbolManager, getParentProcess, getPreceedingUnit, getPreceedingUnit, getPreceedingUnit, getPreceedingUnit, getPreceedingUnitFromSeq, getPreceedingUnitFromSeq, getPrevDataEnd, getPrimaryDataMap, getProcessAnnotations, getQuickId, getQuickId2, getRawSourceDataBlock, getRawSourceDataBlock2, getRecordingTrigger, getRecycledUnit, getRecyclingStoreLength, getRemovedItems, getReverseChannelIterator, getSampleRate, getSaveRequirements, getSequenceCount, getSequenceIterator, getSequenceMap, getSequenceMapObject, getShouldBinary, getShouldLog, getShouldLog, getSourceDataBlock, getSourceProcess, getSuperDetectionClass, getSynchLock, getTaskDataCopy, getTethysDataProvider, getTOADCalculator, getUidHandler, getUIDRepairLogging, getUniqueParentList, getUnitClass, getUnitIndex, getUnitsCount, getUnitsCountFromTime, hasDataRange, isCanClipGenerate, isClearAtStart, isLinkGpsData, isOffline, isRecycling, loadViewerData, loadViewerData, masterClockUpdate, needViewerDataLoad, noteNewSettings, notifyOfflineObservers, orderOfflineData, orderOfflineData, pamStart, pamStop, remove, remove, remove, removedDataUnit, removeOfflineDataMap, removeOldUnitsS, removeOldUnitsT, reset, saveViewerData, setAnnotationHandler, setBackgroundManager, setBinaryDataSource, setCanClipGenerate, setChannelMap, setClearAtStart, setCurrentViewDataEnd, setCurrentViewDataStart, setDatagramProvider, setDataName, setDataSelectCreator, setEffortProvider, setJSONDataSource, setLinkGpsData, setLocalisationContents, SetLogging, setMixedDirection, setNanoTimeCalculator, setNaturalLifetime, setNaturalLifetimeMillis, setPamSymbolManager, setParentProcess, setRecordingTrigger, setRecycling, setRecyclingStoreLength, setSampleRate, setSequenceMap, setShouldBinary, setShouldLog, setSynchLock, setUidHandler, shouldNotify, sortData, sortOutputMaps, stopTimer, toString, updatePamData

Methods inherited from class PamguardMVC.PamObservable

addInstantObserver, canDraw, canDraw, clearchanged, countObservers, createKeyItem, deleteObserver, deleteObservers, drawDataUnit, findThreadedObserver, getCPUPercent, getCPUPercent, getHoverText, getInstantObservers, getLongestObserver, getMaxThreadJitter, getOverlayDraw, getPamObserver, getPamObservers, getRequiredHistory, isInstantObserver, notifyInstantObservers, notifyNornalObservers, notifyObservers, notifyObservers, setChanged, setOverlayDraw, updateObservers, waitForThreadedObservers

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

LtsaDataBlock

public LtsaDataBlock(String dataName,
 PamProcess parentProcess,
 boolean moreAveraged)

Method Details

getOfflineData

public int getOfflineData(OfflineDataLoadInfo offlineLoadDataInfo)

Description copied from class: PamDataBlock

Gets data for offline display, playback, etc.

This is used to get data from some upstream process which is quite different to the function loadViewerData(...) which loads data directly associated with this data block.

For example, this might be called in the FFT data block by the spectrogram which wants some data to display. The FFT data block does not have this data, so it passes the request up to it's process which will in turn pass the request on until it reaches a module which is capable of loading data into data units and sending them back down the line.

Overrides:

getOfflineData in class PamDataBlock<FFTDataUnit>

orderOfflineData

public void orderOfflineData(PamObserver dataObserver,
 LoadObserver loadObserver,
 long startMillis,
 long endMillis,
 int loadKeepLayers,
 int interrupt,
 boolean allowRepeats)

Description copied from class: PamDataBlock

Similar functionality to getOfflineData, but this will launch a separate worker thread to do the actual work getting the data. The worker thread will call getOfflineData.

getOfflineData will probably (if not overridden) be sending data to the update member function of the observer, but from the worker thread. Once it's complete, it will send a message to say that data are loaded.

It's possible that the user will do something which causes this to be called again before the previous thread completed execution, in which case there are three options:

OFFLINE_DATA_INTERRUPT - previous thread will be terminated

OFFLINE_DATA_WAIT - wait for previous thread to terminate, then start this load

OFFLINE_DATA_CANCEL - give up and return

Overrides:

orderOfflineData in class PamDataBlock<FFTDataUnit>

Parameters:

dataObserver - observer of the loaded data

loadObserver - observer to get status information on the load.

startMillis - data start time in milliseconds

endMillis - data end time in milliseconds.

loadKeepLayers - Number of layers of datablock which should hang on to loaded data rather than delete it immediately.

interrupt - interrupt options.

allowRepeats - allow repeated loads of exactly the same data.

getDataGain

public double getDataGain(int iChan)

Override the normal FFTDataBlock getDataGain method here and just return 1. If we use the FFTDataBlock version without running the normal FFTDataBlock initialization routines, we will always get 0 gain.

Overrides:

getDataGain in class FFTDataBlock

Parameters:

iChan - channel number

Returns:

gain as a factor (to allow for negative gains)