Package difar

Class SonobuoyManager

java.lang.Object

PamguardMVC.PamProcess

difar.SonobuoyManager

All Implemented Interfaces:

PamObserver, ProcessAnnotator

public class SonobuoyManager
extends PamProcess

SonobuoyManager should contain all of the Sonobuoy related functions in the DIFAR module. Previous to 2018-07-24, These functions were split between SonobuoyManager and DifarControl. To the Difar Module (invalid input: '&' SonobuoyManager) a sonobuoy is essentially an Array.Streamer (or perhaps StreamerDataUnit) with some additional methods and annotations added by the DIFAR module. These additional methods include routines for deploying, calibrating, editing, and ending sonobuoys. SonobuoyManager also manages the data structure for the SonobuoyLog (SonobuoyManagerPanel) Eventually it might make sense to extend Array.Streamer instead of using custom module-specific annotations.

Author:

brian_mil

Field Summary

Fields

Modifier and Type	Field	Description
StreamerDataBlock	buoyDataBlock
StringAnnotationType	calMeanAnnotation
StringAnnotationType	calStdDevAnnotation
static final int	COLUMN_CALSTDDEV
static final int	COLUMN_CHANNEL
static final int	COLUMN_COMPASSCORRECTION
static final int	COLUMN_DATABASEID
static final int	COLUMN_DEPTH
static final int	COLUMN_ENDTIME
static final int	COLUMN_HEADING
static final int	COLUMN_LATITUDE
static final int	COLUMN_LONGITUDE
static final int	COLUMN_NAME
static final int	COLUMN_TIMESTAMP
String[]	columnNames
TimestampAnnotationType	sonobuoyEndTimeAnnotation
Object[][]	tableData
DefaultTableModel	tableDataModel

Fields inherited from class PamguardMVC.PamProcess

outputDataBlocks, parentDataBlock, processName, sampleRate

Constructor Summary

Constructors

Constructor	Description
SonobuoyManager(DifarControl difarControl)

Method Summary

Modifier and Type	Method	Description
void	addSonobuoyAnnotation(StreamerDataUnit sdu, TimestampAnnotationType annotation, long timestamp)
void	deployBuoy(int channel)	Deploy a DIFAR buoy.
void	endBuoy(int channel, long endTime, boolean overwrite)	Add a data annotation for the finishing time of a sonobuoy.
CalibrationHistogram	getCalCorrectionHistogram(DifarControl difarControl, int channel)
CalibrationHistogram	getCalibrationHistogram(DifarControl difarControl, int channel)
double	getCompassCorrection(int channel, long timeMillis)
void	newData(PamObservable o, PamDataUnit arg)
void	overwriteSonobuoyData(StreamerDataUnit sdu)
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	setupProcess()	DIFAR module uses PAMGuard's ArrayManager very differently than modules that require a static or towed array.
void	showCalibrationDialog(int channel)	Shows the calibration dialog for a particular channel.
protected void	sortSQLLogging()	Check all the SQL Logging additions are set up correctly.
boolean	updateCorrection(Streamer streamer, long calibrationStartTime, Double newHead, Double std, int numClips)
void	updateSonobuoyTableData()	Called after changes have been made to the sonobuoy data: buoy deployed, buoy ended, buoy calibrated, or buoy manually edited

Methods inherited from class PamguardMVC.PamProcess

absMillisecondsToSamples, absSamplesToMilliseconds, addData, addMultiPlexDataBlock, addOutputDataBlock, changedThreading, clearOldData, createAnnotations, destroyProcess, dumpBufferStatus, flushDataBlockBuffers, getAncestorDataBlock, getAnnotation, getChainPosition, getCompatibleDataUnits, getCpuPercent, getFrequencyRange, getLastSourceNotificationObject, getLastSourceNotificationType, getMuiltiplexDataBlock, getNumAnnotations, getNumMuiltiplexDataBlocks, getNumOutputDataBlocks, getObserverName, getObserverObject, getOfflineData, getOfflineData, getOutputDataBlock, getOutputDataBlocks, getPamControlledUnit, getParentDataBlock, getParentDataBlocks, getParentProcess, getProcessCheck, getProcessName, getRawSourceDataBlock, getRawSourceDataBlock, getRequiredDataHistory, getSampleRate, getSourceDataBlock, getSourceProcess, hasOutputDatablock, isCanMultiThread, isExternalProcess, isMultiplex, makePamProcess, masterClockUpdate, noteNewSettings, notifyModelChanged, prepareProcess, prepareProcessOK, processNewBuoyData, receiveSourceNotification, relMillisecondsToSamples, relSamplesToMilliseconds, removeAllDataBlocks, removeAllMultiPlexDataBlocks, removeMultiPlexDataBlock, removeObservable, removeOutputDatablock, resetDataBlocks, saveViewerData, setCanMultiThread, setExternalProcess, setMultiplex, setParentDataBlock, setParentDataBlock, setProcessCheck, setProcessName, setSampleRate, toString, updateData

Methods inherited from class java.lang.Object

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

Field Details

COLUMN_DATABASEID

public static final int COLUMN_DATABASEID

See Also:

• Constant Field Values

COLUMN_NAME

public static final int COLUMN_NAME

See Also:

• Constant Field Values

COLUMN_TIMESTAMP

public static final int COLUMN_TIMESTAMP

See Also:

• Constant Field Values

COLUMN_ENDTIME

public static final int COLUMN_ENDTIME

See Also:

• Constant Field Values

COLUMN_CHANNEL

public static final int COLUMN_CHANNEL

See Also:

• Constant Field Values

COLUMN_LATITUDE

public static final int COLUMN_LATITUDE

See Also:

• Constant Field Values

COLUMN_LONGITUDE

public static final int COLUMN_LONGITUDE

See Also:

• Constant Field Values

COLUMN_DEPTH

public static final int COLUMN_DEPTH

See Also:

• Constant Field Values

COLUMN_HEADING

public static final int COLUMN_HEADING

See Also:

• Constant Field Values

COLUMN_COMPASSCORRECTION

public static final int COLUMN_COMPASSCORRECTION

See Also:

• Constant Field Values

COLUMN_CALSTDDEV

public static final int COLUMN_CALSTDDEV

See Also:

• Constant Field Values

sonobuoyEndTimeAnnotation

public TimestampAnnotationType sonobuoyEndTimeAnnotation

calMeanAnnotation

public StringAnnotationType calMeanAnnotation

calStdDevAnnotation

public StringAnnotationType calStdDevAnnotation

buoyDataBlock

public StreamerDataBlock buoyDataBlock

columnNames

public String[] columnNames

tableData

public Object[][] tableData

tableDataModel

public DefaultTableModel tableDataModel

Constructor Details

SonobuoyManager

public SonobuoyManager(DifarControl difarControl)

Method Details

sortSQLLogging

protected void sortSQLLogging()

Check all the SQL Logging additions are set up correctly.

addSonobuoyAnnotation

public void addSonobuoyAnnotation(StreamerDataUnit sdu,
 TimestampAnnotationType annotation,
 long timestamp)

overwriteSonobuoyData

public void overwriteSonobuoyData(StreamerDataUnit sdu)

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

newData

public void newData(PamObservable o,
 PamDataUnit arg)

Overrides:

newData in class PamProcess

setupProcess

public void setupProcess()

DIFAR module uses PAMGuard's ArrayManager very differently than modules that require a static or towed array. Here we load sonobuoy deployments from the PAMGuard database in normal and mixed-mode, so that we don't duplicate sonobuoy deployments every time PAMGuard restarts. Add an annotation for sonobuoy end time

Overrides:

setupProcess in class PamProcess

endBuoy

public void endBuoy(int channel,
 long endTime,
 boolean overwrite)

Add a data annotation for the finishing time of a sonobuoy.

Parameters:

channel -

endTime - TODO

overwrite - TODO

difarControl - TODO

deployBuoy

public void deployBuoy(int channel)

Deploy a DIFAR buoy. In reality this means show only the streamer dialog for a single channel.

Parameters:

channel - channel number. If invalid input: '<' 0 or if the streamer can't be found, then show the full array dialog

difarControl - TODO

getCalCorrectionHistogram

public CalibrationHistogram getCalCorrectionHistogram(DifarControl difarControl,
 int channel)

getCalibrationHistogram

public CalibrationHistogram getCalibrationHistogram(DifarControl difarControl,
 int channel)

showCalibrationDialog

public void showCalibrationDialog(int channel)

Shows the calibration dialog for a particular channel.

Parameters:

channel -

difarControl - TODO

updateSonobuoyTableData

public void updateSonobuoyTableData()

Called after changes have been made to the sonobuoy data: buoy deployed, buoy ended, buoy calibrated, or buoy manually edited

getCompassCorrection

public double getCompassCorrection(int channel,
 long timeMillis)

updateCorrection

public boolean updateCorrection(Streamer streamer,
 long calibrationStartTime,
 Double newHead,
 Double std,
 int numClips)