videoRangePanel.vrmethods

Class VRLandMarkMethod

java.lang.Object

videoRangePanel.vrmethods.AbstractVRMethod

videoRangePanel.vrmethods.VRLandMarkMethod

All Implemented Interfaces:

VRMethod

public class VRLandMarkMethod
extends AbstractVRMethod

The LandMark uses landmarks at known positions or at known angles from the position the image was taken to calculate an animal's position. Two Landmark's essentially give you the four out of the five vital bits of information required to get a true location (on the sea surface). Image bearing, pitch and tilt and degrees per pixel. The fifth bit of information , the height from which the image was taken, is defined by the user.

Angular convention for this module and method.

Bearing- 0==north, 90==east 180=south, 270==west

Pitch- 90=-g, 0=0g, -90=g

Tilt 0->180 -camera turning towards left to upside down 0->-180 camera turning right to upside down

Author:

Jamie Macaulay

Field Summary

Fields

Modifier and Type	Field and Description
static java.awt.Color	animalCol
static VRSymbolManager	animalMark
static PamSymbol	animalMarker
static PamSymbol	candAnimalMarker
static java.awt.Color	landMarkCol
static PamSymbol	landMarkMarker
static VRSymbolManager	landMarksSymbol

Constructor Summary

Constructors

Constructor and Description
VRLandMarkMethod(VRControl vrControl)

Method Summary

Methods

Modifier and Type	Method and Description
static double	calcAnimalBearing(double tilt, java.awt.Point lndmrkPoint, java.awt.Point animalPoint, double calValue) Calculates the bearing of the target animal based on a landmark point, the animal location and a calibration value;
static double	calcAnimalPitch(double tilt, java.awt.Point lndmrkPoint, java.awt.Point animalPoint, double calValue) Calculates the pitch of the target animal based on a landmark point, the animal location and a calibration value;
static double	calcBearingDiffAnimal(double tilt, java.awt.Point landmrkp1, java.awt.Point animal) Calculates the bearing of the animal in pixels
static java.awt.Point	calcPerpPoint(double tilt, double bearingDiff, java.awt.Point landMark2) Calculates the point at which the perpendicular corner of the pitch/bearing triangle resides.
java.awt.Point	calcPerpPoint(double tilt, java.awt.Point landmrkP1, java.awt.Point landmrkP2, LandMark landmrk1, LandMark landmrk2, LatLong imagePos) Calculates location of the perpendicular vertex of the triangle defined by landmarks 1 and 2, with the side of the triangle following the tilt of the picture.
static double	calcPitch(LandMark landMrk, LatLong imagePos) Calculate the pitch between a landMark and image location.
static double	calcPitchDiffAnimal(double tilt, java.awt.Point landmrkp1, java.awt.Point animal) Calculates the pitch of the animal in pixels
static double	calcTilt(java.awt.Point landmrkP1, java.awt.Point landmrkP2, double bearingDiff, double pitchDiff) Calculates the tilt of the image based on two landmarks selected on that image and the known angles between those landmarks.
static double	calcTilt(java.awt.Point landmrkP1, java.awt.Point landmrkP2, LandMark landmrk1, LandMark landmrk2, LatLong imagePos)
void	clearOverlay() Clears all user ineractions and resets overlay.
PamPanel	createSidePanel()
LatLong	getImagePos() Return the position the image was taken from.
javax.swing.plaf.LayerUI	getJLayerOverlay() Get the overlay panel for the picture unique to this method.
java.lang.String	getName() The name of this type of analysis method.
PamPanel	getRibbonPanel() Some methods may require a panel above the picture for manual input or to view current information.
LandMarkGroup	getSelectedLMGroup()
PamPanel	getSettingsPanel() Different video range methods will have different settings.
PamPanel	getSidePanel() Different video range methods will have different controls in the side panel.
void	setLandMarks() Create a landmark list for the landmark combo box on side panel;
void	update(int updateType) Called from other parts of the module whenever a method panel may needed updated e.g.
static double	wrap360(double t) Make sure an angle falls between zero and 2pi(360 degrees)

Methods inherited from class videoRangePanel.vrmethods.AbstractVRMethod

calcLocLatLong, createCalibrationList, createLocationListPanel, createMapFilePanel, enableControls, getCandidateMeasurement, getHorizonTilt, getImageHeading, selectCalibration, setGPSText, setHorizonTilt

Methods inherited from class java.lang.Object

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

Field Detail

landMarkCol

public static final java.awt.Color landMarkCol

animalCol

public static final java.awt.Color animalCol

landMarkMarker

public static PamSymbol landMarkMarker

animalMarker

public static PamSymbol animalMarker

candAnimalMarker

public static PamSymbol candAnimalMarker

landMarksSymbol

public static VRSymbolManager landMarksSymbol

animalMark

public static VRSymbolManager animalMark

Constructor Detail

VRLandMarkMethod

public VRLandMarkMethod(VRControl vrControl)

Method Detail

getName

public java.lang.String getName()

Description copied from interface: VRMethod

The name of this type of analysis method.

Returns:

createSidePanel

public PamPanel createSidePanel()

setLandMarks

public void setLandMarks()

Create a landmark list for the landmark combo box on side panel;

getSelectedLMGroup

public LandMarkGroup getSelectedLMGroup()

getSidePanel

public PamPanel getSidePanel()

Description copied from interface: VRMethod

Different video range methods will have different controls in the side panel. This returns the side panel unique to the method. May return null if no panel is needed.

Returns:

getJLayerOverlay

public javax.swing.plaf.LayerUI getJLayerOverlay()

Description copied from interface: VRMethod

Get the overlay panel for the picture unique to this method. In general this will be a translucent panel which will be placed over the picture and will include the interactions for the method. Layer Ui's can be used for a variety of purposes, including adding wait animations etc.

Returns:

wrap360

public static double wrap360(double t)

Make sure an angle falls between zero and 2pi(360 degrees)

Returns:

angle between 0 and 360;

clearOverlay

public void clearOverlay()

Description copied from interface: VRMethod

Clears all user ineractions and resets overlay. Required for changes to settings, picture being changed and other interactions not directly associated with the VRMethod.

getRibbonPanel

public PamPanel getRibbonPanel()

Description copied from interface: VRMethod

Some methods may require a panel above the picture for manual input or to view current information. getRibbonPanel() returns the panel unique to this method which may go above the picture. May return null if no panel is needed.

Returns:

getSettingsPanel

public PamPanel getSettingsPanel()

Description copied from interface: VRMethod

Different video range methods will have different settings. This panel provide the vr specific settings in the vr settings dialog panel.

Returns:

update

public void update(int updateType)

Description copied from interface: VRMethod

Called from other parts of the module whenever a method panel may needed updated e.g. when new calibration data is manually added in the settings dialog.

Specified by:

update in interface VRMethod

Overrides:

update in class AbstractVRMethod

calcAnimalBearing

public static double calcAnimalBearing(double tilt,
                       java.awt.Point lndmrkPoint,
                       java.awt.Point animalPoint,
                       double calValue)

Calculates the bearing of the target animal based on a landmark point, the animal location and a calibration value;

Parameters:

tilt- - tilt of the image in radians.

landmrkp1-landmark - point.

animal-animal - point.

calValue- - calibration value in pixels per degree

Returns:

bearing relative to the landmark - radians.

calcAnimalPitch

public static double calcAnimalPitch(double tilt,
                     java.awt.Point lndmrkPoint,
                     java.awt.Point animalPoint,
                     double calValue)

Calculates the pitch of the target animal based on a landmark point, the animal location and a calibration value;

Parameters:

tilt- - tilt of the image in radians.

landmrkp1-a - point on the image for which we know the pitch and bearing.

animal-animal - point.

calValue- - calibration value in pixels per degree.

Returns:

pitch relative to the landmark .radians.

calcBearingDiffAnimal

public static double calcBearingDiffAnimal(double tilt,
                           java.awt.Point landmrkp1,
                           java.awt.Point animal)

Calculates the bearing of the animal in pixels

Parameters:

tilt- - tilt of the image in radians.

landmrkp1-a - point on the image for which we know the pitch and bearing.

animal-animal - point.

Returns:

bearing in pixels.

calcPitchDiffAnimal

public static double calcPitchDiffAnimal(double tilt,
                         java.awt.Point landmrkp1,
                         java.awt.Point animal)

Calculates the pitch of the animal in pixels

Parameters:

tilt- - tilt of the image in radians.

landmrkp1-a - point on the image for which we know the pitch and bearing.

animal-animal - point.

Returns:

bearing in pixels.

calcPerpPoint

public java.awt.Point calcPerpPoint(double tilt,
                           java.awt.Point landmrkP1,
                           java.awt.Point landmrkP2,
                           LandMark landmrk1,
                           LandMark landmrk2,
                           LatLong imagePos)

Calculates location of the perpendicular vertex of the triangle defined by landmarks 1 and 2, with the side of the triangle following the tilt of the picture.

Parameters:

tilt-tilt - of image

landmrkP1-landmark - 1 point on image

landmrkP2-landmark - 2 point on image

landmrk1-landmark - 1

landmrk2-landmark - 2

imagePos-the - from which the image was taken from. Note that this can be null if the landmarks are defined by bearings rathar than GPS co-ordinates.

Returns:

the perpindicular vertex of a tringle where the other two vertex have been defined by landmark points.

calcPerpPoint

public static java.awt.Point calcPerpPoint(double tilt,
                           double bearingDiff,
                           java.awt.Point landMark2)

Calculates the point at which the perpendicular corner of the pitch/bearing triangle resides.

Parameters:

tilt-tilt - in radians

bearingDiff-difference - in bearing angle, in pixels.

calcTilt

public static double calcTilt(java.awt.Point landmrkP1,
              java.awt.Point landmrkP2,
              LandMark landmrk1,
              LandMark landmrk2,
              LatLong imagePos)

calcPitch

public static double calcPitch(LandMark landMrk,
               LatLong imagePos)

Calculate the pitch between a landMark and image location.

Parameters:

landMrk-current - landmark

imagePos-image - location

Returns:

calcTilt

public static double calcTilt(java.awt.Point landmrkP1,
              java.awt.Point landmrkP2,
              double bearingDiff,
              double pitchDiff)

Calculates the tilt of the image based on two landmarks selected on that image and the known angles between those landmarks.

Parameters:

landmrkP1- - the location on the image of landmark1-pixels

landmrkP2- - the location on the image of landmark2-pixels

bearingDiff- - the difference in heading between landMark1 and landMark2

pitchDiff- - the difference in pitch between landMark1 and landMark2

Returns:

tilt in radians

getImagePos

public LatLong getImagePos()

Return the position the image was taken from. This is either the location from which bearings were determined for the current land mark group or uses the location manager to determine a position. Note that in the event any landmark is defined by bearings rather than a latlong then the position of the image has to be the location from which those bearings were calculated.

Returns:

the position of the image.