MMAffine2DHyperbola (MathletFactory API Specification)

java.lang.Object
- net.mumie.mathletfactory.mmobject.MMDefaultCanvasObject
- - net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DQuadric
  - - net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DHyperbola

All Implemented Interfaces:

java.beans.PropertyChangeListener, java.util.EventListener, AffineGeometryIF, GeometryIF, NumberTypeDependentIF, InteractivityIF, MMCanvasObjectIF, MMObjectIF, PropertyHandlerIF, VisualizeIF, VisualizeInCanvasIF
```
public class MMAffine2DHyperbola
extends MMAffine2DQuadric
```
Class for the construction of an hyperbola. The hyperbola is internally represented by a symmetric 3x3 matrix NumberMatrix. If a quadric in homogeneous coordinates is given by the equation c11 X� + c22 Y� + c33 W� + 2c12 XY + 2c13 XW + 2c23 YW = 0 then the corresponding symmetric quadricMatrix is given by
[c_11 c_12 c_13]
[c_12 c_22 c_23]
[c_13 c_23 c_33].
This projective quadric corresponds to the affine quadric given by c11 X� + c22 Y� + 2c12 XY + 2c13 X + 2c23 Y + c33 = 0. The qaudric matrix represents an hyperbola if the two eigenvalues of the minor matrix
[c_11 c_12]
[c_21 c_22]
have a different sign and are |=0 and if det C |= 0.

Author:

Schimanowski, Liu

Document status:

finished

Field Summary
- Fields inherited from class net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DQuadric
  m_quadricMatrix
- Fields inherited from interface net.mumie.mathletfactory.math.geom.GeometryIF
  AFFINE_GEOMETRY, AFFINE2D_GEOMETRY, AFFINE3D_GEOMETRY, EUCLIDEAN2D_GEOMETRY, EUCLIDEAN3D_GEOMETRY, HYPERBOLIC2D_GEOMETRY, NO_GEOMETRY_TYPE, PROJECTIVEND_GEOMETRY
- Fields inherited from interface net.mumie.mathletfactory.mmobject.PropertyHandlerIF
  DIRECTION_VECTOR, EDITABLE, EDITED, FINITE_NUMBER_SET_ENTRY, INDEXED_ENTRY, INTERVAL, INTERVAL_LOW_BOUND_TYPE, INTERVAL_LOW_BOUND_VALUE, INTERVAL_UP_BOUND_TYPE, INTERVAL_UP_BOUND_VALUE, MATRIX_ENTRY, NUMBER, NUMBERMATRIX, OPERATION, OPERATION_ARRAY, ORIGIN_VECTOR, RELATION, SET_ENTRY, STRING, STRING_MATRIX

Constructor Summary

Constructors
Constructor and Description
`MMAffine2DHyperbola(double[] focalPoints, double distance)` Class constructor creating a hyperbola by the two focal points of the hyperbola and by the difference of the distances between an arbitrary point on the hyperbola and the two focal points.
`MMAffine2DHyperbola(double[] focalPoints, double distance, java.lang.Class matrixNumberClass)` Class constructor creating a hyperbola by the two focal points of the hyperbola, by the difference of the distances between an arbitrary point on the hyperbola and the two focal points, and by the desired number class of the quadric matrix representing the ellipse.
`MMAffine2DHyperbola(double[] center, double radian, double lengthFirstSemiAxis, double lengthSecondSemiAxis)` Class constructor creating an hyperbola by the center, by the radian between the semi-axes and the canonic coordinate system and the length of the semi-axes, and by the desired number class of the quadric matrix representing the hyperbola.
`MMAffine2DHyperbola(double[] center, double radian, double lengthFirstSemiAxis, double lengthSecondSemiAxis, java.lang.Class matrixNumberClass)` Class constructor creating an hyperbola by the center, by the radian between the semi-axes and the canonic coordinate system and the length of the semi-axes, and by the desired number class of the quadric matrix representing the hyperbola.
`MMAffine2DHyperbola(NumberMatrix quadricMatrix)` Class constructor specifying the `quadricMatrix` of type `NumberMatrix` of the hyperpola to create.

Method Summary

Methods
Modifier and Type	Method and Description
`double[]`	`getAsymptote()` returns two points,which lie on the asymptotes.
`double[]`	`getCenter()` Returns the center of this hyperbola
`double`	`getDistance()` Returns the difference of the distances between an arbitrary point on this hyperbola and the two focal points of this hyperbola.
`double[]`	`getFocalPoints()` Returns the two focal points of this hyperbola.
`double`	`getLengthSemimajorAxis()` Returns the length of the first semi axis of this hyperbola.
`double`	`getLengthSemiminorAxis()` Returns the length of the second semi axis of this hyperbola.
`NumberMatrix`	`getMatrix()` Returns the quadric matrix representing this quadric.
`double`	`getRadian()` Returns the radian of this hyperbola.
`double[]`	`getUpperLeftPointOfBoundingBox()` Returns the upper left point of the bounding rectangle of this hyperbola, assumed that the semi-axes of this hyperbola lie on the coordinate axes

Methods inherited from class net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DQuadric
eigenvalueOfMinorMatrixDouble, eigenvectorOfMinorMatrixDouble, getDefaultTransformType, getDefaultTransformTypeInCanvas, getGeomType, getNumberClass, getPoint, getQuadricType, getTransformationMatrix, getValues, getValuesFirstComponent, getValuesSecondComponent, getVersion, groupAction, groupAction, isDegenerated, setFromQuadricMatrix, setFromQuadricMatrix

Methods inherited from class net.mumie.mathletfactory.mmobject.MMDefaultCanvasObject
addHandler, addSpecialCaseListener, addUpdater, dependsOn, dependsOn, doAction, draw, fireSpecialCaseEvent, getActiveHandler, getAsCanvasContent, getAsContainerContent, getAsContainerContent, getCanvas, getCanvasTransformer, getDefaultTransformTypeAsContainer, getDisplayProperties, getDisplayTransformerMap, getHandlerCount, getHandlers, getInteractionHelper, getLabel, getTransformType, getUpdaterCount, getWorldBoundingBox, invokeUpdaters, isAtScreenLocation, isEditable, isSelectable, isSelected, isVisible, propertyChange, removeAllHandlers, removeAllUpdaters, removeHandler, removeSpecialCaseListener, removeUpdater, render, resetActiveHandler, setBorderColor, setCanvas, setCanvasTransformer, setColor, setDisplayProperties, setEditable, setLabel, setObjectColor, setVisible

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MMAffine2DHyperbola
```
public MMAffine2DHyperbola(NumberMatrix quadricMatrix)
```
    Class constructor specifying the quadricMatrix of type NumberMatrix of the hyperpola to create.
    
    Throws:
    
    java.lang.IllegalArgumentException - if quadricMatrix does not describe an ellipse.
  - MMAffine2DHyperbola
```
public MMAffine2DHyperbola(double[] center,
                   double radian,
                   double lengthFirstSemiAxis,
                   double lengthSecondSemiAxis,
                   java.lang.Class matrixNumberClass)
```
    Class constructor creating an hyperbola by the center, by the radian between the semi-axes and the canonic coordinate system and the length of the semi-axes, and by the desired number class of the quadric matrix representing the hyperbola. The radian describes the angle between the x-axis and the FirstSemiAxis. The FirstSemiAxis lies in the first quadrant. Therefore the radian has to be element of [0, pi[. lengthFirstSemiAxis and lengthSecondSemiAxis have to be positive. With matrixNumberClass the desired number class of the quadric matrix representing the hyperbola can be determined.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the length of the semi axes is not positive or radian is no element of [0,Pi[.
  - MMAffine2DHyperbola
```
public MMAffine2DHyperbola(double[] center,
                   double radian,
                   double lengthFirstSemiAxis,
                   double lengthSecondSemiAxis)
```
    Class constructor creating an hyperbola by the center, by the radian between the semi-axes and the canonic coordinate system and the length of the semi-axes, and by the desired number class of the quadric matrix representing the hyperbola. The radian describes the angle between the x-axis and the FirstSemiAxis. The FirstSemiAxis lies in the first quadrant. Therefore the radian has to be element of [0, pi[. lengthFirstSemiAxis and lengthSecondSemiAxis have to be positive. The number class of the quadric matrix is MDouble.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the length of the semi axes is not positive or radian is no element of [0,Pi[.
  - MMAffine2DHyperbola
```
public MMAffine2DHyperbola(double[] focalPoints,
                   double distance,
                   java.lang.Class matrixNumberClass)
```
    Class constructor creating a hyperbola by the two focal points of the hyperbola, by the difference of the distances between an arbitrary point on the hyperbola and the two focal points, and by the desired number class of the quadric matrix representing the ellipse.
    
    Throws:
    
    java.lang.IllegalArgumentException - if distance is greater than the distance between the two focal points nad not positive.
  - MMAffine2DHyperbola
```
public MMAffine2DHyperbola(double[] focalPoints,
                   double distance)
```
    Class constructor creating a hyperbola by the two focal points of the hyperbola and by the difference of the distances between an arbitrary point on the hyperbola and the two focal points. The number class of the quadric matrix is MDouble.
    
    Throws:
    
    java.lang.IllegalArgumentException - if distance is greater than the distance between the two focal points and not positive.
- Method Detail
  - getCenter
```
public double[] getCenter()
```
    Returns the center of this hyperbola
    
    Returns:
    a>code>double[] holding the coordinates of the center
  - getRadian
```
public double getRadian()
```
    Returns the radian of this hyperbola. Since the radian describes the angle between the x-axis and the first semi axis, the return value is element of [0,Pi[.
    
    Returns:
    a double holding the radian
  - getLengthSemimajorAxis
```
public double getLengthSemimajorAxis()
```
    Returns the length of the first semi axis of this hyperbola. The first semi axisis the semi axis lying in the first quadrant.
    
    Returns:
    a double holding the length of the first semi axis
  - getLengthSemiminorAxis
```
public double getLengthSemiminorAxis()
```
    Returns the length of the second semi axis of this hyperbola. The second semi axis is the semi axis lying in the second quadrant.
    
    Returns:
    a double holding the length of the second semi axis
  - getUpperLeftPointOfBoundingBox
```
public double[] getUpperLeftPointOfBoundingBox()
```
    Returns the upper left point of the bounding rectangle of this hyperbola, assumed that the semi-axes of this hyperbola lie on the coordinate axes
    
    Returns:
    a double[] of length 2holding the coordinates of the upper left point
  - getFocalPoints
```
public double[] getFocalPoints()
```
    Returns the two focal points of this hyperbola.
    
    Returns:
    a double[] of length 4 holding the coordinates of the two focal points
  - getDistance
```
public double getDistance()
```
    Returns the difference of the distances between an arbitrary point on this hyperbola and the two focal points of this hyperbola.
    
    Returns:
    a double holding the distance
  - getAsymptote
```
public double[] getAsymptote()
```
    returns two points,which lie on the asymptotes.
    
    Returns:
    a double[] of length 4holding the coordinates of the two points
  - getMatrix
```
public NumberMatrix getMatrix()
```
    Description copied from class: MMAffine2DQuadric
    
    Returns the quadric matrix representing this quadric.
    
    Overrides:
    
    getMatrix in class MMAffine2DQuadric
    
    Returns:
    a NumberMatrix holding the quadric matrix

Class MMAffine2DHyperbola

Field Summary

Fields inherited from class net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DQuadric

Fields inherited from interface net.mumie.mathletfactory.math.geom.GeometryIF

Fields inherited from interface net.mumie.mathletfactory.mmobject.PropertyHandlerIF

Constructor Summary

Method Summary

Methods inherited from class net.mumie.mathletfactory.mmobject.geom.affine.MMAffine2DQuadric

Methods inherited from class net.mumie.mathletfactory.mmobject.MMDefaultCanvasObject

Methods inherited from class java.lang.Object

Constructor Detail

MMAffine2DHyperbola

MMAffine2DHyperbola

MMAffine2DHyperbola

MMAffine2DHyperbola

MMAffine2DHyperbola

Method Detail

getCenter

getRadian

getLengthSemimajorAxis

getLengthSemiminorAxis

getUpperLeftPointOfBoundingBox

getFocalPoints

getDistance

getAsymptote

getMatrix