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 Link icon

    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 Link icon

    Constructors
    Constructor
    Description
    VRHorzCalcMethod()
     

  • Method Summary Link icon

    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 Link icon

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

  • Field Details Link icon

    • earthRadius Link icon

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

    • gravity Link icon

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

  • Constructor Details Link icon

    • VRHorzCalcMethod Link icon

      public VRHorzCalcMethod()

  • Method Details Link icon

    • getRange Link icon

      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 Link icon

      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 Link icon

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

    • getRangeMethodPane Link icon

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

    • getHorizonAngle Link icon

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

    • getHorizonDistance Link icon

      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 Link icon

      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 Link icon

      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;