observed/lai/0_modis_landcover_readme.txt
author Forrest Hoffman <forrest@climatemodeling.org>
Tue, 27 Jan 2009 02:06:40 -0500
changeset 1 a3930ac0be17
permissions -rw-r--r--
Replaced EMDI Class A NPP 81 observational data with new revision from ORNL DAAC

The original EMDI Class A NPP 81 data provided by the ORNL DAAC contained
error as follows:

from Cook, Robert B. <cookrb@ornl.gov>
to jranders@uci.edu,
Forrest Hoffman <fmhoffman@gmail.com>,
"Hoffman, Forrest M." <hoffmanfm@ornl.gov>
cc "Hook, Leslie A." <hookla@ornl.gov>,
uso@daac.ornl.gov
date Fri, Oct 31, 2008 at 11:48 AM
subject revised EMDI data: please use this version
mailed-by ornl.gov

10/31/08 [NPP_EMDI_R1_20081028.html,EMDI_ClassA_NPP_81_R1.csv]

Hi Jim and Forrest,

We recently found out that the data we sent to you two years ago for
use in your model-data intercomparison activity has some problems.

One of our users discovered problems with the TNPP data for Class
A site tropical forest biomes. For a description of the problem
and what we've done to correct it are in the attached html file.

The attached csv file has the correct values. Please remove the
old file / data and use the new file.

We apologize for the inconvenience this may cause. We understand
that you have a paper in press that uses these data. Sorry about
this.

I am sending this note to you before we formally make the change
on our Web site, because you have a paper in press. When we place
the revision on our Web site, we will update the data set citation
and DOI.

Olson, R. J., J. M. O. Scurlock, S. D. Prince, D. L. Zheng,
and K. R. Johnson (eds.). 2008. NPP Multi-Biome: NPP and Driver
Data for Ecosystem Model-Data Intercomparison, R[evision]1. Data
set. Available on-line [http://www.daac.ornl.gov] from the Oak Ridge
National Laboratory Distributed Active Archive Center, Oak Ridge,
Tennessee, U.S.A. doi:10.3334/ORNLDAAC/xxx

Please let me know if you have any questions.

Thanks Bob

On Jan 26, 2009, I moved the original data.81 file to data.81.rev0.bad and
data.81.nc to data.81.rev0.bad.nc. Then I copied the file provided by the
ORNL DAAC, called EMDI_ClassA_NPP_81_R1.csv, to data.81 and re-generated
data.81.nc using the NCL script clamp/npp/01.read_ascii_81.ncl

Forrest Hoffman
Mon Jan 26 23:23:46 EST 2009
forrest@0
     1
################################################################################
forrest@0
     2
# MODIS Global Land Cover Classifications at 0.25, 0.5 and 1 degree (2000-2001)#
forrest@0
     3
################################################################################
forrest@0
     4
forrest@0
     5
The files in this directory were provided by Drs. Mark Friedl and Alan Strahler, 
forrest@0
     6
and Mr. John Hodges from the Department of Geography at Boston University. These 
forrest@0
     7
are global, coarse resolution (1/4, 1/2 and 1 degree spatial resolutions) land 
forrest@0
     8
cover classifications (dominant type, classification confidence and fractional 
forrest@0
     9
cover) generated using a full year of MODerate Resolution Imaging 
forrest@0
    10
Spectroradiometer (MODIS) data covering the period from October 2000 to October 
forrest@0
    11
2001. These land cover products use the classification scheme proposed by the 
forrest@0
    12
International Geosphere-Biosphere Programme (IGBP). Original 1km MODIS data and 
forrest@0
    13
land cover products are available from the EROS Data Center Distributed Active 
forrest@0
    14
Archive Center (DAAC) or from Boston University at 
forrest@0
    15
http://geography.bu.edu/landcover/index.html
forrest@0
    16
forrest@0
    17
The objective of the MODIS Land Cover Product is to provide a suite of land 
forrest@0
    18
cover types useful to global system science modelers by exploiting the 
forrest@0
    19
information content of MODIS data in the spectral, temporal, spatial, and 
forrest@0
    20
directional domains. The MODIS Land Cover Product describes the geographic 
forrest@0
    21
distribution of the 17 IGBP land cover types based on an annual time series of 
forrest@0
    22
observations (See below for a list of the cover types included). Confidence 
forrest@0
    23
assessments of the classifications are also provided in a separate layer. The 
forrest@0
    24
data set also provides the fraction of each of the 17 classes within the coarser 
forrest@0
    25
resolution cells. These data sets have been adjusted to match the land/water 
forrest@0
    26
boundaries and fractions of the ISLSCP2 land/water masks. The user should always 
forrest@0
    27
refer to the full data set documentation and/or the reference below for more 
forrest@0
    28
information on data processing. 
forrest@0
    29
forrest@0
    30
Please cite the following publication when these data are used:
forrest@0
    31
forrest@0
    32
Friedl M.A., D.K. McIver, J.C.F. Hodges, X.Y. Zhang, D. Muchoney, A.H. Strahler, 
forrest@0
    33
C.E. Woodcock, S. Gopal, A. Schneider, A. Cooper, A. Baccini, F. Gao, and C. 
forrest@0
    34
Schaaf, Global Land Cover Mapping from MODIS: Algorithms and Early Results, 
forrest@0
    35
Remote Sensing of Environment 83(1-2):287-302.
forrest@0
    36
forrest@0
    37
Any problems encountered with the data set should be reported to Eric Brown de 
forrest@0
    38
Colstoun at ericbdc@ltpmail.gsfc.nasa.gov
forrest@0
    39
forrest@0
    40
##############################################################################
forrest@0
    41
forrest@0
    42
File Name Convention
forrest@0
    43
--------------------
forrest@0
    44
The data sets in this directory are provided at three spatial resolutions of 
forrest@0
    45
0.25, 0.5 and 1 degrees lat./long. For each spatial resolution there is a land 
forrest@0
    46
cover type classification layer (with numbers from 0 to 17), a classifier 
forrest@0
    47
confidence assessment layer, in percent, and 17 associated layers that provide 
forrest@0
    48
the fraction, from 0 to 100, of each land cover type per cell. The land cover 
forrest@0
    49
type files are named "modis_landcover_class_XX.asc", where XX is qd, hd, or 1d, 
forrest@0
    50
denoting a spatial resolution of 1/4, 1/2 or 1 degrees, respectively. The 
forrest@0
    51
classifier confidence layer is named "modis_landcover_conf_XX.asc", where XX is 
forrest@0
    52
the same as above. The fractional files are called "modis_landcover_XX_cZZ.asc", 
forrest@0
    53
where XX is the same as above, and ZZ is a number from 00 to 17 which represents 
forrest@0
    54
the land cover type code as described below. As an example, the file named 
forrest@0
    55
"modis_landcover_qd_c02.asc" is the fraction of Evergreen Broadleaf Forest at a 
forrest@0
    56
quarter degree spatial resolution. This file is associated with the 
forrest@0
    57
"modis_landcover_class_qd.asc" land cover type file and the 
forrest@0
    58
"modis_landcover_conf_qd.asc" classifier confidence file.
forrest@0
    59
forrest@0
    60
##############################################################################
forrest@0
    61
forrest@0
    62
ASCII File Format
forrest@0
    63
------------------
forrest@0
    64
All of the files in the ISLSCP Initiative II data collection are in the ASCII, 
forrest@0
    65
or text format. The file format consists of numerical fields of varying length, 
forrest@0
    66
which are delimited by a single space and arranged in columns and rows. The 
forrest@0
    67
values in the land cover class type and classifier confidence files are written 
forrest@0
    68
as integers from 0 to 17 and 0 to 255, respectively. In the classifier 
forrest@0
    69
confidence files a value of 254 is assigned to all water bodies while a value of 
forrest@0
    70
255 is assigned to cells with no data. All values in the land cover fraction 
forrest@0
    71
files are written as real numbers.
forrest@0
    72
forrest@0
    73
The files at different spatial resolutions each contain the following numbers of 
forrest@0
    74
columns and rows:
forrest@0
    75
    One degree: 360 columns by 180 rows 
forrest@0
    76
    1/2 degree: 720 columns by 360 rows 
forrest@0
    77
    1/4 degree: 1440 columns by 720 rows 
forrest@0
    78
forrest@0
    79
All files are gridded to a common equal-angle lat/long grid, where the 
forrest@0
    80
coordinates of the upper left corner of the files are located at 180oW, 90oN and 
forrest@0
    81
the lower right corner coordinates are located at 180oE, 90oS. Data in the files 
forrest@0
    82
are ordered from North to South and from West to East beginning at 180 degrees 
forrest@0
    83
West and 90 degrees North. 
forrest@0
    84
forrest@0
    85
The data files are PKZip compressed. On UNIX, they can be decompressed using the 
forrest@0
    86
"unzip -a" command. On Windows, they can be decompressed using WinZip or other 
forrest@0
    87
PKZip software. On the Macintosh, they can be decompressed using Stuffit 
forrest@0
    88
Expander.
forrest@0
    89
forrest@0
    90
################################################################################
forrest@0
    91
forrest@0
    92
Land Cover Type Codes and Definitions
forrest@0
    93
-------------------------------------
forrest@0
    94
The following 17 IGBP classes are used. 
forrest@0
    95
forrest@0
    96
0 = Water Bodies: Oceans, seas, lakes, reservoirs, and rivers. Can be either fresh 
forrest@0
    97
   or salt water bodies. Note that this class has not been mapped directly from 
forrest@0
    98
   MODIS data in this provisional release. It is overlaid from a Digital Elevation 
forrest@0
    99
   Model (DEM) generated for the MODIS processing stream at the Jet Propulsion 
forrest@0
   100
   Laboratory (JPL). This has been adjusted to match the ISLSCP2 land/water masks.
forrest@0
   101
forrest@0
   102
1= Evergreen Needleleaf Forests: Lands dominated by trees with a percent canopy 
forrest@0
   103
   cover >60% and height exceeding 2 meters. Almost all trees remain green all 
forrest@0
   104
   year. Canopy is never without green foliage. 
forrest@0
   105
forrest@0
   106
2= Evergreen Broadleaf Forests: Lands dominated by trees with percent canopy 
forrest@0
   107
   cover >60% and height exceeding 2 meters. Almost all trees remain green year all 
forrest@0
   108
   year. Canopy is never without green foliage. 
forrest@0
   109
forrest@0
   110
3= Deciduous Needleleaf Forests: Lands dominated by trees with a percent canopy 
forrest@0
   111
   cover >60% and height exceeding 2 meters. Consists of seasonal needleleaf tree 
forrest@0
   112
   communities with an annual cycle of leaf-on and leaf-off periods. 
forrest@0
   113
forrest@0
   114
4= Deciduous Broadleaf Forests: Lands dominated by trees with a percent canopy 
forrest@0
   115
   cover >60% and height exceeding 2 meters. Consists of seasonal broadleaf tree 
forrest@0
   116
   communities with an annual cycle of leaf-on and leaf-off periods. 
forrest@0
   117
forrest@0
   118
5= Mixed Forests: Lands dominated by trees with a percent canopy cover >60% and 
forrest@0
   119
   height exceeding 2 meters. Consists of tree communities with interspersed 
forrest@0
   120
   mixtures or mosaics of the other four forest cover types. None of the forest 
forrest@0
   121
   types exceeds 60% of landscape. 
forrest@0
   122
forrest@0
   123
6= Closed Shrublands: Lands with woody vegetation less than 2 meters tall and 
forrest@0
   124
   with shrub canopy cover is >60%. The shrub foliage can be either evergreen or 
forrest@0
   125
   deciduous. 
forrest@0
   126
forrest@0
   127
7= Open Shrublands: Lands with woody vegetation less than 2 meters tall and with 
forrest@0
   128
   shrub canopy cover is between 10-60%. The shrub foliage can be either evergreen 
forrest@0
   129
   or deciduous. 
forrest@0
   130
forrest@0
   131
8= Woody Savannas: Lands with herbaceous and other understory systems and forest 
forrest@0
   132
   canopy cover of 30-60%. The forest cover height exceeds 2 meters. 
forrest@0
   133
forrest@0
   134
9= Savannas: Lands with herbaceous and other understory systems and forest canopy 
forrest@0
   135
   cover of 10-30%. The forest cover height exceeds 2 meters.
forrest@0
   136
 
forrest@0
   137
10=Grasslands: Lands with herbaceous types of cover. Tree and shrub cover is 
forrest@0
   138
   less than 10%. 
forrest@0
   139
forrest@0
   140
11=Permanent Wetlands: Lands with a permanent mixture of surface water and 
forrest@0
   141
   herbaceous or woody vegetation. The vegetation can be present in either salt, 
forrest@0
   142
   brackish, or fresh water. 
forrest@0
   143
forrest@0
   144
12=Croplands: Lands covered with temporary crops followed by harvest and a bare 
forrest@0
   145
   soil period (e.g., single and multiple cropping systems). Note that perennial 
forrest@0
   146
   woody crops will be classified as the appropriate forest or shrub land cover 
forrest@0
   147
   type. 
forrest@0
   148
forrest@0
   149
13=Urban and Built-Up: Land primarily covered by buildings and other man-made 
forrest@0
   150
   structures. Note that this class has not been mapped directly from MODIS data in 
forrest@0
   151
   this provisional release. It is overlaid from the populated places layer from 
forrest@0
   152
   the EDC Global Land Cover Characterization project (GLCC, 
forrest@0
   153
   http://edcdaac.usgs.gov/glcc/glcc.html). 
forrest@0
   154
forrest@0
   155
14=Cropland/Natural Vegetation Mosaic: Lands with a mosaic of croplands, 
forrest@0
   156
   forests, shrublands, and grasslands in which no one component comprises more 
forrest@0
   157
   than 60% of the landscape. 
forrest@0
   158
forrest@0
   159
15=Permanent Snow and Ice: Lands under snow and/or ice cover throughout the year. 
forrest@0
   160
forrest@0
   161
16=Barren or Sparsely Vegetated: Lands with exposed soil, sand, rocks, or snow 
forrest@0
   162
   that never has more than 10% vegetated cover during any time of the year. 
forrest@0
   163
forrest@0
   164
17=Unclassified: Artifacts due to discrepancies between the EDC GLCC water mask 
forrest@0
   165
   and the JPL DEM. Found in coastal zones and mid-ocean islands in this 
forrest@0
   166
   provisional release. 
forrest@0
   167
forrest@0
   168
################################################################################