[TOC] [INTRO] [LEVEL 1A] [LEVEL 1B] [LEVEL 2] [LEVEL 3 MAP] [LEVEL 3 BINNED MAP]
[ADEOS HOME]

LEVEL 3 BINNED PRODUCT

Introduction
Naming Convention
Global Attributes
Level 3 Binned Data V Group in Main File
Level 3 Binned Data V group in Subordinate Files

Introduction

Level 3 Binned product data are integrated from Level 2 GAC data for specified period. Level 3 Binned products are classified into three products: ocean color, vegetation and sea surface temperature. There are products corresponding to the integration period of a day, a week, a month and a year. Each product is separated header and each datas. (note 1)

Ocean color product store following data:

Bin data
Normalized water-leaving radiance. (412nm, 443nm, 490nm, 520nm, 565nm), Aerosol radiance at (670nm, 765nm, 865nm), epsilon(670 : 865), and tau-a (865nm).
CZCS-like pigment concentration
Chlorophyll a concentration
Diffuse attenuation coefficient at 490nm
Integral chlorophyll a

Vegetation indices product stores following data.

Bin data.
Vegetation indices

Sea surface temperature product stores following data

Bin data.
Sea surface temperature

(note 1) If you try to access to multiple files of level 3Binned product by HDF libraries, all files must be stored current directory.

Note that the data types in throughout this document are expressed with followings:

Ch character line
Short 2 byte integer (signed)
Ushort 2 byte integer (unsigned)
Long 4 byte integer (signed)
Ulong 4 byte integer (unsigned)
Real 4 byte real number
Double 8 byte real number
Byte 1 byte integer

Ch	character line
Short	2 byte integer (signed)
Ushort	2 byte integer (unsigned)
Long	4 byte integer (signed)
Ulong	4 byte integer (unsigned)
Real	4 byte real number
Double	8 byte real number
Byte	1 byte integer

Naming Convention

Ocean color product	L3BOC$ (Bin data), L3BOC$.x00 (radiance, epsilon, tau-a), L3BOC$.x01(CZCS-like pigment), L3BOC$.x02 (chlorophyll a concentration), L3BOC$.x03 (Diffuse attenuation coefficient at 490nm), L3BOC$.x04 (Integral chlorophyll a)
Vegetation product	L3BVI$ (Bin data), L3BVI$.x00 (Vegetation indices)
Sea surface temperature product	L3BST$(Bin data), L3BST$.x00 (Sea surface temperature)

* $ is as follows:
'D' shows a day, 'W' shows a week, 'M' shows a month, 'Y' shows a year.

Structure of level 3 Binned product
Main File
Global Attributes
Level-3 Binned Data class: Planetary Grid
SEAGrid class: Geometry

registration straddle bins radius max_north max_south seam_lon

1 record

BinIndex class: Index

row_num vsize hsize start_num begin extent max

2160 records

BinList class: DataMain

bin_num nobs nscenes time_rec weights flags_set

n records

Subordinate Files
chlor_a_K_490
_sum _sum_sq
K_490
_sum _sum_sq
chlor_a
_sum _sum_sq
CZCS-pigment
_sum _sum_sq

nLw_412 - tau_865

_sum _sum_sq - _sum _sum_sq
n records n records

vegetation

_sum _sum_sq

n records

SST

_sum _sum_sq

n records

V group name (Tag = VG) V group class
refer Naming Convention CDF0.0

V group name (Tag = VG)	V group class
refer Naming Convention	CDF0.0

Mission and Documentation

[oc] : Ocean Color, [vi] : Vegetation Indices, [st] : Sea Surface Temperature

V data name
(Tag = VH) Nb of data Type Size
(bytes) Data (Tag = VS) Contents
Product Name 1 Ch 7 / 11 refer Naming Convention The name of the product file (without path)
Title 1 Ch 25 "OCTS Level-3 Binned Data"
Data Center 1 Ch 31 "NASDA/Earth Observation Center" OCTS Data Processing Center (National Space Development Agency of Japan)
Mission 1 Ch 11 "ADEOS OCTS" Mission (satellite name and sensor name)
Mission Characteristics 1 Ch 189 "Nominal orbit: inclination = 98.59 (Sun-Synchronous); node = 10:15-10:45 AM (descending); eccentricity <= 0.0012; altitude = 797km; ground speed = 6.6km/sec; revolutions per day = 14+11/41"
Sensor 1 Ch 43 "Ocean Color and Temperature Scanner (OCTS)"
Sensor Characteristics 1 Ch 123 "Number of bands = 12; number of detectors per band = 10; bits per pixel = 10; scan period = 0.905sec; bit rate = 3Mbit/sec"
Product Type 1 Ch 4 "day"
5 "week"
6 "month"
5 "year"
Data Sub-type 1 Ch 12 "Ocean Color"
19 "Vegetation Indices"
24 "Sea Surface Temperature"
Replacement Flag 1 Ch 9 "ORIGINAL" If this is the first version of this product delivered to the NASDA/EOC.
Software ID 1 Ch 4
"X Y"
Identities version of the operational software used to create this product.
X : OCTS software version
Y : OCTS database version
Processing Time 1 Ch 22 YYYYMMDD hh:mm:ss.ttt Local time of generation of this product.
Processing Control 1 Ch over 111 refer Process Product Order (OCTS-bin) All input and processing control parameters used by the calling program to generate the product.
Processing Log 1 Ch 160 refer Process Work Result (OCTS) Processing status information.
L2 Flag Usage 1 Ch 139 : [oc] "AEROSOL1, LOWLW1, HIGHTAU1, SOLZEN1, TURBIDW1, COCCOLITH1, CLDICE1, INCPLTSET1, NEGLW1, COASTZ1, SATZEN1, BRIGHT1, SUNGLINT1, NEARCLOUD1, LAND1, EPSILON1" : [oc] List of algorithm names (each separated by one comma) for the bits (masks and flags) in the parent Level-2 products.
56 : [vi] "INCPLTSET1, OCEAN1,SCANANG1, OCEANGAIN1, SATURATE1, BRIGHT1" : [vi]
51 : [st] "INCPLTSET1, LAND1, IRCLOUD1, SURFWIND1, EMIANG1, SSTQC1" : [st]
L2 Engineering Quality Usage 24 Byte 24 Flags for showing emergency telemetry. (For bits in the array that are set (=1), the corresponding bit in the parent Level-2 products' "eng_qual" values are used for exclusion during binning.

V data name (Tag = VH)	Nb of data	Type	Size (bytes)	Data (Tag = VS)	Contents
Product Name	1	Ch	7 / 11	refer Naming Convention	The name of the product file (without path)
Title	1	Ch	25	"OCTS Level-3 Binned Data"
Data Center	1	Ch	31	"NASDA/Earth Observation Center"	OCTS Data Processing Center (National Space Development Agency of Japan)
Mission	1	Ch	11	"ADEOS OCTS"	Mission (satellite name and sensor name)
Mission Characteristics	1	Ch	189	"Nominal orbit: inclination = 98.59 (Sun-Synchronous); node = 10:15-10:45 AM (descending); eccentricity <= 0.0012; altitude = 797km; ground speed = 6.6km/sec; revolutions per day = 14+11/41"
Sensor	1	Ch	43	"Ocean Color and Temperature Scanner (OCTS)"
Sensor Characteristics	1	Ch	123	"Number of bands = 12; number of detectors per band = 10; bits per pixel = 10; scan period = 0.905sec; bit rate = 3Mbit/sec"
Product Type	1	Ch	4	"day"
5	"week"
6	"month"
5	"year"
Data Sub-type	1	Ch	12	"Ocean Color"
19	"Vegetation Indices"
24	"Sea Surface Temperature"
Replacement Flag	1	Ch	9	"ORIGINAL"	If this is the first version of this product delivered to the NASDA/EOC.
Software ID	1	Ch	4	"X Y"	Identities version of the operational software used to create this product. X : OCTS software version Y : OCTS database version
Processing Time	1	Ch	22	YYYYMMDD hh:mm:ss.ttt	Local time of generation of this product.
Processing Control	1	Ch	over 111	refer Process Product Order (OCTS-bin)	All input and processing control parameters used by the calling program to generate the product.
Processing Log	1	Ch	160	refer Process Work Result (OCTS)	Processing status information.
L2 Flag Usage	1	Ch	139 : [oc]	"AEROSOL1, LOWLW1, HIGHTAU1, SOLZEN1, TURBIDW1, COCCOLITH1, CLDICE1, INCPLTSET1, NEGLW1, COASTZ1, SATZEN1, BRIGHT1, SUNGLINT1, NEARCLOUD1, LAND1, EPSILON1" : [oc]	List of algorithm names (each separated by one comma) for the bits (masks and flags) in the parent Level-2 products.
56 : [vi]	"INCPLTSET1, OCEAN1,SCANANG1, OCEANGAIN1, SATURATE1, BRIGHT1" : [vi]
51 : [st]	"INCPLTSET1, LAND1, IRCLOUD1, SURFWIND1, EMIANG1, SSTQC1" : [st]
L2 Engineering Quality Usage	24	Byte	24		Flags for showing emergency telemetry. (For bits in the array that are set (=1), the corresponding bit in the parent Level-2 products' "eng_qual" values are used for exclusion during binning.

Data Time

V data name (Tag = VH)	Nb of data	Type	Size (bytes)	Data (Tag = VS)	Contents
Period Start Year	1	Short	2		Year of start of binning period (cf. "Start Year"); used for interpreting "time_rec" of Vdata "BinList".
Period Start Day	1	Short	2		GMT day-of year of start of binning period (cf. "Start Day") used for interpreting "time_rec" of Vdata "BinList".
Period End Year	1	Short	2		Year of end of binning period (cf. "End Year"); used for interpreting "time_rec" of Vdata "BinList".
Period End Day	1	Short	2		GMT day-of year of end of binning period (cf. "End Day") used for interpreting "time_rec" of Vdata "BinList".
Start Time	1	Ch	22	YYYYMMDD hh:mm:ss.ttt	Start GMT of earliest input product.
End Time	1	Ch	22	YYYYMMDD hh:mm:ss.ttt	End GMT of latest input product.
Start Year	1	Short	2		GMT year of data start for earliest input product.
Start Day	1	Short	2		GMT day-of-year of data start for earliest input product.
Start Millisec	1	Long	4		GMT milliseconds-of-day of data start for latest input product.
End Year	1	Short	2		GMT year of data start for latest input product.
End Day	1	Short	2		GMT day-of-year of data start for latest input product.
End Millisec	1	Long	4		GMT milliseconds-of-day of data start for latest input product.

Data Explanation

V data name (Tag = VH)	Nb of data	Type	Size (bytes)	Data (Tag = VS)	Contents
Latitude Units	1	Ch	14	"degrees North"	Units used for all lat. values in this product.
Longitude Units	1	Ch	13	"degrees East"	Units used for all long. values in this product.
Data Bins	1	Long	4		Number of bins in this product. (1 - 5940422)
Percent Data Bins	1	Real	4		Percentage of number of bins in this product by number of total bins. ( Data Bins x 100 / 5940422 )

Level 3 Binned Data V Group in Main File

Vdata SEAGrid of Class Geometry
Vdata BinIndex of Class Index
Vdata BinList of Class DataMain

The Level 3 Binned product V data listed in each subsection bellow belong to the V group Level 3 Binned Data which is of class Planetary Grid. For OCTS Level 3 Binned products, this V group is spread over multiple HDF files. Ocean color product consists of a main file and 5 subordinate files and vegetation product and sea surface temperature product consists of a main file and only one subordinate file. If you try to access to these main file and subordinate files by HDF libraries, all files must be stored on current directory.

The main file contains the global attributes described above as well as the V data described in this subsection.

V group name (Tag = VG) V group class
Level-3 Binned Data PlanetaryGrid

V group name (Tag = VG)	V group class
Level-3 Binned Data	PlanetaryGrid

Vdata SEAGrid of Class Geometry

This Vdata contains information needed for description of the geographic binning scheme to HDF access software and may not be useful to most users.

V data name
(Tag = VH)
[class name] Field name Dimension Type Size
(bytes) Data
(Tag = VS) Contents
SEAGrid
[ Geometry ] registration 1 Long 4 5 Location of characteristic point within bin.
straddle 1 Long 4 0 (no) Does a latitudinal band straddle the equator?
bins 1 Long 4 4320 Number of equatorial bins.
radius 1 Double 8 6378.137 Earth's radius in kilometers.
max_north 1 Double 8 90.0 Northernmost latitude in grid.
max_south 1 Double 8 -90.0 Southernmost latitude in grid.
seam_lon 1 Double 8 -180.0 Longitude of westernmost edge of grid

V data name (Tag = VH) [class name]	Field name	Dimension	Type	Size (bytes)	Data (Tag = VS)	Contents
SEAGrid [ Geometry ]	registration	1	Long	4	5	Location of characteristic point within bin.
straddle	1	Long	4	0 (no)	Does a latitudinal band straddle the equator?
bins	1	Long	4	4320	Number of equatorial bins.
radius	1	Double	8	6378.137	Earth's radius in kilometers.
max_north	1	Double	8	90.0	Northernmost latitude in grid.
max_south	1	Double	8	-90.0	Southernmost latitude in grid.
seam_lon	1	Double	8	-180.0	Longitude of westernmost edge of grid

Vdata BinIndex of Class Index

Vdata "BinIndex" of class "Index" contains one record of the following fields for each of the 2,160 latitudinal bin rows in the geographic binning scheme. This Vdata contains information needed for description of the geographic binning scheme to HDF access software and may not be useful to most users.

V data name
(Tag = VH)
[class name] Field name Dimension Type Size
(bytes) Data
(Tag = VS) Contents
BinIndex
[ Index ] row_num 2160 Long 8640 0 ~ 2159 Index of row corresponding to each "BinIndex" record.
vsize 2160 Double 17280 0.0833333 (1/12 degree) North-south extent (degrees latitude) of bins for each row.
hsize 2160 Double 17280 0.0833333 ~ 120.0 East-west extent (degrees longitude) of bins for each row.
start_num 2160 Long 8640 1 ~ 5940420 Bin number of first bin in the grid for each row (cf. "begin"); always the same set of values for the set of rows: 1 for row 0, 4 for row 1,...,5940420 for row 2159.
begin 2160 Long 8640 1 ~ 5940420 Bin number of first data containing bin for each row (cf. "start_num").
extent 2160 Long 8640 Number of bins actually stored (i.e., containing data) for each row.
max 2160 Long 8640 3 ~ 4320 The maximum number of bins in the grid for each row.

V data name (Tag = VH) [class name]	Field name	Dimension	Type	Size (bytes)	Data (Tag = VS)	Contents
BinIndex [ Index ]	row_num	2160	Long	8640	0 ~ 2159	Index of row corresponding to each "BinIndex" record.
vsize	2160	Double	17280	0.0833333 (1/12 degree)	North-south extent (degrees latitude) of bins for each row.
hsize	2160	Double	17280	0.0833333 ~ 120.0	East-west extent (degrees longitude) of bins for each row.
start_num	2160	Long	8640	1 ~ 5940420	Bin number of first bin in the grid for each row (cf. "begin"); always the same set of values for the set of rows: 1 for row 0, 4 for row 1,...,5940420 for row 2159.
begin	2160	Long	8640	1 ~ 5940420	Bin number of first data containing bin for each row (cf. "start_num").
extent	2160	Long	8640		Number of bins actually stored (i.e., containing data) for each row.
max	2160	Long	8640	3 ~ 4320	The maximum number of bins in the grid for each row.

Vdata BinList of Class DataMain

Vdata "BinList" of class "DataMain" contains one record of the following fields for each bin in which at least one pixel was binned. Records for bins in which no pixels were binned ("nsamps" = 0) are excluded from the product.

n : number of bins (value of "extent")

V data name
(Tag = VH)
[class name] Field name Dimension Type Size
(bytes) Data
(Tag = VS) Contents
BinList
[ DataMain ] bin_num n Long 4x 1 ~ 5940422 The index number of the bin represented by this record and corresponding records in each of the Vdatas of class "DataSubordinate.
nobs n Short 2xn Number of observations (pixels) binned in this bin.
nscenes n Short 2xn Number of scenes contributing data (at least one pixel) to this bin.
time_rec n Short 2xn The bit sequence represents the time distribution of the data binned in this bin; the bits represent consecutive time in the binning period (as defined by the gloval attributes "Period Start Year", "Period Start Day", "Period End Year", and "Period End Day"), the lowest bin being the earliest; for daily products, bits correspond to the relative sequence of orbits binned; for weekly products, each bit represents one day; for monthly products, each bit represents two days; for yearly products, each bit represents on calendar month; a bit is set (=1) only if data for the time corresponding to that bit were binned in this bin.
weights n Real 4xn Sum of the weights of the equivalent bins of the input products.
flags_set n Short 2xn 16 bits in two bytes corresponding to those of the parent Level-2 products' "l2_flags" for Ocean Color, "VI" for Vegetation Indices, or "SST" for Sea Surface Temperature.

V data name (Tag = VH) [class name]	Field name	Dimension	Type	Size (bytes)	Data (Tag = VS)	Contents
BinList [ DataMain ]	bin_num	n	Long	4x	1 ~ 5940422	The index number of the bin represented by this record and corresponding records in each of the Vdatas of class "DataSubordinate.
nobs	n	Short	2xn		Number of observations (pixels) binned in this bin.
nscenes	n	Short	2xn		Number of scenes contributing data (at least one pixel) to this bin.
time_rec	n	Short	2xn		The bit sequence represents the time distribution of the data binned in this bin; the bits represent consecutive time in the binning period (as defined by the gloval attributes "Period Start Year", "Period Start Day", "Period End Year", and "Period End Day"), the lowest bin being the earliest; for daily products, bits correspond to the relative sequence of orbits binned; for weekly products, each bit represents one day; for monthly products, each bit represents two days; for yearly products, each bit represents on calendar month; a bit is set (=1) only if data for the time corresponding to that bit were binned in this bin.
weights	n	Real	4xn		Sum of the weights of the equivalent bins of the input products.
flags_set	n	Short	2xn		16 bits in two bytes corresponding to those of the parent Level-2 products' "l2_flags" for Ocean Color, "VI" for Vegetation Indices, or "SST" for Sea Surface Temperature.

Level 3 Binned Data V group in Subordinate Files

Ocean Color
Vegetation indices
Sea Surface Temperature

The Level 3 binned product V data listed below belong to the V group Level 3 Binned Data which is of class Planetary Grid. For OCTS Level 3 binned products, the V group is spread over multiple HDF files: a main file and subordinate files. If you try to access to these main file and subordinate files by HDF libraries, all files must be stored on current directory.

Each subordinate file consists of one or several V data of class Data Subordinate and each V data is named for the geophysical quality being binned as follows :

Ocean Color Product

nLw_412	normalized water-leaving radiance (mW cm-2 mm-1 sr-1) at 412 nm
nLw_443	normalized water-leaving radiance (mW cm-2 mm-1 sr-1) at 443 nm
nLw_490	normalized water-leaving radiance (mW cm-2 mm-1 sr-1) at 490 nm
nLw_520	normalized water-leaving radiance (mW cm-2 mm-1 sr-1) at 520 nm
nLw_565	normalized water-leaving radiance (mW cm-2 mm-1 sr-1) at 565 nm
La_670	aerosol radiance (mW cm-2 mm-1 sr-1) at 670 nm
La_765	aerosol radiance (mW cm-2 mm-1 sr-1) at 765 nm
La_865	aerosol radiance (mW cm-2 mm-1 sr-1) at 865 nm
epsilon	epsilon of aerosol collection
tau_865	aerosol optical thickness at 865 nm
Above 10 parameters are stored in one subordinate file.
CZCS_pigment	CZCS-like pigment concentration (mg m-3)
chlor_a	chlorophyll a concentration (mg m-3)
K_490	diffuse attenuation coefficient (m-1) at 490 nm
chlor_a_K_490	integral chlorophyll (mg m-2), calculated using the Level 2 values chlorophyll a divided by K (490).

Vegetation
vegetation : vegetation indices

Sea surface Temperature

SST :

sea surface temperature (K)

For each file containing a Vdata of the class Data Subordinate, the name of the main file (same as content of the global attribute Product Name) is written in ASCII starting with the first byte of the file byte 0. The data records of these V data start at byte 512 in each file. (TBD) Each V data contains two fields, the names of which are made up of the name of the V data itself concatenated with _sum and _sum_sq, as, for example, nLw_412_sum and nLw_412_sum_sq.

V group name (Tag = VG) V group class
Level-3 Binned Data PlanetaryGrid

V group name (Tag = VG)	V group class
Level-3 Binned Data	PlanetaryGrid