Package videoRangePanel

Class VRHorzCalcMethod

java.lang.Object
videoRangePanel.VRHorzCalcMethod
Direct Known Subclasses:
RoundEarthMethod
public abstract class VRHorzCalcMethod extends Object
Method for measuring the distance to an animal based on the pitch and height of an observer.
Author:
Doug Gillespie, Jamie Macaulay

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected static final double
    earthRadius
    The earth's radius in meters.
    protected static final double
    gravity
    The gravitational field strength in (m/s)^2

  • Constructor Summary

    Constructors
    Constructor
    Description
    VRHorzCalcMethod()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    abstract RangeDialogPanel
    dialogPanel()
    Get the swing based pane for the method
    abstract double
    getAngle(double height, double range)
    Converts a range into an angle below the horizon.
    protected double
    getHorizonAngle(double height)
    Calculate the horizon dip angle from the horizontal
    abstract double
    getHorizonDistance(double height)
    Calculate the distance to the horizon from a given height.
    abstract double
    getRange(double height, double angle)
    Converts a height and an angle below the horizon to a distance in metres.
    abstract SettingsPane<?>
    getRangeMethodPane()
    Get the FX based settings pane for the method
    abstract double
    psiFromRange(double height, double range)
    Get the pitch of the camera from the height and range to target.
    abstract double
    rangeFromPsi(double height, double psi)
    Get the range from the pitch of the camera and camera height.

    Methods inherited from class java.lang.Object

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

  • Field Details

    • earthRadius

      protected static final double earthRadius
      The earth's radius in meters.
      See Also:

    • gravity

      protected static final double gravity
      The gravitational field strength in (m/s)^2
      See Also:

  • Constructor Details

    • VRHorzCalcMethod

      public VRHorzCalcMethod()

  • Method Details

    • getRange

      public abstract double getRange(double height, double angle)
      Converts a height and an angle below the horizon to a distance in metres.
      Parameters:
      height - platform height (metres)
      angle - angle below the horizon (Radians)
      Returns:
      distance in metres.

    • getAngle

      public abstract double getAngle(double height, double range)
      Converts a range into an angle below the horizon.

      Or returns -1 if the range is beyond the horizon.

      Parameters:
      height - platform height (metres)
      range - range to object.
      Returns:
      angle in Radians.

    • dialogPanel

      public abstract RangeDialogPanel dialogPanel()
      Get the swing based pane for the method
      Returns:
      pane for changing settings

    • getRangeMethodPane

      public abstract SettingsPane<?> getRangeMethodPane()
      Get the FX based settings pane for the method
      Returns:
      pane for changing settings.

    • getHorizonAngle

      protected double getHorizonAngle(double height)
      Calculate the horizon dip angle from the horizontal
      Parameters:
      height - Platform height
      Returns:
      dip angle in radians.

    • getHorizonDistance

      public abstract double getHorizonDistance(double height)
      Calculate the distance to the horizon from a given height.
      Parameters:
      height -
      Returns:
      distnace to horizon in metres.

    • rangeFromPsi

      public abstract double rangeFromPsi(double height, double psi)
      Get the range from the pitch of the camera and camera height. Note that the range is the distance from the camera to the animal.
      Parameters:
      height - - height of the camera
      psi - - the angle of the camera in radians. 0-camera pointing downwards (i.e same direction as g). 90 degrees= camera point perpendicular to direction of g;
      Returns:
      the rane in meters

    • psiFromRange

      public abstract double psiFromRange(double height, double range)
      Get the pitch of the camera from the height and range to target.
      Parameters:
      height - -height of the camera
      range - -distance to the target from the camera.
      Returns:
      psi- the angle of the camera in radians. 0-camera pointing downwards (i.e same direction as g). 90 degrees= camera point perpendicular to direction of g;