TileManager

java.lang.Object
- starvationevasion.sim.TileManager

public class TileManager
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`COLS`
`static double`	`DLAT`
`static double`	`DLON`
`static double`	`DX_KM`
`static double`	`DY_KM`
`static double`	`LAT_RANGE`
`static double`	`LON_RANGE`
`static double`	`MAX_LAT`
`static double`	`MAX_LON`
`static double`	`MIN_LAT`
`static double`	`MIN_LON`
`static LandTile`	`NO_DATA`
`static double`	`NOISE_RADIUS`
`static int`	`ROWS`

Constructor Summary

Constructors
Constructor and Description

TileManager()

Constructors
Constructor and Description
`TileManager()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.util.List<LandTile>`	`allTiles()`
`float`	`calcTileDelta(double min, double max, double r1, double r2)` Calculates the delta value used to add noise to tiles, given a maximum and minimum value for the parameter, and two random numbers in range [0,1] To use this for the annual rainfall delta, use 0 as the minimum.
`static double`	`colToLon(int col)`
`java.util.List<LandTile>`	`countryTiles()` Returns a Collection of tiles that have been registered with a country.
`LandTile[]`	`dataTiles()` Returns a Collection of the tiles held by this TileManager that actually contain data.
`float`	`getRainfall(float lat, float lon)` Get the annual rainfall at a location in the current simulation year.
`float`	`getTemperatureDay(float lat, float lon)` Get the average daytime temperature at a location in the current simulation year.
`float`	`getTemperatureMax(float lat, float lon)` Get the max temperature at a location in the current simulation year.
`float`	`getTemperatureMin(float lat, float lon)` Get the min temperature at a location in the current simulation year.
`float`	`getTemperatureNight(float lat, float lon)` Get the average nighttime temperature at a location in the current simulation year.
`LandTile`	`getTile(double lon, double lat)` Get a tile by longitude and latitude
`void`	`putTile(LandTile tile)` Add a given tile to the data set.
`void`	`registerCountryTile(LandTile tile)` Registers a tile as having been associated with a country.
`boolean`	`removeTile(LandTile tile)` remove a given tile from the underlying set of tiles.
`static double`	`rowToLat(int row)`
`float`	`scaleDeltaByDistance(double delta, double distance, double r3)` Calculates the actual amount to add to a given parameter in a LandTile, given the delta value, the distance between the tile from which noise is being added and a random number in range [0,2]
`void`	`setClimate(int year)` Mutates all the tile data based on projections maintained within each tile and noise added randomly.

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

- Field Detail
  - NO_DATA
```
public static final LandTile NO_DATA
```
  - ROWS
```
public static final int ROWS
```
    See Also:
    
    Constant Field Values
  - COLS
```
public static final int COLS
```
    See Also:
    
    Constant Field Values
  - MIN_LAT
```
public static final double MIN_LAT
```
    See Also:
    
    Constant Field Values
  - MAX_LAT
```
public static final double MAX_LAT
```
    See Also:
    
    Constant Field Values
  - MIN_LON
```
public static final double MIN_LON
```
    See Also:
    
    Constant Field Values
  - MAX_LON
```
public static final double MAX_LON
```
    See Also:
    
    Constant Field Values
  - LAT_RANGE
```
public static final double LAT_RANGE
```
    See Also:
    
    Constant Field Values
  - LON_RANGE
```
public static final double LON_RANGE
```
    See Also:
    
    Constant Field Values
  - DLON
```
public static final double DLON
```
    See Also:
    
    Constant Field Values
  - DLAT
```
public static final double DLAT
```
    See Also:
    
    Constant Field Values
  - DX_KM
```
public static final double DX_KM
```
    See Also:
    
    Constant Field Values
  - DY_KM
```
public static final double DY_KM
```
    See Also:
    
    Constant Field Values
  - NOISE_RADIUS
```
public static final double NOISE_RADIUS
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TileManager
```
public TileManager()
```
- Method Detail
  - getTemperatureMax
```
public float getTemperatureMax(float lat,
                               float lon)
```
    Get the max temperature at a location in the current simulation year.
    
    Parameters:
    
    lat - [-90.0 to 90.0], South latitudes are less than 0.
    
    lon - [-180.0 to 180.0], West longitudes are less than 0.
    
    Returns:
    
    the max temperature at the coordinates, either estimated or exact, depending on the year
  - getTemperatureMin
```
public float getTemperatureMin(float lat,
                               float lon)
```
    Get the min temperature at a location in the current simulation year.
    
    Parameters:
    
    lat - [-90.0 to 90.0], South latitudes are less than 0.
    
    lon - [-180.0 to 180.0], West longitudes are less than 0.
    
    Returns:
    
    the min temperature at the coordinates, either estimated or exact, depending on the year
  - getTemperatureDay
```
public float getTemperatureDay(float lat,
                               float lon)
```
    Get the average daytime temperature at a location in the current simulation year.
    
    Parameters:
    
    lat - [-90.0 to 90.0], South latitudes are less than 0.
    
    lon - [-180.0 to 180.0], West longitudes are less than 0.
    
    Returns:
    
    the average daytime temperature at the coordinates, either estimated or exact, depending on the year
  - getTemperatureNight
```
public float getTemperatureNight(float lat,
                                 float lon)
```
    Get the average nighttime temperature at a location in the current simulation year.
    
    Parameters:
    
    lat - [-90.0 to 90.0], South latitudes are less than 0.
    
    lon - [-180.0 to 180.0], West longitudes are less than 0.
    
    Returns:
    
    the average night temperature at the coordinates, either estimated or exact, depending on the year
  - getRainfall
```
public float getRainfall(float lat,
                         float lon)
```
    Get the annual rainfall at a location in the current simulation year.
    
    Parameters:
    
    lat - [-90.0 to 90.0], South latitudes are less than 0.
    
    lon - [-180.0 to 180.0], West longitudes are less than 0.
    
    Returns:
    
    the annual rainfall at the coordinates, either estimated or exact, depending on the year
  - setClimate
```
public void setClimate(int year)
```
    Mutates all the tile data based on projections maintained within each tile and noise added randomly.
    
    Parameters:
    
    year - The simulation year.
  - calcTileDelta
```
public float calcTileDelta(double min,
                           double max,
                           double r1,
                           double r2)
```
    Calculates the delta value used to add noise to tiles, given a maximum and minimum value for the parameter, and two random numbers in range [0,1] To use this for the annual rainfall delta, use 0 as the minimum.
    
    Parameters:
    
    min - minimum value in the range of the data
    
    max - maximum value in the range of the data
    
    r1 - first random number between 0 and 1
    
    r2 - second random number between 0 and 1
    
    Returns:
    
    the delta value used to randomize climate data
  - scaleDeltaByDistance
```
public float scaleDeltaByDistance(double delta,
                                  double distance,
                                  double r3)
```
    Calculates the actual amount to add to a given parameter in a LandTile, given the delta value, the distance between the tile from which noise is being added and a random number in range [0,2]
    
    Parameters:
    
    delta - calculated delta value
    
    distance -
    
    r3 -
    
    Returns:
  - getTile
```
public LandTile getTile(double lon,
                        double lat)
```
    Get a tile by longitude and latitude
    
    Parameters:
    
    lon - degrees longitude
    
    lat - degrees latitude
    
    Returns:
    
    the tile into which the specified longitude and latitude coordinates fall. If no tile exists at that point, NO_DATA is returned
  - putTile
```
public void putTile(LandTile tile)
```
    Add a given tile to the data set. This should really only be used when reading in a new set of tiles from a file.
    
    Parameters:
    
    tile - LandTile to add
  - registerCountryTile
```
public void registerCountryTile(LandTile tile)
```
    Registers a tile as having been associated with a country. Due to gaps in the country data, if a set of tiles covering all the land is desired, use dataTiles()
    
    Parameters:
    
    tile - tile to register
  - countryTiles
```
public java.util.List<LandTile> countryTiles()
```
    Returns a Collection of tiles that have been registered with a country. This is dependent on the usage of registerCountryTile() at initial data creation. (Also maybe should be refactored to another location?)
    
    Returns:
    
    Collection of those LandTiles that have been registered with a Territory
  - dataTiles
```
public LandTile[] dataTiles()
```
    Returns a Collection of the tiles held by this TileManager that actually contain data. This, in effect, excludes tiles that would be over ocean and those at the extremes of latitude. For all tiles, use allTiles();
    
    Returns:
    
    a Collection holding only those tiles for which there exists raster data.
  - allTiles
```
public java.util.List<LandTile> allTiles()
```
    Returns:
    
    all the tiles in this manager in a List
  - removeTile
```
public boolean removeTile(LandTile tile)
```
    remove a given tile from the underlying set of tiles. This has the effect of placing a NO_DATA tile at the location of the given tile in the full projection (assuming the given tile was found)
    
    Parameters:
    
    tile - tile to remove
    
    Returns:
    
    true if the tile was found and removed
  - rowToLat
```
public static double rowToLat(int row)
```
  - colToLon
```
public static double colToLon(int col)
```

Class TileManager

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NO_DATA

ROWS

COLS

MIN_LAT

MAX_LAT

MIN_LON

MAX_LON

LAT_RANGE

LON_RANGE

DLON

DLAT

DX_KM

DY_KM

NOISE_RADIUS

Constructor Detail

TileManager

Method Detail

getTemperatureMax

getTemperatureMin

getTemperatureDay

getTemperatureNight

getRainfall

setClimate

calcTileDelta

scaleDeltaByDistance

getTile

putTile

registerCountryTile

countryTiles

dataTiles

allTiles

removeTile

rowToLat

colToLon