GCOM-W1
AMSR2 Product I/O Tool Kit (AMTK)
Operation manualChange record
Issue

Date

Sheet

Description of changeNC

2010/3－－

1.11

2013/01/24－

First Release

1.12

2013/05/13－

Fixed typo

1.13

2013/12/03－

To change the scale factor of Precipitation.
0.1→0.01

1.14

2015/03/26－

Revise the definition of the missing value.
Revise the definition of the AM2_DEF_RMISS value.
-9999.00->-9999.99iContents
1 HDF library and AMSR2 I/O Tool kit ......................................................................................... 1-1
1.1 About HDF ........................................................................................................................... 1-1
1.2 About AMTK ........................................................................................................................ 1-2
2 Installing HDF library and AMTK............................................................................................... 2-1
2.1 Installing HDF library ........................................................................................................... 2-1
2.1.1 Getting HDF5 library ..................................................................................................... 2-1
2.1.2 Installing HDF5 (sz library) ........................................................................................... 2-1
2.1.3 Installing HDF library(binary) ........................................................................................ 2-2
2.1.4 Installing HDF library(source code base) ....................................................................... 2-3
2.2 Installing AMTK................................................................................................................... 2-5
2.2.1 Installing AMTK on Linux ............................................................................................. 2-5
2.2.2 Installing AMTK on UNIX ............................................................................................. 2-7
2.3 Execution environment setting of AMTK ........................................................................... 2-10
2.4 About leap second file ........................................................................................................ 2-11
2.5 Geophysical quantity definition file .................................................................................... 2-11
3 Programming using AMTK ......................................................................................................... 3-1
3.1 Flow of programming ........................................................................................................... 3-1
3.2 C programming ..................................................................................................................... 3-3
3.2.1 C sample programming .................................................................................................. 3-3
3.2.2 Description of programming ........................................................................................... 3-3
3.2.3 C sample (sample1.c) program ....................................................................................... 3-6
3.2.4 Compile and executions ................................................................................................. 3-7
3.3 Fortran Programing ............................................................................................................... 3-9
3.3.1 Fortran sample program ................................................................................................. 3-9
3.3.2 Description of programming ........................................................................................... 3-9
3.3.3 Fortran(sample1_f) Sample program ............................................................................ 3-12
3.3.4 Compilations and executions ........................................................................................ 3-13
4 Function composition .................................................................................................................. 4-1
5 API of function ............................................................................................................................ 5-1
5.1 C- Language ......................................................................................................................... 5-1
5.1.1 Common function ........................................................................................................... 5-1
5.1.2 Input functions ............................................................................................................. 5-13
5.1.3 Output functions ........................................................................................................... 5-15
5.2 Fortran ................................................................................................................................ 5-16
5.2.1 Common function ......................................................................................................... 5-16
5.2.2 Input functions ............................................................................................................. 5-28
5.2.3 Output function ............................................................................................................ 5-30
5.3 Scan number ....................................................................................................................... 5-31
5.4 Stored value ........................................................................................................................ 5-35
6 In/Out-put data ............................................................................................................................ 6-1
6.1 Data definition ...................................................................................................................... 6-1(i)6.1.1 HDF access lavel ............................................................................................................ 6-1
6.1.2 Geophysical quantity dataset ........................................................................................ 6-39
6.1.3 Product related iformation ............................................................................................ 6-52
6.2 L1 ,L2 ,L3 Common data .................................................................................................... 6-53
7 Error Number ID ......................................................................................................................... 7-1(ii)

HDF library and AMSR2 I/O Tool kit

1

AMSR2 I/O Tool kit(AMTK)is offered to use AMSR2 product data, which is the dataof Global Change Observation Mission 1 st –Water, with a software program developedby C-language or FORTRAN. AMSER2 product is classified into Level 1 to 3 and thedata stored in the data format HDF (Hierarchical Data Format). AMTK can be easily
accessed to the AMSR2 product data of HDF.

About HDF
All of the AMSR2 product data are stored in the data format of HDF.

1.1

HDF is the data format which doesn't depend on the user's computer compositio
n developed by NCSA (The National Center for Supercomputing Applications: Illin
ois University) to use the information. The HDF file has the HDF4 form and the
HDF5 form, and HDF5 completely reviews the problem of HDF4 (data type of t
wo or more kinds of that there is a limitation in the data size etc.) and is being
offered. The file format of HDF5 is applied in the AMSR2 product. AMTK accesses the file of HDF5, and acquires (input function) or sets (output function) inform
ation specified by the user program.
The HDF file is divided into Attribute part containing attribute information andDataset part containing product information. The Attribute part of AMSR2 produ
ct contains the metta data and the Dataset part contains the product data such as observation data and latitude longitude data.

AMSR2 productAttribute

Attribute information
Brightness
Observattemperature
ion Observat
data
Brightness
ion Observat
data
temperature
ion data

HDF5

1-1

Dataset図 1.1-1 HDF File composition
About AMTKAMTK is a toolkit developed to access the AMSR2 product data, the DEM file, and1.2

the weather file easily on C language and the Fortran language program. AMTK is
composed of the I/O function group of AMSR2 product information.
The way to access to HDF is to open the HDF file, specify identifier (hid_t) returnedby this opening, and input and output information on Attribute and each Dataset.
Dataset is specified by using the HDF identification number (Please refer to Chapter
6.1.1 for details) to identify two or more Dataset in AMTK.

(1) Requirements

AMTK runs under the environment shown in table 1.2-1.

Table 1.2-1 Requirements
Item

DELL4

OS

Red Hat Enterprise Linux Client release 5(Tikanga)
C Language

compilergcc, g++Intel C++
CompilerRAM

Sun-Fire-V440

Fortrang77, g95 (*1)
f77, f95
Intel Fortran Compiler
PGI Fortran Compiler
12GB

HDF Library

SGI Origin2000

SunOS 5.9

IRIX64 6.5

Sun Studio 11

MIPSpro Compilers:
Version 7.30

8GB

1GB

HDF5-1.8.4-patch1 (*2)(*1)AMTK using g95 compiler is shown below website.
Linux x86_64/EMT64 (32 bit D.I.)

Default integer of 32 bits, compatible with older programs(*2)Sun-Fire-V440 is compiled from source code.
You need to make changes to some parts of source code of HDF library before compile SGI
Origin2000. Refer to the 2.1 Installing HDF library section.

(2) Platform

AMTK supports both 32 / 64 bits machines.

(3) Language and Compiler

AMTK is used with language and compiler to show in Table 1.2-2

Table 1.2-2
OS

C-Language

RedHatEnterpriseLinuxgcc, g++Intel C++ Compiler

IRIX64

IRIX CC

Language and Compiler
FORTRAN
Fortran77
g77, f77
Intel Fortran Compiler
PGI FORTRAN77
IRX FORTRAN77

1-2

Fortran95
g95, f95
PGI FORTRAN90/95
MIPSproCompilers:Version 7.30

Solaris Sun
OS

Sun Studio 11 C

Sun Studio 11

1-3

Sun Studio 11 Fortran2

Installing HDF library and AMTKThe AMSR2 product data is made by using Release 1.8.4 Patch1 in the HDF5 library. Here, it explains the installation of Release 1.8.4 Patch1 in the HDF5 libr
ary.
Installing HDF library
There are two kinds of methods to install the HDF library. One is to install the compiled binary

2.1

data of Release 1.8.4 Patch1 and the other is to install the source code of the HDF library.

2.1.1

Getting HDF5 library
The HDF5 library is obtained from the homepage of the HDF group. The homepageof the latest HDF5 library version is shown below.
http://www.hdfgroup.org/HDF5/release/obtain5.html#obtain
The table shows the object of the download in March, 2010. Please obtain the HDF5
library corresponding to computer and OS used.

Table 2.1-1
Platform
All Platform
Linux 2.6 i686
Linux 2.6 x86_64
Solaris 2.10 (32-bit)

HDF5 library

Download File namesrc/hdf5-1.8.4-patch1.tar.gz
hdf5-1.8.4-patch1-linux-shared.tar.gz
hdf5-1.8.4-patch1-linux-x86_64-shared.tar.gz
hdf5-1.8.4-patch1-solaris-shared.tar.gz

Remarksource code
Binary(common)
Binary(common)binary(common)

Because the sz library is used in HDF5, it is necessary to obtain it for
szip-2.1.tar.gz separately.

Talbe 2.1-2

sz library

At the obtaining destination

Remarkftp://ftp.hdfgroup.org/lib-external/szip/2.1/src/

2.1.2

Installing HDF5 (sz library)
Here, it explains for the platform of Linux2.6.

(1) Getting library
Get

the

szip-2.1.tar.gz

file

and

Linux

2.6

i686(hdf5-1.8.4-patch1-linux-shared.tar.gz).

(2) Installing SZ library

Uncompress the szip-2.1.tar.gz file and install. The example of installing the sz
library in/usr/local/lib is shown as follows.

2-1

$ tar xzf szip-2.1.tar.gz$ cd szip-2.1/$ ./configure –prefix=/usr/local$ makeNeed to be super user!
# make install

2.1.3

Installing HDF library(binary)Uncompress hdf5-1.8.4-patch1-linux-shared.tar.gz$ tar xzf hdf5-1.8.4-patch1-linux-shared.tar.gz

When the above command is executed, the directory named hdf5-1.8.4-patch1-linux-shared is made. The file and the directory shown in Table 2.2-1 are deployed inthis directory.

Table 2.1-1 HDF libraryNamefile orContents

Remarkdirectory
COPYINGREADME

File
File

It is Copyright Notice
Easy use and sz library is explained.

RELEASE.txt

File

It is release memo.

binDirectory

The directory deployed HDF tool

includeDirectory

The directory deployed include files

libDirectory

The directory deployed library

The file related to HDF is not cared about in any directory because the include fil
e of HDF and the directory of the library are specified with the installer of AMTK.
To put it together on the Description of the installation of AMTK, it will put it on the directory of/HDF5/shared here.

2-2

# mkdir /HDF5# mkdir sharedThis directory must be made by super user.

$ cd hdf5-1.8.4-patch1-linux-shared$ cp –r include/ /HDF5/shared

Copy HDF related files$ cp –r lib/ /HDF5/shared

2.1.4

Installing HDF library(source code base)Uncompress hdf5-1.8.4-patch1.tar.gz.

$ tar xzf hdf5-1.8.4-patch1.tar.gz
For example, install HDF5 library to “/HDF5/shared” directory.
# cd hdf5-1.8.4-patch1

Set install directory. And compile HDF5 library.

# ./configure --prefix=/HDF5/shared# make# make install○ Installation of SGI environment
When you install HDF5 library in SGI(IRIX64 / MIPSpro Compilers) environm
ent, you may fault installtion as shown below.
92 errors detected in the compilation of "h5tools.c".
*** Error code 1 (bu21)*** Error code 1 (bu21)

These messages mean compiling error.

*** Error code 1 (bu21)
In this case, this probrem may clear with a modification.
1) Edit the hdf5-1.8.4-patch1/tools/lib/h5tools_error.h file with any editer application.
2) Modify the sentence as below in 35 lines in the file.
・Before: #error "We need __func__ or __FUNCTION__ to test function names!
"
・After : #define "We need __func__ or __FUNCTION__ to test function names!
"
3) Compile as below command.

2-3

# ./configure --prefix=/HDF5/shared CFLAGS=-64# make# make install

Set install directory and add “-64” option in
CFLAGS.

2-4

Installing AMTK

2.2
2.2.1

Installing AMTK on Linux(1) Development of file

Uncompress AMTK_AMSR2_Ver1.13.tar.gz file and deploy the files$ tar xzf AMTK_AMSR2_Ver1.13.tar.gz
When the above command is executed, the directory named AMTK_AMSR2 is made. In this directory, it is Table 2.2 The file and the directory of three are prog
ressed.

Table 2.2-1

The comtents in AMTK

Name
Makefile.inautom4te.cash
config.gessconfig.sub
configureconfigure.ininstall-sh

file or directory
File

Contents
It is installer for AMTK

include/Directorylib/

Directory

src/

Directory

sample/Directory

It is a directory deployed the include file of AMTK.
It is a directory deployed the include file of AMTK library.
It is a directory deployed the include file of AMTK source code.
It is a directory deployed the include file of sample program.

share/

Directory

Common configure files are stored.

RemarkThe leap second file isstored.
sample/data/leapsec.dat
Refer to the 2.3 section.

(2) Installing library

After it moves to the directory of AMTK, the installer of AMTK (configure command) is executed. In the installer, Makefile that suits the machine environmentis generated.
$ ./configure
If it is an installation of usual HDF, it is not necessary to specify it because t
he filerelated to following HDF is retrieved with the installer.
○HDF include file.
2-5

Hdf5.h under /*/*/include or /*/*/*/include
If you installed it to arbitrary directory, set below commands.
○HDF library file--with-hdf-lib=/HDF5/shread/lib○HDF include file--with-hdf-include=/HDF5/shread/include
Afterwards, the make command is executed by using generated Makefile.
$ make
The example of the continuation of the configure command and the make command execution is shown.

2-6

$ ./configure
checking build system type... i686-redhat-linux-gnu
checking host system type... i686-redhat-linux-gnu
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yeschecking whether we are cross compiling... nochecking for suffix of executables...
checking for suffix of object files... ochecking whether we are using the GNU C compiler... yeschecking whether gcc accepts -g... yeschecking for gcc option to accept ANSI C... none needed/HDF5/shared/lib/HDF5/shared/include
configure: creating ./config.statusconfig.status: creating Makefile(run compile)$ makegcc -c src/amtk_get.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/amtk_get.o -I./include-I/HDF5/shared/include -I./src
gcc -c src/amtk_set.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/amtk_set.o -I./include-I/HDF5/shared/include -I./src
gcc -c src/amtk_hdf.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/amtk_hdf.o -I./include-I/HDF5/shared/include -I./src
gcc -c src/amtk_latlon.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/amtk_latlon.o -I./include-I/HDF5/shared/include -I./src
gcc -c src/amtk_scantime.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/amtk_scantime.o -I./include-I/HDF5/shared/include -I./src
gcc -c src/IOTK_common.c -g -DDBG -DLINUX -ansi -g -DDBG -o src/IOTK_common.o -I./include-I/HDF5/shared/include -I./src
arcr ./lib/libAMSR2.a ./src/amtk_get.o ./src/amtk_set.o ./src/amtk_hdf.o ./src/amtk_latlon.o ./src/amtk_scantime.o./src/IOTK_common.orm ./src/*.o

The library making is confirmed. Making the AMTK library ends if lib directoryunder libAMSR2.a is made.
$ ls –l /home/amtk/AMTK /lib
Total 208
-rw-r--r-- 1 amtk amtk 204672

2.2.2

25 July 19:01 libAMSR2.a

Installing AMTK on UNIX

(1) Development of file

Uncompress AMTK_AMSR2_Ver1.12.tar.gz file and deploy the files

2-7

$ tar xzf AMTK_AMSR2_Ver1.12.tar.gz
When the above command is executed, the directory named AMTK_AMSR2 is made. In this directory, it is Table 2.3 the file and the directory of three are progr
essed.

Table 2.2-3
Namefile orThe comtents in AMTK
Contents

Remarkdirectory
Makefile.inautom4te.cash
config.gessconfig.sub
configureconfigure.ininstall-sh

File

It is installer for AMTK

include/Directorylib/

Directory

src/

Directory

sample/Directory

It is a directory deployed the include
file of AMTK.
It is a directory deployed the include
file of AMTK library.
It is a directory deployed the include
file of AMTK source code.
It is a directory deployed the include
file of sample program.

share/

Directory

Common configure files are stored.

2-8

The leap second file isstored.
sample/data/leapsec.dat
Refer to the 2.3 section.

(2) Installing library

After it moves to the directory of AMTK, Makefile that suits the machine envir
onment is made. Makefile.in is copied, and the model of Makefile is made.
# cp Makefile.in Makefile

Please change the following items of Makefile in the editor.
 CC
CC= cc CFLAGCFLAGS=-DSGI –xansi –O –s -64

in the case of SGI

CFLAGS=- DSunOS –Xc –xO2 –lnsl

in the case of Sun

 HDF Directory
Directory where HDFINC=HDF include file exists
The make command is executed. The execution example is shown in the followi
ng.

2-9

(run compile)$ makecc -c src/amtk_get.c -DSunOS -xO2 -lnsl -o src/amtk_get.o -I./include -I/HDF5/shared/include -I./src
cc -c src/amtk_set.c -DSunOS -xO2 -lnsl -o src/amtk_set.o -I./include -I/HDF5/shared/include -I./src
cc -c src/amtk_hdf.c -DSunOS -xO2 -lnsl -o src/amtk_hdf.o -I./include -I/HDF5/shared/include -I./src
cc -c src/amtk_latlon.c -DSunOS -xO2 -lnsl -o src/amtk_latlon.o -I./include -I/HDF5/shared/include -I./src
cc -c src/amtk_scantime.c -DSunOS -xO2 -lnsl -o src/amtk_scantime.o -I./include -I/HDF5/shared/include-I./src
cc -c src/IOTK_common.c -DSunOS -xO2 -lnsl -o src/IOTK_common.o -I./include -I/HDF5/shared/include-I./srcarcr ./lib/libAMSR2.a ./src/amtk_get.o ./src/amtk_set.o ./src/amtk_hdf.o ./src/amtk_latlon.o ./src/amtk_scantime.o./src/IOTK_common.orm ./src/*.o

The library making is confirmed. Making the AMTK library ends if lib directoryunder libAMSR2.a is made.
$ ls –l /home/amtk/AMTK /lib
Total 208
-rw-r--r-- 1 amtk amtk 204672

2.3

25 July

19:01 libAMSR2.a

Execution environment setting of AMTK

The setting of the environment variable is needed for the execution of theapplication using the AMTK library. Table 2.3-1 shows the list of theenvironment parameter.
Table 2.3-1
Name
LD_LIBRARY_PATH
L3LATLONFILEDIRAMSR2_LEAP_DATAGEOPHYSICALFILEAMTK environment parameter

Description
Passing a shared library of HDF is speci
fied.
The directory where the latitude longitud
e file of L3 exists is specified.
The directory where the leap second file
exists is specified. The directory where
the leap second file exists is specified.
The directory where the geophysical qua
ntity definition is specified.

Remarks

sample/data/leapsec.dat

share/data/geophysiocal_file

As for the environment parameter, specification is different according to the shell used. Every time, it will not be necessary to set it if it sets it to the log in sh
2-10

ell though the environment parameter can be individually set by the command w
hen executing it. Here, the method of specification for the log in shell is shown.

(1) For csh

Please add the following to the ".cshrc" file that exists in the home directory.

setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:/HDF5/shared/lib:/usr/local/lib
setenv L3LATLONFILEDIR (Directory where latitude longitude file of L3 exists)
setenv AMSR2_LEAP_DATA (Directory where leap second file exists)
setenv GEOPHYSICALFILE (Geophysical quantity definition sile exists)(2) For bash

Please add the following to the ".bashrc" file that exists in the home directory.

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/HDF5/shared/lib:/usr/local/lib
export L3LATLONFILEDIR= (Directory where latitude longitude file of L3 exists)
export AMSR2_LEAP_DATA= (Directory where leap second file exists)
export GEOPHYSICALFILE (Geophysical quantity definition sile exists)

About leap second file
Leap second file (sample/data/leapsec.dat) in the AMTK library is a setting as o

2.4

f August, 2010. Thereafter, when the leap second is updated, it is necessary to replace the leap second file.
Geophysical quantity definition file
It defines the property of the geophysical quantity of L2/L3.

2.5

Modification of this file enables to add or modify the definition of the geophysicalquantity without modificationof AMTK own
The Geophysical quantity definition file is written in the format shown below.

Table 2.5-1 Geophysical quantity definition file format
Format by line
1 Geophysical Name

2

Scale Factor

3

Unit

4

EQR

5

PS-N

Geophysical Name,Scale Factor,Unit,EQR,PS-N,PS-S
Name of geophysical quantity. It is the name corresponding Metadata ”GeophysicalName”.
(within 36 ASCII characters)
Scale factor affects to the data set “GeophysicalData.
(within 6 numberic characters and decimal point)
Unit affects to the data set “GeophysicalData”(within 10 ASCII characters)
Identification mark of Lat/Long file in case of Projection is “EQR”.
This is used to identify L3 Lat/Long file depending Geophysical quantity.
("EQR" / "-")
Identification mark of Lat/Long file in case of Projection is “PS-N”.

2-11

6

PS-S

This is used to identify L3 Lat/Long file depending Geophysical quantity.
("SIC" / "SND" / "-")
Identification mark of Lat/Long file in case of Projection is “PS-S”.
This is used to identify L3 Lat/Long file depending Geophysical quantity.
("SIC" / "SND" / "-")・ One geophysical quantity is defined by one line.
・ Each data are divided with a comma-delimited (‘,‘).
・ It set a hyphen (‘-‘) in the data item that does not need the setting.
・ The hash mark (‘#’) at the beginning of line is used as simble of comment line. It is excluded by a reading object.
・ The Brightness Temperature is defined in this file. In case of the brightness
temperature is defined, it is not necessary to set the ScaleFactor and Unit.
【the example of Geophysical quantitiy file】#Geophysical Name,Scale Factor,Unit,EQR,PS-N,PS-S
Total Precipitable Water,0.01,Kg/m2,EQR,-,Sea Ice Concentration,0.1,%,-,SIC,SIC
Snow Depth,0.1,cm,EQR,SND,Brightness Temperature (6GHz),-,-,EQR,SIC,SIC(comment line)

In the default Geophysical quantity file ( share/data/geophysiocal_file ) which AMTK
offers, the value should be set in Metadata “GeophysicalName”which is necessa
ry for HDF access is described.
The contents of Geophysical quantity file corresponding to the value of Metadat
a “GeophysicalName” are shown on the following.

Table 2.5-2 Geophysical quantity file
GeophysicalName

Unit

Scale
Factor

EQR

PS-N

PS-S

L2

L3

Total Precipitable Water
Cloud Liquid Water
Precipitation
Sea Surface Temperature
Sea Surface Wind speed
Sea Ice Concentration
Snow Depth
Soil Moisture Content
Brightness Temperature (6GHz)
Brightness Temperature (7GHz)
Brightness Temperature (10GHz)
Brightness Temperature (18GHz)
Brightness Temperature (23GHz)
Brightness Temperature (36GHz)
Brightness Temperature (89GHz)

kg/m2
kg/m2
mm/h
C
m/s
%
cm
%
constant
constant
constant
constant
constant
constant
constant

0.01
0.001
0.01
0.01
0.01
0.1
0.1
0.1
constant
constant
constant
constant
constant
constant
constant

EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR
EQR

SIC
SND
SIC
SIC
SIC
SIC
SIC
SIC
SIC

SIC
SIC
SIC
SIC
SIC
SIC
SIC
SIC

○
○
○
○
○
○
○
○
-

○
○
○
○
○
○
○
○
○
○
○
○
○
○
○

2-12

3

Programming using AMTK
The flow that the AMSR2 data is read and written with C and Fortran is show

n below by the use of AMTK. Please show the flow of the programming here, andC language refer to the sample program of Fortran an actual source.

3.1

Flow of programming(1) New making of HDF fileStart

Description of header file

The include file for AMTK is specified.

Definition of variable

The variable used is defined.

Allocating of memory area

The memory area of the written data is allocatedOpening of HDF file

The HDF file is opened in the writing mode. When the HDF file doesn't
exist, it is newly made.

Writing of meta data

The meta data is written in the HDF file.

Making of data set

The data set is newly made for the HDF file.

Writing of data

Data is written in the HDF file.

Freeing of memory area

The memory area is opened.

Close of HDF file

The HDF file is closed

End

3-1

(2) Reading of data from HDF fileStart

Description of header file

The include file for AMTK is specified.

Definition of variable

The variable used is defined.

Allocating of memory area

The memory area of the read data is allocated.

Opening of HDF file

The HDF file is opened in the reading mode.

Reading of meta data

The meta data is read from the HDF file.

Reading of data

Data is read to the memory area specifying the data set of the HDF file.

Freeing of memory area

The memory area is opened.

Close of HDF file

The HDF file is closed.

End

3-2

C programming

3.2
3.2.1

C sample programming
It is Table 3.2 as for the sample program of C language It shows in one.

Table 3.2-1 sample programming
File namesample1.csample2_make_L1Bproduct.c
sample3_make_L2Lproduct.c
sample4_make_L2Hproduct.c
sample5_make_L3Dproduct.c
sample6_make_L3Mproduct.c
sample7_ read_L1Bproduct.c
sample8_read_L2Lproduct.c
sample9_read_L2Hproduct.c
sample10_read_L3Dproduct.c
sample11_read_L3Mproduct.c
sample12_make_L1Rproduct.c
sample13_read_L1Rproduct.c
sample_common.csample_common.h

Description of sample
The two meta data sets and the navigation
are made, and is read again.
The meta data and the data set of L1B are
made.
The meta data and the data set of L2 low
resolution are made.
The meta data and the data set of L2 highresolution are made.
The meta data and the data set of L3 daily
are made.
The meta data and the data set of L3
monthly are made.
The meta data and the data set of L1B are
made.
The meta data and the data set of L2 low
resolution are output to the screen.
The meta data and the data set of L2 highresolution are output to the screen.
The meta data and the data set of L3 daily
are output to the screen.
The meta data and the data set of L3
monthly are output to the screen.
The meta data and the data set of L1R are
made.
The meta data and the data set of L1R are
made.
Common functions source for sample
programs
Common functions header for sample
programs

RemarkIt explains the program in Chapter 3.2.2.
The executable file name is sample1
The executable file name is sample2
The executable file name is sample3
The executable file name is sample4
The executable file name is sample5
The executable file name is sample6
The executable file name is sample7
The executable file name is sample8
The executable file name is sample9
The executable file name is sample10
The executable file name is sample11
The executable file name is sample12
The executable file name is sample13-

Please refer to README.txt of the directory with the sample program for details.

3.2.2

Description of programming
It explains the meta data of sample1.c, and here, the data set of 2 and the navigation is
made, and it explains the part that relates to HDF about the read program.

(1) New making of HDF file(a) Description of header file#include "AMTK.h"

Header file in AMTK library(b) Definition of variable3-3hid_t file_id;
float *navi = NULL;

Header file in AMTK library
The address of the navigation data is defined.
The address of the navigation data is defined.
The variable that specifies the size of the data
set is defined.

int size[3];(c) Allocating of memory areanavi = (float *)malloc(sizeof(float) * scan_size * 6);

The memory area of the navigation data isallocated.

(d) Opening of HDF file
file_id = AMTK_openH5_Write(FN_SAMPLE_PRODUCT_L1B,
AM2_CREATE_MODE);The HDF file is opened.

(e) Writing of meta data
AMTK_setMetaData(file_id,metadata_name[i], metadata_value[i]);The meta data is written.

(f) Making of data set
size[0] = scan_size;
size[1] = 0;size[2] = 0;
AMTK_setDimSize(file_id, AM2_NAVI, size);

The size of the data set of the navigation data is
specified.
The data set of the navigation data is made.

(g) Writing of data
AMTK_set_SwathFloat(file_id, navi, scan_start,
scan_end, AM2_NAVI);

Data is written in the data set.

(h) Free of memory area
free(navi );The memory area is freed(i) Close of HDF file
AMTK_closeH5_Write(file_id);

The HDF file is closed.

(2) Reading of data from HDF file(a) Description of header file#include "AMTK.h"

Header file in AMTK library(b) Definition of variable
hid_t file_id;
float *navi = NULL;
int size[3];Header file in AMTK library
The address of the navigation data is defined.
The variable that specifies the size of the data
set is defined.
It is a variable that stores the return value.

int ret;3-4

(c) Allocating memory area
ret = AMTK_getDimSize(file_id, AM2_LATLON_LO, &size[0]);navi = (float *)malloc(sizeof(float) * scan_size * 6);

The size of the memory area of the necessity inthe navigation data is acquired.
The memory area of the navigation data isallocated.

(d) Opening of HDF file
file_id = AMTK_openH5(FN_SAMPLE_PRODUCT_L1B);

The HDF file is opened.

(e) Reading of meta data
AMTK_getMetaData(file_id,
metadata_&value);

META_PRODUCTNAME_NAME,

The meta data is read.

(f) Reading of data
AMTK_get_SwathFloat(file_id, &navi, scan_start,
scan_end, AM2_NAVI);

Data is read from the data set.

(g) Freeing of memory area
free(navi );The memory area is freed.

(h) Close of HDF file
AMTK_closeH5(file_id);

The HDF file is closed.

3-53.2.3 C sample (sample1.c) program
The whole of sample1.c explains by 3.2.2 is shown below.
#include <stdio.h>#include <stdlib.h>#include "AMTK.h"#define FN_SAMPLE_PRODUCT_L1B"../data/sample1_IOToolKit.h5"#define FN_SAMPLE_META_DATA_NAME_SN"ShortName"#define FN_SAMPLE_META_DATA_SN"AMSR2-L1B"#define FN_SAMPLE_META_DATA_NAME_OV"OverlapScans"#define FN_SAMPLE_META_DATA_OV"20"#define SCENE_SCAN_NUM
2000#define OVERLAP_SCAN_NUM
20

/* */
/* */

/** @file sample1.c* I/O toolkit sample program main*
* @author
NEC* @date2010/07/31*/
int main(int argc, char *argv[]){
hid_t file_id;
float *navi = NULL;
int size[3];int scan_size = SCENE_SCAN_NUM + OVERLAP_SCAN_NUM * 2;
int scan_start = 1 - OVERLAP_SCAN_NUM;
int scan_end = SCENE_SCAN_NUM + OVERLAP_SCAN_NUM;
char granuleID[50];char *value;
int i;/* Newly make HDF Dataset */navi = (float *)malloc(sizeof(float) * scan_size * 6);
file_id = AMTK_openH5_Write(FN_SAMPLE_PRODUCT_L1B, AM2_CREATE_MODE );AMTK_setMetaDataName(file_id, FN_SAMPLE_META_DATA_NAME_SN, FN_SAMPLE_META_DATA_SN);
AMTK_setMetaDataName(file_id, FN_SAMPLE_META_DATA_NAME_OV, FN_SAMPLE_META_DATA_OV);
size[0] = scan_size;
size[1] = 0;size[2] = 0;
AMTK_setDimSize(file_id, AM2_NAVI, size);for( i=scan_start ; i< scan_end ; i++){navi[i+OVERLAP_SCAN_NUM-1] = (float)i*0.1;}
AMTK_set_SwathFloat(file_id, navi, scan_start,
scan_end, AM2_NAVI);
free( navi );AMTK_closeH5_Write(file_id);/*
Read HDF Dataset */navi = (float *)malloc(sizeof(float) * scan_size * 6);
file_id = AMTK_openH5(FN_SAMPLE_PRODUCT_L1B);
value = &granuleID[0];AMTK_getMetaDataName(file_id,"ShortName",&value) ;AMTK_get_SwathFloat(file_id, &navi, scan_start,
scan_end, AM2_NAVI);
printf( "ShortName=%s navi[0]=%f ¥n", granuleID, navi[OVERLAP_SCAN_NUM]);

3-6

free( navi );AMTK_closeH5(file_id);
return 0;}

3.2.4

Compile and executions
Make the pattern file (named Makefile) by typing the following command.
$ ./configure
The file related to HDF is retrieved by the automatic operation as well as inst
alling AMTK and Makefile is generated. Please correct the definition of Makefile
generated with the configure command in the editor when it wants to change thecompiler, and you want to edit passing the file related to HDF. If you installed
HDF5 library to arbitrary directory, you can set the library with [--with-hdf-lib],[--with-hdf-include] options.
 Compilation command
CC= Compilation command of use compiler
CFLAGS= Option of use compiler
 HDF library
HDFLIB=/ Directory where HDF library exists
 HDF Directory
HDFINC=/ HDF Directory where include file exists

The make command to make an execute file is executed.
$ makeWhen the make command is executed, the execute form of all sample program is
made for a present directory. Each sample program is executed. The example of ex
3-7

ecuting sample1 is shown as follows.
$./sample1
ShortName=AMSR2-L1B navi[0]=0.1000000"ShortName=AMSR2-L1B navi 0=0.1000000" message is output when sample1 is ex
ecuted, and the HDF file named sample1_IOToolKit.h5 is made for the data direct
ory of the sample directory.
Other samples are similar the compilation and execution.

3-8

Fortran Programing
As for Fortran, two kinds of types for f95 and for f77 are prepared. There is f9

3.3

5 type in the Fortran directory and there is f77 type in the Fortran77 directory.
The file composition and both execution methods are the same. Here, it explains
Fortran (for f95).

3.3.1

Fortran sample program
The table shows the sample program of Fortran.

Table 3.3-1 Fortran sample program
File namesample1.fsample2_make_L1Bproduct.f
sample3_make_L2Lproduct.f
sample4_make_L2Hproduct.f
sample5_make_L3Dproduct.f
sample6_make_L3Mproduct.f
sample7_ read_L1Bproduct.f
sample8_read_L2Lproduct.f
sample9_read_L2Hproduct.f
sample10_read_L3Dproduct.f
sample11_read_L3Mproduct.f
sample12_make_L1Rproduct.c
sample13_read_L1Rproduct.c
sample_common.csample_common.h

Description of sample
The two meta data sets and the navigation
are made, and is read again.
The meta data and the data set of L1B are
made.
The meta data and the data set of L2 low
resolution are made.
The meta data and the data set of L2 highresolution are made.
The meta data and the data set of L3 daily
are made.
The meta data and the data set of L3
monthly are made.
The meta data and the data set of L1B are
made.
The meta data and the data set of L2 low
resolution are output to the screen.
The meta data and the data set of L2 highresolution are output to the screen.
The meta data and the data set of L3 daily
are output to the screen.
The meta data and the data set of L3
monthly are output to the screen.
The meta data and the data set of L1R are
made.
The meta data and the data set of L1R are
made.
Common functions source for sample
programs
Common functions header for sample
programs

RemarkIt explains the program in Chapter
3.3.2.
The executable file name is sample1
The executable file name is sample2
The executable file name is sample3
The executable file name is sample4
The executable file name is sample5
The executable file name is sample6
The executable file name is sample7
The executable file name is sample8
The executable file name is sample9
The executablesample10
The executablesample11
The executablesample12
The executablesample13
-

file

name

is

file

name

is

file

name

is

file

name

is

-

Please refer to README.txt of the directory with the sample program for details.

3.3.2

Description of programming
In here, it explains the part that relates to HDF in the program that makes two metadata of sample1.f and navigation data set and read it.

(1) New making of HDF file(a) Description of header file3-9

include 'AMTK_f.h'

Header file in AMTK library

3-10

(b) Definition of variable
Integer file_id
real navi(2000)
Integer size(3)Header file in AMTK library
The address of the navigation data is defined.
The variable that specifies the size of the data
set is defined.

(c) Opening of HDF file
file_id = AMTK_openH5_Write( fname,
AM2_CREATE_MODE )The HDF file is opened.

(d) Writing of meta data
status = AMTK_setMetaDataName(file_id, shortname_ID,shortname)status = AMTK_setMetaDataName(file_id, OverlapScans_ID,* OverlapScans)

The meta data is written.

(e) Making of data setsize(1) = 2040
size(2) = 0
size(3) = 0
status = AMTK_setDimSize(file_id,AM2_NAVI, size)

The size of the data set of the navigation data is
specified.
The data set of the navigation data is made.

(f) Writing of data
status = AMTK_set_SwathFloat(file_id,navi,-19,2020, AM2_NAVI)

Data is written in the data set.

(g) Close of HDF filestatus = AMTK_closeH5_Write(file_id)

The HDF file is closed.

(2) Reading of data from HDF file(a) Opening of HDF file
file_id = AMTK_openH5( fname );The HDF file is opened.

(b) Reading of meta data
status = AMTK_getMetaDataName(file_id,shortname_ID,granuleID)

The meta data is written.

(c) Reading of data
status = AMTK_get_SwathFloat(file_id, navi,1,2000, AM2_NAVI)(d) Close of HDF file
3-11

Data is read from the data set.

status = AMTK_closeH5(file_id)

3.3.3

The HDF file is closed.

Fortran(sample1_f) Sample program
Program main
include 'AMTK_f.h'

CImplicit NONE
character*30 fname
data fname/'../data/sample1_f_IOToolKit.h5'/
Integer file_id
Integer status
integer*1 char1
integer*2 char2
integer*1 char3(10)character*9 shortname_IDdata shortname_ID/'ShortName'/character*9 shortname
data shortname/'AMSR2-L1B'/
character*12 OverlapScans_ID
data OverlapScans_ID/'OverlapScans'/
character*2 OverlapScansdata OverlapScans/'20'/
character*40 granuleID
Integer size(3)Integer ireal navi(2000)
file_id = AMTK_openH5_Write( fname , AM2_CREATE_MODE )status = AMTK_setMetaDataName(file_id, shortname_ID,shortname)status = AMTK_setMetaDataName(file_id, OverlapScans_ID,* OverlapScans)size(1) = 2040
size(2) = 0
size(3) = 0
status = AMTK_setDimSize(file_id,AM2_NAVI, size)i = 1
Do i=1,2000
navi(i) = i*0.1
End dostatus = AMTK_set_SwathFloat(file_id,navi,-19,2020, AM2_NAVI)
status = AMTK_closeH5_Write(file_id)
file_id = AMTK_openH5( fname );status = AMTK_getMetaDataName(file_id,shortname_ID,granuleID)status = AMTK_get_SwathFloat(file_id, navi,-19,2020, AM2_NAVI)
status = AMTK_closeH5(file_id);
Write(*,*) 'ShortName=', shortname, ' navi(1)=', navi(1)
Stop
End

3-12

3.3.4 Compilations and executions
Makefile for the make command execution is made first.
$ ./configure
The make command of the execute form making is executed. Please correct thedefinition of Makefile generated with the configure command in the editorwhen it
wants to change the compiler, and you want to edit passing the file related to
HDF.
If you installed HDF5 library to arbitrary directory, you can set the library wit
h [--with-hdf-lib], [--with-hdf-include] options.
In the case of SGI environment, the Makefile must be added “-64” at the FFLAGS.
FFLAGS = ...(*snip* )... -64

In the case of SGI environment○HDF library file--with-hdf-lib=/HDF5/shread/lib○HDF include file--with-hdf-include=/HDF5/shread/include

 Compilation command
CC= Compilation command of use compiler
CFLAGS= Option of use compiler
 HDF library
HDFLIB=/ Directory where HDF library exists
 HDF directory
HDFINC=/ Directory where HDF include file exists$ makeWhen the make command is executed, the execute form of all sample program is
3-13

made for a present directory. Each sample program is executed. The example of ex
ecuting sample1 is shown as follows.
$./sample1
ShortName=AMSR2-L1B navi[0]=0.1000000"ShortName=AMSR2-L1B navi 0=0.1000000" message is output when sample1 is ex
ecuted, and the HDF file named sample1_IOToolKit.h5 is made for the data direct
ory of the sample directory.
Other samples are similar the compilation and execution.

3-14

4

Function composition
Function composition of AMTK is shown in Fig3.3-1.
The offered function is divided by the input function and the output function.
１） Input function(1)Level 1 product(L1A ,L1B ,L1R)input function(2)Level 2 product(L2)input function(3)Level 3 product(L3)input function

AMSR2
L1A、

Input function

HDF5

L1B、
L1R

User programAMSR2
AMSR2 I/O

HDF5

Tool Kit

L2

AMSR2
HDF5

Fig 4-1 AMTK product input function

4-1

L3

２） Output function(1)Level 1 product(L1A ,L1B ,L1R)output function(2)Level 2 product (L2)output function(3)Level 3 product (L3)output function

AMSR2
L1A、
L1B、
L1R

Output functoin
User programAMSR2
AMSR2 I/O

HDF5

Tool Kit

L2

AMSR2

HDF5

Fig.4-2

AMTK product output function

4-2

L3

5

API of function

5.1

C- Language

5.1.1 Common function(1) L1A ,L1B ,L1R ,L2 ,L3 input functions
Product file opening (reading only)
The HDF product file is opened with read only.
hid_t AMTK_openH5(char *file_name)Name
return value

HDF_file_id

Type

IN/OUT

Size

Description

hid_t

output1

Normal：HDF access file id is returned
Error ： A negative value returns when it is notpossible to acquire it.

char *input

1

AMSR2 HDFfile nameparameter

file_nameProduct file close
The HDF product file is closed.
int AMTK_closeH5(hid_t HDF_file_id)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns.

hid_t

input

1

HDF access file idparameter

HDF_file_id

5-1

Acquisition of data dimension size
The data dimension size is acquired from product.
ー When the access label intended for plural Datasets is specified, the error is returned.

int AMTK_getDimSize(hid_t HDF_file_id, int access_lbl , int *size)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：The array number of dimension returns.
Error：A negative value returns when it is notpossible to acquire it.

hid_t
int
int *

input
input
output1
1
1

HDF access file idparameter

HDF_file_id
access_lbl
size

Please refer to "6.1.1 the HDF access label".
Dimension Size (Please refer the fig below)

K

I

I

J

I
J

size={I, 0, 0}

size={I, J, 0}

size={I, J, K}

array[I]array[I * J]

array[I*J*K]

One-dimensional data

Three-dimensional data
Two-dimensional data

5-2

Refer to the 6.1.2 section.

Acquisition of meta data(meta data name)
The meta data is acquired by specifying the meta data name of the product.
ー When the memory area where the meta data value is stored is NULL, the error is returned.

int AMTK_getMetaDataName(hid_t HDF_file_id, char *name, char **value)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal ： The number of meta data character
returns.
Error ： A negative value returns when it is notpossible to acquire it.

hid_tchar *
char **

input
input
output1
1
1

HDF access file idparameter

HDF_file_id
name
value

meta data namemeta data value

Acquisition of meta data(index value)
The meta data is acquired by specifying the index value of the product.
ー When the memory area where the meta data value is stored is NULL, the error is returned.

int AMTK_getMetaData(hid_t HDF_file_id, int index, char **value)
Name
return value

statusType

IN/OUT

Size

Description

int

output1

Normal ： The number of meta data character
returns.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
int
char **

input
input
output1
1
1

HDF access file idparameter

HDF_file_id
index
value

meta data index value
meta data value

Acquisition of scanning time
The scanning time is acquired.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_SCANTIME)*dimension size(AMTK_getDimSize function reference)”Ex.) Scan Time (scan): AM2_COMMON_SCANTIME *p_data = malloc(sizeof(AM2_COMMON_SCANTIME) * scan)int AMTK_getScanTime(hid_t HDF_file_id, int from_scan, int to_scan, AM2_COMMON_SCANTIME**scan_time)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal ： The number of acquisition
scannings returns.
Error：A negative value returns when
it is not possible to acquire it.

hid_t
int
int

input
input
input
output1
1
1
1

HDF access file id
Scan number of acquisition start
Scan number of acquisition end
Data structure

parameter

HDF_file_id
from_scan
to_scanscan_time

AM2_COMMON_SCANTIME**

5-3

Acquisition of Latitude longitude data
The Lat/Long data of the range of an appointed scan number is acquired.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_ LATLON)*dimension size(AMTK_getDimSize function reference)”Ex.) Latitude of Observation Point for 89A/89B (scan x 486)
: AM2_COMMON_LATLON *p_data = malloc(sizeof(AM2_COMMON_LATLON) * scan * 486)

int AMTK_getLatLon(hid_t HDF_file_id, AM2_COMMON_LATLON **latitudelongitude, int from_scan,
int to_scan, int access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal ： The number of acquired
scan is returned.
Error ： A negative value returns
when it is not possible to acquire it.

hid_t

input
output1
1

HDF access file id
Data structure

parameter

HDF_file_id
latitudelongitude
from_scan
To_scanaccess_lbl

AM2_COMMON_LATLON
**

int
int
int

(x N
scan)

input
input
input

1
1
1

Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1.6 the
LATLON function".

Acquisition of L1 quality information
The quality information of L1 data is acquired.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_ LATLON)*dimension size(AMTK_getDimSize function reference)”Ex.) Scan Data Quality (scan x 512) # data set is char type. x sizeof(AMTK_SCAN_DATA_QUALITY)size: AMTK_SCAN_DATA_QUALITY *p_data = malloc(sizeof(AMTK_SCAN_DATA_QUALITY) * scan)int AMTK_getScanDataQuality(hid_t HDF_file_id, AMTK_SCAN_DATA_QUALITY **quality,
int from_scan, int to_scan, int access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：The number of acquired scan isreturned.
Error：A negative value returns when it
is not possible to acquire it.

HDF_file_id
quality

hid_t

input
output1
1

HDF access file id
Data structure

from_scan
to_scanaccess_lbl

int
int
int

input
input
input

1
1
1

Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF accesslabel".

parameter
AMTK_SCAN_DATA_QU
ALITY **

5-4

Acquisition of Integer Type data
The data of integer Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(int) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.

int AMTK_get_SwathInt(hid_t HDF_file_id, int **data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
int **
int
int
int

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Acquisition of floating Type data
The data of floating Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(float) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.

int AMTK_get_SwathFloat(hid_t HDF_file_id, float **data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
float **
int
int
int

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-5

Acquisition of double Type data
The data of double Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(double) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.

int AMTK_get_SwathDouble(hid_t HDF_file_id, double **data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
double **
int
int
int

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Acquisition of unsigned CharType data
The data of unsigned CharType is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(unsigned char) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.

int AMTK_get_SwathUChar(hid_t HDF_file_id, unsigned char **data, int from_scan, int to_scan, int
access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
unsignedchar **
int
int
int

input
output1
1

HDF access file id
Memory area where data is stored

input
input
input

1
1
1

Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-6

(2) L1A ,L1B ,L1R ,L2 ,L3 Output functions
Product file opening (writing only)
The HDF product file is opened with write only.
hid_t AMTK_openH5_Write(char *file_name, int mode)
Name

Type

IN/OUT

Size

Description

return value

HDF_file_id

hid_t

output1

Normal：HDF access file id
Error ： A negative value returns when it is notpossible to open.

char *
int

input
input

1
1

AMSR2 HDFfile name
File open mode
AM2_CREATE_MODE : New making
The existing file is deleted.
AM2_RW_MODE: Superscription
It becomes an error when there is no existing
file.

parameter

file_namemode

Product file close
The HDF product file is closed.
int AMTK_closeH5_Write(hid_t HDF_file_id)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns.

hid_t

input

1

HDF access file idparameter

HDF_file_id

5-7

HDF Dataset making
HDF Dataset of data dimention size is made.
ー When generating it, HDF Dataset is initialized by the missing value.

int AMTK_setDimSize(hid_t HDF_file_id,int access_lbl , int *size)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns when it is notpossible to set it

hid_t
int
int *

input
input
input

1
1
1

HDF access file id
Please refer to "6.1.1 the HDF access label".
Dimention s ize (For detailed information, threed imention array. Please refer to function
Description of AMTK_getDimSize.)parameter

HDF_file_id
access_lbl
size

Meta data setting
The meta data is set by the meta data name of the HDF product.
int AMTK_setMetaDataName(hid_t HDF_file_id, char *name, char *value)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error： A negative value returns when it is notpossible to set it

hid_tchar *
char *

input
input
input

1
1
1

HDF access file id
Meta data nameMeta data value

parameter

HDF_file_id
name
value

5-8

Setting at scanning time
Scanning time data (Year, Month, Day, Hour, Minute, second, mili second) is converted to TAI93 real
integer and written in the specified scan number.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_SCANTIME)*dimension size(AMTK_getDimSize function reference)”Ex.) Scan Time (scan): AM2_COMMON_SCANTIME *p_data = malloc(sizeof(AM2_COMMON_SCANTIME) * scan)int AMTK_setScanTime(hid_t HDF_file_id, AM2_COMMON_SCANTIME *scan_time, int from_scan, int
to_scan)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns when
it is not possible to set it.

hid_t
AM2_COMMON_SCANTIME
*
int
int

input
input

1
1

HDF access file id
Data structure

input
input

1
1

beginning scanning number
end scanning number

parameter

HDF_file_id
scan_time
from_scan
to_scanLatitude longitude data setting
The Lat/Long data is written in the specified scan number.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires
data stored away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_ LATLON )*dimension size(AMTK_getDimSize functionreference)”
Ex) Latitude of Observation Point for 89A/89B (scan x 486)
: AM2_COMMON_LATLON *p_data = malloc(sizeof(AM2_COMMON_LATLON) * scan * 486)

int AMTK_setLatLon(hid_t HDF_file_id, AM2_COMMON_LATLON *latitudelongitude, int from_scan,
int to_scan, int access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error ： A negative value returns
when it is not possible to set it.

hid_t
AM2_COMMON_LATLON
*

input
input

1
1

HDF access file id
Data structure

int
int
int

input
input
input

parameter

HDF_file_id
latitudelongitude
from_scan
to_scanaccess_lbl

(x N
scan)

5-9

1
1
1

beginning scanning number
end scanning number
Please refer to "6.1.1.6
LATLON function".

theQuality information setting
The qualitiy information of L1 data is set.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires
data stored away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_SCANTIME)*dimension size(AMTK_getDimSize functionreference)”Ex)) Scan Data Quality (scan x 512) # data set is char type. x sizeof(AMTK_SCAN_DATA_QUALITY)size: AMTK_SCAN_DATA_QUALITY *p_data = malloc(sizeof(AMTK_SCAN_DATA_QUALITY) * scan)int AMTK_set_ScanDataQuality(hid_t HDF_file_id, AMTK_SCAN_DATA_QUALITY *quality,
int from_scan, int to_scan, int access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns when it
is not possible to set it.

HDF_file_id
quality

hid_t

input
output1
１

HDF access file id
Data structure

from_scan
to_scanaccess_lbl

int
int
int

input
input
input

1
1
1

beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF accesslabel".

parameter
AMTK_SCAN_DATA_QUALITY*

Integer Type data setting
Data is set to HDF Dataset as data of integer Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(int) * line number * scannings".
When the numerical value that cannot be accommodated in HDF Dataset exists in the setting data, correspondence
data is replaced with the error value and it writes it in HDF. And a negative value of the warning is set to return
value.

int AMTK_set_SwathInt(hid_t HDF_file_id, int *data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
int *
int
int
int

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-10Floating Type data setting
Data is set to HDF Dataset as data of floating Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(float) * line number * scannings".
- When you convert the value of the floating number into the integral value by the scale factor of HDF Dataset of thecorrespondence, the first place of the decimal point is rounded off after it divides in the scale factor.
Ex.) Navigation Data (scan x 6): float *p_data = malloc(sizeof(float) * scan * 6)

int AMTK_set_SwathFloat(hid_t HDF_file_id, float *data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
float *
int
int
int

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Double Type data setting
Data is set to HDF Dataset as data of double Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(double) * line number * scannings".
Ex.) Position in Orbit (scan): double *p_data = malloc(sizeof(double) * scan)int AMTK_set_SwathDouble(hid_t HDF_file_id, double *data, int from_scan, int to_scan, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
double *
int
int
int

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-11Unsigned Char Type data setting
Data is set to HDF Dataset as data of Unsigned Char Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(unsigned char) * line number * scannings".
When the numerical value that cannot be accommodated in HDF Dataset exists in the setting data, correspondence
data is replaced with the error value and it writes it in HDF. And a negative value of the warning is set to return
value.
Ex.) SPC Temperature Count (scan x 34): unsigned char *p_data = malloc(scan * 34)

int AMTK_set_SwathUChar(hid_t HDF_file_id, unsigned char *data, int from_scan, int to_scan, int
access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
unsignedchar *
int
int
int

input
input

1
1

HDF access file id
Memory area where data is stored

input
input
input

1
1
1

beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-125.1.2

Input functions(1) L1A, L1B ,L1R function

There is no input function peculiar to L1 because the common function is used.

(2) L2 input function
There is no input function peculiar to L2 because the common function is used.

(3) L3 input function
Acquistion of Integer Type data
The data of integer Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "sizeof(int)*Dimension".
- When the Memory area where data is stored specification is NULL, the memory area is allocated in the function
internally.

int AMTK_get_GridInt(hid_t HDF_file_id, int **data, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
int **
int

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

Acquistion of float type data **The data of float Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "sizeof(int)*Dimension".
- When the Memory area where data is stored specification is NULL, the memory area is allocated in the function
internally.

int AMTK_get_GridFloat(hid_t HDF_file_id, float **data, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
float **
int

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

5-13

Average data acquisition on the third
The average data of three days of level 3 is acquired.
In the case the input file is not based on rules, the error number (-250 or more) is returned.
Please refer to ”7 Error Number ID” for the details.
int AMTK_get_Grid03D(float **average, char *name_table)Name
return value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to acquire it.

averagefloat **

outputM pixcelx N scanname_tablechar *

input

256

Data structure
0.1-degree or 0.25-degree lattice is judged from afile name.
The all specified files are from the same lattice.
File name table (Please refer to the figure below).

parameter

file name table
Point the top of the table
File name1 （The specified day accending）
File name1 （The specified day decending）

File name2 （The day before specified day accending）
File name2 （The day before specified day decending）

File name3 （The tow days before specified day accending）
File name3 （The tow days before specified day decending）

5-14

5.1.3

Output functions(1) L1 output function
There is no output function peculiar to L1 because the common function is used.

(2) L2 output function

There is no output function peculiar to L2 because the common function is used.

(3) L3 output function
Acquistion of Integer Type data
The HDF Dataset data are set as integer type data in an appointed HDF access lavel.
-

All of the array data of the L3 product appointed with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "size of(int)*Dimension".
Ex.) Average Number (V) (Xpixel x Ypixel): int *p_data = malloc(sizeof(int) * Xpixel * Ypixel)

int AMTK_get_GridInt(hid_t HDF_file_id, int **data, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
int **
int

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

Acquistion of float Type data
The HDF Dataset data are set as float type data in an appointed HDF access lavel.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "sizeof(int)*Dimension".
Ex.) Standard Deviation (V) (Xpixel x Ypixel): float *p_data = malloc(sizeof(float) * Xpixel * Ypixel)

int AMTK_get_GridInt(hid_t HDF_file_id, int **data, int access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

int

output1

Normal：0
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
int **
int

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

5-15Fortran

5.2
5.2.1

Common function(1) L1A ,L1B ,L1R ,L2 ,L3 input functions
Product file opening (reading only)
The HDF product file is opened with read only.
hid_t = AMTK_openH5(file_name)Name
return value

Type

IN/OUT

Size

Description

HDF_file_id

integer

output1

Normal：HDF access file id is returned
Error：A negative value returns when it is notpossible to acquire it.

character*500

input

1

AMSR2 HDFfile nameparameter

file_nameProduct file close
The HDF product file is closed.
int AMTK_closeH5(hid_t HDF_file_id)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error：A negative value returns.

integer

input

1

HDF access file idparameter

HDF_file_id

5-16

Acquisition of the data dimension size
The data dimension size is acquired from HDF product.
ー When the access label intended for plural Datasets is specified, the error is returned.

status = AMTK_getDimSize(HDF_file_id, access_lbl , size)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：The array number of dimension returns.
Error：A negative value returns when it is notpossible to acquire it.

hid_t
integer
integer

input
input
output1
1
1

HDF access file id

Parameter

HDF_file_id
access_lbl
size(3)

Please refer to "6.1.1 the HDF access label".
Dimension Size (Please refer the fig below)

K

I

I

J

I
J

size={I, 0, 0}

size={I, J, 0}

size={I, J, K}

array[I]array[I * J]

array[I*J*K]

two-dimensional data
one-dimensional data

three-dimensional data
Refer to the 6.1.2 section.

5-17

Acquisition of meta data(meta data name)
The meta data is acquired by specifying the meta data name of the product.
ー When the memory area where the meta data value is stored is NULL, the error is returned.

status = AMTK_getMetaDataName(HDF_file_id, name, value)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal ： The number of meta data character
returns.
Error ： A negative value returns when it is notpossible to acquire it.

integercharacter*30
character*10

input
input
output1
1
1

HDF access file id
Meta data nameMeta data value

Parameter

HDF_file_id
name
value

Acquisition of meta data(index value)
The meta data is acquired by specifying the index value of the product.
ー When the memory area where the meta data value is stored is NULL, the error is returned.

status = AMTK_getMetaData(HDF_file_id, index, value)
Name
return value

statusType

IN/OUT

Size

Description

integer

output1

Normal ： The number of meta data character
returns.
Error ： A negative value returns when it is notpossible to acquire it.

integer
integercharacter*10

input
input
output1
1
1

HDF access file id

Parameter

HDF_file_id
index
value

meta data index value
meta data value

Acquisition of scanning time
The scanning time is acquired.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquire data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_SCANTIME)*dimension size(AMTK_getDimSize function reference)”Ex.) Scan Time (scan): type(AM2_COMMON_SCANTIME) data(scan)status = AMTK_getScanTime(HDF_file_id, from_scan, to_scan, scan_time)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal ： The number of acquired
scan is returned.
Error：A negative value returns when
it is not possible to acquire it.

hid_t
integer
integer
AM2_COMMON_SCANTIME

input
input
input
output1
1
1
1

HDF access file id
Scan number of acquisition start
Scan number of acquisition end
Data structure

parameter

HDF_file_id
from_scan
to_scanscan_time

5-18

Acquisition of Latitude longitude data
It takes out the Lat/Long data of the range of an appointed scan number from a HDF.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “sizeof(AM2_COMMON_LATLON)*dimension size(AMTK_getDimSize function reference)”Ex.) Latitude of Observation Point for 89A/89B (scan x 486) : type(AM2_COMMON_LATLON) data(486, scan)status = AMTK_getLatLon(HDF_file_id, latitudelongitude, from_scan, to_scan, access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal ： The number of acquired
scan is returned.
Error：A negative value returns when
it is not possible to acquire it.

hid_t
AM2_COMMON_LATLON*

input
output1
1

HDF access file id
Data structure

integer
integer
integer

input
input
input

parameter

HDF_file_id
latitudelongitude
from_scan
to_scanaccess_lbl

(x N
scan)

1
1
1

Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1.6 the LATLON
function".

Acquisition of L1 quality information
The quality information of the L1 data is acquired.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “512(AM2_COMMON_LATLON)*dimension size(AMTK_getDimSize function reference)”Ex.) Scan Data Quality (scan x 512) # data set is char type. x sizeof(AMTK_SCAN_DATA_QUALITY)size: type(AMTK_SCAN_DATA_QUALITY) data(scan)int AMTK_getScanDataQuality(HDF_file_id, quality, from_scan, to_scan, access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusInt

output1

Normal：The number of acquired scan isreturned.
Error：A negative value returns when it
is not possible to acquire it.

HDF_file_id
quality

hid_t

input
output1
１

HDF access file id
Data structure

from_scan
to_scanaccess_lbl

Int
Int
Int

input
input
input

1
1
1

Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF accesslabel".

Parameter
AMTK_SCAN_DATA_QU
ALITY *

5-19

Acquisition of Integer Type data
The data of integer Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(int) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.
Ex.) Hot Load Count 6 to 36 (12 x scan x 16): integer data(16 * scan * 12)

status = AMTK_get_SwathInt(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

Integer

output1

Normal：The number of scan acquired returns.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
Integer
Integer
Integer
Integer

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label"Parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Acquisition of floating Type data
The data of floating Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(float) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.
Ex.) Navigation Data (scan x 6): real data(6, scan)status = AMTK_get_SwathFloat(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

Integer

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
real
integer
integer
integer

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

Parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-20

Acquisition of double Type data
The data of double Type is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(double) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.
Ex.) Position in Orbit (scan): real*8 data(scan)status = AMTK_get_SwathDouble(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
real8
integer
integer
integer

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Acquisition of CharcterType data
The data of CharacterType is acquired specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(unsigned char) * line number * scannings".
- When the memory area specification that stores data is NULL, the memory area is secured in the function.
Ex.) SPC Temperature Count (scan x 34): character data(34, scan)status = AMTK_get_SwathUChar(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_tCharacter
integer
integer
integer

input
output
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
Scan number of acquisition start
Scan number of acquisition end
Please refer to "6.1.1 the HDF access label".

Parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-21

(2) L1A, L1B ,L1R ,L2 ,L3 output function
Product file opening (writing only)
The HDF product file is opened with write only.
hid_t AMTK_openH5_Write(char *file_name, int mode)
Name

Type

IN/OUT

Size

Description

return value

HDF_file_id

integer

output1

Normal：HDF access file id
Error：A negative value returns when it is notpossible to acquire it.

character*500
integer

input
input

1
1

AMSR2 HDFfile name
File open mode
AM2_CREATE_MODE : New file
The existing file is deleted.
AM2_RW_MODE: Overwrite
It becomes an error when there is no
existing file.

parameter

file_namemode

Product file close
The HDF product file is closed.
int AMTK_closeH5_Write(hid_t HDF_file_id)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error：A negative value returns.

integer

input

1

HDF access file idparameter

HDF_file_id

5-22

HDF Dataset making
HDF Dataset of data dimention size is made.
ー When generating it, HDF Dataset is initialized by the missing value.

status = AMTK_setDimSize(HDF_file_id, access_lbl, size)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error：A negative value returns when it is notpossible to set it.

hid_t
integer
integer

input
input
input

1
1
1

HDF access file id
Please refer to "6.1.1 the HDF access label".
Dimention s ize (Three dimention array. For
detailed information, Please refer to function
Description of AMTK_getDimSize.)parameter

HDF_file_id
access_lbl
size(3)

Meta data setting
The meta data is set by the meta data name of the HDF product.
status = AMTK_setMetaDataName(HDF_file_id, name, value)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

integercharacter*30
character*10

input
input
input

1
1
1

HDF access file id
Meta data nameMeta data value

parameter

HDF_file_id
name
value

5-23

Setting at scanning time
Scanning time data (Year, Month, Day, Hour, Minute, second, mili second) is converted to TAI93 real
integer and written in the specified scan number.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “24(=AM2_COMMON_SCANTIME)*dimension size(AMTK_getDimSize function reference)”.
Ex.) Scan Time (scan): type(AM2_COMMON_SCANTIME) data(scan)status = AMTK_setScanTime(HDF_file_id, scan_time, from_scan, to_scan)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error：A negative value returns when
it is not possible to set it.

integer
AM2_COMMON_SCANTIME
integer
integer

input
input
input
input

1
1
1
1

HDF access file id
Data structure
beginning scanning number
end scanning number

parameter

HDF_file_id
scan_time
from_scan
to_scanLatitude longitude data setting
The Lat/Long data is written in the specified scan number.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “8(=AM2_COMMON_LATLON)*dimension size(AMTK_getDimSize function reference)”.
Ex.) Latitude of Observation Point for 89A/89B (scan x 486) : type(AM2_COMMON_LATLON) data(486, scan)status = AMTK_setLatLon(HDF_file_id, latitudelongitude, from_scan, to_scan, access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusinteger

output1

Normal：0
Error ： A negative value returns
when it is not possible to set it.

hid_t
AM2_COMMON_LATLON

input
input

1
1

HDF access file id
Data structure

parameter

HDF_file_id
latitudelongitude

(x N
scan)

from_scan
to_scanaccess_lbl

integer
integer
integer

input
input
input

5-24

1
1
1

beginning scanning number
end scanning number
Please refer to "6.1.1.6
LATLON function".

theQuality information setting
The qualitiy information of L1 data is set.
- The scan number appoints a start scan number and an end scan number.
When an end scan number is smaller than a start scan number, an error returns.
When an end scan number is bigger than a scan number stored away by appointed HDF data set, It acquires data stored
away by HDF data set.
- The user using a function allocate memory area storing data.
A data size is “512(AM2_COMMON_LATLON)*dimension size(AMTK_getDimSize function reference)”.
Ex.) Scan Data Quality (scan x 512) # Data set is char type x sizeof(AMTK_SCAN_DATA_QUALITY)size: type(AMTK_SCAN_DATA_QUALITY) data(scan)int AMTK_set_ScanDataQuality(hid_t HDF_file_id, AMTK_SCAN_DATA_QUALITY *quality,
int from_scan, int to_scan, int access_lbl)
Name

Type

IN/OUT

Size

Description

return value

statusint

output1

Normal：0
Error：A negative value returns when it
is not possible to set it.

HDF_file_id
quality

hid_t

input
output1
１

HDF access file id
Data structure

from_scan
to_scanaccess_lbl

int
int
int

input
input
input

1
1
1

beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF accesslabel".

parameter
AMTK_SCAN_DATA_QUALITY*

Integer Type data setting
Data is set to HDF Dataset as data of integer Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(int) * line number * scannings".
When the numerical value that cannot be accommodated in HDF Dataset exists in the setting data, correspondence
data is replaced with the error value and it writes it in HDF. And a negative value of the warning is set to return
value.
Ex.) Hot Load Count 6 to 36 (12 x scan x 16): integer data(16 * scan * 12)

status = AMTK_set_SwathInt(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
integer
integer
integer
integer

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-25

Floating Type data setting
Data is set to HDF Dataset as data of floating Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(float) * line number * scannings".
- When you convert the value of the floating number into the integral value by the scale factor of HDF Dataset of thecorrespondence, the first place of the decimal point is rounded off after it divides in the scale factor.
Ex.) Navigation Data (scan x 6): real data(6, scan)status = AMTK_set_SwathFloat(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
real
integer
integer
integer

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

Double Type data setting
Data is set to HDF Dataset as data of double Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of size of(double) * line number * scannings".
Ex.) Position in Orbit (scan): real*8 data(scan)status = AMTK_set_SwathDouble(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
real8
integer
integer
integer

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-26

Char Type data setting
Data is set to HDF Dataset as data of Char Type by specifying the HDF access label.
- The data of the correspondence is acquired specifying the scanning number.
- The specification of the scanning number specifies the beginning scanning number and the end scanning number.
The error returns when the end scanning number is smaller than the beginning scanning number.
When the end scanning number is larger than the scanning number accommodated by HDF Dataset, the dataaccommodated by HDF Dataset is acquired.
- The user who uses the function has to alocate the memory area where data is stored.
Size specifies "Number of sizeof(unsigned char) * line number * scannings".
When the numerical value that cannot be accommodated in HDF Dataset exists in the setting data, correspondence
data is replaced with the error value and it writes it in HDF. And a negative value of the warning is set to return
value.
Ex.) SPC Temperature Count (scan x 34): character data(34, scan)status = AMTK_set_SwathUChar(HDF_file_id, data, from_scan, to_scan, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_tcharacter
integer
integer
integer

input
input
input
input
input

1
1
1
1
1

HDF access file id
Memory area where data is stored
beginning scanning number
end scanning number
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
from_scan
to_scanaccess_lbl

5-27

5.2.2

Input functions(1) L1A, L1B ,L1R function
There is no input function peculiar to L1 because the common function is used.

(2) L2 input function
There is no input function peculiar to L2 because the common function is used.

(3) L3 input function
Acquistion of Integer Type data
The data of integer Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "4*Dimension".
Ex.) Average Number (V) (Xpixel x Ypixel): integer data(Ypixel * Xpixel)

status = AMTK_get_GridInt(HDF_file_id, data, access_lbl)
Name
Return value

statusType

IN/OUT

Size

Description

integer

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
integer
integer

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

Parameter

HDF_file_id
data
access_lbl

Acquistion of float type data **The data of float Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "4*Dimension".
Ex.) Standard Deviation (V) (Xpixel x Ypixel): real data(Ypixel * Xpixel)

status = AMTK_get_GridFloat(HDF_file_id, data, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：The number of acquired scan is returned.
Error ： A negative value returns when it is notpossible to acquire it.

hid_t
real
integer

input
output
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

Parameter

HDF_file_id
data
access_lbl

5-28

Average data acquisition on the third
The average data of three days of level 3 is acquired.
In the case the input file is not based on rules, the error number (-250 or more) is returned.
Please refer to ”7 Error Number ID” for the details.
status = AMTK_get_Grid03D(average, name_table)Name
return value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to acquire it.

averagereal

outputM pixcelx N scanname_tablecharacter*30

input

256

Data structure
0.1-degree or 0.25-degree lattice are judged withfile name.
The specified file specifies all files of the samelattice.
File name table (Please refer to the figure below).

parameter

file name table
Point the top of the table
File name1 （The day specified day accending）
File name1 （The day specified day decending）

File name2 （The day before specified day accending）
File name2 （The day before specified day decending）

File name3 （The doble day before specified day accending）
File name3 （The doble day before specified day decending）

5-29

5.2.3 Output function(1) L1 output functions
There is no input function peculiar to L1 because the common function is used.

(2) L2 output function
There is no input function peculiar to L2 because the common function is used.

(3) L3 output function
Acquistion of Integer Type data
The data of integer Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "4*Dimension".
Ex.) Average Number (V) (Xpixel x Ypixel): integer data(Ypixel * Xpixel)

status = AMTK_set_GridInt(HDF_file_id, data, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
integer
integer

input
input
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

Acquistion of float Type data
The data of float Type is acquired specifying the HDF access label.
-

All of the array data of the L3 product specified with the access label are acquired.
To get the information of array Size, it uses the AMTK_getDimSize function.
- The user who uses the function secures Memory area where data is stored.
Size specifies "4*Dimension".
Ex.) Standard Deviation (V) (Xpixel x Ypixel): real data(Ypixel * Xpixel)

status = AMTK_set_GridFloat(HDF_file_id, data, access_lbl)
Namereturn value

statusType

IN/OUT

Size

Description

integer

output1

Normal：0
Error ： A negative value returns when it is notpossible to set it.

hid_t
real
integer

input
input
input

1
1
1

HDF access file id
Memory area where data is stored
Please refer to "6.1.1 the HDF access label".

parameter

HDF_file_id
data
access_lbl

5-30

5.3

Scan number
The AMTK function executes to in/out-put with pointing the scan number. The scan number starts from 1 on L1 and L2 product. About overlap segment to
be included in a L1 product, it is necessary to make a scan number of the dep
artment of scene data agree in L1 and L2. Show the details in the following fi
gure.
The scan number starts from 1

L1 productOverlap
segment( front )L2 ProductOverlap
segment(behind)

Scene data segment

Scene data segment

SceanStart

SceanEndThe normal access is taken for scene data segment only. In the case of a user
accesses an overlap segment with a L1 product, use the following values.
Overlap segment (front)：negative number ~ 0
Overlap segment (behind)：SeanEnd＋Overlap
The SceanStart and SceanEnd of the Scene data segment is defined as OverlapSca
ns and NumberOfScans.
SceanStart：OverlapScans＋１
SceamEnd ：OverlapScans＋NumberOfScans
For all scan segment, the number of the scan is defined as follows.
Scean scan number：NumberOfScans

Product scan number ：NumberOfScans＋OverlapScans×２
As the L2 product, the value of the Scean scan number is the same as the Product scan number.As the L1 product, the value of the Scean scan number is not thesame as the Product scannumber so that there is the Overlap segments.
If the scan number set to AMTK functions is outside of the coverage of the Produ
ct scan number, it will be error.
The case that L1 input to L1 output (their overlap scan are same) and the case t
5-31

hat L1 input to L2 output (their overlap scan are not same) are shown as followe
d next page.

5-32

Input L1 ・Output L1
read：-19～2020
write：-19～2020

There is the data position on the memory in the top ofdata.
Top of the Scean data20

Top of data
0……

Data

on

End of the Scean data
2019

End of data
2039

the

memoryOverlap＝20

Beyond scan number

negative-19……

….0 1……

…

Overlap
segment

L1 Product 1

2000 2001……
2020
Overlap
segment

OverLap＝20

Beyond scan number

negative….0 1……

-19……

…

2000 2001……
Overlap
segment

Overlap
segment

L1product 2

2020

Input L1・Output L2
Read：-19～2020
Write：1～2000
The data position of the memory to write in appoints the scene data top.

Top of data
0……

Data

on

Top of the Scean data
20

End of the Scean data
2019

End of data
2039

the

memoryOverlap＝20

Beyond scan number

Negative-19……

L1 Product….0 1……

…

2000 2001……
Overlap
segment

Overlap
segment

Overlap＝0
1……

…

L2 Product

5-33

2000

2020

* The overlap scan number refers to the value of OverlapScans of Metadata. The
re aboveexample assuming the following information.
・L1 Product : OverlapScans = 20
・L2 Product : OverlapScans = 0

5-34

Stored value
The AMTK functions are classified by data type. On the other hand, the data s

5.4

tored in HDF are classified, too. Note the case that the type of AMTK function
is not the type of the data stored in HDF.
Show the following the value that is stored in HDF when data are made first and the valu stored when data in/out-put.
The Dataset are made with AMTK_setDimSize function. This function makes th
e Dataset with the appointed size and store the following value into HDF as initi
al value.
Type of
C-Language
Int
unsigned int
float
doubleunsihned charType of FortranStored value

Integer*4
real*4
real*8--3276665533-9997.0-9997.0253

Remarks

The value stored in the case of input and output is fixed by a function and a combination with the data type of the product to use. There are deficit value andan abnormal value for data to use. When there are not data in the appointed pla
ce, the deficit value sets it. When there are the abnormality value, the abnormal
value sets parity error. Deficit value, neither of the abnormal value process the scale factor to become a fixed price. Show below a function and the combination of
the data type of the product and deficit value, an abnormal value. The upper section of each column, deficit value, the lower berth show an abnormal value. Sho
w the data type with the model of the C language.
Type of
C-Language
Int

unsigned int

float
doubleunsihned charInt()

Float()-32768-32768.0-32767-32767.065535

65535.065534

65534.0―

Double()

UChar

―

―

―

―

―

―

-9999.0-9998.0

―

―

255
254

―

-9999.0-9998.0

―

255.0

255

254.0

5-35

Remarks

6 In/Out-put data
6.1 Data definition
6.1.1 HDF access lavel
The function of AMTK is made universally, and a number is given to each data set tospecify the data set that is an access unit of HDF.
A user appoints a direct number or uses the identifier defined as an access labelshown in the following table. When it in/out put the data set with appointing theaccess lave, it should refer the following medata at the function of AMTK. Therefore, itis neccssary to store an appropriate value for meta data beforehand. When there is nometa data, it returns an error number of the peculiarity every each meta data.
Refer to “7 Error Number ID” for the details.
Meta data
ProductName
OverlapScans

GeophysicalName

GranuleID
CoRegistrationParameterA1
CoRegistrationParameterA2

Projection
OrbitDirection
ProductionDateTime

description
It is referred to distinguish product classification.
It is referred to specify the scan number of the input andoutput object. (Refer to “5.3 Scan number”abut the scannumber.)
It is not referred in the case of product classification is L3.
In the case of product classification is L2 or L3, it is reffered
to distinguish Geophysical quantity. (Refer to “2.5
Geophysical quantity definition file“about the geophysicalquantity.)In the case of L3, it is referred to distinguish productclassification.
In the case of appointing the following access label, it isreferred to calculate a low frequency Lat/Long.
AM2_LATLON_06, AM2_LATLON_07,
AM2_LATLON_10,AM2_LATLON_18,
AM2_LATLON_23, AM2_LATLON_36,
AM2_LATLON_LO
In the case of appointing “AM2_GRID_LATLON” as accesslabel, it is referred to distinguish a map projection system.
When it runs AMTK_get_Grid03D(), it is referred to
distinguishaorbital direction.
When it runs AMTK_get_Grid03D(), it is referred to get a
production data time.

The following table shows the details of the contents in the following page.
Data name
The name of HDF file data set.
It is data type stored by HDF and the argument data type of theTypeaccess function.
There are access functions for input and output with. Select thefu
nction desired. “-“ indicates that the target function is not availa
ble. Be careful for there are different cases in a data type stored
Access function
by HDF anda access function. Even if integer value data is stor
ed away by data set, there is a case to become the access functi
on of the true numberical value to consider Scale Facter.
Access label
Access ID
Remarks

It is an identifier to access HDF data set. (Alias definition of the accessID)
A number for access to HDF data set.
Refernece information. (Ex. Valu of Scale Facter)6-1

6.1.1.1

L1A

Data name

Type(HDF)

Access function

Type
In

Access label

Access
ID

Out

6-2

1

Product Meta Data

2

Scan TimedoubleAM2_COM
MON_SCANTIME

AMTK_getScanTime

AMTK_setScanTime

AM2_SCAN_TIME_
DEF

10010

3

Position in Orbit

doubledouble

AMTK_get_SwathDouble

AMTK_set_SwathDouble

AM2_POS_ORBIT

10020

4

Navigation Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_NAVI

10030

5

Attitude Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_ATT

10040

6

Observation Count (6.9GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC06V

10050

7

Observation Count (6.9GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC06H

10060

8

Observation Count (7.3GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC07V

10070

9

Observation Count (7.3GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC07H

10080

10

Observation Count (10.7GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC10V

10090

11

Observation Count (10.7GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC10H

10100

12

Observation Count (18.7GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC18V

10110

13

Observation Count (18.7GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC18H

10120

14

Observation Count (23.8GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC23V

10130

15

Observation Count (23.8GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC23H

10140

16

Observation Count (36.5GHz,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC36V

10150

17

Observation Count (36.5GHz,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC36H

10160

18

Observation Count (89.0GHz-A,V)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC89AV

10170

19

Observation Count (89.0GHz-A,H)signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC89AH

10180

20

Observation Count (89.0GHz-B,V)signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC89BV

10190

Observation Count (89.0GHz-B,H)

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OC89BH

10200

signed int

signed int

AMTK_get_SwathIntー

AM2_OC_LO

10210

signed int

signed int

AMTK_get_SwathIntー

AM2_OC_89A

10220

signed int

signed int

AMTK_get_SwathIntー

AM2_OC_89B

10230

21

23

Observation Count (6.9GHz-36.5GHz,
V&H)
Observation Count (89GHz-A, V&H)

24

Observation Count (89GHz-B, V&H)

22

RemarkData name

Type(HDF)

Access function

Type
In

Access label
Out

AccessID

6-3

25

Hot Load Count 6 to 36

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_LO

10240

26

Hot Load Count 89

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_HI

10250

27

Cold Sky Mirror Count 6 to 36

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_LO

10260

28

Cold Sky Mirror Count 89

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_HI

10270

29

Rx Offset_Gain Count

unsigned int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

10290

30

Latitude of Observation Point for 89A

float

float

Refer to LATLON function

Refer to LATLON function

31

Longitude of Observation Point for 89A

float

float

Refer to LATLON function

Refer to LATLON function

32

Latitude of Observation Point for 89B

float

float

Refer to LATLON function

Refer to LATLON function

33

Longitude of Observation Point for 89B

float

float

Refer to LATLON function

Refer to LATLON function

AM2_OFF_GAIN
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function

34

Sun Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_AZ

10300

35

Sun Elevation

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_EL

10310

36

Earth Incidence

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_EARTH_INC

10320

37

Earth Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_EARTH_AZ

10330

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_LO

10340

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_HI

10350

unsignedchar
unsigned
char

-

38

Land_Ocean Flag 6 to 36

39

Land_Ocean Flag 89

40

Observation Supplement

binary(2byte)unsignedchar *2

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_OB_SPL

10420

41

SPC Temperature Count

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SPC_TEMP

10430

42

SPS Temperature Count

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SPS_TEMP

10440

43

PCD Data

binary(64byte)unsignedchar *64

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PCD

10450

44

Scan Data Quality

binary(512byte)

512byte を
float *128 に分割

AMTK_getScanDataQuality

AMTK_setScanDataQualityAM2_SCAN_QUAL

10460

RemarkData name

Type(HDF)

Access functionType
1bit を
unsignedchar に変換(unsigned
char*16 になる)
1bit を
unsignedchar に変換(unsigned
char*8 になる)

Access label

AccessID

In

Out

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_L
O

10470

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_H
I

10480

45

Pixel Data Quality 6 to 36

binary(2byte)46

Pixel Data Quality 89

binary(1byte)47

Interpolation Flag 6 to 36

binary(1byte)unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_LO

10490

48

Interpolation Flag 89

binary(1byte)unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_HI

10500

Remark

6-4

6.1.1.2

L1B
Access function

Data name

Type(HDF)

Type

Access label
In

1

Product Meta Data

Out-

Access
ID
-

6-5

2

Scan TimedoubleAM2_COMMO
N_SCANTIME

3

Position in Orbit

doubledouble

AMTK_get_SwathDouble

AMTK_set_SwathDouble

AM2_POS_ORBIT

10020

4

Navigation Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_NAVI

10030

5

Attitude Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_ATT

10040

6

Brightness Temperature (6.9GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB06V

11050

7

Brightness Temperature (6.9GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB06H

11060

8

Brightness Temperature (7.3GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB07V

11070

9

Brightness Temperature (7.3GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB07H

11080

10

Brightness Temperature (10.7GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB10V

11090

11

Brightness Temperature (10.7GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB10H

11100

12

Brightness Temperature (18.7GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB18V

11110

13

Brightness Temperature (18.7GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB18H

11120

14

Brightness Temperature (23.8GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB23V

11130

15

Brightness Temperature (23.8GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB23H

11140

16

Brightness Temperature (36.5GHz,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB36V

11150

17

Brightness Temperature (36.5GHz,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB36H

11160

18

Brightness Temperature (89.0GHz-A,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89AV

11170

19

Brightness Temperature (89.0GHz-A,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89AH

11180

20

Brightness Temperature (89.0GHz-B,V)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89BV

11190

Brightness Temperature (89.0GHz-B,H)

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89BH

11200

unsigned int

float

AMTK_get_SwathFloatー

AM2_TB_LO

11210

unsigned int

float

AMTK_get_SwathFloatー

AM2_TB_89A

11220

unsigned int

float

AMTK_get_SwathFloatー

AM2_TB_89B

11230

21
22
23
24

Brightness Temperature(6.9GHz-36.5GHz, V&H)
Brightness Temperature (89GHz-A,
V&H)
Brightness Temperature (89GHz-B,
V&H)

AMTK_getScanTime

AMTK_setScanTime

AM2_SCAN_TIM
E_DEF

10010

RemarkAccess function
Data name

Type(HDF)

Type
In

Access label

AccessID

Out

25

Hot Load Count 6 to 36

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_LO

10240

26

Hot Load Count 89

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_HI

10250

27

Cold Sky Mirror Count 6 to 36

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_LO

10260

28

Cold Sky Mirror Count 89

signed int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_HI

10270

29

Rx Offset_Gain Count

unsigned int

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_OFF_GAIN

10290

Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function

6-630

Latitude of Observation Point for 89A

float

float

31

Longitude of Observation Point for 89A

float

float

32

Latitude of Observation Point for 89B

float

float

33

Longitude of Observation Point for 89B

float

float

34

Sun Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_AZ

10300

35

Sun Elevation

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

10310

36

Earth Incidence

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_EL
AM2_EARTH_IN
C

37

Earth Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_EARTH_AZ

10330

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_LO

10340

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_HI

10350

unsignedchar
unsignedchar

Refer to LATLON function

Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function

Refer to LATLON function
Refer to LATLON function
Refer to LATLON function

-

10320

38

Land_Ocean Flag 6 to 36

39

Land_Ocean Flag 89

40

Observation Supplement

binary(2byte)unsigned char
*2

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_OB_SPL

10420

41

SPC Temperature Count

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SPC_TEMP

10430

42

SPS Temperature Count

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SPS_TEMP

10440

43

PCD Data

binary(64byte)unsigned char
*64

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_PCD

10450

44

Scan Data Quality

binary(512byte)

AMTK_getScanDataQuality

AMTK_setScanDataQualityAM2_SCAN_QUA
L

10460

45

Pixel Data Quality 6 to 36

binary(2byte)

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_
LO

10470

Convert from512byte to
float *128
Convert from
1bit tounsignedchar(unsigned
char*16)

RemarkAccess function
Data name

Type(HDF)

Type
In

Out

Access label

AccessID

Convert from
1bit tounsignedchar(unsigned
char*16)

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_
HI

10480

46

Pixel Data Quality 89

binary(1byte)47

Interpolation Flag 6 to 36

binary(1byte)unsigned char

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_LO

10490

48

Interpolation Flag 89

binary(1byte)unsigned char

AMTK_set_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_HI

10500

Remark

6-7

6.1.1.3

L1R

Data name

Type(HDF)

Access function

Type
In

1

Product Meta Data

Access label
Out-

AccessID-

2

Scan TimedoubleAM2_COMM
ON_SCANTI
ME

3

Position in Orbit

doubledouble

AMTK_get_SwathDouble

AMTK_set_SwathDouble

AM2_POS_ORBIT

10020

4

Navigation Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_NAVI

10030

5

Attitude Data

float

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_ATT

10040

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AMTK_getScanTime

AMTK_setScanTime

AM2_SCAN_TIME_
DEF

10010

<6GHz resolution>
6

6-8

7
8
9
10
11
12
13
14
15
16
17
18
19

Brightness Temperature(res06,6.9GHz,V)
Brightness Temperature(res06,6.9GHz,H)
Brightness Temperature(res06,7.3GHz,V)
Brightness Temperature(res06,7.3GHz,H)
Brightness Temperature(res06,10.7GHz,V)
Brightness Temperature(res06,10.7GHz,H)
Brightness Temperature(res06,18.7GHz,V)
Brightness Temperature(res06,18.7GHz,H)
Brightness Temperature(res06,23.8GHz,V)
Brightness Temperature(res06,23.8GHz,H)
Brightness Temperature(res06,36.5GHz,V)
Brightness Temperature(res06,36.5GHz,H)
Brightness Temperature(res06,89.0GHz,V)
Brightness Temperature

AM2_RES06_TB06
V
AM2_RES06_TB06
H
AM2_RES06_TB07
V
AM2_RES06_TB07
H
AM2_RES06_TB10
V
AM2_RES06_TB10
H
AM2_RES06_TB18
V
AM2_RES06_TB18
H
AM2_RES06_TB23
V
AM2_RES06_TB23
H
AM2_RES06_TB36
V
AM2_RES06_TB36
H
AM2_RES06_TB89
V
AM2_RES06_TB89

12050
12060
12070
12080
12090
12100
12110
12120
12130
12140
12150
12160
12170
12180

RemarkData name

Type(HDF)

Access function

Type
In

Access label
Out(res06,89.0GHz,H)
20

Brightness Temperature (res06,all)AccessID

Hーunsigned int

float

AMTK_get_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_RES06_TB_A
LL

12190

<10GHz resolution>
21
22
23
24
25
26
27

6-9

28
29
30
31

32
33
34
35
36
37
38
39

Brightness Temperature(res10,10.7GHz,V)
Brightness Temperature(res10,10.7GHz,H)
Brightness Temperature(res10,18.7GHz,V)
Brightness Temperature(res10,18.7GHz,H)
Brightness Temperature(res10,23.8GHz,V)
Brightness Temperature(res10,23.8GHz,H)
Brightness Temperature(res10,36.5GHz,V)
Brightness Temperature(res10,36.5GHz,H)
Brightness Temperature(res10,89.0GHz,V)
Brightness Temperature(res10,89.0GHz,H)
Brightness Temperature (res10,all)<23GHz resolution>
Brightness Temperature(res23,18.7GHz,V)
Brightness Temperature(res23,18.7GHz,H)
Brightness Temperature(res23,23.8GHz,V)
Brightness Temperature(res23,23.8GHz,H)
Brightness Temperature(res23,36.5GHz,V)
Brightness Temperature(res23,36.5GHz,H)
Brightness Temperature(res23,89.0GHz,V)
Brightness Temperatureー

AM2_RES10_TB10
V
AM2_RES10_TB10
H
AM2_RES10_TB18
V
AM2_RES10_TB18
H
AM2_RES10_TB23
V
AM2_RES10_TB23
H
AM2_RES10_TB36
V
AM2_RES10_TB36
H
AM2_RES10_TB89
V
AM2_RES10_TB89
H
AM2_RES10_TB_A
LL
AM2_RES23_TB18
V
AM2_RES23_TB18
H
AM2_RES23_TB23
V
AM2_RES23_TB23
H
AM2_RES23_TB36
V
AM2_RES23_TB36
H
AM2_RES23_TB89
V
AM2_RES23_TB89

12200
12210
12220
12230
12240
12250
12260
12270
12280
12290
12300

12310
12320
12330
12340
12350
12360
12370
12380

RemarkData name

Type(HDF)

Access function

Type
In

Access labelOut(res23,89.0GHz,H)
40

41
42
43
44
45

Brightness Temperature (res23,all)<36GHz resolution>
Brightness Temperature(res36,36.5GHz,V)
Brightness Temperature(res36,36.5GHz,H)
Brightness Temperature(res36,89.0GHz,V)
Brightness Temperature(res36,89.0GHz,H)
Brightness Temperature (res36,all)AccessID

H
AM2_RES23_TB_A
LL

12390

AMTK_set_SwathFloat

AM2_RES36_TB36
V

12400

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_RES36_TB36
H

12410

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89AV

11170

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89AH

11180

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89BV

11190

unsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_TB89BH

11200

unsigned int

float

AMTK_get_SwathFloatー

AM2_TB_89A

11220

unsigned int

float

AMTK_get_SwathFloatー

AM2_TB_89B

11230

unsigned int

float

AMTK_get_SwathFloat

unsigned int

float

AMTK_get_SwathFloat

unsigned int

float

unsigned int

ーー

AM2_RES36_TB89
V
AM2_RES36_TB89
H
AM2_RES36_TB_A
LL

12420
12430
12440

<89GHz resolution>

6-10

46
47
48
49
50
51

Brightness Temperature(original,89GHz-A,V)
Brightness Temperature(original,89GHz-A,H)
Brightness Temperature(original,89GHz-B,V)
Brightness Temperature(original,89GHz-B,H)
Brightness Temperature(original,89GHz-A,V&H)
Brightness Temperature(original,89GHz-B,V&H)

Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function

Refer to LATLON function

Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
Refer to LATLON
function
AM2_MEAN_HEIG
HT

52

Latitude of Observation Point for 89A

float

float

53

Longitude of Observation Point for 89A

float

float

54

Latitude of Observation Point for 89B

float

float

55

Longitude of Observation Point for 89B

float

float

56

Area Mean Heightsigned int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

57

Sun Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_AZ

10300

58

Sun Elevation

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_SUN_EL

10310

Refer to LATLON function
Refer to LATLON function
Refer to LATLON function

12510

RemarkData name

Type(HDF)

Access function

Type
In

Access label
Out

AccessID

59

Earth Incidence

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_EARTH_INC

10320

60

Earth Azimuth

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

AM2_EARTH_AZ

10330

61

Land_Ocean Flag 6 to 36

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_RES_LO

12560

62

Land_Ocean Flag 89

signed int

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_RES_HI

12570

AMTK_getScanDataQual
ity

AMTK_setScanDataQualityAM2_SCAN_QUAL

10460

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_L
O

10470

unsignedchar
unsignedchar

63

Scan Data Quality

binary(512byte)

64

Pixel Data Quality 6 to 36

binary(2byte)6-11

65

Pixel Data Quality 89

binary(1byte)Convert form
512byte to
float *128
Convert form
1bittounsignedchar(unsigned
char*16)
Convert form
1bittounsignedchar(unsigned
char*16)

RemarkInt or Float

Refer to
6.1.1.7
AMTK_get_SwathUChar

AMTK_set_SwathUChar
AM2_PIX_QUAL_H
I

AMTK_get_SwathInt

AMTK_set_SwathInt

10480

6.1.1.4

L2
Access function

Data name

Type(HDF)

Type

Access label
In

Out

AccessID

RemarkLow resolution
1

Product Meta Data

-

-

2

Scan TimedoubleAM2_COM
MON_SCAN
TIME

3

Position in Orbit

doubledouble

AMTK_getScanTime

AMTK_setScanTime

AM2_SCAN_TIME_DEF

10010

AMTK_get_SwathDouble

AMTK_set_SwathDouble

AM2_POS_ORBIT

10020

AM2_SWATH_GEO1

21030

AM2_SWATH_GEO2

21040

AM2_SWATH_GEO3

21050

AM2_SWATH_GEOA

21060

4
5
6

Geophysical Data

signed int

float

6-12

AMTK_get_SwathFloat

AMTK_set_SwathFloat

Refer
to
function
Refertofunction

Refertofunction
Refertofunction

78

Latitude of Observation Point

float

float

9

Longitude of Observation Point

float

float

10

Pixel Data Quality

binary(1byte)unsignedchar

LATLONLATLONLATLONLATLONAMTK_get_SwathUChar

AMTK_set_SwathUChar

AMTK_get_SwathDouble
AMTK_get_SwathDouble

AMTK_set_SwathDouble
AMTK_set_SwathDoubleRefer to LATLON function-

Refer to LATLON function-

AM2_PIX_QUAL

21070

Refert toNote 1 and6.1.1.7

Refert to
6.1.1.7

High resolution
1

Product Meta Data

-

-

2

Scan Timedoubledouble3

Position in Orbit

doubledouble45
6

AMTK_get_SwathFloat
Geophysical Data for 89A

signed int

float

AMTK_set_SwathFloat

7
8

Geophysical Data for 89B

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat-

AM2_SCAN_TIME_DEF

10010

AM2_POS_ORBIT

10020

AM2_SWATHA_GEO1

22030

AM2_SWATHA_GEO2

22040

AM2_SWATHA_GEO3

22050

AM2_SWATHA_GEOA

22060

AM2_SWATHB_GEO1

22070

Refert toNote 1 and6.1.1.7
Refert toAccess function
Access label

AccessID

Remark9

AM2_SWATHB_GEO2

22080

10

AM2_SWATHB_GEO3

22090

Note 1 and6.1.1.7

11

AM2_SWATHB_GEOA

22100

Refer to LATLON function-

Refer to LATLON function-

Refer to LATLON function-

Refer to LATLON function-

Data name

Type(HDF)

Type
In

Refer
to
function
Refertofunction
Refertofunction
RefertofunctionOut

LATLONRefer
tofunction
Refertofunction
Refertofunction
RefertofunctionLATLON

6-13

12

Latitude of Observation Point for 89A

float

float

13

Longitude of Observation Point for
89A

float

float

14

Latitude of Observation Point for 89B

float

float

15

Longitude of Observation Point for
89B

float

float

16

Pixel Data Quality for 89A

binary(1byte)unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_A

22110

Refert to
6.1.1.7

17

Pixel Data Quality for 89B

binary(1byte)unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_B

22120

Refert to
6.1.1.7

LATLONLATLONLATLONLATLONLATLONLATLON

Note 1 : show the Scale factors
scale factor
Physical amount
Name
Mark
Integrated Water vapor
TPW
Integrated Cloud liquid Water
CLW
Sea Surface Winds
SSW
Sea Surface Temperature
SST
Sea Ice Concentration
SIC
Snow Depth
SND
Soil Moisture
SMC
Precipitation Rate
PRC

unit
kg/m2
kg/m2
m/s
℃
%
cm
%
mm/h

0.01
0.001
0.01
0.01
0.1
0.1
0.1
0.01

6-14

6.1.1.5 L3
Daily (High resolution)
Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Access ID

RemarkData nameOut

EQR, brightness temperature
1

ProductMeta Data-

2

Brightness Temperature (V)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBV

31010

-

3

Brightness Temperature (H)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBH

31020

4

Brightness Temperature (V&H)

signed int

float

AMTK_get_GridFloat

AM2_GRID_TB

31030

5

Time Information

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TIME

31040

ー
AMTK_set_GridInt

PS The North, Brightness temperature

6-15

1

ProductMeta Data

-

-

2

Brightness Temperature (V)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBV

31010

3

Brightness Temperature (H)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBH

31020

4

Brightness Temperature (V&H)

signed int

float

AMTK_get_GridFloat

AM2_GRID_TB

31030

5

Time Information

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TIME

31040

ー
AMTK_set_GridInt

PS The south, Brightness temperature
1

ProductMeta Data

-

-

2

Brightness Temperature (V)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBV

31010

3

Brightness Temperature (H)signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBH

31020

4

Brightness Temperature (V&H)

signed int

float

AMTK_get_GridFloat

AM2_GRID_TB

31030

5

Time Information

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TIME

31040

ー
AMTK_set_GridInt

EQR, physical quantity
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

3

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

4

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

Refert to Note
1 and 6.1.1.7

Data
name

Type(HDF)

Type

Accessfunction

Access label
Access ID
In

5

6Time Information

signed int

signed int

AMTK_get_GridInt

RemarkData nameOut

AMTK_set_GridInt

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

PS The north, Sea Ice Concentration
1

ProductMeta Data

-

-

2
3

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

4
56Time Information

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

Refert to Note
1 and 6.1.1.7

6-16

PS The south, Sea Ice Concentration
1

ProductMeta Data

-

-

2
3
4

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

5
6Time Information

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

Refert to Note
1 and 6.1.1.7

PS The north, Snow Depth
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

4

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

3
Geophysical Data

6

Time Information

signed int

signed int

float

signed int

AMTK_get_GridFloat

AMTK_get_GridInt

AMTK_set_GridFloat

AMTK_set_GridInt

Refert to
6.1.1.7

Daily (Low resolution)
Data
name

Type(HDF)

Type

Accessfunction

Access label
Access ID
In

RemarkData nameOut

EQR, Brightness temperature
1

ProductMeta Data-

2

Brightness Temperature (V)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBV

31010

3

Brightness Temperature (H)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBH

31020

Brightness Temperature (V&H)

unsigned int

float

AMTK_get_GridFloat

AM2_GRID_TB

31030

Time Information

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_TIME

31040

AM2_GRID_TBV

31010

4

-

ー

PS The north, Brightness temperature

6-17

1

ProductMeta Data

2

Brightness Temperature (V)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

3

Brightness Temperature (H)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

Brightness Temperature (V&H)

unsigned int

float

AMTK_get_GridFloat

Time Information

signed int

signed int

AMTK_get_GridInt

4-

ー
AMTK_set_GridInt

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TIME

31040

PS Southern, Brightness temperature
1

ProductMeta Data-

2

Brightness Temperature (V)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBV

31010

3

Brightness Temperature (H)unsigned int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_TBH

31020

Brightness Temperature (V&H)

unsigned int

float

AMTK_get_GridFloat

AM2_GRID_TB

31030

Time Information

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TIME

31040

4

-

ー
AMTK_set_GridInt

EQR, physical quantity
1

ProductMeta Data

-

-

2
3
4

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

Refert to Note
1 and 6.1.1.7

Data
name

Type(HDF)

Type

Accessfunction

Access label
Access ID
In

5
6Time Information

signed int

signed int

AMTK_get_GridInt

RemarkData nameOut

AMTK_set_GridInt

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

PS The north, Sea Ice Concentration
1

ProductMeta Data

-

-

2
3
4

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

5
6Time Information

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

Refert to Note
1 and 6.1.1.7

6-18

PS The south, Sea Ice Concentration
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

4

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

AM2_GRID_TIME

31040

3
Geophysical Data

6

Time Information

signed int

signed int

float

signed int

AMTK_get_GridFloat

AMTK_get_GridInt

AMTK_set_GridFloat

AMTK_set_GridInt

Refert to Note
1 and 6.1.1.7

PS The north, Snow Depth
1

ProductMeta Data

-

-

2
3
4
5

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

AM2_GRID_GEOA

31340

Refert to Note
1 and 6.1.1.7

Data
name

6

Type(HDF)

Time InformationTypesigned int

Accessfunctionsigned int

Access label
Access IDIn

AMTK_get_GridInt

RemarkOut

AMTK_set_GridInt

AM2_GRID_TIME

31040

Data name6-19

Monthly (High resolution)
Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

Access ID

Remark

EQR, Brightness temperature
1

ProductMeta Data

unsigned int

-

6-20

2

Brightness Temperature (V)3Brightness Temperature (H)4Brightness Temperature (V&H)

5Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

12

Total Number (H)signed int

signed int

AMTK_get_GridInt

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

unsigned int
unsigned int

float
float
float

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

AM2_GRID_TBV_ANUM

34170

AM2_GRID_TBH_ANUM

34180

ー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TB_ANUM

34190

AM2_GRID_TBV_TNUM

34200

AM2_GRID_TBH_TNUM

34210

ー

AM2_GRID_TB_TNUM

34220

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oatー
AMTK_set_GridInt
AMTK_set_GridInt

Data name

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkPS The north, Brightness temperature
1
2

ProductMeta Data
Brightness Temperature (V)unsigned int
unsigned int

float

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

6-21

3

Brightness Temperature (H)4Brightness Temperature (V&H)

5Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_TBV_ANUM

34170

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_TBH_ANUM

34180

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TB_ANUM

34190

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

AM2_GRID_TBV_TNUM

34200

12

Total Number (H)signed int

signed int

AMTK_get_GridIntー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TBH_TNUM

34210

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

ー

AM2_GRID_TB_TNUM

34220

unsigned int

float

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloa
t

float

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oatーData name

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkPS The south, Brightness temperature
1
2

ProductMeta Data
Brightness Temperature (V)unsigned int
unsigned int

float

6-22

3

Brightness Temperature (H)4Brightness Temperature (V&H)

5Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

12

Total Number (H)signed int

signed int

AMTK_get_GridInt

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

unsigned int

float

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloa
t

float

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

AM2_GRID_TBV_ANUM

34170

AM2_GRID_TBH_ANUM

34180

ー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TB_ANUM

34190

AM2_GRID_TBV_TNUM

34200

AM2_GRID_TBH_TNUM

34210

ー

AM2_GRID_TB_TNUM

34220

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oatー
AMTK_set_GridInt
AMTK_set_GridInt

Data name

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkData name

EQR, Physical amount1

ProductMeta Data

-

-

2
3
4

Geophysical Data

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFl
oat

5

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

7

AM2_GRID_GEO2_STD

34520

8

Standard Deviation

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFl
oat

6-23

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

11

AM2_GRID_GEO2_ANUM

34560

AM2_GRID_GEO3_ANUM

34570

12

Average Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

15
16
17

Total Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkData name

PS The north, Sea Ice Concentration
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

3
4

7
8

11

6-24

12

Geophysical Data

Standard Deviation

Average Number

signed int

signed int

signed int

float

float

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

15

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

16
17

Total Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkData name

PS The southern, Sea Ice Concentration
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

3
4

7
8

11

6-25

12

Geophysical Data

Standard Deviation

Average Number

signed int

signed int

signed int

float

float

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

15

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

16
17

Total Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Data
name

Type(HDF)

Type

Accessfunction

Access label
In

Out

Access ID

RemarkData name

PS The south, Sea Ice Concentration
1

ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

3
4

7
8

11

6-26

12

Geophysical Data

Standard Deviation

Average Number

signed int

signed int

signed int

float

float

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

15

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

16
17

Total Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Refer toNote 1 and6.1.1.7

Monthly (Low resolution)

Data
name

Type(HDF)

Type

Accessfunction

Access label
Access ID
In

Out

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

Remark

EQR, Brightness temperature
1
2
3

ProductMeta Data
Brightness Temperature (V)Brightness Temperature (H)unsigned int
unsigned int
unsigned int

float
float

4

Brightness Temperature (V&H)

float

5

Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

6-27

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

12

Total Number (H)signed int

signed int

AMTK_get_GridInt

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

AM2_GRID_TBV_ANUM

34170

AM2_GRID_TBH_ANUM

34180

ー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TB_ANUM

34190

AM2_GRID_TBV_TNUM

34200

AM2_GRID_TBH_TNUM

34210

ー

AM2_GRID_TB_TNUM

34220

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oatー
AMTK_set_GridInt
AMTK_set_GridInt

Data name

Data
name

Type(HDF)

PS The North , Brightness temperature
1
ProductMeta Data
2

Brightness Temperature (V)3Brightness Temperature (H)4Brightness Temperature (V&H)

Type

Accessfunction

Access label
Access ID
In

Out

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

unsigned int
unsigned int
unsigned int

Remark

float
float
float

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

6-28

5

Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_TBV_ANUM

34170

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

AM2_GRID_TBH_ANUM

34180

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TB_ANUM

34190

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

AM2_GRID_TBV_TNUM

34200

12

Total Number (H)signed int

signed int

AMTK_get_GridIntー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TBH_TNUM

34210

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

ー

AM2_GRID_TB_TNUM

34220

ー

Data name

Data
name

Type(HDF)

PS The south, Brightness temeperature
1
ProductMeta Data
2

Brightness Temperature (V)3Brightness Temperature (H)4Brightness Temperature (V&H)

Type

Accessfunction

Access label
Access ID
In

Out

AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat
AMTK_get_GridFloat

AMTK_set_GridFl
oat
AMTK_set_GridFl
oat

unsigned int
unsigned int
unsigned int

Remark

float
float
float

6-29

5

Standard Deviation (V)signed int

float

6

Standard Deviation (H)signed int

float

7

Standard Deviation (V&H)

signed int

float

8

Average Number (V)signed int

signed int

AMTK_get_GridInt

9

Average Number (H)signed int

signed int

AMTK_get_GridInt

10

Average Number (V&H)

signed int

signed int

AMTK_get_GridInt

11

Total Number (V)signed int

signed int

AMTK_get_GridInt

12

Total Number (H)signed int

signed int

AMTK_get_GridInt

13

Total Number (V&H)

signed int

signed int

AMTK_get_GridInt

AM2_GRID_TBV

31010

AM2_GRID_TBH

31020

AM2_GRID_TB

31030

AM2_GRID_TBV_STD

34140

AM2_GRID_TBH_STD

34150

AM2_GRID_TB_STD

34160

AM2_GRID_TBV_ANUM

34170

AM2_GRID_TBH_ANUM

34180

ー
AMTK_set_GridInt
AMTK_set_GridInt

AM2_GRID_TB_ANUM

34190

AM2_GRID_TBV_TNUM

34200

AM2_GRID_TBH_TNUM

34210

ー

AM2_GRID_TB_TNUM

34220

ー
AMTK_set_GridFl
oat
AMTK_set_GridFl
oatー
AMTK_set_GridInt
AMTK_set_GridInt

Data name

Data
name

Type(HDF)

EQR, Physical quantity
1
ProductMeta DataType

Accessfunction

Access label
Access ID
In

Remark--2

AM2_GRID_GEO1

31310

3

AM2_GRID_GEO2

31320

4

AM2_GRID_GEO3

31330

Geophysical Data

signed int

float

AMTK_get_GridFloa
tRefer toNote1 and
6.1.1.7

AMTK_set_GridFl
oat

6-30

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

AM2_GRID_GEO2_TNUM

34600

16

AM2_GRID_GEO3_TNUM

34610

17

AM2_GRID_GEOA_TNUM

34620

7
Standard Deviation

signed int

float

8

AMTK_get_GridFloa
t

11
12

15

Average Number

Total Number

Data nameOutsigned int

signed int

signed int

signed int

AMTK_get_GridInt

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridInt

AMTK_set_GridInt

Refer toNote1 and
6.1.1.7

Refer toNote1 and
6.1.1.7

Refer toNote1 and
6.1.1.7

Data
name

Type(HDF)

PS The North Sea Ice Concentration
1
ProductMeta DataType

Accessfunction

Access label
Access ID
In

Remark--2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

3
4

Geophysical Data

signed int

float

7
Standard Deviation

signed int

float

8

AMTK_get_GridFloat

AMTK_get_GridFloa
t

6-31

11
Average Number

signed int

signed int

AMTK_get_GridInt

12

15
Total Number
16
17

Data nameOutsigned int

signed int

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AMTK_set_GridInt

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Data
name

Type(HDF)

PS The South, Sea Ice Concentration
1
ProductMeta DataType

Accessfunction

Access label
Access ID
In

Remark--2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

3
4

Geophysical Data

signed int

float

7
Standard Deviation

signed int

float

8

6-32

11

Average Number

signed int

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

12

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

15
Total Number
16
17

Data nameOutsigned int

signed int

AMTK_get_GridInt

AMTK_set_GridInt

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Data
name

Type(HDF)

PS The south, Sea Ice Concentration
1
ProductMeta DataType

Accessfunction

Access label
Access ID
In

Remark--2

AM2_GRID_GEO1

31310

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

3
4

Geophysical Data

signed int

float

7
Standard Deviation

signed int

float

8

6-33

11

Average Number

signed int

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

12

15
16
17

Total Number

Data nameOutsigned int

signed int

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AMTK_set_GridInt

AM2_GRID_GEO2_TNUM
AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

PS The north, Snow Depth
1
ProductMeta Data

-

-

2

AM2_GRID_GEO1

31310

3

AM2_GRID_GEO2

31320

AM2_GRID_GEO3

31330

5

AM2_GRID_GEOA

31340

6

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD

34520

AM2_GRID_GEO3_STD

34530

9

AM2_GRID_GEOA_STD

34540

10

AM2_GRID_GEO1_ANUM

34550

AM2_GRID_GEO2_ANUM

34560

AM2_GRID_GEO3_ANUM

34570

13

AM2_GRID_GEOA_ANUM

34580

14

AM2_GRID_GEO1_TNUM

34590

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

4

Geophysical Data

signed int

float

7
Standard Deviation

signed int

float

8

6-34

11

Average Number

signed int

signed int

AMTK_get_GridFloat

AMTK_get_GridFloat

AMTK_get_GridInt

12

15
16
17

Total Number

signed int

signed int

AMTK_get_GridInt

AMTK_set_GridFl
oat

AMTK_set_GridFl
oat

AMTK_set_GridInt

AMTK_set_GridInt

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

Refer to
6.1.1.7

6.1.1.6
Data
name

LATLON function

Type(HDF)

Type

1

LatitudeLongitude ( L1A/L1B 6.9GHz)

float

2

LatitudeLongitude ( L1A/L1B 7.3GHz)

float

3

LatitudeLongitude ( L1A/L1B 10.7GHz)

float

4

LatitudeLongitude ( L1A/L1B 18.7GHz)

float

5

LatitudeLongitude ( L1A/L1B 23.8GHz)

float

6

6-35

7
8

LatitudeLongitude ( L1A/L1B 36.5GHz)
LatitudeLongitude ( L1A/L1B
89.0GHz-A)
LatitudeLongitude ( L1A/L1B
89.0GHz-B)

float
float
float

9

LatitudeLongitude ( L1A/L1B Low
Mean)

float

10

LatitudeLongitude ( L1R 89A)

float

11

LatitudeLongitude ( L1R 89B)

float

12

LatitudeLongitude ( L1R resampling )

float

13

LatitudeLongitude ( L2 Low-Res)

float

14

LatitudeLongitude ( L2 High-Res 89A)

float

15

LatitudeLongitude ( L2 High-Res 89B)

float

16

LatitudeLongitude ( L3 daily/monthly
High-Res EQR )float

Access function
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON

AM2_COMMON_LATL
ON

AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON

Access label

Access ID

Remark―AM2_LATLON_06

40010

AMTK_getLatLon―

AM2_LATLON_07

40020

AMTK_getLatLon―

AM2_LATLON_10

40030

AMTK_getLatLon―

AM2_LATLON_18

40040

AMTK_getLatLon―

AM2_LATLON_23

40050

AMTK_getLatLon―

AM2_LATLON_36

40060

AM2_LATLON_89A

40070

HDF hangar

AM2_LATLON_89B

40080

HDF hangar

AM2_LATLON_LO

40090

AM2_LATLON_RS_89A

40100

AM2_LATLON_RS_89B

40110

In

Out

AMTK_getLatLon

AMTK_getLatLon
AMTK_getLatLon

AMTK_getLatLon

AMTK_getLatLon
AMTK_getLatLon

AMTK_getLatLon

AMTK_getLatLon
AMTK_getLatLon
AMTK_getLatLon
AMTK_getLatLon

AMTK_setLat
Lon
AMTK_setLat
Lon―
AMTK_setLat
Lon
AMTK_setLat
Lon―

AMTK_setLat
Lon
AMTK_setLat
Lon
AMTK_setLat
Lon―

AM2_LATLON_RS_LO

40120

AM2_LATLON_L2_LO

40130

AM2_LATLON_L2_89A

40140

AM2_LATLON_L2_89B

40150

AM2_GRID_LATLON

40160

Data nameReturn the eachchannellat/long-itude
calculated by theeach registrationfrom 89A point.

Return the averagevalue of thelat/long-itude ofLow(06-36GHz)
Return thelat/long-itude.
Return thelat/long-itude.
Return theresampling point
even number of
AM2_LATLON_R
S_89A (start 1)

Return thelat/long-itude of
L2.
Return thelat/ling-itude from

Data
name
17
18
19
20
21

Type(HDF)
LatitudeLongitude ( L3 daily/monthly
High-Res PS North )LatitudeLongitude ( L3 daily/monthly
High-Res PS South )LatitudeLongitude ( L3 daily/monthly
Low-Res EQR )LatitudeLongitude ( L3 daily/monthly
Low-Res PS North )LatitudeLongitude ( L3 daily/monthly
Low-Res PS South )

Type
float
float
float
float
float

Access function
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON
AM2_COMMON_LATL
ON

Access label

Access ID

RemarkIn

Out

AMTK_getLatLon―

AM2_GRID_LATLON

40160

AMTK_getLatLon―

AM2_GRID_LATLON

40160

AMTK_getLatLon―

AM2_GRID_LATLON

40160

AMTK_getLatLon―

AM2_GRID_LATLON

40160

AMTK_getLatLon―

AM2_GRID_LATLON

40160

Data name
HDF metadata.
Specifying theStart/end number isinvalid.

6-36

6.1.1.7

Paticular Dataset(1) PIXEL DATA QUALITY(Access label：AM2_PIX_QUAL_LO ,AM2_PIX_QUAL_HI)
Plural unsigned char data are collected up and stored HDF.
AM2_PIX_QUAL_LO

AM2_PIX_QUAL_HI

6-37

0

1

1

0

2

1

0

1

3

0

1

0

4

1

2

1

3

0

4

1

5

0
1
0

5
6
7

0
76543210

11111154321098

10010101101010

8

0

6

9

1

7

10

0

11

1

12

0

13

1

14

0

15

1

76543210

01010101

Write: convert from 8 bytes data to 1 bytes.
Write: convert from 16bytes data to 2bytes.
Read: spread 1 bytes into 8 bytes data.
Read: spread 2 bytes into 16 bytes data.

(2) Give Specification for the layer structure (Access label：AM2_SWATHA_GEXX ,AM2_GRID_GEXX)
Note the differences of the data set of the layer structure and the designated of the access label at the time of generation andthe writing.
Show the a concept in the following figures.

AM2_SWATHA_GE03

HDF

DatasetAM2_SWATHA_GE02
AM2_SWATHA_GE01

AM2_SWATHA_GE0A

6-38
Generate：Create the three-dimension data with specifying the access label for AM2_SWATHA_GE0A.

Read/Write ：read/write to the two-dimension data with specifying the access label for AM2_SWATHA_GE01, GE02 and
GE03.
The array elements are different as follows to let a scan number position support in Create and Read/Write.
AM2_SWATHA_GE0A: Scan number is appointed as a two-dimensional element.
AM2_SWATHA_GE01 ,GE02 ,GE03 : Scan number is appointed as a one-dimensional element.

6.1.2

Geophysical quantity dataset
3-dimension dataset
In AMTK, it classify 3-dimensional data set in two kinds of “nomal 3-dimensional data set” and “3-dimensinal data set a

6.1.2.1

bout the geophysical quantity”. Then it offers a different input and output method each.
Both have each characteristic of “dimensions to express the number of the scan” when it in/out the size of data set.
Table 6.1-1 shows each input and output method.

Table 6.1-1 List of input and output methods of the 3-dimensional data set
Specification of the input and output

1

nomal 3-dimensional data set

When It inputs and outputs the size of the data set with AMTK_setDimSize() or
AMTK_getDimSize(), the number of the scan of the dimension size assumes it the second
dimension.
Ex.)
The size of Hot Load Count 6 to 36: number of channel * number of scan * number ofpixel
dimsize[0] = 12
dimsize[1] = 2000 // number of scan is at the second dimension.
dimsize[2] = 1623-dimensinal data set about the ge
ophysical quantity(Data set to access each layer hav
ing 1-3 levels two-dimensional dat
a individually)

When it input and output the size of the data set with AMTK_setDimSize() or
AMTK_getDimSize(), the number of the scan of the dimension size assumes it the 1st dimension
and the number of the layer assumes it the 3 rd dimension.
Ex.)
The size of Geopysical Data: number of scan * number of pixel * number of layer
dimsize[0] = 2000 // number of scan is at the 1st dimension.
dimsize[1] = 243
dimsize[2] = 3// number of layer is at the third dimension.

6-39

No. Type

6.1.2.1.1 Original 3-dimension dataset list
○L1
No.

Data set name

HDF storage
type

In/puttype

Input function

Output function

Access label

Access ID

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_LO

10240

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_HTS_HI

10250

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_LO

10260

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_CSM_HI

10270

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_LO

10340

signedint

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_HI

10350

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_L
O

10470

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_H
I

10480

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_LO

10490

L1A, L1B

6-40

1

Hot Load Count 6 to 36

signed int

2

Hot Load Count 89

signed int

3

Cold Sky Mirror Count 6 to 36

signed int

4

Cold Sky Mirror Count 89

signed int

5

Land_Ocean Flag 6 to 36

unsigned char6

Land_Ocean Flag 89

unsigned charbinary(2byte)= unsigned
char*2
binary (1byte)= unsigned
char*1binary (1byte)= unsigned
char*1signedint
signedint
signedint
signedint
signedint

7

Pixel Data Quality 6 to 36

8

Pixel Data Quality 89

9Interpolation Flag 6 to 36

10

Interpolation Flag 89

binary (1byte)= unsigned
char*1

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_INTPL_HI

10500

11

Land_Ocean Flag 6 to 36

unsigned charsignedint

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_RES_LO

12560

12

Land_Ocean Flag 89

unsigned charsignedint

AMTK_get_SwathInt

AMTK_set_SwathInt

AM2_LOF_RES_HI

12570

L1R

13

Pixel Data Quality 6 to 36

14

Pixel Data Quality 89

binary(2byte)= unsigned
char*2
binary (1byte)= unsigned
char*1

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_L
O

10470

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_H
I

10480

6-41

○L2
No.

Data set name

HDF storage
type

In/puttype

Input function

Output function

Access label

binary (1byte)= unsigned
char*1

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL

21070

Access ID

Low resolution
1

Pixel Data Quality

High resolution
2

Pixel Data Quality for 89A

binary (1byte)= unsigned
char*1

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_A

22110

3

Pixel Data Quality for 89B

binary (1byte)= unsigned
char*1

unsignedchar

AMTK_get_SwathUChar

AMTK_set_SwathUChar

AM2_PIX_QUAL_B

22120

6-42

6.1.2.1.2 3-dimension dataset of Geophysical quantity list
・AM2_*A of the access label inputs and outputs it as 3-dimensional data set (Scan * Pixel * Layer size).
・AM2_*1 - *3 of the access label inputs and outputs 2-dimensions of data of the layer of 1-3 as data set (Scan * Pixel siz
e).
○L2
No.

HDF storage
type

In/puttype

Output function

Access label

AMTK_set_SwathFloat

AM2_SWATH_GEO1
AM2_SWATH_GEO2
AM2_SWATH_GEO3
AM2_SWATH_GEOA

21030
21040
21050
21060

5

AM2_SWATHA_GEO1

22030

6
7
8
9

AM2_SWATHA_GEO2
AM2_SWATHA_GEO3
AM2_SWATHA_GEOA
AM2_SWATHB_GEO1

22040
22050
22060
22070

AM2_SWATHB_GEO2
AM2_SWATHB_GEO3
AM2_SWATHB_GEOA

22080
22090
22100

1
2
3
4

6-43

10
11
12

Data set name

Geophysical Data

signed int

float

Input function

AMTK_get_SwathFloat

Geophysical Data for 89A

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

Geophysical Data for 89B

signed int

float

AMTK_get_SwathFloat

AMTK_set_SwathFloat

Access ID

○L3
No.

HDF storage
type

In/puttype

Output function

Access label

AMTK_set_GridFloat

AM2_GRID_GEO1
AM2_GRID_GEO2
AM2_GRID_GEO3
AM2_GRID_GEOA

31310
31320
31330
31340

AM2_GRID_GEO1_STD

34510

AM2_GRID_GEO2_STD
AM2_GRID_GEO3_STD
AM2_GRID_GEOA_STD
AM2_GRID_GEO1_ANUM

34520
34530
34540
34550

AM2_GRID_GEO2_ANUM
AM2_GRID_GEO3_ANUM
AM2_GRID_GEOA_ANUM

34560
34570
34580

13

AM2_GRID_GEO1_TNUM

34590

14

AM2_GRID_GEO2_TNUM

34600

AM2_GRID_GEO3_TNUM

34610

AM2_GRID_GEOA_TNUM

34620

1
2
3
4

Data set name

Geophysical Data

signed int

float

Input function

AMTK_get_GridFloat

5
6
7
8
9
10
11
12

6-44

15
16

Standard Deviation

signed int

float

AMTK_get_GridFloat

AMTK_set_GridFloat

Average Number

signed int

signedint

AMTK_get_GridInt

AMTK_set_GridInt

Total Number

signed int

signedint

AMTK_get_GridInt

AMTK_set_GridInt

Access ID

6.1.2.1.3 A dimension to express the number of the scan of the 3-dimensional data set
The normal 3-dimensional data set handles the secound dimension with the number of the scan. On the other hand, t
he 3-dimensional data set about the quantity of physics handles the first dimension with the number ofthe scan. I show the difference of the dimension to express the number of the scan in the dimension s
ize of both to
Fig. 6-1.

K

A dimension toshow the numberof the scan isdifferent
fromothers.

K

The 3rd level input andoutput6-45

The 2nd level input
and output

J

J
I

I

The 1st level input andoutputNormal 3-dimensional data set

3-dimensinal data set about the Geophysical quantity# Number of scan: J# Number of scan: I(input and output 1-3 levels 2-dimension data individually.)I

Reference： one-dimensinal
data set# Number of scan: I

IJReference： two-dimensinal dataset
# Number of scan: I

For understanding detail of
relationshipofthedimension size, the array andthe numberof scan, refer thefollowing section.
5.1.2 (1) (C-language)
5.2.1 (1) (Fortran)
AMTK_getDimSize()Fig. 6.1-1 The difference of the dimension to express the number of the scan in the D men John size
The Geophysical Data dataset of L2 or L3, Standard Deviation of L3, Average Number and Total number dataset are 3-dimensinal dataset about thegeophysical quantity. Then its structure has the 1st level – the 3 rd levels 2-dimensional data.
AMTK offers the 2 kinds of access label. The one inputs and outputs all 3-dimensins of layers by a lump as data. The other inputs and outputs 2-dimension
data of1st level, the 2 nd level and the 3 rd level individually.

The image is shown in Fig. 6-2
・Lump access label：AM2_* _GEOA* (3-dimensional data access for all layers)For

AMTK_setDimSize() , AMTK_getDimSize()・individually access label：AM2_* _GEO1* ,AM2_* _GEO2* ,AM2_* _GEO3*(2-dimensional data access for each layer)

For AMTK_set_Swath*(), AMTK_get_Swath*(), AMTK_set_Grid*(), AMTK_get_Grid*()
HDF data set
6-46

AM2_*_GEO3*
AM2_*_GEO2*

AM2_* _GEOA*

AM2_*_GEO1*

Fig. 6.1-2 Two dimensions data individual access label and 3-dimensional data lump access label
For a concrete input/output example of a normal 3-dimensinal data set or a 3-dimensinal data set about the geophysical quantity, refer the
input/output sample program of L3.
In the following, the part of the input/output sample program of L2 is explained.

(1) Output sample of a normal 3-dimensional data set
sample3_make_L2Lproduct.c : Pixel Data Quality dataset (part extracted)
...

6-47

/** Number of Geophysical Data. */#define GEO_DATA_LAYER_NUM(3)...
/* Pixel Data Quality* (type size * Number of Geophysical Data[1...3] * Numbef of scans * 243) */p_dataset->p_pixel_quality = (unsigned char *) malloc(
GEO_DATA_LAYER_NUM * scan_size * AM2_DEF_SNUM_LO);
if (NULL == p_dataset->p_pixel_quality){
E_MSG("malloc() error.¥n");return RET_ERROR;}...
/* Pixel Data Quality */{dimsize[0] = GEO_DATA_LAYER_NUM; /* 1 ... 3 */dimsize[1] = scan_size;
dimsize[2] = AM2_DEF_SNUM_LO;/* binary (1byte) */ret = AMTK_setDimSize(file_id, AM2_PIX_QUAL, dimsize);if (0 > ret){
E_MSG("AMTK_setDimSize() error.[%d]¥n", ret);terminate(file_id, &dataset);exit(EXIT_FAILURE);}
ret = AMTK_set_SwathUChar(file_id, dataset.p_pixel_quality,
scan_start, scan_end, AM2_PIX_QUAL);
if (0 > ret){
E_MSG("AMTK_set_SwathUChar() error.[%d]¥n", ret);terminate(file_id, &dataset);exit(EXIT_FAILURE);}}●declaration
In this exsample, the number of geophysical quantity (layer)of Pixel Data Quality data set to output is 3.
●memory allocation
It allocates the area of the data set to output.
Memory area : number of layer * number of scan * number ofpixel
It allocate a memory area using malloc().

●create the dataset
It set dimension size to output.
At this time, it set the number of scan in the 2 nd layer.
1 st dimension: number of Layer
2 nd dimension: number of scan
3 rd dimension: number of pixel
It outputs the 3-dimensional dataset of (number of layer *number of scan * number of pixel) size using
AM2_PIX_QUALaccess label.
●write data
It set the value of data set to output

(2) Output sample of a3-dimensinal data set about the Geophysical quantity
sample3_make_L2Lproduct.c :Geophysical Data dataset output(part extracted)
...

6-48

/** Number of Geophysical Data. */#define GEO_DATA_LAYER_NUM(3)...
/* Access label: Geophysical Data */const int geo_data_label[] = {AM2_SWATH_GEO1, AM2_SWATH_GEO2, AM2_SWATH_GEO3};...
/* Geophysical Data (Layer: 1...3)* (type size * Number of scans * 243) */for (i = 0; i < GEO_DATA_LAYER_NUM; i++){p_dataset->p_geo_data[i] = (float *) malloc(sizeof(float) * scan_size* AM2_DEF_SNUM_LO);
if (NULL == p_dataset->p_geo_data[i]){E_MSG("malloc() error.¥n");return RET_ERROR;}}...
/* Geophysical Data (Layer: 1...3) */{dimsize[0] = scan_size;
dimsize[1] = AM2_DEF_SNUM_LO;
dimsize[2] = GEO_DATA_LAYER_NUM; /* 1 ... 3 *//* Layer: ALL -> AM2_SWATH_GEOA */ret = AMTK_setDimSize(file_id, AM2_SWATH_GEOA, dimsize);if (0 > ret){
E_MSG("AMTK_setDimSize() error.[%d]¥n", ret);terminate(file_id, &dataset);exit(EXIT_FAILURE);}/* Layer: 1...3 -> AM2_SWATH_GEO1 ... AM2_SWATH_GEO3 */for (i = 0; i < GEO_DATA_LAYER_NUM; i++){ret = AMTK_set_SwathFloat(file_id, dataset.p_geo_data[i], scan_start,
scan_end, geo_data_label[i]);if (0 > ret){
E_MSG("AMTK_set_SwathFloat() error.[%d]¥n", ret);●declaration
In this exsample, the number of geophysical quantity (layer)of Geophysical Data data set to output is 3.

●memory allocation
It allocates the area of the data set to output.
Memory area : number of scan * number of pixel * 3 layers
It allocate a memory area using malloc().

●create the dataset
It set dimension size to output.
At this time, it set the number of scan in the 1st layer.
1 st dimension: : number of scan
2 nd dimension: number of pixel
3 rd dimension: number of Layer
It outputs the 3-dimensional dataset of (number of layer *number of scan * number of pixel) size using
AM2_SWATH_GEOA access label.

●write data
It set the value of data set to output
It outputs the value of the 2-dimensional data set for 3 levels
in total using the access label of the 1 st layer to 3 rd layer ofGeophysical Data dataset.

terminate(file_id, &dataset);exit(EXIT_FAILURE);
}
}
}
...

6-49

6.1.2.2

Pixel Data Quality dataset stored method
When it input/output the Pixel Data Quality dataset using AMTK, C-language uses unsigned chartype array and Fortran uses

charactertype array.
The value to set is stored amay by bit of each element.
Pixel Data Quality 6 to 36 of L1 makes sense by 16bits unit (array size = 2) . And

Pixel Data Quality 89 of L1 makes sense by

8bits unit (arraysize = 1 ).

6 GHz-H

6 GHz-V

7 GHz-H

7 GHz-V

10 GHz-H

10 GHz-V

18 GHz-H

18 GHz-V

23 GHz-H

23 GHz-V

36 GHz-H

6-50

36 GHz-V

The stored image is shown in Fig. 6-3.

Pixel Data Quality 6 to 36
89 GHzA-V

89 GHzB-H

89 GHzB-V

1bit
0: 正常
1 : RFI混入データ

89 GHzA-H

(LSB)

(MSB)

Pixel Data Quality 89
(MSB)

(LSB)

Fig. 6.1-3 Stored image (Pixel Data Quality 6 to 36, 89 of L1)
It input/output to HDF file by 1byte unit.
The image of the data set and the array of Pixel Data Quality 6 to 36 and Pixel Data Quality 89 is shown in Fig. 6-4

Pixel Data Quality 6 to 36 (AM2_PIX_QUAL_LO)

Pixel Data Quality 89(AM2_PIX_QUAL_HI)

Array size: scan * (243pixel * 2byte)

Array size: scan * (486pixel * 1byte)

0

1

1

0

The first element of the array corresponds to the first byte of

2

1

3

the beginning of the data set.

The first element of the array corresponds to the first byte of
0

1

0

1

0

4

1

2

1

5

0

3

0

4

1

5

0
1
0

6

76543210

11111154321098

01010101

1010101

1

7

0

6-51

8

0

6

9

1

7

10

0

11

1

12

0

13

1

The second element of the array corresponds to the 2rd byte of

140

the beginning of the data set.

15

1

...

...

*

*

the begging of the data set.

76543210

01010101

243pixel

243pixel

Fig. 6.1-4 Corresponding image (data sets and array for Pixel Data Quality 6 to 36, 89 of L1)

6.1.3

Product related iformation
Name

Sample number

Emendatory
information

Missing value

HDF create
mode

Value

Description

AM2_DEF_SNUM_LO

243(AMSR-E A2LOW 196)

AM2_DEF_SNUM_HI

486(AMSR-E A2HIGH 392)

AM2_DEF_L3H_EQ_X

3600

Number of pixels in X
direction(longitude) for L3 High-res EQ

AM2_DEF_L3H_EQ_Y

1800

Number of pixels in Y direction(latitude)for L3 High-res EQ

AM2_DEF_L3L_EQ_X

1440

AM2_DEF_L3L_EQ_Y

720

Number of pixels in X
direction(longitude) for L3 Low-res EQ
Number of pixels in Y direction(latitude)for L3 Low-res EQ

AM2_DEF_L3H_EQ_GSIZE

0.1

Grid size for L3 High-res EQ

AM2_DEF_L3L_EQ_GSIZE

0.25

Grid size for L3 Low-res EQ

AM2_DEF_L3H_PN1_X

760

AM2_DEF_L3H_PN1_Y

1120

AM2_DEF_L3L_PN1_X

304

AM2_DEF_L3L_PN1_Y

448

AM2_DEF_L3H_PN2_X

1078

AM2_DEF_L3H_PN2_Y

1432

AM2_DEF_L3L_PN2_X

431

AM2_DEF_L3L_PN2_Y

573

AM2_DEF_L3H_PS_X

790

AM2_DEF_L3H_PS_Y

830

AM2_DEF_L3L_PS_X

316

AM2_DEF_L3L_PS_Y

332

Number of pixels in X direction for L3
High-res PN (TB,SIC)
Number of pixels in Y direction for L3
High-res PN (TB,SIC)
Number of pixels in Y direction for L3
Low-res PN (TB,SIC)
Number of pixels in X direction for L3
Low-res PN (TB,SIC)
Number of pixels in Y direction for L3
High-res PN (SND)
Number of pixels in X direction for L3
High-res PN (SND)
Number of pixels in Y direction for L3
Low-res PN (SND)
Number of pixels in X direction for L3
Low-res PN (SND)
Number of pixels in Y direction for L3
High-res PS
Number of pixels in X direction for L3
High-res PS
Number of pixels in Y direction for L3
Low-res PS
Number of pixels in X direction for L3
Low-res PS

AM2_DEF_CAL_LO

16

CAL data sampling number(AMSR-E
16)

AM2_DEF_CAL_HI

32

AM2_DEF_IMISS-32768CAL data sampling number(AMSR-E
32)
signed integer loss value

AM2_DEF_UIMISS

65535

unsigned integer loss value

AM2_DEF_CMISS
AM2_DEF_RMISS
AM2_RW_MODE

255-9999.99
1

character loss value
real loss value
AMTK_openH5_Write(): read/write mode
AMTK_openH5_Write(): create mode

AM2_CREATE_MODE

2

6-52

Remark6.2

L1, L2 ,L3 Common data
Show the common data structure as following.
Applied data
Scan time
Lat/Long-titude
Data quality

Data structure
Remark
AM2_COMMON_SCANTIME
AM2_COMMON_LATLONAMTK_SCAN_DATA_QUALI For L1
TY

Scan time
AM2_COMMON_SCANTIME
Name

Type

tai93sec
year
month
day
hour
minutesecondms

Size

double
short
short
short
short
short
short
short

Description

1
1
1
1
1
1
1
1

The elapsed seond time from january 1st, 1993
Year
Month
Day
Hour
MinuteSecondMili second11Latitude[deg]Longitude[deg]Lat/Long-itude
AM2_COMMON_LATLON
Name

lat
lon

Type

float
float

Size

Description

6-53

Quality data
AMTK_SCAN_DATA_QUALITY
Name

scan_quality
calibration
Spc_sps_error
Htsparityquality_info
spare

Type

unsigned
int[]
float
unsignedint
unsignedint
unsignedint[]
unsignedint[]
unsigned
int[]

Size

Description

4

Quality for a Scan

64
1

Calibration Data
SPC/SPS Error

16

HTS Temperature

33

Parity Error Summary

4

Quality Information for a scan

6

Spare

6-54

7

Error Number ID
Show the error ID of AMTK functions as following.
All of ID are negative value and assigned to some categories.
-100～

Execution environment error-200～

the error cause of the user program’s bug.

-500～

the error cause of HDF file-600～

the error cause of appricated data

Table 7-1 Error number ID
ID

Description

-100
-101
-102
-103
-109

Fail to opne the file
Fail to allocate memory
Fail to get evaluate variable
Fail to get leap second
Fail to get geophysical quantity file

-201
-202
-203
-204
-205
-206
-207
-208
-209
-210
-211

Specify an invalid value(year of scan time)
Specify an invalid value(month of scan time)
Specify an invalid value(day of scan time)
Specify an invalid value(hour of scan time)
Specify an invalid value(minute of scan time)
Specify an invalid value(second of scan time)
Specify an invalid value(mili second of scan time)
Specify an invalid value(mili second of scan time)
Specify an invalid value(elapsed second time)
No file nameA start scan number is a big value than an end scannumberHDF file ID is 0 or a minus value.
The index value of meta data is a minus value.
Appointed dimension size is unjust.
No specified wire data
Access label is 0.
Specify an invalid value(Access label is out of write
object. )Specify an invalid value(Access label is out of read
object.)0 size data acquires a memory area.
Specify an NULL address.
Invalid write mode for HDF file.
Unadapted data type for Access Label.
Fail to get three days average value responsible illigal
geophysical quantity.
"GeophysicalName" in metadata should be same in all
input files.

-213
-214
-215
-216
-217
-218
-219
-220
-221
-238
-239
-250

-251

-252

Fail to get 3days average value so that “OrbitDirection”
dosenot match a rule.
It is necessary to set orbit direction in Descending in thecase of the even number file in Ascending in the case of
the odd number file in orbit direction.
Fail toget 3days
average
value
so
that
"ProductionDateTime" dose not match a rule.

7-1

RemarkAfter 1993
Valid data: 1-12
Valid data:1-31
Valid data:1-24
Valid data:0-59
Valid data:0-60
Valid data:0-999

reference:
5 API function
Acquisition for 3days averagedata
AMTK_get_Grid03D()
eference:
5 API function
Acquisition for 3days averagedata
AMTK_get_Grid03D()
eference:
5 API function

ID

-253

Description

RemarkThe date of "ProductionDateTime" is necessary to besame with an add number file and an even number file.
And that, the filename1 is set as appointed day(ex. N),
the filename2 is set as the before day of appointed day(ex. N-1) and the filename3 is set as the before day offilename2(ex. N-2).
Fail to get 3days average value so that a size of ophysicalquantity dose not much a rule.
It is necessary for a file acquiring average to be same as
for ths size of "GeophysicalData".

Acquisition for 3days averagedata
AMTK_get_Grid03D()

-501
-502
-503
-504
-505
-506
-507
-508
-509
-510
-511

Fail to open HDF file.
Fail to close HF file.
Fail to set dimension size.
Fail to access to data set.
Fail to open data set.
Fail to get space for data set.
Fail to get the number of array for data set.
Fail to get the size of dimension for data set.
Fail to create data set.
Fail to write to data set.
Fail to read from data set.

-520
-521
-522
-523
-524
-525
-526
-527
-528
-529
-540
-541
-550

Fail to open the name of metadata.
Fail to fet the kind od data of metadata name.
Fail to read the value of metadata.
Fail to open with specified name of metadata.
Fail to create the name of metadata.
Fail to wirte the value of metadata.
Fail to get the class of data type.
Fail to copy the class of data type.
Fail to modify the size of data type.
Fail to get data type.
Fail to get the space of data type.
Fail to specify the point to read/writefor data set.
Fail to access data set so that the opening error ofmeta
data “ProductName"

-551
-552
-553
-554
-555
-556
-557
-558
-559

eference:
5 API function
Acquisition for 3days averagedata
AMTK_get_Grid03D()

Reference ：Fail to access data set so that the internal error when it isreading metadata “ProductName"

Reference ：Fail to access data set so that the open error of meta data
“OverlapScans”.

Reference ：Fail to access data set so that the internal error when it isreading metadata “OverlapScans".

Reference ：Fail to access data set so that the open error of meta data
“GeophysicalName”.

Reference ：Fail to access data set so that the internal error when it isreading metadata “GeophysicalName ".

Reference ：Fail to access data set so that the open error of meta data
“GranuleID”

Reference ：Fail to access data set so that the internal error when it isreading metadata “GranuleID ".

Reference ：Fail to access data set so that the open error of meta data
“CoRegistrationParameterA1”

Reference ：Fail to access data set so that the internal error when it isreading metadata “CoRegistrationParameterA1".

Reference ：

7-2

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

access laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess lave

ID

Description-560

Fail to access data set so that the open error of meta data
“CoRegistrationParameterA2”

Reference ：-561

Fail to access data set so that the internal error when it isreading metadata “CoRegistrationParameterA2".

Reference ：-562

Fail to access data set so that the open error of meta data
“Projection”

Reference ：Fail to access data set so that the internal error when it isreading metadata “Projection ".

Reference ：Fail to access data set so that the open error of meta data
“OrbitDirection”

Reference ：Fail to access data set so that the internal error when it isreading metadata “OrbitDirection ".

Reference ：Fail to access data set so that the open error of meta data
“ProductionDateTime”

Reference ：Fail to access data set so that the internal error when it isreading metadata “ProductionDateTime ".

Reference ：

-563
-564
-565
-566
-567

-601
-602

Unadapted data type for read/write data.
Detect the outlier of maximam/minimamvalue for write
data.

9999

Write data is over the maximum value.

7-3

Remark
6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

6.1.1

HDF

access laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess laveaccess lave