earth

Class EarthArea

java.lang.Object

javafx.geometry.Rectangle2D

earth.EarthArea

Direct Known Subclasses:

CellArea

public class EarthArea
extends javafx.geometry.Rectangle2D

An EarthArea is a rectangle division of Earth in Latitude / Longitude Projection which can be defined as : longitude is x, latitude is y and the earth has considerable distortion away from the Equator due to horizontal increase in longitude degrees. This class without geographic spherical projection is sufficient to detect if an area intersects an other one or contains a point but need some conventions to works with meridian 180 :

              w                          w                    w                  w
      +---------------+      +---------------+        +---------------+        +---------------+
      |               |      |               |        |               |        |               |
      |               |      |               |        |               |        |               |
      |       C       | h    |       C       | h      |       C       | h      |       C       | h 
      |               |      |               |        |               |        |               |
      |       |       |      |       |       |        |               |    |   |               |
      M-------+-------+      M-------+-------+        M---------------+    |   M---------------+
             180                     0                                     0   
      fig1                       fig2                  fig3                    fig4
 
  C : center
  M : (minX,minY) = (lonMin,latMin)
  w : width       = width in degree
  h : height      = heigth in degree
  fig1 : consider longitude after 180 as positive
  fig2 : longitude from negative to positive (no considerations)
  fig3 : longitude from negative to negative (no considerations)
  fig4 : longitude from positive to positive (no considerations)
 

Field Summary

Fields inherited from class javafx.geometry.Rectangle2D

EMPTY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EarthArea(int areaNumber, double lonMin, double latMin, double width, double height) EarthArea constructor, see IseaSplitter project to divide Earth in areas.

Method Summary

Modifier and Type	Method and Description
boolean	contains(double longitude, double latitude) Override Rectangle2D.contains to manage 180 meridian, checks if a point is inside the area.
boolean	contains(javafx.geometry.Point2D coordinate) Override Rectangle2D.contains to manage 180 meridian, checks if a point is inside the area.
java.lang.String	filename() Getter for the fileName of the area.
int	getAreaNumber() Getter for the area number (identifier)
javafx.geometry.Point2D	getCenter() Getter for area center, x is real longitude, y is real latitude
boolean	intersects(double longitude, double latitude, double width, double height) Override Rectangle2D.intersects to manage 180 meridian, check intersection between areas.
boolean	intersects(javafx.geometry.Rectangle2D area) Override Rectangle2D.intersects to manage 180 meridian.
boolean	over180() Checks if area is over 180 meridian
java.lang.String	toString() Getter for description of area.

Methods inherited from class javafx.geometry.Rectangle2D

contains, contains, equals, getHeight, getMaxX, getMaxY, getMinX, getMinY, getWidth, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

EarthArea

protected EarthArea(int areaNumber,
                    double lonMin,
                    double latMin,
                    double width,
                    double height)

EarthArea constructor, see IseaSplitter project to divide Earth in areas. Protected, use EarthAreaFactory to create a new EarthArea.

Parameters:

areaNumber - the area number (identifier)

lonMin - minimum longitude for bottom left corner of area (south)

latMin - minimum latitude for bottom left corner of area (east)

width - length of area in longitude degree

height - height of area in latitude degree

Method Detail

getAreaNumber

public int getAreaNumber()

Getter for the area number (identifier)

Returns:

the area number (identifier)

getCenter

public javafx.geometry.Point2D getCenter()

Getter for area center, x is real longitude, y is real latitude

Returns:

the area center

over180

public boolean over180()

Checks if area is over 180 meridian

Returns:

true if meridian 180 intersects the Area

intersects

public boolean intersects(javafx.geometry.Rectangle2D area)

Override Rectangle2D.intersects to manage 180 meridian. (An area inside an other one has intersection)

Overrides:

intersects in class javafx.geometry.Rectangle2D

Parameters:

area - the area who intersect this (or not)

Returns:

true if intersection exists

intersects

public boolean intersects(double longitude,
                          double latitude,
                          double width,
                          double height)

Override Rectangle2D.intersects to manage 180 meridian, check intersection between areas. (An area inside an other one has intersection)

Overrides:

intersects in class javafx.geometry.Rectangle2D

Parameters:

longitude - of the area who intersect this (or not)

latitude - of the area who intersect this (or not)

width - of the area who intersect this (or not)

height - of the area who intersect this (or not)

Returns:

true if intersection exists

contains

public boolean contains(javafx.geometry.Point2D coordinate)

Override Rectangle2D.contains to manage 180 meridian, checks if a point is inside the area.

Overrides:

contains in class javafx.geometry.Rectangle2D

Parameters:

coordinate - longitude (x) and latitude (y) of point

Returns:

true if point is inside the area

contains

public boolean contains(double longitude,
                        double latitude)

Override Rectangle2D.contains to manage 180 meridian, checks if a point is inside the area.

Overrides:

contains in class javafx.geometry.Rectangle2D

Parameters:

longitude - longitude of point

latitude - latitude of point

Returns:

true if point is inside the area

filename

public java.lang.String filename()

Getter for the fileName of the area. By example "Area_1.csv"

Returns:

the fileName

toString

public java.lang.String toString()

Getter for description of area. By example for Area 1 : "1:Rectangle2D [minX = -170.0, minY=-90.0, maxX=-150.0, maxY=-70.0, width=20.0, height=20.0]"

Overrides:

toString in class javafx.geometry.Rectangle2D

Returns:

the description