LandTile

java.lang.Object
- starvationevasion.sim.LandTile

```
public class LandTile
extends java.lang.Object
```
Author:

david created: 2015-03-21 description: LandTile class describes a single section of the equal area projection of the world map. It holds y0Elevation, climate and climate projection data found at www.worldclim.org. The class also describes a ByteBuffer format for a custom binary file. This allows the data from the raw sets to be parsed, projected and averaged across equal-area sections of the globe once. This data can then simply be loaded in at the program start. (see CropZoneDataIO class)

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class LandTile.BYTE_DEF
BYTE_DEF enum generalizes the binary format the LandTiles can be stored in

Nested Classes
Modifier and Type	Class and Description
`static class`	`LandTile.BYTE_DEF` BYTE_DEF enum generalizes the binary format the LandTiles can be stored in

Constructor Summary

Constructors
Constructor and Description
`LandTile(java.nio.ByteBuffer buf)` Constructor using custom binary file
`LandTile(double lon, double lat)` Constructor used for initial creation of data set

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`float`	`getAvgDayTemp()`
`float`	`getAvgNightTemp()`
`MapPoint`	`getCenter()`
`EnumFood`	`getCurrentCrop()` Retuns the crop currently planted on this tile.
`float`	`getElevation()`
`double`	`getLat()`
`double`	`getLon()`
`float`	`getMaxAnnualTemp()`
`float`	`getMinAnnualTemp()`
`float`	`getProj2050AvgDayTemp()`
`float`	`getProj2050AvgNightTemp()`
`float`	`getProj2050MaxAnnualTemp()`
`float`	`getProj2050MinAnnualTemp()`
`float`	`getProj2050Rainfall()`
`float`	`getRainfall()`
`double`	`getTileYieldPercent(EnumFood crop, CropZoneData.EnumCropZone zone)` Get percent of country's yield for crop tile will yield, base on its zone rating and current use
`static float`	`interpolate(float start, float end, float slices, float n)` Find an interpolated value given extremes of the range across which to interpolate, the number of steps to divide that range into and the step of the range to find.
`CropZoneData.EnumCropZone`	`rateTileForCrop(EnumFood crop)` Rates tile's suitability for a particular crop.
`CropZoneData.EnumCropZone`	`rateTileForOtherCrops(CropZoneData otherCropsData)` Rate tile's suitability for a particular country's other crops.
`void`	`setAvgDayTemp(float avgDayTemp)`
`void`	`setAvgNightTemp(float avgNightTemp)`
`void`	`setClimate(int year)` Mutates tile's values when year changes
`void`	`setElev(float elev)`
`void`	`setMaxAnnualTemp(float maxAnnualTemp)`
`void`	`setMinAnnualTemp(float minAnnualTemp)`
`void`	`setProj2050AvgDayTemp(float proj2050AvgDayTemp)`
`void`	`setProj2050AvgNightTemp(float proj2050AvgNightTemp)`
`void`	`setProj2050MaxAnnualTemp(float proj2050MaxAnnualTemp)`
`void`	`setProj2050MinAnnualTemp(float proj2050MinAnnualTemp)`
`void`	`setProj2050Rainfall(float proj2050rainfall)`
`void`	`setRainfall(float rainfall)`
`java.nio.ByteBuffer`	`toByteBuffer()`
`java.lang.String`	`toDetailedString()`
`java.lang.String`	`toolTipText()`
`java.lang.String`	`toString()`

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

- Constructor Detail
  - LandTile
```
public LandTile(double lon,
                double lat)
```
    Constructor used for initial creation of data set
    
    Parameters:
    
    lon - longitude of this LandTile
    
    lat - latitude of this LandTile
  - LandTile
```
public LandTile(java.nio.ByteBuffer buf)
```
    Constructor using custom binary file
    
    Parameters:
    
    buf - custom binary file
- Method Detail
  - interpolate
```
public static float interpolate(float start,
                                float end,
                                float slices,
                                float n)
```
    Find an interpolated value given extremes of the range across which to interpolate, the number of steps to divide that range into and the step of the range to find.
    
    Parameters:
    
    start - beginning (min) of the range
    
    end - end (max) of the range
    
    slices - slices to divide range into
    
    n - slice desired from interpolation
    
    Returns:
    
    interpolated value
  - setElev
```
public void setElev(float elev)
```
    Parameters:
    
    elev - tile's y0Elevation
  - toolTipText
```
public java.lang.String toolTipText()
```
    Returns:
    
    tool tip text when cursor over tile
  - toByteBuffer
```
public java.nio.ByteBuffer toByteBuffer()
```
  - getLon
```
public double getLon()
```
  - getLat
```
public double getLat()
```
  - getCenter
```
public MapPoint getCenter()
```
  - setClimate
```
public void setClimate(int year)
```
    Mutates tile's values when year changes
    
    Parameters:
    
    year - The simulation year
  - getElevation
```
public float getElevation()
```
  - getMaxAnnualTemp
```
public float getMaxAnnualTemp()
```
  - setMaxAnnualTemp
```
public void setMaxAnnualTemp(float maxAnnualTemp)
```
  - getMinAnnualTemp
```
public float getMinAnnualTemp()
```
  - setMinAnnualTemp
```
public void setMinAnnualTemp(float minAnnualTemp)
```
  - getAvgDayTemp
```
public float getAvgDayTemp()
```
  - setAvgDayTemp
```
public void setAvgDayTemp(float avgDayTemp)
```
  - getAvgNightTemp
```
public float getAvgNightTemp()
```
  - setAvgNightTemp
```
public void setAvgNightTemp(float avgNightTemp)
```
  - getRainfall
```
public float getRainfall()
```
  - setRainfall
```
public void setRainfall(float rainfall)
```
  - getProj2050MaxAnnualTemp
```
public float getProj2050MaxAnnualTemp()
```
  - setProj2050MaxAnnualTemp
```
public void setProj2050MaxAnnualTemp(float proj2050MaxAnnualTemp)
```
  - getProj2050MinAnnualTemp
```
public float getProj2050MinAnnualTemp()
```
  - setProj2050MinAnnualTemp
```
public void setProj2050MinAnnualTemp(float proj2050MinAnnualTemp)
```
  - getProj2050AvgDayTemp
```
public float getProj2050AvgDayTemp()
```
  - setProj2050AvgDayTemp
```
public void setProj2050AvgDayTemp(float proj2050AvgDayTemp)
```
  - getProj2050AvgNightTemp
```
public float getProj2050AvgNightTemp()
```
  - setProj2050AvgNightTemp
```
public void setProj2050AvgNightTemp(float proj2050AvgNightTemp)
```
  - getProj2050Rainfall
```
public float getProj2050Rainfall()
```
  - setProj2050Rainfall
```
public void setProj2050Rainfall(float proj2050rainfall)
```
  - rateTileForCrop
```
public CropZoneData.EnumCropZone rateTileForCrop(EnumFood crop)
                                          throws java.lang.NullPointerException
```
    Rates tile's suitability for a particular crop.
    
    Parameters:
    
    crop - crop for which we want rating (wheat, corn, rice, or soy)
    
    Returns:
    
    EnumCropZone (IDEAL, ACCEPTABLE, or POOR)
    
    Throws:
    
    java.lang.NullPointerException - if called with argument EnumFood.OTHER_CROPS, will throw an exception because OTHER_CROPS required climate varies by country; rating cannot be calculated using crop alone.
  - rateTileForOtherCrops
```
public CropZoneData.EnumCropZone rateTileForOtherCrops(CropZoneData otherCropsData)
```
    Rate tile's suitability for a particular country's other crops.
    
    Parameters:
    
    otherCropsData - a country's otherCropsData object
    
    Returns:
    
    EnumCropZone (IDEAL, ACCEPTABLE, or POOR)
  - getTileYieldPercent
```
public double getTileYieldPercent(EnumFood crop,
                                  CropZoneData.EnumCropZone zone)
```
    Get percent of country's yield for crop tile will yield, base on its zone rating and current use
    
    Parameters:
    
    crop - crop in question
    
    zone - tile's zone for that crop
    
    Returns:
    
    percent of country's yield tile can yield
  - getCurrentCrop
```
public EnumFood getCurrentCrop()
```
    Retuns the crop currently planted on this tile.
    
    Returns:
    
    planted crop
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - toDetailedString
```
public java.lang.String toDetailedString()
```

Class LandTile

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LandTile

LandTile

Method Detail

interpolate

setElev

toolTipText

toByteBuffer

getLon

getLat

getCenter

setClimate

getElevation

getMaxAnnualTemp

setMaxAnnualTemp

getMinAnnualTemp

setMinAnnualTemp

getAvgDayTemp

setAvgDayTemp

getAvgNightTemp

setAvgNightTemp

getRainfall

setRainfall

getProj2050MaxAnnualTemp

setProj2050MaxAnnualTemp

getProj2050MinAnnualTemp

setProj2050MinAnnualTemp

getProj2050AvgDayTemp

setProj2050AvgDayTemp

getProj2050AvgNightTemp

setProj2050AvgNightTemp

getProj2050Rainfall

setProj2050Rainfall

rateTileForCrop

rateTileForOtherCrops

getTileYieldPercent

getCurrentCrop

toString

toDetailedString