Your SlideShare is downloading. ×
0
The HDF-EOS5 Tutorial
Ray Milburn
L3 Communciations, EER Systems Inc.
1801 McCormick Drive, 170
Largo, MD 20774 USA
Ray.Mi...
What is HDF-EOS ?
• HDF (Hierarchical Data Format) is a disk-based format
chosen by NASA as a standard for EOS program
• H...
HDF-EOS 5 Library
• Provides Grid/Point/Swath/ZA interfaces
• Allows to create/access Grid/Point/Swath/ZA and
manipulate t...
Grid Structure
• Data organized by regular geographic
spacing, specified by projection parameters.
• Structure
– Multidime...
Grid Data Example

5
Swath Structure
• Data is organized by time or track parameter
• Data spacing can be irregular
• Structure
– Geolocation i...
Swath Data Example

7
Point Structure
• Data is specified temporally and/or spatially,
but with no particular organization
• Structure
– Tables ...
Point Data Example
Lat
61.12
45.31
38.50
38.39
30.00
37.45
18.00
43.40
34.03
32.45
33.30
42.15
35.05
34.12
46.32
47.36
39....
Zonal Average (ZA) Structure
• Generalized array structure with no
geolocation linkage
• Data can be organized by time or ...
HDF-EOS Grid Structure
• Usage - Data which is organized by regular
geographic spacing, specified by projection
parameters...
HDF-EOS Swath Structure
• Usage - Data which is organized by time,
monotonic geolocation, track parameter.
Spacing can be ...
HDF-EOS Point Structure
• Usage - Data which is specified temporally
and/or spatially, but with no particular
organization...
HDF-EOS ZA Structure
• Usage - Data which is organized by time,
track parameter. Spacing can be irregular.
• Structure
– D...
Basic HDF-EOS5 Functions
• Access - Open, create, close objects/files
• Definition - Set key parameters of data sets
• Inp...
File/Object Access
•
•
•
•
•

GRID:
HE5_GDopen/he5_gdopen
HE5_GDcreate/he5_gdcreate
HE5_GDattach/he5_gdattach
HE5_GDdetach...
File/Object Access
•
•
•
•
•

POINT:
HE5_PTopen/he5_ptopen
HE5_PTcreate/he5_ptcreate
HE5_PTattach/he5_ptattach
HE5_PTdetac...
File/Object Access
•
•
•
•
•

SWATH:
HE5_SWopen/he5_swopen
HE5_SWcreate/he5_swcreate
HE5_SWattach/he5_swattach
HE5_SWdetac...
File/Object Access
•
•
•
•
•

ZA:
HE5_ZAopen/he5_zaopen
HE5_ZAcreate/he5_zacreate
HE5_ZAattach/he5_zaattach
HE5_ZAdetach/h...
Definition
GRID:
• HE5_GDdefdim/he5_gddefdim
• HE5_GDdefproj/he5_gddefproj
• HE5_GDdeforigin/he5_gddeforigin
• HE5_GDdefpi...
Definition
POINT:
• HE5_PTdeflevel/he5_ptdeflevel
• HE5_PTdeflinkage/he5_ptdeflinkage

21
Definition

•
•
•
•
•

SWATH:
HE5_SWdefdim/he5_swdefdim
HE5_SWdefdimmap/he5_swdefmap
HE5_SWdefidxmap/he5_swdefimap
HE5_SWd...
Definition

•
•
•
•

ZA:
HE5_ZAdefdim/he5_zadefdim
HE5_ZAdefine/he5_zadefine
HE5_ZAdefcomp/he5_zadefcomp
HE5_ZAdefchunk/he...
Input/Output
GRID:
• HE5_GDwritefield/he5_gdwrfld
• HE5_GDreadfield/he5_gdrdfld
• HE5_GDwriteattr/he5_gdwrattr
• HE5_GDrea...
Input/Output
POINT:
• HE5_PTwritelevel/he5_ptwritelevel
• HE5_PTreadlevel/he5_ptreadlevel
• HE5_PTwriteattr/he5_ptwrattr
•...
Input/Output
SWATH:
• HE5_SWwritefield/he5_swwrfld
• HE5_SWreadfield/he5_swrdfld
• HE5_SWwriteattr/he5_swwrattr
• HE5_SWre...
Input/Output
ZA:
• HE5_ZAwrite/he5_zawrite
• HE5_ZAread/he5_zaread
• HE5_ZAwriteattr/he5_zawrattr
• HE5_ZAreadattr/he5_zar...
Inquiry

•
•
•
•
•

GRID:
HE5_GDinqdims/he5_gdinqdims
HE5_GDdiminfo/he5_gddiminfo
HE5_GDprojinfo/he5_gdprojinfo
HE5_GDorig...
Inquiry
POINT:
• HE5_PTlevelinfo/he5_ptlevelinfo
• HE5_PTinqattrs/he5_ptinqattrs
• HE5_PTattrinfo/he5_ptattrinfo
29
Inquiry
SWATH:
• HE5_SWinqdatafields/he5_swinwdflds
• HE5_SWinqgeofields/he5_swinqgflds
• HE5_SWinqattrs/he5_swinqattrs
• ...
Inquiry
ZA:
• HE5_ZAinquire/he5_zainquire
• HE5_ZAinfo/he5_zainfo
• HE5_ZAinqattrs/he5_zainqattrs
• HE5_ZAattrinfo/he5_zaa...
Programming Model
• Open the HDF-EOS5 file
• Create or Attach to a specified
Grid/Swath/Point/ZA object
• Define key objec...
HDF-EOS Tools and Utilities
• heconvert - command-line utility to convert
HDF-EOS2 objects to HDF-EOS5 objects
• HE5View -...
Upcoming SlideShare
Loading in...5
×

The HDF-EOS5 Tutorial

115

Published on

Introduction to HDF-EOS Library, Programmer's Interface and Examples

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
115
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
6
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "The HDF-EOS5 Tutorial"

  1. 1. The HDF-EOS5 Tutorial Ray Milburn L3 Communciations, EER Systems Inc. 1801 McCormick Drive, 170 Largo, MD 20774 USA Ray.Milburn@L-3com.com
  2. 2. What is HDF-EOS ? • HDF (Hierarchical Data Format) is a disk-based format chosen by NASA as a standard for EOS program • HDF-EOS is an extension to HDF which standardizes common Earth Sciences data structures • HDF-EOS2 based on HDF4 is used operationally by EOS TERRA and AQUA instrument teams • HDF-EOS5, based on HDF5 is newer and will be used by EOS AURA instruments • Contains Geolocation Information: – Structural metadata links Geolocation and science data 2
  3. 3. HDF-EOS 5 Library • Provides Grid/Point/Swath/ZA interfaces • Allows to create/access Grid/Point/Swath/ZA and manipulate their objects (data sets, attributes, etc.) • Written in C with FORTRAN-77 wrappers • C-function names prefixed with “HE5_” • FORTRAN-77 calls have similar naming convention 3
  4. 4. Grid Structure • Data organized by regular geographic spacing, specified by projection parameters. • Structure – Multidimensional data arrays – Geolocation information is given implicitly by projection parameters contained in structural metadata 4
  5. 5. Grid Data Example 5
  6. 6. Swath Structure • Data is organized by time or track parameter • Data spacing can be irregular • Structure – Geolocation information stored explicitly in Geolocation Field (2-D array) – Data stored in multidimensional arrays – Time stored in 1-D or 2-D array – SM links Geolocation and science data 6
  7. 7. Swath Data Example 7
  8. 8. Point Structure • Data is specified temporally and/or spatially, but with no particular organization • Structure – Tables used to store science data at a particular Lat/Long/Height – Up to eight levels of data allowed. Structural metadata specifies relationship between levels. 8
  9. 9. Point Data Example Lat 61.12 45.31 38.50 38.39 30.00 37.45 18.00 43.40 34.03 32.45 33.30 42.15 35.05 34.12 46.32 47.36 39.44 21.25 44.58 41.49 25.45 Lon -149.48 -122.41 -77.00 -90.15 -90.05 -122.26 -76.45 -79.23 -118.14 -96.48 -112.00 -71.07 -106.40 -77.56 -87.25 -122.20 -104.59 -78.00 -93.15 -87.37 -80.11 Temp(C) Dewpt(C) 15.00 5.00 17.00 5.00 24.00 7.00 27.00 11.00 22.00 7.00 25.00 10.00 27.00 4.00 30.00 14.00 25.00 4.00 32.00 8.00 30.00 10.00 28.00 7.00 30.00 9.00 28.00 9.00 30.00 8.00 32.00 15.00 31.00 16.00 28.00 7.00 32.00 13.00 28.00 9.00 19.00 3.00 9
  10. 10. Zonal Average (ZA) Structure • Generalized array structure with no geolocation linkage • Data can be organized by time or track parameter • Data spacing can be irregular • Structure – Data stored in multidimensional arrays – Time stored in 1-D or 2-D array – SM links science data 10
  11. 11. HDF-EOS Grid Structure • Usage - Data which is organized by regular geographic spacing, specified by projection parameters. • Structure – Any number of 2-D to 8-D data arrays per structure, one per data type (e.g. temperature) – Geolocation information contained in projection formula, coupled by structural metadata. – Any number of Grid structures per file allowed. 11
  12. 12. HDF-EOS Swath Structure • Usage - Data which is organized by time, monotonic geolocation, track parameter. Spacing can be irregular. • Structure – Geolocation information stored explicitly in Geolocation Field (2-D array) – Data stored in 2-D or 3-D arrays – Time stored in 1-D or 2-D array, TAI is standard. – Geolocation/science data connected by structural 12 metadata
  13. 13. HDF-EOS Point Structure • Usage - Data which is specified temporally and/or spatially, but with no particular organization. • Structure – Tables (Vdatas) used to store science data at a particular Lat/Long/Height. – Up to eight levels of data allowed. Structural metadata specifies relationship between levels. 13
  14. 14. HDF-EOS ZA Structure • Usage - Data which is organized by time, track parameter. Spacing can be irregular. • Structure – Data stored in 2-D or 3-D arrays – Time stored in 1-D or 2-D array, TAI is standard. – Science data connected by structural metadata 14
  15. 15. Basic HDF-EOS5 Functions • Access - Open, create, close objects/files • Definition - Set key parameters of data sets • Input/Output - Read/Write data • Inquiry - Return information about data • Subset - Read data from specified region 15
  16. 16. File/Object Access • • • • • GRID: HE5_GDopen/he5_gdopen HE5_GDcreate/he5_gdcreate HE5_GDattach/he5_gdattach HE5_GDdetach/he5_gddetach HE5_GDclose/he5_gdclose 16
  17. 17. File/Object Access • • • • • POINT: HE5_PTopen/he5_ptopen HE5_PTcreate/he5_ptcreate HE5_PTattach/he5_ptattach HE5_PTdetach/he5_ptdetach HE5_PTclose/he5_ptclose 17
  18. 18. File/Object Access • • • • • SWATH: HE5_SWopen/he5_swopen HE5_SWcreate/he5_swcreate HE5_SWattach/he5_swattach HE5_SWdetach/he5_swdetach HE5_SWclose/he5_swclose 18
  19. 19. File/Object Access • • • • • ZA: HE5_ZAopen/he5_zaopen HE5_ZAcreate/he5_zacreate HE5_ZAattach/he5_zaattach HE5_ZAdetach/he5_zadetach HE5_ZAclose/he5_zaclose 19
  20. 20. Definition GRID: • HE5_GDdefdim/he5_gddefdim • HE5_GDdefproj/he5_gddefproj • HE5_GDdeforigin/he5_gddeforigin • HE5_GDdefpixreg/he5_gd_defpreg 20
  21. 21. Definition POINT: • HE5_PTdeflevel/he5_ptdeflevel • HE5_PTdeflinkage/he5_ptdeflinkage 21
  22. 22. Definition • • • • • SWATH: HE5_SWdefdim/he5_swdefdim HE5_SWdefdimmap/he5_swdefmap HE5_SWdefidxmap/he5_swdefimap HE5_SWdefgeofield/he5_swdefgfld HE5_SWdefdatafield/he5_swdefdfld 22
  23. 23. Definition • • • • ZA: HE5_ZAdefdim/he5_zadefdim HE5_ZAdefine/he5_zadefine HE5_ZAdefcomp/he5_zadefcomp HE5_ZAdefchunk/he5_zadefchunk 23
  24. 24. Input/Output GRID: • HE5_GDwritefield/he5_gdwrfld • HE5_GDreadfield/he5_gdrdfld • HE5_GDwriteattr/he5_gdwrattr • HE5_GDreadattr/he5_gdrdattr 24
  25. 25. Input/Output POINT: • HE5_PTwritelevel/he5_ptwritelevel • HE5_PTreadlevel/he5_ptreadlevel • HE5_PTwriteattr/he5_ptwrattr • HE5_PTreadattr/he5_ptrdattr 25
  26. 26. Input/Output SWATH: • HE5_SWwritefield/he5_swwrfld • HE5_SWreadfield/he5_swrdfld • HE5_SWwriteattr/he5_swwrattr • HE5_SWreadattr/he5_swrdattr 26
  27. 27. Input/Output ZA: • HE5_ZAwrite/he5_zawrite • HE5_ZAread/he5_zaread • HE5_ZAwriteattr/he5_zawrattr • HE5_ZAreadattr/he5_zardattr 27
  28. 28. Inquiry • • • • • GRID: HE5_GDinqdims/he5_gdinqdims HE5_GDdiminfo/he5_gddiminfo HE5_GDprojinfo/he5_gdprojinfo HE5_GDorigininfo/he5_gdorigininfo HE5_GDpixreginfo/he5_gdpreginfo 28
  29. 29. Inquiry POINT: • HE5_PTlevelinfo/he5_ptlevelinfo • HE5_PTinqattrs/he5_ptinqattrs • HE5_PTattrinfo/he5_ptattrinfo 29
  30. 30. Inquiry SWATH: • HE5_SWinqdatafields/he5_swinwdflds • HE5_SWinqgeofields/he5_swinqgflds • HE5_SWinqattrs/he5_swinqattrs • HE5_SWattrinfo/he5_swattrinfo 30
  31. 31. Inquiry ZA: • HE5_ZAinquire/he5_zainquire • HE5_ZAinfo/he5_zainfo • HE5_ZAinqattrs/he5_zainqattrs • HE5_ZAattrinfo/he5_zaattrinfo 31
  32. 32. Programming Model • Open the HDF-EOS5 file • Create or Attach to a specified Grid/Swath/Point/ZA object • Define key object features and/or perform necessary operations (with the data sets, attributes, etc) • Detach from the Grid/Swath/Point/ZA object • Close the HDF-EOS5 file 32
  33. 33. HDF-EOS Tools and Utilities • heconvert - command-line utility to convert HDF-EOS2 objects to HDF-EOS5 objects • HE5View - X-Motif based tool which displays all parts of the HDF-EOS5 objects • JEB - Java EOS Browser - Java based tool to display HDF4, HDF-EOS2 and HDFEOS5 objects 33
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×