IshmaelLocator

Class IshLocProcess

java.lang.Object

PamguardMVC.PamProcess

IshmaelLocator.IshLocProcess

All Implemented Interfaces:

PamObserver, ProcessAnnotator, SpectrogramMarkObserver

Direct Known Subclasses:

IshLocHyperbProcess, IshLocPairProcess

public abstract class IshLocProcess
extends PamProcess
implements SpectrogramMarkObserver

This is a superclass to a "real" localization class. It gathers the necessary data (samples, phone positions, etc.) for the subclass, then calls calcData(), which the subclass should define. Current children include IshLocPairProcess and IshLocHyperbProcess.

Author:

Dave Mellinger

Field Summary

Fields

Modifier and Type	Field and Description
Complex[]	inputData

Fields inherited from interface Spectrogram.SpectrogramMarkObserver

MOUSE_DOWN, MOUSE_DRAG, MOUSE_UP

Constructor Summary

Constructors

Constructor and Description
IshLocProcess(IshLocControl ishLocControl)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canMark()
void	doLocalisation(long startSam, long durationSam, double f0, double f1, PamRawDataBlock daqBlock) Do the localization for the call delineated by startMsec, durationMsec, f0, and f1.
PamDataBlock	getInputDataBlock() An IshLocProcess has one input stream (data block).
java.lang.String	getMarkObserverName()
abstract java.lang.String	getName()
void	newData(PamObservable o, PamDataUnit arg1) Data for localization can arrive from either an upstream data source or from the user drawing a box on the spectrogram.
void	pamStart() Called for each process to tell it to start (may not be necessary for processes which are listening for data anyway).
void	pamStop() Stops the process.
void	setParentDataBlock(PamDataBlock newParentDataBlock) Set a parent data block with the default options of rethreading if set
void	setupConnections()
boolean	spectrogramNotification(SpectrogramDisplay display, java.awt.event.MouseEvent mouseEvent, int downUp, int channel, long startMsec, long durationMsec, double f0, double f1) Data for localization can arrive from either an upstream data source or from the user drawing a box on the spectrogram.

Methods inherited from class PamguardMVC.PamProcess

absMillisecondsToSamples, absSamplesToMilliseconds, addOutputDataBlock, changedThreading, clearOldData, createAnnotations, destroyProcess, fillXMLElement, flushDataBlockBuffers, getAncestorDataBlock, getAnnotation, getChainPosition, getCpuPercent, getNumAnnotations, getNumOutputDataBlocks, getObserverName, getObserverObject, getOfflineData, getOutputDataBlock, getOutputDataBlocks, getPamControlledUnit, getParentDataBlock, getParentProcess, getProcessName, getRawSourceDataBlock, getRequiredDataHistory, getSampleRate, getSourceDataBlock, getSourceProcess, isCanMultiThread, makePamProcess, masterClockUpdate, noteNewSettings, notifyModelChanged, prepareProcess, processNewBuoyData, relMillisecondsToSamples, relSamplesToMilliseconds, removeAllDataBlocks, removeObservable, removeOutputDatablock, resetDataBlocks, saveViewerData, setCanMultiThread, setParentDataBlock, setProcessName, setSampleRate, setupProcess, toString, update, updateData

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

inputData

public Complex[] inputData

Constructor Detail

IshLocProcess

public IshLocProcess(IshLocControl ishLocControl)

Method Detail

getName

public abstract java.lang.String getName()

setParentDataBlock

public void setParentDataBlock(PamDataBlock newParentDataBlock)

Description copied from class: PamProcess

Set a parent data block with the default options of rethreading if set

Overrides:

setParentDataBlock in class PamProcess

Parameters:

newParentDataBlock - source data block.

getInputDataBlock

public PamDataBlock getInputDataBlock()

An IshLocProcess has one input stream (data block). Return it, or null if it's not available.

setupConnections

public void setupConnections()

spectrogramNotification

public boolean spectrogramNotification(SpectrogramDisplay display,
                              java.awt.event.MouseEvent mouseEvent,
                              int downUp,
                              int channel,
                              long startMsec,
                              long durationMsec,
                              double f0,
                              double f1)

Data for localization can arrive from either an upstream data source or from the user drawing a box on the spectrogram. This is the routine for capturing user box-drawing.

Specified by:

spectrogramNotification in interface SpectrogramMarkObserver

Parameters:

display - spectrogram display; ignored

downUp - mouse action (only MOUSE_UP events are used)

channel - which channel was drawn on; ignored

startMsec - in absolute msec (since 1970)

durationMsec -

f0,f1 - frequency range of the selection

Returns:

true if the user has popped up a menu or done something that should stop the sending display from carrying out any further actions on this mouse action (put in place to prevent the spectrogram menu popping up when editing marks in viewer mode).

canMark

public boolean canMark()

Specified by:

canMark in interface SpectrogramMarkObserver

Returns:

whether or not it's possible to use this marker. Generally false when in viewer mode, but maynot always be.

newData

public void newData(PamObservable o,
           PamDataUnit arg1)

Data for localization can arrive from either an upstream data source or from the user drawing a box on the spectrogram. This is the routine for data arriving from upstream.

Overrides:

newData in class PamProcess

Parameters:

arg1 - data arriving from upstream; type must be PamDetection (or a subclass of it)

doLocalisation

public void doLocalisation(long startSam,
                  long durationSam,
                  double f0,
                  double f1,
                  PamRawDataBlock daqBlock)

Do the localization for the call delineated by startMsec, durationMsec, f0, and f1.

Parameters:

startSam - in absolute msec (since 1970)

durationSam -

f0,f1 - frequency range to use in calculating the loc

daqProcess - the PamProcess producing raw audio data, needed for getting hydrophone info

getMarkObserverName

public java.lang.String getMarkObserverName()

Specified by:

getMarkObserverName in interface SpectrogramMarkObserver

Returns:

Name for the mark observer to show in the spectrogram dialog.

pamStart

public void pamStart()

Description copied from class: PamProcess

Called for each process to tell it to start (may not be necessary for processes which are listening for data anyway).

Specified by:

pamStart in class PamProcess

pamStop

public void pamStop()

Description copied from class: PamProcess

Stops the process.

Specified by:

pamStop in class PamProcess