Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
1
Date
15/11/2006
BELMANIP Database
PRODUCTS READ ME
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
2
Date
15/11/2006
For any questions, contact [email protected]
Adresse:
Patrice BICHERON,
POSTEL Service Centre
MEDIAS-France
18 av. Edouard Belin,
CNES, bpi2102
31401 TOULOUSE Cedex 9,
FRANCE
Phone : (33) 5 61 28 18 96
Fax : (33) 5 61 28 29 05
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Readme_BELMANIPextract_CYCLOPES-V3.1
Ref
Issue
1 Rev. 0
Page
3
Date
15/11/2006
Database structure
The Belmanip database encompasses 398 sites over the 1997-2003 period. Only 323 sites
have been extracted in this version. A yearly tar archive contains at the first level the 323 sites
indicated by a directory named as the reference site number. Each directory (ie a Belmanip
site) contains 36 tar files describing the CYCLOPES L3A (ie normalized spectral reflectance
and directional parameters) or L3B (ie biophysical parameters) extracted information over an
area of 51 x 51 km² (ie 51 x 51 pixels) centred on the site coordinates.
Name of the products
Field
Signification
Value
1
Project Acronym
CYCL
2
Type of product
3
Spatial Resolution
Refl for L3A products (directional parameters,
normalized reflectance)
BIO for LAI, fAPAR, fCover
1km
4
Product Version
V3.1 for version 3, release 1
5
Sensor used
VGT
7
Date of the product
Center of the temporal window (in julian day) at a
10 days frequency
8
Belmanip site number
Between 1 and 398
Location information
The file Extracted_BELMANIP_sites_I1.00.xls gives, for each site, the site name, the geographical
coordinates, the land cover type, the CYCLOPES tile where the site is located, and the ground
network which instruments the site. It may be downloaded on the POSTEL website
(http://postel.mediasfrance.org/en/download/documents). The main geographical features are
summarized below
Field
Description
projection
plate-carrée, WGS 84 (TR=Terrestrial Radius=
6378km)
pixels geographical coordinates
middle of the pixel. It means for example that if
you wish the real longitude of the upper left
corner, it corresponds to the pixel longitude –
angular resolution /2.
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
4
Date
15/11/2006
angular pixel resolution
1/112 degree
kilometric pixel resolution
high : constant = TR_equator x 2pi x (1/112) / 360
width : variable = TR_equator x cos (lat) x 2pi x
(1/112) / 360
Main physical status according to the level processing steps
Level processing
steps
Physical status
Residual bug or
complementary
information
L0->L1: Calibration
Calibration correction: improved calibration
coefficients (sensor reference POLDER 2) has been
applied for all the years
L1->L2: Status
Each observation may be:
-
invalid (out of orbit, cloudy, shadowed,
saturation)
-
valid either:
-
clear (all the spectral bands valid)
-
cloudy/shadowed
‘suspect’)
-
snowy with:
extended
(ie
-
all the spectral bands valid
-
some spectral bands invalid (B0
and/or B2 and/or B3)
L1->L2: Auxiliary Data
Correction of a spatial pixel shift (bug) in the spatial
interpolation of various fields: ozone, water vapour,
DTM, LMK, angles
L1->L2: Auxiliary Data
Monthly aerosol climatology derived from a mean
over 6 years aerosol monthly 1° x 1° MODIS data
with a threshold at 0.6 for each month. The gaps are
filled with a classical function of latitude.
The built map is then resampled
VEGETATION spatial resolution
at
the
L1->L2: Cloud spatial A global threshold method is applied independently
detection
of the surface type except for particular bright land
covers where a fine tuning of cloud detection has
been made. These bright land covers include:
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
5
Date
15/11/2006
barren, sparse herbaceous, artificial surfaces and
associated areas, mosaic cropland/shrub cover,
shrub cover
L1->L2: Cloud spatial As a cloudy pixel is detected, all the pixels over a 2
extension
x 2 radius are fixed to ‘invalid’ and pixels over a 3 x
3 radius are declared ‘suspect’
The cloudy pixels are not spatially extended over
snowy pixels
L1->L2:
detection
Snow Observations partly saturated in B0, B2 and B3 are Validated with a provided
taking into account to flag the snow
dataset over Europe but few
false detections appeared
over Equatorial Africa
(certainly a coding error)
L1->L2: Lakes
1) Salt lakes present at regional scale in GLC2000
maps have been integrated at global scale
2) Cloud detection is no more active over salt lakes
L2->L3A:
filtering
Temporal 1) There is no more temporal and angular weight in
the filtering procedure but only for the last
directional parameters assessment
2) The ‘suspect’ pixels are taking into account in the
temporal synthesis
3) Minimal Nmod value fixed to 2 whatever the
wavelength
If a pixel is detected as snow during the synthesis,
the temporal filtering is not applied since all
observations are not always valid whatever the
wavelength. The inversion of directional 3-kernels
model is performed only once for each wavelength
L2->L3A: Directional If several kind of observations status (snow, clear,
parameters assessment cloud) are present in the synthesis, the whole month
over snow
is chosen as reference to determine the status of the
synthesis (ie a pixel is detected as snow if the
number of snow observations is greater than clear
observations in the month)
L3A->L3B:
Biophysical parameters
The normalized reflectances are taken as inputs in The maximum fCover
the neural network if their spectral values are in the observed value seems to be
following validity domain
too low (max at 0.6) and
has to be corrected in a
B2: [0; 0.612]
future version 3.2
B3: [0; 0.916]
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
6
Date
15/11/2006
MIR: [0; 0.835]
L3A->L3B: Status
The bit 1 ‘Land/Sea’ indicates if the pixel is land or
sea
The bit 2 ‘Status’ indicates if the pixel is clear or
snowy
The bit 3 ‘Suspect’ indicates if the pixel is suspect
or not (see L1->L2 Cloud Spatial Extension)
The bit 4 ‘Aerosol status’ describes if pure
climatology (either MODIS products or a linear
latitudinal relationship) or a mixed of both has been
used for the atmospheric correction of observations
in the synthesis
The bit 5 ‘Aerosol source’ indicates the origin of
monthly aerosol climatology
The bit 6 ‘Parameter out of range or unvalid’ is
active (ie 1) if the biophysical parameter is out of
range ([0 6] for LAI; [0 1] for fCover and fAPAR)
or if no valid L3A product is available
The bit 7, bit 8 and bit 9 ‘Saturation B0/B2/B3’ is:
- ‘inactive’ if no saturated observation has
been removed in the synthesis for B0, B2,
B3,
- ‘active’ if saturated observations have been
removed from the temporal L3 fitting
present in B0, or B2 or B3 (but not for
MIR)
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
7
Date
15/11/2006
Level 3B products
BSQ (raw binary) files * BIO contain the products LAI, fAPAR, fCOVER, and their
associated errors plus NMOD, SM, LMK.
Ouput
Parameter
Description
Type
Dim
Domain
For each pixel of each tile
LAI
Leaf Area Index 1
Char
1
[0 ; 180]/30
255 = Invalid
253 = OutofRange_sup
254 = OutofRange_inf
fAPAR
Active Photosynthetically Absorbed Radiation Char
Fraction
1
[0 ; 250]/250
id for extremal values
fCover
Cover Fraction
Char
1
[0 ; 250]/250
id for extremal values
NMOD
Valid observations number during the
synthesis period
Char
1
[0; 60]
LMK
Land Cover map based on GLC2000
integrating salt lakes at global scale
Char
1
[0; 255]: 200 + classe
number of GLC2000
SM
Status :
Int
Bit 1 Land/Sea : 0(Land) / 1 (Sea)
Bit 2 Status: Clear 0 /Snow 1
Bit 3 Suspect: No Suspect 0 /Suspect 1
Bit 4 Aerosol status : Pure 0 / Mixed 1
Bit 5 Aerosol source: Modis 0 / Climato 1
Bit 6 Parameter out of range parameter or
invalid: 0 (ok) / 1 (no)
Bit 7 saturation B0 : 0 (ok) / 1 (saturated)
Bit 8 saturation B2 : 0 (ok) / 1 (saturated)
Bit 9 saturation B3: 0 (ok) / 1 (saturated)
1
[0 ; 255]
Err_Param
Parameter Uncertainty
3
[0; 255]/200 for LAI
id for extremal values
[0; 255]/250 for fCover,
fAPAR
id for extremal values
Char
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
8
Date
15/11/2006
Level 3A products
BSQ (raw binary) files * Refl contain the products REF_NOR, SZN, K0, K1, K2, COV, CC,
ERR, NMOD, SM, LMK
Ouput
Parameter
Description
Type
Dim
Domain
For each pixel of each tile
SZN
Sun solar normalization angle at 10:00 locally
Char
1
[0 ; 180]/2
NMOD
Valid observations number during the
synthesis period
Char
1
[0; 60]
LMK
Land Cover map based on GLC2000
integrating salt lakes at global scale
Char
1
[0; 255]: 200 +
classe number of
GLC2000
SM
Status :
Int
Bit 1 Land/Sea : 0(Land) / 1 (Sea)
Bit 2 Status: Clear 0 /Snow 1
Bit 3 Suspect: No Suspect 0 /Suspect 1
Bit 4 Aerosol status : Pure 0 / Mixed 1
Bit 5 Aerosol source: Modis 0/ Climato 1
Bit 6 Parameter out of range parameter or
invalid: 0 (ok) / 1 (no)
Bit 7 saturation B0 : 0 (ok) / 1 (saturated)
Bit 8 saturation B2 : 0 (ok) / 1 (saturated)
Bit 9 saturation B3: 0 (ok) / 1 (saturated)
1
[0 ; 255]
Signed
Short
1
[-0.1; 1.2]*2000
32767 for invalid
value
32766 for out of
range value by low
value
32765 for out of
range value by high
value
Signed
Short
1
[-0.1; 0.2]*2000
32767 for invalid
value
32766 for out of
range value by low
For each spectral band
K0(λ)
K1(λ)
Directional model parameters
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
9
Date
15/11/2006
value
32765 for out of
range value by high
value
K2(λ)
Signed 1
Short
[-0.2; 1.4]*2000
32767 for invalid
value
32766 for out of
range value by low
value
32765 for out of
range value by high
value
REF_NOR( Normalized reflectance for SZN and θv=0
λ)
Signed 1
Short
[-0.1;1.2]/2000
32767 for invalid
value
32766 for out of
range value by low
value
32765 for out of
range value by high
value
ERR(λ)
Root mean square of difference between
Char
modelled and measured reflectance divided by
the observation number
1
[0 ; 255] / 500
255 for invalid value
CC(λ)
Correlation coefficient between measured and Char
modelled reflectance
1
[0 ;255]/125 – 1
255 for invalid value
COV(λ)
Covariance matrix parameters of directional
model. The diagonal elements COVii of this
matrix represent the variance σ[ki] of the
respective parameters ki. The covariance
between ki and kj is given by the signed offdiagonal elements root mean square(Cij)
Signed 6
Short
[-32767 ;
32767]/10000
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.
Ref
Readme_BELMANIPextract_CYCLOPES-V3.1
Issue
1 Rev. 0
Page
10
Date
15/11/2006
© MEDIAS-France 2006
This document is the property of the CYCLOPES consortium, no part of it shall be reproduced or transmitted without the
express prior written authorisation of MEDIAS-France.