Name

---

LAND_OCEAN_READ_KPB

Purpose

---

This function reads the ISLSCP land-water mask data sets and returns a
data structure containing the mask data and ancillary information.

Calling Sequence

---

mask = LAND_OCEAN_READ_KPB(version, data_type, resolution)

Inputs

---

version : string indicating the data set version
'land_ocean_masks', has no inland waters - DEFAULT
'land_water_masks', contains ocean and inland waters
'inland_water_masks', contains inland waters only
'land_water_masks-99', special version, see documentation
data_type : string indicating the data set type, depends on data set version
land_ocean_masks :
'land_ocean_mask2', land-ocean mask (0 or 1)
'land_percent2', percent land in each grid cell - DEFAULT
'ocean_percent2', percent ocean in each grid cell
land_water_masks :
'land_water_mask', land-water mask (0 or 1)
'land_percent', percent land in each grid cell
'water_percent', percent water in each grid cell
inland_water_masks :
'inland_water_mask', inland water maks (0 or 1)
'inland_water_percent', percent inland water in each grid cell
'other_percent', percent other in each grid cell
land_water_masks-99 :
'land_water_mask-99'
resolution : string indicating the resolution of the data set to be read
'1d' - 1.0 x 1.0 degree
'hd' - 0.5 x 0.5 degree - DEFAULT
'qd' - 0.25 x 0.25 degree

Output

---

mask : structure containing selected land-water mask data and ancillary
information, including the area of each grid cell as a fraction of the
total area of the Earth.

Keywords

---

DIRECTORY : optional alternative input directory. The default is the value of
the system variable !LAND_OCEAN_KPB, which should be set to something
like this:
DEFSYSV, '!LAND_OCEAN_KPB', '/bowman_lib/land_ocean/data/'

DATELINE : if set, start dataset at the international dateline. The default
is to start at the Greenwich meridian.

Author And History

---

K. Bowman. 2008-03-01.
For proper alignment of each line, view with a 3-space tab.
Please report bugs to k-bowman@tamu.edu.