LatLonRect (NetCDF-Java CDM Public API v5.4.2)

java.lang.Object
- ucar.unidata.geoloc.LatLonRect

```
public class LatLonRect
extends Object
```
Bounding box for latitude/longitude points. This is a rectangle in lat/lon coordinates. This class handles the longitude wrapping problem. The Rectangle always starts from lowerLeft, goes east width degrees until upperRight For latitude, lower < upper. Since the longitude must be in the range +/-180., right may be less or greater than left.

Field Summary

Fields
Modifier and Type Field and Description

static LatLonRect INVALID

Fields
Modifier and Type	Field and Description
`static LatLonRect`	`INVALID`

Constructor Summary

Constructors
Constructor and Description
`LatLonRect()` Create a LatLonRect that covers the whole world.
`LatLonRect(LatLonPoint p1, double deltaLat, double deltaLon)` Construct a lat/lon bounding box from a point, and a delta lat, lon.
`LatLonRect(LatLonPoint left, LatLonPoint right)` Construct a lat/lon bounding box from two points.
`LatLonRect(LatLonRect r)` Copy Constructor
`LatLonRect(String spec)` Construct a lat/lon bounding box from a string.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`containedIn(LatLonRect b)` Determine if this bounding box is contained in another LatLonRect.
`boolean`	`contains(double lat, double lon)` Determine if the given lat/lon point is contined inside this rectangle.
`boolean`	`contains(LatLonPoint p)` Determine if a specified LatLonPoint is contained in this bounding box.
`boolean`	`crossDateline()` Get whether the bounding box crosses the +/- 180 seam
`boolean`	`equals(Object o)`
`static LatLonRect`	`extend(LatLonRect rect, LatLonPoint p)` Extend the bounding box to contain this point.
`static LatLonRect`	`extend(LatLonRect rect, LatLonRect other)` Extend the bounding box to contain another bounding box.
`double`	`getCenterLon()` return center Longitude, always in the range +/-180
`double`	`getHeight()` return height of bounding box, always between 0 and 180 degrees.
`double`	`getLatMax()` Get maximum latitude, aka "north" edge
`double`	`getLatMin()` Get minimum latitude, aka "south" edge
`double`	`getLonMax()` Get maximum longitude, aka "east" edge
`double`	`getLonMin()` Get minimum longitude, aka "west" edge
`ucar.unidata.geoloc.LatLonPointImpl`	`getLowerLeftPoint()` Get the lower left corner of the bounding box.
`ucar.unidata.geoloc.LatLonPointImpl`	`getLowerRightPoint()` Get the lower left corner of the bounding box.
`ucar.unidata.geoloc.LatLonPointImpl`	`getUpperLeftPoint()` Get the upper left corner of the bounding box.
`ucar.unidata.geoloc.LatLonPointImpl`	`getUpperRightPoint()` Get the upper right corner of the bounding box.
`double`	`getWidth()` return width of bounding box, always between 0 and 360 degrees.
`int`	`hashCode()`
`LatLonRect`	`intersect(LatLonRect clip)` Create the instersection of this LatLon with the given one
`boolean`	`nearlyEquals(LatLonRect other)` Returns the result of `nearlyEquals(LatLonRect, double)`, with `Misc.defaultMaxRelativeDiffFloat`.
`boolean`	`nearlyEquals(LatLonRect other, double maxRelDiff)` Returns `true` if this rectangle is nearly equal to `other`.
`String`	`toString()` Return a String representation of this object.
`String`	`toString2()` Return a String representation of this object.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - INVALID
```
public static LatLonRect INVALID
```
- Constructor Detail
  - LatLonRect
```
public LatLonRect()
```
    Create a LatLonRect that covers the whole world.
  - LatLonRect
```
public LatLonRect(LatLonPoint p1,
                  double deltaLat,
                  double deltaLon)
```
    Construct a lat/lon bounding box from a point, and a delta lat, lon. This disambiguates which way the box wraps around the globe.
    
    Parameters:
    
    p1 - one corner of the box
    
    deltaLat - delta lat from p1. (may be positive or negetive)
    
    deltaLon - delta lon from p1. (may be positive or negetive)
  - LatLonRect
```
public LatLonRect(LatLonPoint left,
                  LatLonPoint right)
```
    Construct a lat/lon bounding box from two points. The order of longitude coord of the two points matters: pt1.lon is always the "left" point, then points contained within the box increase (unless crossing the Dateline, in which case they jump to -180, but then start increasing again) until pt2.lon The order of lat doesnt matter: smaller will go to "lower" point (further south)
    
    Parameters:
    
    left - left corner
    
    right - right corner
  - LatLonRect
```
public LatLonRect(LatLonRect r)
```
    Copy Constructor
    
    Parameters:
    
    r - rectangle to copy
  - LatLonRect
```
public LatLonRect(String spec)
```
    Construct a lat/lon bounding box from a string.
    
    Parameters:
    
    spec - "lat, lon, deltaLat, deltaLon"
    
    See Also:
    
    LatLonRect(LatLonPoint p1, double deltaLat, double deltaLon)
- Method Detail
  - containedIn
```
public boolean containedIn(LatLonRect b)
```
    Determine if this bounding box is contained in another LatLonRect.
    
    Parameters:
    
    b - the other box to see if it contains this one
    
    Returns:
    
    true if b contained in this bounding box
  - contains
```
public boolean contains(double lat,
                        double lon)
```
    Determine if the given lat/lon point is contined inside this rectangle.
    
    Parameters:
    
    lat - lat of point
    
    lon - lon of point
    
    Returns:
    
    true if the given lat/lon point is contined inside this rectangle
  - contains
```
public boolean contains(LatLonPoint p)
```
    Determine if a specified LatLonPoint is contained in this bounding box.
    
    Parameters:
    
    p - the specified point to be tested
    
    Returns:
    
    true if point is contained in this bounding box
  - crossDateline
```
public boolean crossDateline()
```
    Get whether the bounding box crosses the +/- 180 seam
    
    Returns:
    
    true if the bounding box crosses the +/- 180 seam
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - extend
```
public static LatLonRect extend(LatLonRect rect,
                                LatLonPoint p)
```
    Extend the bounding box to contain this point. Return new LatLonRect.
  - extend
```
public static LatLonRect extend(LatLonRect rect,
                                LatLonRect other)
```
    Extend the bounding box to contain another bounding box. Return new LatLonRect.
  - getCenterLon
```
public double getCenterLon()
```
    return center Longitude, always in the range +/-180
    
    Returns:
    
    center Longitude
  - getHeight
```
public double getHeight()
```
    return height of bounding box, always between 0 and 180 degrees.
    
    Returns:
    
    height of bounding box in degrees latitude
  - getLatMax
```
public double getLatMax()
```
    Get maximum latitude, aka "north" edge
    
    Returns:
    
    maximum latitude
  - getLatMin
```
public double getLatMin()
```
    Get minimum latitude, aka "south" edge
    
    Returns:
    
    minimum latitude
  - getLonMax
```
public double getLonMax()
```
    Get maximum longitude, aka "east" edge
    
    Returns:
    
    maximum longitude
  - getLonMin
```
public double getLonMin()
```
    Get minimum longitude, aka "west" edge
    
    Returns:
    
    minimum longitude
  - getLowerLeftPoint
```
public ucar.unidata.geoloc.LatLonPointImpl getLowerLeftPoint()
```
    Get the lower left corner of the bounding box.
    
    Returns:
    
    lower left corner of the bounding box LOOK will return LatLonPoint in ver6
  - getLowerRightPoint
```
public ucar.unidata.geoloc.LatLonPointImpl getLowerRightPoint()
```
    Get the lower left corner of the bounding box.
    
    Returns:
    
    lower left corner of the bounding box LOOK will return LatLonPoint in ver6
  - getUpperLeftPoint
```
public ucar.unidata.geoloc.LatLonPointImpl getUpperLeftPoint()
```
    Get the upper left corner of the bounding box.
    
    Returns:
    
    upper left corner of the bounding box LOOK will return LatLonPoint in ver6
  - getUpperRightPoint
```
public ucar.unidata.geoloc.LatLonPointImpl getUpperRightPoint()
```
    Get the upper right corner of the bounding box.
    
    Returns:
    
    upper right corner of the bounding box LOOK will return LatLonPoint in ver6
  - getWidth
```
public double getWidth()
```
    return width of bounding box, always between 0 and 360 degrees.
    
    Returns:
    
    width of bounding box in degrees longitude
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - intersect
```
public LatLonRect intersect(LatLonRect clip)
```
    Create the instersection of this LatLon with the given one
    
    Parameters:
    
    clip - intersect with this
    
    Returns:
    
    intersection, or null if there is no intersection
  - nearlyEquals
```
public boolean nearlyEquals(LatLonRect other)
```
    Returns the result of nearlyEquals(LatLonRect, double), with Misc.defaultMaxRelativeDiffFloat.
  - nearlyEquals
```
public boolean nearlyEquals(LatLonRect other,
                            double maxRelDiff)
```
    Returns true if this rectangle is nearly equal to other. The "near equality" of corners is determined using LatLonPoint.nearlyEquals(LatLonPoint, double), with the specified maxRelDiff.
    
    Parameters:
    
    other - the other rectangle to check.
    
    maxRelDiff - the maximum relative difference that two corners may have.
    
    Returns:
    
    true if this rectangle is nearly equal to other.
  - toString
```
public String toString()
```
    Return a String representation of this object.
```
 eg: ll: 90.0S .0E+ ur: 90.0N .0E
 
```
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a String representation of this object.
  - toString2
```
public String toString2()
```
    Return a String representation of this object.
```
 lat= [-90.00,90.00] lon= [0.00,360.00
 
```
    Returns:
    
    a String representation of this object.

Class LatLonRect

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

INVALID

Constructor Detail

LatLonRect

LatLonRect

LatLonRect

LatLonRect

LatLonRect

Method Detail

containedIn

contains

contains

crossDateline

equals

extend

extend

getCenterLon

getHeight

getLatMax

getLatMin

getLonMax

getLonMin

getLowerLeftPoint

getLowerRightPoint

getUpperLeftPoint

getUpperRightPoint

getWidth

hashCode

intersect

nearlyEquals

nearlyEquals

toString

toString2