cells

Class CellArea

java.lang.Object

javafx.geometry.Rectangle2D

earth.EarthArea

cells.CellArea

public class CellArea
extends EarthArea

A CellArea is a earth Area with all cells having intersection or included in it. 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	CellArea(EarthArea earthArea) Constructs a CellArea from its equivalent EarthArea.
protected	CellArea(int areaNumber, double lonMin, double latMin, double width, double height) CellArea constructor.

Method Summary

Modifier and Type	Method and Description
void	addCell(Cell cell) Adds a cell to the cell area, the cell must have intersection (or is included in) with the cell area.
Cell	getCell(double longitude, double latitude) Getter for cell from geographic point, CellArea (this) should contains the point (longitude,latitude)
java.util.ArrayList<Cell>	getCells() Getter for all cells having intersection or included in the cell area (this)
java.lang.String	toString() Getter for description of cell area.

Methods inherited from class earth.EarthArea

contains, contains, filename, getAreaNumber, getCenter, intersects, intersects, over180

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

CellArea

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

CellArea constructor.

Parameters:

areaNumber - the cell area id

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

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

width - length of cell area in longitude degree

height - height of cell area in latitude degree

CellArea

protected CellArea(EarthArea earthArea)

Constructs a CellArea from its equivalent EarthArea.

Parameters:

earthArea - the equivalent EarthArea

Method Detail

addCell

public void addCell(Cell cell)

Adds a cell to the cell area, the cell must have intersection (or is included in) with the cell area.

Parameters:

cell - the cell to add

getCells

public java.util.ArrayList<Cell> getCells()

Getter for all cells having intersection or included in the cell area (this)

Returns:

cells having intersection or included in the cell area

getCell

public Cell getCell(double longitude,
                    double latitude)
             throws DiscreteGlobalGridException

Getter for cell from geographic point, CellArea (this) should contains the point (longitude,latitude)

Parameters:

longitude - longitude for point

latitude - latitude for point

Returns:

the cell

Throws:

DiscreteGlobalGridException - if can't be found

toString

public java.lang.String toString()

Getter for description of cell area. By example for Area 101 : "418 cells in 101:Rectangle2D [minX = 30.0, minY=10.0, maxX=50.0, maxY=30.0, width=20.0, height=20.0]"

Overrides:

toString in class EarthArea

Returns:

the description