Package uk.ac.rdg.resc.edal.util

Class CurvilinearCoords

java.lang.Object

uk.ac.rdg.resc.edal.util.CurvilinearCoords

public final class CurvilinearCoords
extends Object

A horizontal (2D) grid that is defined by explicitly specifying the longitude and latitude coordinates of its cells. We assume the WGS84 lat-lon coordinate system.

Author:

Guy Griffiths, Jon Blower

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	CurvilinearCoords.Cell	A cell within this curvilinear grid.

Constructor Summary

Constructors

Constructor	Description
CurvilinearCoords(Array2D<Number> lonVals, Array2D<Number> latVals)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
BoundingBox	getBoundingBox()
CurvilinearCoords.Cell	getCell(int i, int j)	Gets the [i,j]th cell in this grid.
List<CurvilinearCoords.Cell>	getCells()	Returns an unmodifiable list of the cells in this grid, with the i direction varying fastest.
double	getMeanCellArea()	Gets the mean area of the cells in this grid, in square degrees.
HorizontalPosition	getMidpoint(int i, int j)	Gets the location of the midpoint of the cell at indices i, j.
int	getNi()
int	getNj()
int	hashCode()
static void	main(String[] args)
int	size()	Returns the number of cells in this grid

Methods inherited from class java.lang.Object

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

Constructor Detail

CurvilinearCoords

public CurvilinearCoords(Array2D<Number> lonVals,
                         Array2D<Number> latVals)

Method Detail

getMidpoint

public HorizontalPosition getMidpoint(int i,
                                      int j)

Gets the location of the midpoint of the cell at indices i, j. The longitude coordinate of the midpoint will be in the range [-180,180].

Throws:

ArrayIndexOutOfBoundsException - if i and j combine to give a point outside the grid.

getCell

public CurvilinearCoords.Cell getCell(int i,
                                      int j)

Gets the [i,j]th cell in this grid. TODO cache or precompute the cells?

Throws:

IllegalArgumentException - if i,j is not a valid cell in this grid.

getNi

public int getNi()

Returns:

the number of points in the i direction in this grid

getNj

public int getNj()

Returns:

the number of points in the j direction in this grid

size

public int size()

Returns the number of cells in this grid

getBoundingBox

public BoundingBox getBoundingBox()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getCells

public List<CurvilinearCoords.Cell> getCells()

Returns an unmodifiable list of the cells in this grid, with the i direction varying fastest.

getMeanCellArea

public double getMeanCellArea()

Gets the mean area of the cells in this grid, in square degrees.

main

public static void main(String[] args)