diff options
Diffstat (limited to 'doc/html/Tutor')
153 files changed, 0 insertions, 16399 deletions
diff --git a/doc/html/Tutor/Contents.html b/doc/html/Tutor/Contents.html deleted file mode 100644 index d2584e5..0000000 --- a/doc/html/Tutor/Contents.html +++ /dev/null @@ -1,104 +0,0 @@ -<html> - -<body bgcolor="#BBFFFF"> - - -<!-- -The following tag is for use only in the distributed doc set. -Remove (or comment out) when served from HDF web server. ---> -<center> -<font size=-1><a href="../index.html" target=_top>Return to HDF5 Doc Set</a></font> -</center> -<br> - -<hr> - -<!-- -<A HREF="READ1ST.HTML" Target="RdFirstWin" onClick="window.open("READ1ST.HTML","RdFirstWin","toolbar=0,location=0,directories=0,status=0,menubar=0,scrollbars=yes,resizable=1,width=500,height=250,titlebar=yes")"><IMG SRC="GRAPHICS/READ1ST.GIF" BORDER=0 ALT="Read this first!"></A> ---> - -<a href="title.html" TARGET="CONTENT"><IMG SRC="Graphics/TitlePg.gif" BORDER=0 ALT="Tutorial Title Page"></a> -<br> - -<hr> -<a href="ContentsIntro.html" TARGET="BUTTONS"><IMG SRC="Graphics/IntroTopics.gif" BORDER=0 ALT="Introductory Topics"></a> -<br> -<!-- -<a href="intro.html" TARGET="CONTENT"><IMG SRC="Graphics/Intro.gif" BORDER=0 ALT="Introduction"></a> -<br> -<a href="fileorg.html" TARGET="CONTENT"><img src="Graphics/FileOrg.gif" BORDER=0 ALT="HDF5 File Organization"></a> -<br> -<a href="api.html" TARGET="CONTENT"><IMG SRC="Graphics/H5API.gif" BORDER=0 ALT="The HDF5 API"></a> -<br> -<a href="crtfile.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateFile.gif" BORDER=0 ALT="Creating an HDF5 File"></a> -<br> -<a href="crtdat.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset1.gif" BORDER=0 ALT="Creating a Dataset"></a> -<br> -<a href="rdwt.html" TARGET="CONTENT"><IMG SRC="Graphics/RdWrDataset.gif" BORDER=0 ALT="Reading from and Writing to a Dataset"></a> -<br> -<a href="crtatt.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateAttr.gif" BORDER=0 ALT="Creating an Attribute"></a> -<br> -<a href="crtgrp.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp1.gif" BORDER=0 ALT="Creating a Group"></a> -<br> -<a href="crtgrpar.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp2.gif" BORDER=0 ALT="Creating Groups Using Absolute and Relative Names"></a> -<br> -<a href="crtgrpd.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset2.gif" BORDER=0 ALT="Creating Datasets in a Group"></a> - - -<br> -<br> -<a href="questions.html" TARGET="CONTENT"><IMG SRC="Graphics/Quiz.gif" BORDER=0 ALT="Quiz Questions"></a> -<br> -<a href="answers.html" TARGET="CONTENT"><IMG SRC="Graphics/QuizAns.gif" BORDER=0 ALT="Quiz Answers"></a> ---> - -<hr> -<a href="ContentsAdv.html" TARGET="BUTTONS"><IMG SRC="Graphics/AdvTopics.gif" BORDER=0 ALT="Advanced Topics"></a> -<!-- -<br> -<a href="compound.html" TARGET="CONTENT"><IMG SRC="Graphics/CompDTypes.gif" BORDER=0 ALT="Compound Datatypes"></a> -<br> -<a href="select.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectHyp.gif" BORDER=0 ALT="Dataspace Selection - Hyperslab"></a> -<br> -<a href="selectc.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectElemCp.gif" BORDER=0 ALT="Dataspace Selection - Individual Points"></a> -<br> -<a href="reftoobj.html" TARGET="CONTENT"><IMG SRC="Graphics/RefObject.gif" BORDER=0 ALT="References to Objects"></a> -<br> -<a href="reftoreg.html" TARGET="CONTENT"><IMG SRC="Graphics/RefRegion.gif" BORDER=0 ALT="References to Dataset Regions"></a> -<br> -<a href="extend.html" TARGET="CONTENT"><IMG SRC="Graphics/ChunkExt.gif" BORDER=0 ALT="Chunking and Extendible Datasets"></a> -<br> -<a href="mount.html" TARGET="CONTENT"><IMG SRC="Graphics/MountFile.gif" BORDER=0 ALT="Mounting Files"></a> -<br> -<a href="iterate.html" TARGET="CONTENT"><IMG SRC="Graphics/Iterate.gif" BORDER=0 ALT="Group Iteration"></a> ---> - - -<hr> -<a href="ContentsAdd.html" TARGET="BUTTONS"><IMG SRC="Graphics/AddInfo.gif" BORDER=0 ALT="Additional Information"></a> -<!-- -<br> -<a href="util.html" TARGET="CONTENT"><IMG SRC="Graphics/Utilities.gif" BORDER=0 ALT="HDF5 Utilities -- h5ls and h5dump"></a> -<br> -<a href="glossary.html" TARGET="CONTENT"><IMG SRC="Graphics/Glossary.gif" BORDER=0 ALT="Glossary"></a> -<br> -<a href="references.html" TARGET="CONTENT"><IMG SRC="Graphics/References.gif" BORDER=0 ALT="References"></a> -<br> -<a href="examples/" TARGET="CONTENT"><IMG SRC="Graphics/Examples.gif" BORDER=0 ALT="Example Programs"></a> ---> - - -<hr> -<a href="ContentsFull.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCFull.gif" BORDER=0 ALT="Full TOC"></a> -<br> - - -<hr> -<br> -<a href="Copyright.html" TARGET="CONTENT"><IMG SRC="Graphics/Copy.gif" BORDER=0 ALT="Copyright, Etc."></a><br> - - -</body> -</html> - diff --git a/doc/html/Tutor/ContentsAdd.html b/doc/html/Tutor/ContentsAdd.html deleted file mode 100644 index cd5d2e1..0000000 --- a/doc/html/Tutor/ContentsAdd.html +++ /dev/null @@ -1,54 +0,0 @@ -<html> - -<body bgcolor="#BBFFFF"> - - -<!-- -The following tag is for use only in the distributed doc set. -Remove (or comment out) when served from HDF web server. ---> -<center> -<font size=-1><a href="../index.html" target=_top>Return to HDF5 Doc Set</a></font> -</center> -<br> - -<hr> - -<!-- -<A HREF="READ1ST.HTML" Target="RdFirstWin" onClick="window.open("READ1ST.HTML","RdFirstWin","toolbar=0,location=0,directories=0,status=0,menubar=0,scrollbars=yes,resizable=1,width=500,height=250,titlebar=yes")"><IMG SRC="GRAPHICS/READ1ST.GIF" BORDER=0 ALT="Read this first!"></A> ---> - - -<a href="Contents.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCShort.gif" BORDER=0 ALT="(Short TOC)"></a> -<hr> - -<a href="title.html" TARGET="CONTENT"><IMG SRC="Graphics/TitlePg.gif" BORDER=0 ALT="Tutorial Title Page"></a> -<hr> - - -<a href="ContentsIntro.html" TARGET="BUTTONS"><IMG SRC="Graphics/IntroTopics.gif" BORDER=0 ALT="Introductory Topics"></a> -<hr> - - -<a href="ContentsAdv.html" TARGET="BUTTONS"><IMG SRC="Graphics/AdvTopics.gif" BORDER=0 ALT="Advanced Topics"></a> -<hr> - - -<IMG SRC="Graphics/AddInfo.gif" BORDER=0 ALT="Additional Information"> -<a href="util.html" TARGET="CONTENT"><IMG SRC="Graphics/Utilities.gif" BORDER=0 ALT="HDF5 Utilities -- h5ls and h5dump"></a> -<a href="glossary.html" TARGET="CONTENT"><IMG SRC="Graphics/Glossary.gif" BORDER=0 ALT="Glossary"></a> -<a href="references.html" TARGET="CONTENT"><IMG SRC="Graphics/References.gif" BORDER=0 ALT="References"></a> -<a href="examples/" TARGET="CONTENT"><IMG SRC="Graphics/Examples.gif" BORDER=0 ALT="Example Programs"></a> -<hr> - - -<a href="ContentsFull.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCFull.gif" BORDER=0 ALT="Full TOC"></a> - - -<hr> -<a href="Copyright.html" TARGET="CONTENT"><IMG SRC="Graphics/Copy.gif" BORDER=0 ALT="Copyright, Etc."></a><br> - - -</body> -</html> - diff --git a/doc/html/Tutor/ContentsAdv.html b/doc/html/Tutor/ContentsAdv.html deleted file mode 100644 index ac27c0e..0000000 --- a/doc/html/Tutor/ContentsAdv.html +++ /dev/null @@ -1,57 +0,0 @@ -<html> - -<body bgcolor="#BBFFFF"> - - -<!-- -The following tag is for use only in the distributed doc set. -Remove (or comment out) when served from HDF web server. ---> -<center> -<font size=-1><a href="../index.html" target=_top>Return to HDF5 Doc Set</a></font> -</center> -<br> - -<hr> - -<!-- -<A HREF="READ1ST.HTML" Target="RdFirstWin" onClick="window.open("READ1ST.HTML","RdFirstWin","toolbar=0,location=0,directories=0,status=0,menubar=0,scrollbars=yes,resizable=1,width=500,height=250,titlebar=yes")"><IMG SRC="GRAPHICS/READ1ST.GIF" BORDER=0 ALT="Read this first!"></A> ---> - -<a href="Contents.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCShort.gif" BORDER=0 ALT="(Short TOC)"></a> -<hr> - -<a href="title.html" TARGET="CONTENT"><IMG SRC="Graphics/TitlePg.gif" BORDER=0 ALT="Tutorial Title Page"></a> -<hr> - - -<a href="ContentsIntro.html" TARGET="BUTTONS"><IMG SRC="Graphics/IntroTopics.gif" BORDER=0 ALT="Introductory Topics"></a> -<hr> - - -<IMG SRC="Graphics/AdvTopics.gif" BORDER=0 ALT="Advanced Topics"> -<a href="compound.html" TARGET="CONTENT"><IMG SRC="Graphics/CompDTypes.gif" BORDER=0 ALT="Compound Datatypes"></a> -<a href="select.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectHyp.gif" BORDER=0 ALT="Dataspace Selection - hyperslab"></a> -<a href="selectc.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectElemCp.gif" BORDER=0 ALT="Dataspace Selection - Individual Points"></a> -<a href="reftoobj.html" TARGET="CONTENT"><IMG SRC="Graphics/RefObject.gif" BORDER=0 ALT="References to Objects"></a> -<a href="reftoreg.html" TARGET="CONTENT"><IMG SRC="Graphics/RefRegion.gif" BORDER=0 ALT="References to Dataset Regions"></a> -<a href="extend.html" TARGET="CONTENT"><IMG SRC="Graphics/ChunkExt.gif" BORDER=0 ALT="Chunking and Extendible Datasets"></a> -<a href="mount.html" TARGET="CONTENT"><IMG SRC="Graphics/MountFile.gif" BORDER=0 ALT="Mounting Files"></a> -<a href="iterate.html" TARGET="CONTENT"><IMG SRC="Graphics/Iterate.gif" BORDER=0 ALT="Group Iteration"></a> -<hr> - - -<a href="ContentsAdd.html" TARGET="BUTTONS"><IMG SRC="Graphics/AddInfo.gif" BORDER=0 ALT="Additional Information"></a> -<hr> - - -<a href="ContentsFull.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCFull.gif" BORDER=0 ALT="Full TOC"></a> -<hr> - - -<a href="Copyright.html" TARGET="CONTENT"><IMG SRC="Graphics/Copy.gif" BORDER=0 ALT="Copyright, Etc."></a><br> - - -</body> -</html> - diff --git a/doc/html/Tutor/ContentsFull.html b/doc/html/Tutor/ContentsFull.html deleted file mode 100644 index d873f82..0000000 --- a/doc/html/Tutor/ContentsFull.html +++ /dev/null @@ -1,71 +0,0 @@ -<html> - -<body bgcolor="#BBFFFF"> - - -<!-- -The following tag is for use only in the distributed doc set. -Remove (or comment out) when served from HDF web server. ---> -<center> -<font size=-1><a href="../index.html" target=_top>Return to HDF5 Doc Set</a></font> -</center> -<br> - -<hr> - -<!-- -<A HREF="READ1ST.HTML" Target="RdFirstWin" onClick="window.open("READ1ST.HTML","RdFirstWin","toolbar=0,location=0,directories=0,status=0,menubar=0,scrollbars=yes,resizable=1,width=500,height=250,titlebar=yes")"><IMG SRC="GRAPHICS/READ1ST.GIF" BORDER=0 ALT="Read this first!"></A> ---> - - -<a href="Contents.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCShort.gif" BORDER=0 ALT="(Short TOC)"></a> -<hr> - -<a href="title.html" TARGET="CONTENT"><IMG SRC="Graphics/TitlePg.gif" BORDER=0 ALT="Tutorial Title Page"></a> - -<hr> -<IMG SRC="Graphics/IntroTopics.gif" BORDER=0 ALT="Introductory Topics"> -<a href="intro.html" TARGET="CONTENT"><IMG SRC="Graphics/Intro.gif" BORDER=0 ALT="Introduction"></a> -<a href="fileorg.html" TARGET="CONTENT"><img src="Graphics/FileOrg.gif" BORDER=0 ALT="HDF5 File Organization"></a> -<a href="api.html" TARGET="CONTENT"><IMG SRC="Graphics/H5API.gif" BORDER=0 ALT="The HDF5 API"></a> -<a href="crtfile.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateFile.gif" BORDER=0 ALT="Creating an HDF5 File"></a> -<a href="crtdat.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset1.gif" BORDER=0 ALT="Creating a Dataset"></a> -<a href="rdwt.html" TARGET="CONTENT"><IMG SRC="Graphics/RdWrDataset.gif" BORDER=0 ALT="Reading from and Writing to a Dataset"></a> -<a href="crtatt.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateAttr.gif" BORDER=0 ALT="Creating an Attribute"></a> -<a href="crtgrp.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp1.gif" BORDER=0 ALT="Creating a Group"></a> -<a href="crtgrpar.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp2.gif" BORDER=0 ALT="Creating Groups Using Absolute and Relative Names"></a> -<a href="crtgrpd.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset2.gif" BORDER=0 ALT="Creating Datasets in a Group"></a> - -<br> -<a href="questions.html" TARGET="CONTENT"><IMG SRC="Graphics/Quiz.gif" BORDER=0 ALT="Quiz Questions"></a> -<a href="answers.html" TARGET="CONTENT"><IMG SRC="Graphics/QuizAns.gif" BORDER=0 ALT="Quiz Answers"></a> - - -<hr> -<IMG SRC="Graphics/AdvTopics.gif" BORDER=0 ALT="Advanced Topics"> -<a href="compound.html" TARGET="CONTENT"><IMG SRC="Graphics/CompDTypes.gif" BORDER=0 ALT="Compound Datatypes"></a> -<a href="select.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectHyp.gif" BORDER=0 ALT="Dataspace Selection - Hyperslab"></a> -<a href="selectc.html" TARGET="CONTENT"><IMG SRC="Graphics/SelectElemCp.gif" BORDER=0 ALT="Dataspace Selection - Individual Points"></a> -<a href="reftoobj.html" TARGET="CONTENT"><IMG SRC="Graphics/RefObject.gif" BORDER=0 ALT="References to Objects"></a> -<a href="reftoreg.html" TARGET="CONTENT"><IMG SRC="Graphics/RefRegion.gif" BORDER=0 ALT="References to Dataset Regions"></a> -<a href="extend.html" TARGET="CONTENT"><IMG SRC="Graphics/ChunkExt.gif" BORDER=0 ALT="Chunking and Extendible Datasets"></a> -<a href="mount.html" TARGET="CONTENT"><IMG SRC="Graphics/MountFile.gif" BORDER=0 ALT="Mounting Files"></a> -<a href="iterate.html" TARGET="CONTENT"><IMG SRC="Graphics/Iterate.gif" BORDER=0 ALT="Group Iteration"></a> - - -<hr> -<IMG SRC="Graphics/AddInfo.gif" BORDER=0 ALT="Additional Information"> -<a href="util.html" TARGET="CONTENT"><IMG SRC="Graphics/Utilities.gif" BORDER=0 ALT="HDF5 Utilities -- h5ls and h5dump"></a> -<a href="glossary.html" TARGET="CONTENT"><IMG SRC="Graphics/Glossary.gif" BORDER=0 ALT="Glossary"></a> -<a href="references.html" TARGET="CONTENT"><IMG SRC="Graphics/References.gif" BORDER=0 ALT="References"></a> -<a href="examples/" TARGET="CONTENT"><IMG SRC="Graphics/Examples.gif" BORDER=0 ALT="Example Programs"></a> - - -<hr> -<a href="Copyright.html" TARGET="CONTENT"><IMG SRC="Graphics/Copy.gif" BORDER=0 ALT="Copyright, Etc."></a><br> - - -</body> -</html> - diff --git a/doc/html/Tutor/ContentsIntro.html b/doc/html/Tutor/ContentsIntro.html deleted file mode 100644 index 96bd716..0000000 --- a/doc/html/Tutor/ContentsIntro.html +++ /dev/null @@ -1,63 +0,0 @@ -<html> - -<body bgcolor="#BBFFFF"> - - -<!-- -The following tag is for use only in the distributed doc set. -Remove (or comment out) when served from HDF web server. ---> -<center> -<font size=-1><a href="../index.html" target=_top>Return to HDF5 Doc Set</a></font> -</center> -<br> - -<hr> - -<!-- -<A HREF="READ1ST.HTML" Target="RdFirstWin" onClick="window.open("READ1ST.HTML","RdFirstWin","toolbar=0,location=0,directories=0,status=0,menubar=0,scrollbars=yes,resizable=1,width=500,height=250,titlebar=yes")"><IMG SRC="GRAPHICS/READ1ST.GIF" BORDER=0 ALT="Read this first!"></A> ---> - - -<a href="Contents.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCShort.gif" BORDER=0 ALT="(Short TOC)"></a> -<hr> - -<a href="title.html" TARGET="CONTENT"><IMG SRC="Graphics/TitlePg.gif" BORDER=0 ALT="Tutorial Title Page"></a> -<hr> - -<IMG SRC="Graphics/IntroTopics.gif" BORDER=0 ALT="Introductory Topics"> -<a href="intro.html" TARGET="CONTENT"><IMG SRC="Graphics/Intro.gif" BORDER=0 ALT="Introduction"></a> -<a href="fileorg.html" TARGET="CONTENT"><img src="Graphics/FileOrg.gif" BORDER=0 ALT="HDF5 File Organization"></a> -<a href="api.html" TARGET="CONTENT"><IMG SRC="Graphics/H5API.gif" BORDER=0 ALT="The HDF5 API"></a> -<a href="crtfile.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateFile.gif" BORDER=0 ALT="Creating an HDF5 File"></a> -<a href="crtdat.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset1.gif" BORDER=0 ALT="Creating a Dataset"></a> -<a href="rdwt.html" TARGET="CONTENT"><IMG SRC="Graphics/RdWrDataset.gif" BORDER=0 ALT="Reading from and Writing to a Dataset"></a> -<a href="crtatt.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateAttr.gif" BORDER=0 ALT="Creating an Attribute"></a> -<a href="crtgrp.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp1.gif" BORDER=0 ALT="Creating a Group"></a> -<a href="crtgrpar.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateGrp2.gif" BORDER=0 ALT="Creating Groups Using Absolute and Relative Names"></a> -<a href="crtgrpd.html" TARGET="CONTENT"><IMG SRC="Graphics/CreateDset2.gif" BORDER=0 ALT="Creating Datasets in a Group"></a> - -<br> -<a href="questions.html" TARGET="CONTENT"><IMG SRC="Graphics/Quiz.gif" BORDER=0 ALT="Quiz Questions"></a> -<a href="answers.html" TARGET="CONTENT"><IMG SRC="Graphics/QuizAns.gif" BORDER=0 ALT="Quiz Answers"></a> -<hr> - - -<a href="ContentsAdv.html" TARGET="BUTTONS"><IMG SRC="Graphics/AdvTopics.gif" BORDER=0 ALT="Advanced Topics"></a> -<hr> - - -<a href="ContentsAdd.html" TARGET="BUTTONS"><IMG SRC="Graphics/AddInfo.gif" BORDER=0 ALT="Additional Information"></a> -<hr> - - -<a href="ContentsFull.html" TARGET="BUTTONS"><IMG SRC="Graphics/TOCFull.gif" BORDER=0 ALT="Full TOC"></a> -<hr> - - -<a href="Copyright.html" TARGET="CONTENT"><IMG SRC="Graphics/Copy.gif" BORDER=0 ALT="Copyright, Etc."></a><br> - - -</body> -</html> - diff --git a/doc/html/Tutor/Copyright.html b/doc/html/Tutor/Copyright.html deleted file mode 100644 index d488a10..0000000 --- a/doc/html/Tutor/Copyright.html +++ /dev/null @@ -1,117 +0,0 @@ -<html> -<html> - <head> - <title> - HDF5 Copyright Notice - </title> - </head> - - <body bgcolor="#FFFFFF"> - - - -<hr> - -<h3>Copyright Notice and Statement for -<br> -NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities</h3> -<hr> -<p> - - -NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities -<br> -Copyright 1998, 1999, 2000, 2001 by the Board of Trustees of the University of Illinois -<br> -<strong>All rights reserved.</strong> -<p> - -Contributors: National Center for Supercomputing Applications (NCSA) at -the University of Illinois at Urbana-Champaign (UIUC), Lawrence Livermore -National Laboratory (LLNL), Sandia National Laboratories (SNL), Los Alamos -National Laboratory (LANL), Jean-loup Gailly and Mark Adler (gzip library). -<p> - -Redistribution and use in source and binary forms, with or without -modification, are permitted for any purpose (including commercial purposes) -provided that the following conditions are met: -<p> - -<ol> -<li>Redistributions of source code must retain the above copyright notice, -this list of conditions, and the following disclaimer. - -<li>Redistributions in binary form must reproduce the above copyright -notice, this list of conditions, and the following disclaimer in the -documentation and/or materials provided with the distribution. - -<li>In addition, redistributions of modified forms of the source or binary -code must carry prominent notices stating that the original code was -changed and the date of the change. - -<li>All publications or advertising materials mentioning features or use of -this software are asked, but not required, to acknowledge that it was -developed by the National Center for Supercomputing Applications at the -University of Illinois at Urbana-Champaign and to credit the contributors. - -<li>Neither the name of the University nor the names of the Contributors may -be used to endorse or promote products derived from this software without -specific prior written permission from the University or the Contributors. - -<li>THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY AND THE CONTRIBUTORS "AS IS" -WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. In no event -shall the University or the Contributors be liable for any damages suffered -by the users arising out of the use of this software, even if advised of -the possibility of such damage. - -</ol> - - - - -<hr> -Portions of HDF5 were developed with support from the University of -California, Lawrence Livermore National Laboratory (UC LLNL). -The following statment applies to those portions of the product -and must be retained in any redistribution of source code, binaries, -documentation, and/or accompanying materials: - -<dir> -This work was partially produced at the University of California, -Lawrence Livermore National Laboratory (UC LLNL) under contract no. -W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy (DOE) -and The Regents of the University of California (University) for the -operation of UC LLNL. -<p> -<b>DISCLAIMER:</b> -This work was prepared as an account of work sponsored by an agency of the -United States Government. Neither the United States Government nor the -University of California nor any of their employees, makes any warranty, -express or implied, or assumes any liability or responsibility for the -accuracy, completeness, or usefulness of any information, apparatus, -product, or process disclosed, or represents that its use would not -infringe privately-owned rights. Reference herein to any specific -commercial products, process, or service by trade name, trademark, -manufacturer, or otherwise, does not necessarily constitute or imply its -endorsement, recommendation, or favoring by the United States Government -or the University of California. The views and opinions of authors -expressed herein do not necessarily state or reflect those of the United -States Government or the University of California, and shall not be used -for advertising or product endorsement purposes. -</dir> - - - - -<hr> - -<address> -<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a> -</address> - -Last modified: 7 June 2000 -<br> - -</body> -</html> - diff --git a/doc/html/Tutor/Graphics/AddInfo.gif b/doc/html/Tutor/Graphics/AddInfo.gif Binary files differdeleted file mode 100644 index 335107f..0000000 --- a/doc/html/Tutor/Graphics/AddInfo.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/AdvTopics.gif b/doc/html/Tutor/Graphics/AdvTopics.gif Binary files differdeleted file mode 100644 index 9cea247..0000000 --- a/doc/html/Tutor/Graphics/AdvTopics.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/BLANK.gif b/doc/html/Tutor/Graphics/BLANK.gif Binary files differdeleted file mode 100644 index 03134e7..0000000 --- a/doc/html/Tutor/Graphics/BLANK.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/ChunkExt.gif b/doc/html/Tutor/Graphics/ChunkExt.gif Binary files differdeleted file mode 100644 index 52f9130..0000000 --- a/doc/html/Tutor/Graphics/ChunkExt.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CompDTypes.gif b/doc/html/Tutor/Graphics/CompDTypes.gif Binary files differdeleted file mode 100644 index 0549b32..0000000 --- a/doc/html/Tutor/Graphics/CompDTypes.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Copy.gif b/doc/html/Tutor/Graphics/Copy.gif Binary files differdeleted file mode 100644 index 7df2e6a..0000000 --- a/doc/html/Tutor/Graphics/Copy.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateAttr.gif b/doc/html/Tutor/Graphics/CreateAttr.gif Binary files differdeleted file mode 100644 index 82c7f72..0000000 --- a/doc/html/Tutor/Graphics/CreateAttr.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateDset1.gif b/doc/html/Tutor/Graphics/CreateDset1.gif Binary files differdeleted file mode 100644 index 2641d88..0000000 --- a/doc/html/Tutor/Graphics/CreateDset1.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateDset2.gif b/doc/html/Tutor/Graphics/CreateDset2.gif Binary files differdeleted file mode 100644 index 294c0a5..0000000 --- a/doc/html/Tutor/Graphics/CreateDset2.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateFile.gif b/doc/html/Tutor/Graphics/CreateFile.gif Binary files differdeleted file mode 100644 index e07d0aa..0000000 --- a/doc/html/Tutor/Graphics/CreateFile.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateGrp1.gif b/doc/html/Tutor/Graphics/CreateGrp1.gif Binary files differdeleted file mode 100644 index 66be2fd..0000000 --- a/doc/html/Tutor/Graphics/CreateGrp1.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/CreateGrp2.gif b/doc/html/Tutor/Graphics/CreateGrp2.gif Binary files differdeleted file mode 100644 index 93a5c87..0000000 --- a/doc/html/Tutor/Graphics/CreateGrp2.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Examples.gif b/doc/html/Tutor/Graphics/Examples.gif Binary files differdeleted file mode 100644 index d6b3ac6..0000000 --- a/doc/html/Tutor/Graphics/Examples.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/FileOrg.gif b/doc/html/Tutor/Graphics/FileOrg.gif Binary files differdeleted file mode 100644 index a0f812d..0000000 --- a/doc/html/Tutor/Graphics/FileOrg.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/FullTOC1.gif b/doc/html/Tutor/Graphics/FullTOC1.gif Binary files differdeleted file mode 100644 index 9a7a810..0000000 --- a/doc/html/Tutor/Graphics/FullTOC1.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/FullTOC2.gif b/doc/html/Tutor/Graphics/FullTOC2.gif Binary files differdeleted file mode 100644 index 651e0c7..0000000 --- a/doc/html/Tutor/Graphics/FullTOC2.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Glossary.gif b/doc/html/Tutor/Graphics/Glossary.gif Binary files differdeleted file mode 100644 index 157208a..0000000 --- a/doc/html/Tutor/Graphics/Glossary.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/H5API.gif b/doc/html/Tutor/Graphics/H5API.gif Binary files differdeleted file mode 100644 index 7d5c8a6..0000000 --- a/doc/html/Tutor/Graphics/H5API.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Intro.gif b/doc/html/Tutor/Graphics/Intro.gif Binary files differdeleted file mode 100644 index a9d299b..0000000 --- a/doc/html/Tutor/Graphics/Intro.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/IntroTopics.gif b/doc/html/Tutor/Graphics/IntroTopics.gif Binary files differdeleted file mode 100644 index 384d7a7..0000000 --- a/doc/html/Tutor/Graphics/IntroTopics.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Iterate.gif b/doc/html/Tutor/Graphics/Iterate.gif Binary files differdeleted file mode 100644 index 0dc68d5..0000000 --- a/doc/html/Tutor/Graphics/Iterate.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Makefile.am b/doc/html/Tutor/Graphics/Makefile.am deleted file mode 100644 index 6e3a60e..0000000 --- a/doc/html/Tutor/Graphics/Makefile.am +++ /dev/null @@ -1,24 +0,0 @@ -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -## -## Makefile.am -## Run automake to generate a Makefile.in from this file. -# - -include $(top_srcdir)/config/commence-doc.am - -localdocdir = $(docdir)/hdf5/Tutor/Graphics - -# Public doc files (to be installed)... -localdoc_DATA=AddInfo.gif AdvTopics.gif BLANK.gif ChunkExt.gif CompDTypes.gif \ - Copy.gif CreateAttr.gif CreateDset1.gif CreateDset2.gif \ - CreateFile.gif CreateGrp1.gif CreateGrp2.gif Examples.gif \ - FileOrg.gif FullTOC1.gif FullTOC2.gif Glossary.gif H5API.gif \ - Intro.gif IntroTopics.gif Iterate.gif MountFile.gif Quiz.gif \ - QuizAns.gif RdWrDataset.gif RefObject.gif RefRegion.gif \ - References.gif SelectElemCp.gif SelectHyp.gif TOC.gif \ - TOCFull.gif TOCShort.gif TitlePg.gif Utilities.gif diff --git a/doc/html/Tutor/Graphics/Makefile.in b/doc/html/Tutor/Graphics/Makefile.in deleted file mode 100644 index df5259b..0000000 --- a/doc/html/Tutor/Graphics/Makefile.in +++ /dev/null @@ -1,493 +0,0 @@ -# Makefile.in generated by automake 1.9.5 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005 Free Software Foundation, Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ - -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -# - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../../../.. -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -build_triplet = @build@ -host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(top_srcdir)/config/commence-doc.am \ - $(top_srcdir)/config/commence.am -subdir = doc/html/Tutor/Graphics -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.in -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(top_srcdir)/bin/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/src/H5config.h -CONFIG_CLEAN_FILES = -SOURCES = -DIST_SOURCES = -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -am__installdirs = "$(DESTDIR)$(localdocdir)" -localdocDATA_INSTALL = $(INSTALL_DATA) -DATA = $(localdoc_DATA) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -# Set the paths for AFS installs of autotools for Linux machines -# Ideally, these tools should never be needed during the build. -ACLOCAL = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/aclocal -I /afs/ncsa/projects/hdf/packages/libtool_1.5.14/Linux_2.4/share/aclocal -ADD_PARALLEL_FILES = @ADD_PARALLEL_FILES@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -AMTAR = @AMTAR@ -AM_MAKEFLAGS = @AM_MAKEFLAGS@ -AR = @AR@ -AUTOCONF = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoconf -AUTOHEADER = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoheader -AUTOMAKE = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/automake -AWK = @AWK@ -BUILD_CXX_CONDITIONAL_FALSE = @BUILD_CXX_CONDITIONAL_FALSE@ -BUILD_CXX_CONDITIONAL_TRUE = @BUILD_CXX_CONDITIONAL_TRUE@ -BUILD_FORTRAN_CONDITIONAL_FALSE = @BUILD_FORTRAN_CONDITIONAL_FALSE@ -BUILD_FORTRAN_CONDITIONAL_TRUE = @BUILD_FORTRAN_CONDITIONAL_TRUE@ -BUILD_HDF5_HL_CONDITIONAL_FALSE = @BUILD_HDF5_HL_CONDITIONAL_FALSE@ -BUILD_HDF5_HL_CONDITIONAL_TRUE = @BUILD_HDF5_HL_CONDITIONAL_TRUE@ -BUILD_PABLO_CONDITIONAL_FALSE = @BUILD_PABLO_CONDITIONAL_FALSE@ -BUILD_PABLO_CONDITIONAL_TRUE = @BUILD_PABLO_CONDITIONAL_TRUE@ -BUILD_PARALLEL_CONDITIONAL_FALSE = @BUILD_PARALLEL_CONDITIONAL_FALSE@ -BUILD_PARALLEL_CONDITIONAL_TRUE = @BUILD_PARALLEL_CONDITIONAL_TRUE@ -BUILD_PDB2HDF = @BUILD_PDB2HDF@ -BUILD_PDB2HDF_CONDITIONAL_FALSE = @BUILD_PDB2HDF_CONDITIONAL_FALSE@ -BUILD_PDB2HDF_CONDITIONAL_TRUE = @BUILD_PDB2HDF_CONDITIONAL_TRUE@ -BYTESEX = @BYTESEX@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CC_VERSION = @CC_VERSION@ -CFLAGS = @CFLAGS@ -CONFIG_DATE = @CONFIG_DATE@ -CONFIG_MODE = @CONFIG_MODE@ -CONFIG_USER = @CONFIG_USER@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CXX = @CXX@ -CXXCPP = @CXXCPP@ -CXXDEPMODE = @CXXDEPMODE@ -CXXFLAGS = @CXXFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEBUG_PKG = @DEBUG_PKG@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -DYNAMIC_DIRS = @DYNAMIC_DIRS@ -ECHO = @ECHO@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -F77 = @F77@ - -# Make sure that these variables are exported to the Makefiles -F9XMODEXT = @F9XMODEXT@ -F9XMODFLAG = @F9XMODFLAG@ -F9XSUFFIXFLAG = @F9XSUFFIXFLAG@ -FC = @FC@ -FCFLAGS = @FCFLAGS@ -FCLIBS = @FCLIBS@ -FFLAGS = @FFLAGS@ -FILTERS = @FILTERS@ -FSEARCH_DIRS = @FSEARCH_DIRS@ -H5_VERSION = @H5_VERSION@ -HADDR_T = @HADDR_T@ -HDF5_INTERFACES = @HDF5_INTERFACES@ -HID_T = @HID_T@ -HL = @HL@ -HL_FOR = @HL_FOR@ -HSIZET = @HSIZET@ -HSIZE_T = @HSIZE_T@ -HSSIZE_T = @HSSIZE_T@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -INSTRUMENT_LIBRARY = @INSTRUMENT_LIBRARY@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LIBTOOL = @LIBTOOL@ -LN_S = @LN_S@ -LTLIBOBJS = @LTLIBOBJS@ -LT_STATIC_EXEC = @LT_STATIC_EXEC@ -MAINT = @MAINT@ -MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ -MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ -MAKEINFO = @MAKEINFO@ -MPE = @MPE@ -OBJECT_NAMELEN_DEFAULT_F = @OBJECT_NAMELEN_DEFAULT_F@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PARALLEL = @PARALLEL@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PERL = @PERL@ -PTHREAD = @PTHREAD@ -RANLIB = @RANLIB@ -ROOT = @ROOT@ -RUNPARALLEL = @RUNPARALLEL@ -RUNSERIAL = @RUNSERIAL@ -R_INTEGER = @R_INTEGER@ -R_LARGE = @R_LARGE@ -SEARCH = @SEARCH@ -SETX = @SETX@ -SET_MAKE = @SET_MAKE@ - -# Hardcode SHELL to be /bin/sh. Most machines have this shell, and -# on at least one machine configure fails to detect its existence (janus). -# Also, when HDF5 is configured on one machine but run on another, -# configure's automatic SHELL detection may not work on the build machine. -SHELL = /bin/sh -SIZE_T = @SIZE_T@ -STATIC_SHARED = @STATIC_SHARED@ -STRIP = @STRIP@ -TESTPARALLEL = @TESTPARALLEL@ -TRACE_API = @TRACE_API@ -USE_FILTER_DEFLATE = @USE_FILTER_DEFLATE@ -USE_FILTER_FLETCHER32 = @USE_FILTER_FLETCHER32@ -USE_FILTER_NBIT = @USE_FILTER_NBIT@ -USE_FILTER_SCALEOFFSET = @USE_FILTER_SCALEOFFSET@ -USE_FILTER_SHUFFLE = @USE_FILTER_SHUFFLE@ -USE_FILTER_SZIP = @USE_FILTER_SZIP@ -VERSION = @VERSION@ -ac_ct_AR = @ac_ct_AR@ -ac_ct_CC = @ac_ct_CC@ -ac_ct_CXX = @ac_ct_CXX@ -ac_ct_F77 = @ac_ct_F77@ -ac_ct_FC = @ac_ct_FC@ -ac_ct_RANLIB = @ac_ct_RANLIB@ -ac_ct_STRIP = @ac_ct_STRIP@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ -am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build = @build@ -build_alias = @build_alias@ -build_cpu = @build_cpu@ -build_os = @build_os@ -build_vendor = @build_vendor@ -datadir = @datadir@ -exec_prefix = @exec_prefix@ -host = @host@ -host_alias = @host_alias@ -host_cpu = @host_cpu@ -host_os = @host_os@ -host_vendor = @host_vendor@ - -# Install directories that automake doesn't know about -includedir = $(exec_prefix)/include -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ - -# Shell commands used in Makefiles -RM = rm -f -CP = cp - -# Some machines need a command to run executables; this is that command -# so that our tests will run. -# We use RUNTESTS instead of RUNSERIAL directly because it may be that -# some tests need to be run with a different command. Older versions -# of the makefiles used the command -# $(LIBTOOL) --mode=execute -# in some directories, for instance. -RUNTESTS = $(RUNSERIAL) - -# Libraries to link to while building -LIBHDF5 = $(top_builddir)/src/libhdf5.la -LIBH5TEST = $(top_builddir)/test/libh5test.la -LIBH5F = $(top_builddir)/fortran/src/libhdf5_fortran.la -LIBH5FTEST = $(top_builddir)/fortran/test/libh5test_fortran.la -LIBH5CPP = $(top_builddir)/c++/src/libhdf5_cpp.la -LIBH5TOOLS = $(top_builddir)/tools/lib/libh5tools.la -LIBH5_HL = $(top_builddir)/hl/src/libhdf5_hl.la -LIBH5F_HL = $(top_builddir)/hl/fortran/src/libhdf5hl_fortran.la -LIBH5CPP_HL = $(top_builddir)/hl/c++/src/libhdf5_hl_cpp.la -docdir = $(exec_prefix)/doc - -# Scripts used to build examples -H5CC = $(bindir)/h5cc -H5CC_PP = $(bindir)/h5pcc -H5FC = $(bindir)/h5fc -H5FC_PP = $(bindir)/h5pfc - -# .chkexe and .chksh files are used to mark tests that have run successfully. -MOSTLYCLEANFILES = *.chkexe *.chksh -localdocdir = $(docdir)/hdf5/Tutor/Graphics - -# Public doc files (to be installed)... -localdoc_DATA = AddInfo.gif AdvTopics.gif BLANK.gif ChunkExt.gif CompDTypes.gif \ - Copy.gif CreateAttr.gif CreateDset1.gif CreateDset2.gif \ - CreateFile.gif CreateGrp1.gif CreateGrp2.gif Examples.gif \ - FileOrg.gif FullTOC1.gif FullTOC2.gif Glossary.gif H5API.gif \ - Intro.gif IntroTopics.gif Iterate.gif MountFile.gif Quiz.gif \ - QuizAns.gif RdWrDataset.gif RefObject.gif RefRegion.gif \ - References.gif SelectElemCp.gif SelectHyp.gif TOC.gif \ - TOCFull.gif TOCShort.gif TitlePg.gif Utilities.gif - -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/config/commence-doc.am $(top_srcdir)/config/commence.am $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ - && exit 0; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/html/Tutor/Graphics/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --foreign doc/html/Tutor/Graphics/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -mostlyclean-libtool: - -rm -f *.lo - -clean-libtool: - -rm -rf .libs _libs - -distclean-libtool: - -rm -f libtool -uninstall-info-am: -install-localdocDATA: $(localdoc_DATA) - @$(NORMAL_INSTALL) - test -z "$(localdocdir)" || $(mkdir_p) "$(DESTDIR)$(localdocdir)" - @list='$(localdoc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(localdocDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(localdocdir)/$$f'"; \ - $(localdocDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -uninstall-localdocDATA: - @$(NORMAL_UNINSTALL) - @list='$(localdoc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(localdocdir)/$$f'"; \ - rm -f "$(DESTDIR)$(localdocdir)/$$f"; \ - done -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - - -distdir: $(DISTFILES) - $(mkdir_p) $(distdir)/../../../../config - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkdir_p) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ - else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-am -all-am: Makefile $(DATA) -installdirs: - for dir in "$(DESTDIR)$(localdocdir)"; do \ - test -z "$$dir" || $(mkdir_p) "$$dir"; \ - done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-am -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -test -z "$(MOSTLYCLEANFILES)" || rm -f $(MOSTLYCLEANFILES) - -clean-generic: - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-am - -clean-am: clean-generic clean-libtool mostlyclean-am - -distclean: distclean-am - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-libtool - -dvi: dvi-am - -dvi-am: - -html: html-am - -info: info-am - -info-am: - -install-data-am: install-localdocDATA - -install-exec-am: - -install-info: install-info-am - -install-man: - -installcheck-am: - -maintainer-clean: maintainer-clean-am - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-am - -mostlyclean-am: mostlyclean-generic mostlyclean-libtool - -pdf: pdf-am - -pdf-am: - -ps: ps-am - -ps-am: - -uninstall-am: uninstall-info-am uninstall-localdocDATA - -.PHONY: all all-am check check-am clean clean-generic clean-libtool \ - distclean distclean-generic distclean-libtool distdir dvi \ - dvi-am html html-am info info-am install install-am \ - install-data install-data-am install-exec install-exec-am \ - install-info install-info-am install-localdocDATA install-man \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ - uninstall uninstall-am uninstall-info-am \ - uninstall-localdocDATA - - -# Ignore most rules -lib progs check test _test check-p check-s: - @echo "Nothing to be done" - -tests dep depend: - @@SETX@; for d in X $(SUBDIRS); do \ - if test $$d != X; then \ - (cd $$d && $(MAKE) $(AM_MAKEFLAGS) $@) || exit 1; \ - fi; - done - -# In docs directory, install-doc is the same as install -install-doc install-all: - $(MAKE) $(AM_MAKEFLAGS) install -uninstall-doc uninstall-all: - $(MAKE) $(AM_MAKEFLAGS) uninstall -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: diff --git a/doc/html/Tutor/Graphics/MountFile.gif b/doc/html/Tutor/Graphics/MountFile.gif Binary files differdeleted file mode 100644 index fb476df..0000000 --- a/doc/html/Tutor/Graphics/MountFile.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Quiz.gif b/doc/html/Tutor/Graphics/Quiz.gif Binary files differdeleted file mode 100644 index 5bba11e..0000000 --- a/doc/html/Tutor/Graphics/Quiz.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/QuizAns.gif b/doc/html/Tutor/Graphics/QuizAns.gif Binary files differdeleted file mode 100644 index 6b73566..0000000 --- a/doc/html/Tutor/Graphics/QuizAns.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/RdWrDataset.gif b/doc/html/Tutor/Graphics/RdWrDataset.gif Binary files differdeleted file mode 100644 index 962fed1..0000000 --- a/doc/html/Tutor/Graphics/RdWrDataset.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/RefObject.gif b/doc/html/Tutor/Graphics/RefObject.gif Binary files differdeleted file mode 100755 index ae9dc05..0000000 --- a/doc/html/Tutor/Graphics/RefObject.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/RefRegion.gif b/doc/html/Tutor/Graphics/RefRegion.gif Binary files differdeleted file mode 100755 index 250039f..0000000 --- a/doc/html/Tutor/Graphics/RefRegion.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/References.gif b/doc/html/Tutor/Graphics/References.gif Binary files differdeleted file mode 100644 index 0d94116..0000000 --- a/doc/html/Tutor/Graphics/References.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/SelectElemCp.gif b/doc/html/Tutor/Graphics/SelectElemCp.gif Binary files differdeleted file mode 100644 index ed8e976..0000000 --- a/doc/html/Tutor/Graphics/SelectElemCp.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/SelectHyp.gif b/doc/html/Tutor/Graphics/SelectHyp.gif Binary files differdeleted file mode 100644 index 29ac707..0000000 --- a/doc/html/Tutor/Graphics/SelectHyp.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/TOC.gif b/doc/html/Tutor/Graphics/TOC.gif Binary files differdeleted file mode 100644 index 0bc3251..0000000 --- a/doc/html/Tutor/Graphics/TOC.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/TOCFull.gif b/doc/html/Tutor/Graphics/TOCFull.gif Binary files differdeleted file mode 100644 index bb1e982..0000000 --- a/doc/html/Tutor/Graphics/TOCFull.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/TOCShort.gif b/doc/html/Tutor/Graphics/TOCShort.gif Binary files differdeleted file mode 100644 index a17aaee..0000000 --- a/doc/html/Tutor/Graphics/TOCShort.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/TitlePg.gif b/doc/html/Tutor/Graphics/TitlePg.gif Binary files differdeleted file mode 100644 index 5f9a633..0000000 --- a/doc/html/Tutor/Graphics/TitlePg.gif +++ /dev/null diff --git a/doc/html/Tutor/Graphics/Utilities.gif b/doc/html/Tutor/Graphics/Utilities.gif Binary files differdeleted file mode 100644 index 62e1d78..0000000 --- a/doc/html/Tutor/Graphics/Utilities.gif +++ /dev/null diff --git a/doc/html/Tutor/Makefile.am b/doc/html/Tutor/Makefile.am deleted file mode 100644 index ed7ab7a..0000000 --- a/doc/html/Tutor/Makefile.am +++ /dev/null @@ -1,25 +0,0 @@ -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -## -## Makefile.am -## Run automake to generate a Makefile.in from this file. -# - -include $(top_srcdir)/config/commence-doc.am - -SUBDIRS=Graphics examples -localdocdir = $(docdir)/hdf5/Tutor - -# Public doc files (to be installed)... -localdoc_DATA=Contents.html ContentsAdd.html ContentsAdv.html \ - ContentsFull.html ContentsIntro.html Copyright.html answers.html \ - api.html bighdf2sp.JPG compound.html crtatt.html crtdat.html \ - crtfile.html crtgrp.html crtgrpar.html crtgrpd.html extend.html \ - fileorg.html glossary.html img001.gif img002.gif img003.gif \ - img004.gif img005.gif index.html intro.html iterate.html \ - mount.html questions.html rdwt.html references.html reftoobj.html \ - reftoreg.html select.html selectc.html title.html util.html diff --git a/doc/html/Tutor/Makefile.in b/doc/html/Tutor/Makefile.in deleted file mode 100644 index 5a16306..0000000 --- a/doc/html/Tutor/Makefile.in +++ /dev/null @@ -1,651 +0,0 @@ -# Makefile.in generated by automake 1.9.5 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005 Free Software Foundation, Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ - -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -# - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../../.. -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -build_triplet = @build@ -host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(top_srcdir)/config/commence-doc.am \ - $(top_srcdir)/config/commence.am -subdir = doc/html/Tutor -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.in -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(top_srcdir)/bin/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/src/H5config.h -CONFIG_CLEAN_FILES = -SOURCES = -DIST_SOURCES = -RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ - html-recursive info-recursive install-data-recursive \ - install-exec-recursive install-info-recursive \ - install-recursive installcheck-recursive installdirs-recursive \ - pdf-recursive ps-recursive uninstall-info-recursive \ - uninstall-recursive -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -am__installdirs = "$(DESTDIR)$(localdocdir)" -localdocDATA_INSTALL = $(INSTALL_DATA) -DATA = $(localdoc_DATA) -ETAGS = etags -CTAGS = ctags -DIST_SUBDIRS = $(SUBDIRS) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -# Set the paths for AFS installs of autotools for Linux machines -# Ideally, these tools should never be needed during the build. -ACLOCAL = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/aclocal -I /afs/ncsa/projects/hdf/packages/libtool_1.5.14/Linux_2.4/share/aclocal -ADD_PARALLEL_FILES = @ADD_PARALLEL_FILES@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -AMTAR = @AMTAR@ -AM_MAKEFLAGS = @AM_MAKEFLAGS@ -AR = @AR@ -AUTOCONF = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoconf -AUTOHEADER = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoheader -AUTOMAKE = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/automake -AWK = @AWK@ -BUILD_CXX_CONDITIONAL_FALSE = @BUILD_CXX_CONDITIONAL_FALSE@ -BUILD_CXX_CONDITIONAL_TRUE = @BUILD_CXX_CONDITIONAL_TRUE@ -BUILD_FORTRAN_CONDITIONAL_FALSE = @BUILD_FORTRAN_CONDITIONAL_FALSE@ -BUILD_FORTRAN_CONDITIONAL_TRUE = @BUILD_FORTRAN_CONDITIONAL_TRUE@ -BUILD_HDF5_HL_CONDITIONAL_FALSE = @BUILD_HDF5_HL_CONDITIONAL_FALSE@ -BUILD_HDF5_HL_CONDITIONAL_TRUE = @BUILD_HDF5_HL_CONDITIONAL_TRUE@ -BUILD_PABLO_CONDITIONAL_FALSE = @BUILD_PABLO_CONDITIONAL_FALSE@ -BUILD_PABLO_CONDITIONAL_TRUE = @BUILD_PABLO_CONDITIONAL_TRUE@ -BUILD_PARALLEL_CONDITIONAL_FALSE = @BUILD_PARALLEL_CONDITIONAL_FALSE@ -BUILD_PARALLEL_CONDITIONAL_TRUE = @BUILD_PARALLEL_CONDITIONAL_TRUE@ -BUILD_PDB2HDF = @BUILD_PDB2HDF@ -BUILD_PDB2HDF_CONDITIONAL_FALSE = @BUILD_PDB2HDF_CONDITIONAL_FALSE@ -BUILD_PDB2HDF_CONDITIONAL_TRUE = @BUILD_PDB2HDF_CONDITIONAL_TRUE@ -BYTESEX = @BYTESEX@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CC_VERSION = @CC_VERSION@ -CFLAGS = @CFLAGS@ -CONFIG_DATE = @CONFIG_DATE@ -CONFIG_MODE = @CONFIG_MODE@ -CONFIG_USER = @CONFIG_USER@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CXX = @CXX@ -CXXCPP = @CXXCPP@ -CXXDEPMODE = @CXXDEPMODE@ -CXXFLAGS = @CXXFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEBUG_PKG = @DEBUG_PKG@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -DYNAMIC_DIRS = @DYNAMIC_DIRS@ -ECHO = @ECHO@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -F77 = @F77@ - -# Make sure that these variables are exported to the Makefiles -F9XMODEXT = @F9XMODEXT@ -F9XMODFLAG = @F9XMODFLAG@ -F9XSUFFIXFLAG = @F9XSUFFIXFLAG@ -FC = @FC@ -FCFLAGS = @FCFLAGS@ -FCLIBS = @FCLIBS@ -FFLAGS = @FFLAGS@ -FILTERS = @FILTERS@ -FSEARCH_DIRS = @FSEARCH_DIRS@ -H5_VERSION = @H5_VERSION@ -HADDR_T = @HADDR_T@ -HDF5_INTERFACES = @HDF5_INTERFACES@ -HID_T = @HID_T@ -HL = @HL@ -HL_FOR = @HL_FOR@ -HSIZET = @HSIZET@ -HSIZE_T = @HSIZE_T@ -HSSIZE_T = @HSSIZE_T@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -INSTRUMENT_LIBRARY = @INSTRUMENT_LIBRARY@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LIBTOOL = @LIBTOOL@ -LN_S = @LN_S@ -LTLIBOBJS = @LTLIBOBJS@ -LT_STATIC_EXEC = @LT_STATIC_EXEC@ -MAINT = @MAINT@ -MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ -MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ -MAKEINFO = @MAKEINFO@ -MPE = @MPE@ -OBJECT_NAMELEN_DEFAULT_F = @OBJECT_NAMELEN_DEFAULT_F@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PARALLEL = @PARALLEL@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PERL = @PERL@ -PTHREAD = @PTHREAD@ -RANLIB = @RANLIB@ -ROOT = @ROOT@ -RUNPARALLEL = @RUNPARALLEL@ -RUNSERIAL = @RUNSERIAL@ -R_INTEGER = @R_INTEGER@ -R_LARGE = @R_LARGE@ -SEARCH = @SEARCH@ -SETX = @SETX@ -SET_MAKE = @SET_MAKE@ - -# Hardcode SHELL to be /bin/sh. Most machines have this shell, and -# on at least one machine configure fails to detect its existence (janus). -# Also, when HDF5 is configured on one machine but run on another, -# configure's automatic SHELL detection may not work on the build machine. -SHELL = /bin/sh -SIZE_T = @SIZE_T@ -STATIC_SHARED = @STATIC_SHARED@ -STRIP = @STRIP@ -TESTPARALLEL = @TESTPARALLEL@ -TRACE_API = @TRACE_API@ -USE_FILTER_DEFLATE = @USE_FILTER_DEFLATE@ -USE_FILTER_FLETCHER32 = @USE_FILTER_FLETCHER32@ -USE_FILTER_NBIT = @USE_FILTER_NBIT@ -USE_FILTER_SCALEOFFSET = @USE_FILTER_SCALEOFFSET@ -USE_FILTER_SHUFFLE = @USE_FILTER_SHUFFLE@ -USE_FILTER_SZIP = @USE_FILTER_SZIP@ -VERSION = @VERSION@ -ac_ct_AR = @ac_ct_AR@ -ac_ct_CC = @ac_ct_CC@ -ac_ct_CXX = @ac_ct_CXX@ -ac_ct_F77 = @ac_ct_F77@ -ac_ct_FC = @ac_ct_FC@ -ac_ct_RANLIB = @ac_ct_RANLIB@ -ac_ct_STRIP = @ac_ct_STRIP@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ -am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build = @build@ -build_alias = @build_alias@ -build_cpu = @build_cpu@ -build_os = @build_os@ -build_vendor = @build_vendor@ -datadir = @datadir@ -exec_prefix = @exec_prefix@ -host = @host@ -host_alias = @host_alias@ -host_cpu = @host_cpu@ -host_os = @host_os@ -host_vendor = @host_vendor@ - -# Install directories that automake doesn't know about -includedir = $(exec_prefix)/include -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ - -# Shell commands used in Makefiles -RM = rm -f -CP = cp - -# Some machines need a command to run executables; this is that command -# so that our tests will run. -# We use RUNTESTS instead of RUNSERIAL directly because it may be that -# some tests need to be run with a different command. Older versions -# of the makefiles used the command -# $(LIBTOOL) --mode=execute -# in some directories, for instance. -RUNTESTS = $(RUNSERIAL) - -# Libraries to link to while building -LIBHDF5 = $(top_builddir)/src/libhdf5.la -LIBH5TEST = $(top_builddir)/test/libh5test.la -LIBH5F = $(top_builddir)/fortran/src/libhdf5_fortran.la -LIBH5FTEST = $(top_builddir)/fortran/test/libh5test_fortran.la -LIBH5CPP = $(top_builddir)/c++/src/libhdf5_cpp.la -LIBH5TOOLS = $(top_builddir)/tools/lib/libh5tools.la -LIBH5_HL = $(top_builddir)/hl/src/libhdf5_hl.la -LIBH5F_HL = $(top_builddir)/hl/fortran/src/libhdf5hl_fortran.la -LIBH5CPP_HL = $(top_builddir)/hl/c++/src/libhdf5_hl_cpp.la -docdir = $(exec_prefix)/doc - -# Scripts used to build examples -H5CC = $(bindir)/h5cc -H5CC_PP = $(bindir)/h5pcc -H5FC = $(bindir)/h5fc -H5FC_PP = $(bindir)/h5pfc - -# .chkexe and .chksh files are used to mark tests that have run successfully. -MOSTLYCLEANFILES = *.chkexe *.chksh -SUBDIRS = Graphics examples -localdocdir = $(docdir)/hdf5/Tutor - -# Public doc files (to be installed)... -localdoc_DATA = Contents.html ContentsAdd.html ContentsAdv.html \ - ContentsFull.html ContentsIntro.html Copyright.html answers.html \ - api.html bighdf2sp.JPG compound.html crtatt.html crtdat.html \ - crtfile.html crtgrp.html crtgrpar.html crtgrpd.html extend.html \ - fileorg.html glossary.html img001.gif img002.gif img003.gif \ - img004.gif img005.gif index.html intro.html iterate.html \ - mount.html questions.html rdwt.html references.html reftoobj.html \ - reftoreg.html select.html selectc.html title.html util.html - -all: all-recursive - -.SUFFIXES: -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/config/commence-doc.am $(top_srcdir)/config/commence.am $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ - && exit 0; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/html/Tutor/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --foreign doc/html/Tutor/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -mostlyclean-libtool: - -rm -f *.lo - -clean-libtool: - -rm -rf .libs _libs - -distclean-libtool: - -rm -f libtool -uninstall-info-am: -install-localdocDATA: $(localdoc_DATA) - @$(NORMAL_INSTALL) - test -z "$(localdocdir)" || $(mkdir_p) "$(DESTDIR)$(localdocdir)" - @list='$(localdoc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(localdocDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(localdocdir)/$$f'"; \ - $(localdocDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -uninstall-localdocDATA: - @$(NORMAL_UNINSTALL) - @list='$(localdoc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(localdocdir)/$$f'"; \ - rm -f "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -# This directory's subdirectories are mostly independent; you can cd -# into them and run `make' without going through this Makefile. -# To change the values of `make' variables: instead of editing Makefiles, -# (1) if the variable is set in `config.status', edit `config.status' -# (which will cause the Makefiles to be regenerated when you run `make'); -# (2) otherwise, pass the desired values on the `make' command line. -$(RECURSIVE_TARGETS): - @failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - target=`echo $@ | sed s/-recursive//`; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - dot_seen=yes; \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done; \ - if test "$$dot_seen" = "no"; then \ - $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ - fi; test -z "$$fail" - -mostlyclean-recursive clean-recursive distclean-recursive \ -maintainer-clean-recursive: - @failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - case "$@" in \ - distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ - *) list='$(SUBDIRS)' ;; \ - esac; \ - rev=''; for subdir in $$list; do \ - if test "$$subdir" = "."; then :; else \ - rev="$$subdir $$rev"; \ - fi; \ - done; \ - rev="$$rev ."; \ - target=`echo $@ | sed s/-recursive//`; \ - for subdir in $$rev; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done && test -z "$$fail" -tags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ - done -ctags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ - done - -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - mkid -fID $$unique -tags: TAGS - -TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - here=`pwd`; \ - if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ - include_option=--etags-include; \ - empty_fix=.; \ - else \ - include_option=--include; \ - empty_fix=; \ - fi; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test ! -f $$subdir/TAGS || \ - tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ - fi; \ - done; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ - test -n "$$unique" || unique=$$empty_fix; \ - $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ - $$tags $$unique; \ - fi -ctags: CTAGS -CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - here=`pwd`; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - test -z "$(CTAGS_ARGS)$$tags$$unique" \ - || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ - $$tags $$unique - -GTAGS: - here=`$(am__cd) $(top_builddir) && pwd` \ - && cd $(top_srcdir) \ - && gtags -i $(GTAGS_ARGS) $$here - -distclean-tags: - -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags - -distdir: $(DISTFILES) - $(mkdir_p) $(distdir)/../../../config - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkdir_p) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ - else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ - || exit 1; \ - fi; \ - done - list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test -d "$(distdir)/$$subdir" \ - || $(mkdir_p) "$(distdir)/$$subdir" \ - || exit 1; \ - distdir=`$(am__cd) $(distdir) && pwd`; \ - top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ - (cd $$subdir && \ - $(MAKE) $(AM_MAKEFLAGS) \ - top_distdir="$$top_distdir" \ - distdir="$$distdir/$$subdir" \ - distdir) \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-recursive -all-am: Makefile $(DATA) -installdirs: installdirs-recursive -installdirs-am: - for dir in "$(DESTDIR)$(localdocdir)"; do \ - test -z "$$dir" || $(mkdir_p) "$$dir"; \ - done -install: install-recursive -install-exec: install-exec-recursive -install-data: install-data-recursive -uninstall: uninstall-recursive - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-recursive -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -test -z "$(MOSTLYCLEANFILES)" || rm -f $(MOSTLYCLEANFILES) - -clean-generic: - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-recursive - -clean-am: clean-generic clean-libtool mostlyclean-am - -distclean: distclean-recursive - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-libtool \ - distclean-tags - -dvi: dvi-recursive - -dvi-am: - -html: html-recursive - -info: info-recursive - -info-am: - -install-data-am: install-localdocDATA - -install-exec-am: - -install-info: install-info-recursive - -install-man: - -installcheck-am: - -maintainer-clean: maintainer-clean-recursive - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-recursive - -mostlyclean-am: mostlyclean-generic mostlyclean-libtool - -pdf: pdf-recursive - -pdf-am: - -ps: ps-recursive - -ps-am: - -uninstall-am: uninstall-info-am uninstall-localdocDATA - -uninstall-info: uninstall-info-recursive - -.PHONY: $(RECURSIVE_TARGETS) CTAGS GTAGS all all-am check check-am \ - clean clean-generic clean-libtool clean-recursive ctags \ - ctags-recursive distclean distclean-generic distclean-libtool \ - distclean-recursive distclean-tags distdir dvi dvi-am html \ - html-am info info-am install install-am install-data \ - install-data-am install-exec install-exec-am install-info \ - install-info-am install-localdocDATA install-man install-strip \ - installcheck installcheck-am installdirs installdirs-am \ - maintainer-clean maintainer-clean-generic \ - maintainer-clean-recursive mostlyclean mostlyclean-generic \ - mostlyclean-libtool mostlyclean-recursive pdf pdf-am ps ps-am \ - tags tags-recursive uninstall uninstall-am uninstall-info-am \ - uninstall-localdocDATA - - -# Ignore most rules -lib progs check test _test check-p check-s: - @echo "Nothing to be done" - -tests dep depend: - @@SETX@; for d in X $(SUBDIRS); do \ - if test $$d != X; then \ - (cd $$d && $(MAKE) $(AM_MAKEFLAGS) $@) || exit 1; \ - fi; - done - -# In docs directory, install-doc is the same as install -install-doc install-all: - $(MAKE) $(AM_MAKEFLAGS) install -uninstall-doc uninstall-all: - $(MAKE) $(AM_MAKEFLAGS) uninstall -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: diff --git a/doc/html/Tutor/answers.html b/doc/html/Tutor/answers.html deleted file mode 100644 index e0cd15e..0000000 --- a/doc/html/Tutor/answers.html +++ /dev/null @@ -1,322 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Introductory Topics Quiz with Answers -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<FONT COLOR="#c101cd">Introductory Topics Quiz - with Answers</FONT> -</H1> - -<hr noshade size=1> - - -<h3>Section 2: HDF File Organization</h3> -<ol> - -<li>Name and describe the two primary objects that can be stored in an HDF5 - file. - - <dl> - <dt><b>Answers:</b> - <dd><em>Group:</em> A grouping structure containing zero or more - HDF5 objects, together with supporting metadata. - <dd><em>Dataset:</em> A multidimensional array of data elements, - together with supporting metadata. - </dl> - -<p> -<li>What is an attribute? - - <dl> - <dt><b>Answer:</b> - <dd>An HDF5 attribute is a user-defined HDF5 structure that provides extra - information about an HDF5 object. - </dl> - -<p> -<li>Give the path name for an object called <code>harry</code> that is - a member of a group called <code>dick</code>, which, in turn, is a - member of the root group. - - <dl> - <dt><b>Answer:</b> - <dd><code>/dick/harry</code> - </dl> - - -</ol> -<h3>Section 3: The HDF5 API</h3> -<ol> - -<li>Describe the purpose of each of the following HDF5 APIs: - - <dir> - H5A, H5D, H5E, H5F, H5G, H5T, H5Z - </dir> - - <dl> - <dt><b>Answers:</b> - <dir> - H5A: Attribute access and manipulation routines <br> - H5D: Dataset access and manipulation routines <br> - H5E: Error handling routines <br> - H5F: File access routines <br> - H5G: Routines for creating and operating on groups <br> - H5T: Routines for creating and manipulating the - datatypes of dataset elements <br> - H5Z: Data compression routines - </dir> - </dl> - - -</ol> -<h3>Section 4: Creating an HDF5 File</h3> -<ol> - -<li>What two HDF5 routines must be called to create an HDF5 file? - - <dl> - <dt><b>Answer:</b> - <dd><code>H5Fcreate</code> and <code>H5Fclose</code>. - </dl> - -<p> -<li>What include file must be included in any file that uses the HDF5 library? - - <dl> - <dt><b>Answer:</b> - <dd><code>hdf5.h</code> must be included because it contains definitions - and declarations used by the library. - </dl> - -<p> -<li>An HDF5 file is never completely empty because as soon as it is created, - it automatically contains a certain primary object. What is that object? - - <dl> - <dt><b>Answer:</b> - <dd>The root group. - </dl> - - -</ol> -<h3>Section 5: Creating a Dataset</h3> -<ol> - -<li>Name and describe two major datatype categories. - - <dl> - <dt><b>Answers:</b> - <dd><em>Atomic datatype:</em> - An atomic datatype cannot be decomposed into smaller units at the - API level. - <br> - <em>Compound datatype:</em> - A compound datatype is a collection of atomic and compound datatypes, - or small arrays of such types. - </dl> - -<p> -<li>List the HDF5 atomic datatypes. Give an example of a predefined datatype. - - <dl> - <dt><b>Answers:</b> - <dd>There are six HDF5 atomic datatypes: integer, floating point, - date and time, character string, bit field, and opaque. - Examples of predefined datatypes include the following: - <dir> - <code>H5T_IEEE_F32LE</code> - - 4-byte little-endian, IEEE floating point <br> - <code>H5T_NATIVE_INT</code> - - native integer - </dir> - </dl> - -<p> -<li>What does the dataspace describe? What are the major characteristics of - the simple dataspace? - - <dl> - <dt><b>Answers:</b> - <dd>The dataspace describes the dimensionality of the dataset. - A simple dataspace is characterized by its rank and dimension sizes. - </dl> - -<p> -<li>What information needs to be passed to the H5Dcreate function, i.e., - what information is needed to describe a dataset at creation time? - - <dl> - <dt><b>Answer:</b> - <dd>The dataset location, name, dataspace, datatype, and dataset - creation property list. - </dl> - - -</ol> -<h3>Section 6: Reading from and Writing to a Dataset</h3> -<ol> - -<li>What are six pieces of information which need to be specified for - reading and writing a dataset? - - <dl> - <dt><b>Answer:</b> - <dd>The dataset identifier, the dataset's datatype and dataspace in - memory, the dataspace in the file, the dataset transfer property - list, and a data buffer. - </dl> - -<p> -<li>Why are both the memory dataspace and file dataspace needed for - read/write operations, while only the memory datatype is required? - - <dl> - <dt><b>Answer:</b> - <dd>A dataset's file datatype is not required for a read/write operation - because the file datatype is specified when the dataset is created - and cannot be changed. Both file and memory dataspaces are required - for dataset subsetting and for performing partial I/O operations. - </dl> - -<p> -<li>What does the line - <br> - <code>DATASPACE { SIMPLE (4 , 6 ) / ( 4 , 6 ) } </code> - <br>in Figure 6.1 mean? - - <dl> - <dt><b>Answer:</b> - <dd>It means that the dataset <code>dset</code> has a simple dataspace - with the current dimensions (4,6) and the maximum size of the - dimensions (4,6). - </dl> - - -</ol> -<h3>Section 7: Creating an Attribute</h3> -<ol> - -<li>What is an attribute? - - <dl> - <dt><b>Answer:</b> - <dd>An attribute is a dataset attached to an object. It describes the - nature and/or the intended usage of the object. - </dl> - -<p> -<li>Can partial I/O operations be performed on attributes? - - <dl> - <dt><b>Answer:</b> - <dd>No. - </dl> - - -</ol> -<h3>Section 8: Creating a Group</h3> -<ol> - -<li>What are the two primary objects that can be included in a group? - - <dl> - <dt><b>Answer:</b> - <dd>A group and a dataset. - </dl> - - -</ol> -<h3>Section 9: Creating Groups Using Absolute and Relative Names</h3> -<ol> - -<li>Group names can be specified in two ways. What are these two types - of group names? - - <dl> - <dt><b>Answer:</b> - <dd>Relative and absolute. - </dl> - -<p> -<li>You have a dataset named <code>moo</code> in the group - <code>boo</code>, which is in the group <code>foo</code>, - which, in turn, is in the root group. - How would you specify an absolute name to access this dataset? - - <dl> - <dt><b>Answer:</b> - <dd><code>/foo/boo/moo</code> - </dl> - - -</ol> -<h3>Section 10: Creating Datasets in Groups</h3> -<ol> - -<li>Describe a way to access the dataset <code>moo</code> described in - the previous section (Section 9, question 2) using a - relative name. - Describe a way to access the same dataset using an absolute name. - - <dl> - <dt><b>Answers:</b> - <ol> - <li>Access the group <code>/foo</code> and get the group ID. - Access the group <code>boo</code> using the group ID obtained - in Step 1. - Access the dataset <code>moo</code> using the group ID obtained - in Step 2. - <pre> -gid = H5Gopen (file_id, "/foo", 0); /* absolute path */ -gid1 = H5Gopen (gid, "boo", 0); /* relative path */ -did = H5Dopen (gid1, "moo"); /* relative path */ </pre> - - <li>Access the group <code>/foo</code> and get the group ID. - Access the dataset <code>boo/moo</code> with the group ID - just obtained. - <pre> -gid = H5Gopen (file_id, "/foo", 0); /* absolute path */ -did = H5Dopen (gid, "boo/moo"); /* relative path */ </pre> - - <li>Access the dataset with an absolute path. - <pre> -did = H5Dopen (file_id, "/foo/boo/moo"); /* absolute path */ </pre> - </ol> - </dl> - -</ol> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/api.html b/doc/html/Tutor/api.html deleted file mode 100644 index a365e67..0000000 --- a/doc/html/Tutor/api.html +++ /dev/null @@ -1,151 +0,0 @@ -<HTML><HEAD> -<TITLE>The HDF5 API -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">The HDF5 API</FONT> -</BIG></BIG></BIG></H1> - - -<hr noshade size=1> - -<BODY> -<P> -The HDF5 library provides several interfaces, or APIs. -These APIs provide routines for creating, accessing, and manipulating -HDF5 files and objects. -<P> -The library itself is implemented in C. To facilitate the work of -FORTRAN90 and Java programmers, HDF5 function wrappers have been developed -in each of these languages. -At the time of this writing, a set of C++ wrappers is in development. -This tutorial discusses the use of the C functions and the FORTRAN wrappers. -<P> -All C routines in the HDF5 library begin with a prefix of the form <I>H5</I>*, -where * is one or two uppercase letters indicating the type of object on which the -function operates. -The FORTRAN wrappers come in the form of subroutines that begin with -<I>h5</I> and end with <I>_f</I>. The APIs are listed below: -<P> -<table width="65%" border="2" cellpadding="4"> - <tr bgcolor="#FFCC99" bordercolor="#FFFFFF"> - <td width="11%"> - <div align="center"><b>API </b></div> - </td> - <td width="89%"> - <div align="left"><b>DESCRIPTION</b> </div> - </td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5</b></div> - </td> - <td width="89%">Library Functions: general-purpose H5 functions</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5A</b></div> - </td> - <td width="89%">Annotation Interface: attribute access and manipulation - routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5D</b></div> - </td> - <td width="89%">Dataset Interface: dataset access and manipulation - routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5E</b></div> - </td> - <td width="89%">Error Interface: error handling routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5F</b></div> - </td> - <td width="89%">File Interface: file access routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5G</b></div> - </td> - <td width="89%">Group Interface: group creation and operation routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5I</b></div> - </td> - <td width="89%">Identifier Interface: identifier routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5P</b></div> - </td> - <td width="89%">Property List Interface: object property list manipulation - routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5R</b></div> - </td> - <td width="89%">Reference Interface: reference routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5S</b></div> - </td> - <td width="89%">Dataspace Interface: dataspace definition and access - routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5T</b></div> - </td> - <td width="89%">Datatype Interface: datatype creation and manipulation - routines</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td width="11%" bgcolor="#99CCCC"> - <div align="center"><b>H5Z</b></div> - </td> - <td width="89%">Compression Interface: compression routine(s)</td> - </tr> -</table> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/bighdf2sp.JPG b/doc/html/Tutor/bighdf2sp.JPG Binary files differdeleted file mode 100644 index aad590e..0000000 --- a/doc/html/Tutor/bighdf2sp.JPG +++ /dev/null diff --git a/doc/html/Tutor/compound.html b/doc/html/Tutor/compound.html deleted file mode 100644 index 93df933..0000000 --- a/doc/html/Tutor/compound.html +++ /dev/null @@ -1,234 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Compound Datatypes -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Compound Datatypes</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#def">Creating Compound Datatypes</A> - <LI>Programming Example -<UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> -</UL> -</UL> -<HR> -<A NAME="def"> -<H2>Creating Compound Datatypes</H2> -A compound datatype is similar to a struct in C or a common block in -FORTRAN. It is a collection of one or more atomic types or small arrays of -such types. To create and use a compound datatype you need to be familiar -with various properties of the compound datatype: -<UL> - <LI>It is of class <strong>compound</strong>. - <LI>It has a fixed total size, in bytes. - <LI>It consists of zero or more members (defined in any order) with - unique names and occupying non-overlapping regions within the datum. - <LI>Each member has its own datatype. - <LI>Each member is referenced by an index number between zero and <em>N</em>-1, - where <em>N</em> is the number of members in the compound datatype. - <LI>Each member has a name which is unique among its siblings in a - compound datatype. - <LI>Each member has a fixed byte offset, which locates the first byte - (smallest byte address) of that member in the compound datatype. - <LI>Each member can be a small array of up to four dimensions. -</UL> -Properties of members of a compound datatype are defined when the -member is added to the compound datatype and cannot be subsequently modified. -<P> -Compound datatypes must be built out of other datatypes. First, one -creates an empty compound datatype and specifies its total size. Then -members are added to the compound datatype in any order. - -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> - -This example shows how to create a compound datatype, write an array -to the file which uses the compound datatype, and read back subsets of -the members. -<p> -<UL> -[ <A HREF="examples/h5_compound.c">C Example</A> ] - <code>h5_compound.c</code> -<BR> -[ <A HREF="examples/compound.f90">Fortran 90 Example</A> ] -- <code>compound.f90</code> -<BR> -[ <A HREF="examples/java/Compound.java">Java Example</A> ] - <code>Compound.java</code> -</UL> -The program outputs the following: -<PRE> - -Field c : -1.0000 0.5000 0.3333 0.2500 0.2000 0.1667 0.1429 0.1250 0.1111 0.1000 - -Field a : -0 1 2 3 4 5 6 7 8 9 - -Field b : -0.0000 1.0000 4.0000 9.0000 16.0000 25.0000 36.0000 49.0000 64.0000 81.0000 - -+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -</PRE> - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><CODE>H5Tcreate</CODE> creates a new datatype of the specified class with -the specified number of bytes. -<PRE> - hid_t H5Tcreate ( H5T_class_t class, size_t size ) -</PRE> -<UL> -<LI>The <I>class</I> parameter specifies the datatype to create. -Currently only the <CODE>H5T_COMPOUND</CODE> datatype class is supported with this -function. -<LI>The <I>size</I> parameter specifies the number of bytes in the -datatype to create. -</UL> -<P> -<LI><CODE>H5Tinsert</CODE> adds a member to the compound datatype specified by -<I>type_id</I>. -<PRE> - herr_t H5Tinsert ( hid_t type_id, const char * name, off_t offset, - hid_t field_id ) -</PRE> -<UL> -<LI>The <I>type_id</I> parameter is the identifier of the compound datatype -to modify. -<LI>The <I>name</I> parameter is the name of the field to insert. The new -member name must be unique within a compound datatype. -<LI>The <I>offset</I> parameter is the offset in the memory structure of -the field to insert. - -The library defines the <CODE>HOFFSET</CODE> macro to compute the offset of a member within -a struct: -<PRE> - HOFFSET ( s, m ) -</PRE> -This macro computes the offset of member <I>m</I> within a struct -variable <I>s</I>. - -<LI>The <I>field_id</I> parameter is the datatype identifier of the -field to insert. -</UL> -<P> -<LI><CODE>H5Tclose</CODE> releases a datatype. -<PRE> - herr_t H5Tclose ( hid_t type_id ) -</PRE> -The <I>type_id</I> parameter is the identifier of the datatype to release. -</UL> -<A NAME="fc"> -<H3><U>File Contents</U></H3> - -<PRE> -HDF5 "SDScompound.h5" { -GROUP "/" { - DATASET "ArrayOfStructures" { - DATATYPE { - H5T_STD_I32BE "a_name"; - H5T_IEEE_F32BE "b_name"; - H5T_IEEE_F64BE "c_name"; - } - DATASPACE { SIMPLE ( 10 ) / ( 10 ) } - DATA { - { - [ 0 ], - [ 0 ], - [ 1 ] - }, - { - [ 1 ], - [ 1 ], - [ 0.5 ] - }, - { - [ 2 ], - [ 4 ], - [ 0.333333 ] - }, - { - [ 3 ], - [ 9 ], - [ 0.25 ] - }, - { - [ 4 ], - [ 16 ], - [ 0.2 ] - }, - { - [ 5 ], - [ 25 ], - [ 0.166667 ] - }, - { - [ 6 ], - [ 36 ], - [ 0.142857 ] - }, - { - [ 7 ], - [ 49 ], - [ 0.125 ] - }, - { - [ 8 ], - [ 64 ], - [ 0.111111 ] - }, - { - [ 9 ], - [ 81 ], - [ 0.1 ] - } - } - } -} -} -</PRE> - - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/crtatt.html b/doc/html/Tutor/crtatt.html deleted file mode 100644 index 3a4d374..0000000 --- a/doc/html/Tutor/crtatt.html +++ /dev/null @@ -1,343 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating an Attribute -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating an Attribute</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">What is an Attribute</A>? - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - <LI> <A HREF="#ddl">Attribute Definition in DDL</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>What is an Attribute?</h2> -<P> -Attributes are small datasets that can be used to describe the nature and/or -the intended usage of the object they are attached to. In this section, we -show how to create, read, and write an attribute. -<P> -<P> -<H3>Creating an attribute</H3> -<P> - Creating an attribute is similar to creating a dataset. To create an - attribute, the application must specify the object which the attribute is - attached to, the datatype and dataspace of the attribute data, - and the attribute creation property list. -<P> - The steps to create an attribute are as follows: -<OL> - <LI> Obtain the object identifier that the attribute is to be attached to. - <LI> Define the characteristics of the attribute and specify the - attribute creation property list. - <UL> - <LI> Define the datatype. - <LI> Define the dataspace. - <LI> Specify the attribute creation property list. - </UL> - <LI> Create the attribute. - <LI> Close the attribute and datatype, dataspace, and - attribute creation property list, if necessary. -</OL> -<P> - To create and close an attribute, the calling program must use -<code>H5Acreate</code>/<code>h5acreate_f</code> and -<code>H5Aclose</code>/<code>h5aclose_f</code>. For example: -<P> -<I>C</I>: -<PRE> - attr_id = H5Acreate (dset_id, attr_name, type_id, space_id, creation_prp); - status = H5Aclose (attr_id); -</PRE> -<I>FORTRAN</I>: -<PRE> - CALL h5acreate_f (dset_id, attr_nam, type_id, space_id, attr_id, & - hdferr, creation_prp=creat_plist_id) - <i>or</i> - CALL h5acreate_f (dset_id, attr_nam, type_id, space_id, attr_id, hdferr) - - CALL h5aclose_f (attr_id, hdferr) -</PRE> - -<H3>Reading/Writing an attribute</H3> -<P> - Attributes may only be read or written as an entire object; no partial I/O is - supported. Therefore, to perform I/O operations on an attribute, the - application needs only to specify the attribute and the attribute's memory - datatype. -<P> - The steps to read or write an attribute are as follows. -<OL> - <LI> Obtain the attribute identifier. - <LI> Specify the attribute's memory datatype. - <LI> Perform the desired operation. - <LI> Close the memory datatype if necessary. -</OL> -<P> -To read and/or write an attribute, the calling program must contain the -<code>H5Aread</code>/<code>h5aread_f</code> and/or -<code>H5Awrite</code>/<code>h5awrite_f</code> routines. For example: -<P> -<I>C</I>: -<PRE> - status = H5Aread (attr_id, mem_type_id, buf); - status = H5Awrite (attr_id, mem_type_id, buf); -</PRE> -<I>FORTRAN</I>: -<PRE> - CALL h5awrite_f (attr_id, mem_type_id, buf, hdferr) - CALL h5aread_f (attr_id, mem_type_id, buf, hdferr) -</PRE> -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -This example shows how to create and write a dataset attribute. -It opens an existing file <code>dset.h5</code> in C -(<code>dsetf.h5</code> in FORTRAN), -obtains the identifier of the dataset <code>/dset</code>, -defines the attribute's dataspace, creates the dataset attribute, writes -the attribute, and then closes the attribute's dataspace, attribute, dataset, -and file. <BR> -<UL> -[ <A HREF="examples/h5_crtatt.c">C Example </A> ] - <code>h5_crtatt.c</code><BR> -[ <A HREF="examples/attrexample.f90">FORTRAN Example</A> ] - <code>attrexample.f90</code><BR> -[ <A HREF="examples/java/CreateAttribute.java">Java Example </A> ] -- <code>CreateAttribute.java</code><BR> -</UL> - -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><code>H5Acreate</code>/<code>h5acreate_f</code> creates an attribute - which is attached to the object specified by the first parameter, - and returns an identifier. -<P> -<I>C</I>: -<PRE> - hid_t H5Acreate (hid_t obj_id, const char *name, hid_t type_id, - hid_t space_id, hid_t creation_prp) -</PRE> -<I>FORTRAN</I>: -<PRE> - h5acreate_f (obj_id, name, type_id, space_id, attr_id, & - hdferr, creation_prp) - - obj_id INTEGER(HID_T) - name CHARACTER(LEN=*) - type_id INTEGER(HID_T) - space_id INTEGER(HID_T) - attr_id INTEGER(HID_T) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - creation_prp INTEGER(HID_T), OPTIONAL - -</PRE> -<UL> - <LI> The <I>obj_id</I> parameter is the identifier of the object that - the attribute is attached to. - <P> - <LI> The <I>name</I> parameter is the name of the attribute to create. -<P> - <LI> The <I>type_id</I> parameter is the identifier of the - attribute's datatype. -<P> - <LI> The <I>space_id</I> parameter is the identifier of the attribute's - dataspace. -<P> - <LI> The <I>creation_prp</I> parameter is the creation property list - identifier. - <code>H5P_DEFAULT</code> in C (<code>H5P_DEFAULT_F</code> in FORTRAN) - specifies the default creation property list. - This parameter is optional in FORTRAN; when it is omitted, - the default creation property list is used. -<P> - <LI> In FORTRAN, the return code for this call is returned in <I>hdferr</I>: - 0 if successful, -1 if not. The attribute identifier is returned - in <I>attr_id</I>. In C, the function returns the - attribute identifier if successful and a negative value if not. - - -</UL> -<P> -<LI><code>H5Awrite</code>/<code>h5awrite_f</code> writes the entire attribute, - and returns the status of the write. -<P> -<I>C</I>: -<PRE> - herr_t H5Awrite (hid_t attr_id, hid_t mem_type_id, void *buf) -</PRE> -<I>FORTRAN</I>: -<PRE> - h5awrite_f (attr_id, mem_type_id, buf, hdferr) - - attr_id INTEGER(HID_T) - memtype_id INTEGER(HID_T) - buf TYPE(VOID) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - -</PRE> -<UL> - <LI> The <I>attr_id</I> parameter is the identifier of the attribute - to write. -<P> - <LI> The <I>mem_type_id</I> parameter is the identifier of the - attribute's memory datatype. -<P> - <LI> The <I>buf</I> parameter is the data buffer to write out. -<P> - <LI>In C, this function returns a non-negative value if successful and - a negative value, otherwise. In FORTRAN, the return value is in the - <I>hdferr</I> parameter: 0 if successful, -1 otherwise. -</UL> -<P> -<LI> When an attribute is no longer accessed by a program, - <code>H5Aclose</code>/<code>h5aclose_f</code> must be called - to release the attribute from use. - The C routine returns a non-negative value if successful; - otherwise it returns a negative value. - In FORTRAN, the return value is in the <I>hdferr</I> parameter: - 0 if successful, -1 otherwise. -<P> -<I>C</I>: -<pre> - herr_t H5Aclose (hid_t attr_id) -</pre> - -<I>FORTRAN</I>: -<pre> - h5aclose_f (attr_id, hdferr) - - attr_id INTEGER(HID_T) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - -</pre> - <ul> - <li> An <code>H5Aclose</code>/<code>h5aclose_f</code> call is mandatory. - </ul> -</UL> - - - -<A NAME="fc"> -<H3><U>File Contents</U></H3> -<P> -The contents of <code>dset.h5</code> (<code>dsetf.h5</code> for FORTRAN) and the -attribute definition are shown below: -<P> -<B>Fig. 7.1a</B> <I><code>dset.h5</code> in DDL</I> - -<PRE> -HDF5 "dset.h5" { -GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 4, 6 ) / ( 4, 6 ) } - DATA { - 1, 2, 3, 4, 5, 6, - 7, 8, 9, 10, 11, 12, - 13, 14, 15, 16, 17, 18, - 19, 20, 21, 22, 23, 24 - } - ATTRIBUTE "attr" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 2 ) / ( 2 ) } - DATA { - 100, 200 - } - } - } -} -} -</PRE> -<B>Fig. 7.1b</B> <I><code>dsetf.h5</code> in DDL</I> -<PRE> -HDF5 "dsetf.h5" { -GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 6, 4 ) / ( 6, 4 ) } - DATA { - 1, 7, 13, 19, - 2, 8, 14, 20, - 3, 9, 15, 21, - 4, 10, 16, 22, - 5, 11, 17, 23, - 6, 12, 18, 24 - } - ATTRIBUTE "attr" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 2 ) / ( 2 ) } - DATA { - 100, 200 - } - } - } -} -} -</PRE> - - - -<A NAME="ddl"> -<h3><U>Attribute Definition in DDL</U></H3> -<B>Fig. 7.2</B> <I>HDF5 Attribute Definition</I> -<PRE> - - <attribute> ::= ATTRIBUTE "<attr_name>" { <datatype> - <dataspace> - <data> } - -</PRE> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/crtdat.html b/doc/html/Tutor/crtdat.html deleted file mode 100644 index aafb8ea..0000000 --- a/doc/html/Tutor/crtdat.html +++ /dev/null @@ -1,497 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating a Dataset -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating a Dataset</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">What is a Dataset</A>? - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - <LI> <A HREF="#ddl">Dataset Definition in DDL</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>What is a Dataset?</h2> -<P> -A dataset is a multidimensional array of data elements, together with -supporting metadata. To create a dataset, the application program must specify -the location at which to create the dataset, the dataset name, the datatype -and dataspace of the data array, and the dataset creation property list. -<P> - <H3> Datatypes</H3> - A datatype is a collection of datatype properties, all of which can - be stored on disk, and which when taken as a whole, provide complete - information for data conversion to or from that datatype. -<P> - There are two categories of datatypes in HDF5: atomic and compound - datatypes. An <i>atomic datatype</i> is a datatype which cannot be - decomposed into smaller datatype units at the API level. - These include the integer, float, date and time, string, bitfield, and - opaque datatypes. - A <i>compound datatype</i> is a collection of one or more - atomic datatypes and/or small arrays of such datatypes. -<P> - Figure 5.1 shows the HDF5 datatypes. Some of the HDF5 predefined - atomic datatypes are listed in Figures 5.2a and 5.2b. - In this tutorial, we consider only HDF5 predefined integers. - For further information on datatypes, see - <a href="../Datatypes.html">The Datatype Interface (H5T)</a> in the - <cite>HDF5 User's Guide</cite>. -<P> - <B>Fig 5.1</B> <I>HDF5 datatypes</I> -<PRE> - - +-- integer - +-- floating point - +---- atomic ----+-- date and time - | +-- character string - HDF5 datatypes --| +-- bitfield - | +-- opaque - | - +---- compound - -</PRE> - -<table width="100%" border="0" cellpadding="4"> -<tr><td valign=top> - - <B>Fig. 5.2a</B> <I>Examples of HDF5 predefined datatypes</I> - -<table width="95%" border="1" cellpadding="0"> - <tr bgcolor="#ffcc99" bordercolor="#FFFFFF"> - <td width="20%"><b>Datatype</b></td> - <td width="80%"><b>Description</b></td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_STD_I32LE</code></td> - <td width="80%">Four-byte, little-endian, signed, two's complement integer</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_STD_U16BE</code></td> - <td width="80%">Two-byte, big-endian, unsigned integer</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_IEEE_F32BE</code></td> - <td width="80%">Four-byte, big-endian, IEEE floating point</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_IEEE_F64LE</code></td> - <td width="80%">Eight-byte, little-endian, IEEE floating point</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_C_S1</code></td> - <td width="80%">One-byte, null-terminated string of eight-bit characters</td> - </tr> -</table> - -</td><td valign=top> - - <B>Fig. 5.2b</B> <I>Examples of HDF5 predefined native datatypes</I> -<table width="95%" border="1" cellpadding="4"> - <tr bgcolor="#ffcc99" bordercolor="#FFFFFF"> - <td width="20%"><b>Native Datatype</b></td> - <td width="80%"><b>Corresponding C or FORTRAN Type</b></td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><B>C:</B></td> - <td width="80%"> </td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_INT</code></td> - <td width="80%">int</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_FLOAT</code></td> - <td width="80%">float</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_CHAR</code></td> - <td width="80%">char</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_DOUBLE</code></td> - <td width="80%">double</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_LDOUBLE</code></td> - <td width="80%">long double</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><B>FORTRAN:</B></td> - <td width="80%"> </td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_INT</code></td> - <td width="80%">integer</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_REAL</code></td> - <td width="80%">real</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_DOUBLE</code></td> - <td width="80%">double precision</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" width="20%"><code>H5T_NATIVE_CHAR</code></td> - <td width="80%">character</td> - </tr> -</table> - -</table> - - <H3> Datasets and Dataspaces</H3> - - A dataspace describes the dimensionality of the data array. A dataspace - is either a regular N-dimensional array of data points, called a simple - dataspace, or a more general collection of data points organized in - another manner, called a complex dataspace. Figure 5.3 shows HDF5 dataspaces. - In this tutorial, we only consider simple dataspaces. -<P> - <B>Fig 5.3</B> <I>HDF5 dataspaces</I> -<PRE> - - +-- simple - HDF5 dataspaces --| - +-- complex - -</PRE> - The dimensions of a dataset can be fixed (unchanging), or they may be - unlimited, which means that they are extensible. A dataspace can also - describe a portion of a dataset, making it possible to do partial I/O - operations on selections. - - <h3>Dataset Creation Property Lists</H3> - - When creating a dataset, HDF5 allows the user to specify how raw data is - organized and/or compressed on disk. This information is - stored in a dataset creation property list and passed to the dataset - interface. The raw data on disk can be stored contiguously (in the same - linear way that it is organized in memory), partitioned into chunks, - stored externally, etc. In this tutorial, we use the - default dataset creation property list; that is, contiguous storage layout - and no compression are used. For more information about - dataset creation property lists, - see <a href="../Datasets.html">The Dataset Interface (H5D)</a> - in the <cite>HDF5 User's Guide</cite>. - -<P> -In HDF5, datatypes and dataspaces are independent objects which are created -separately from any dataset that they might be attached to. Because of this, -the creation of a dataset requires definition of the datatype and dataspace. -In this tutorial, we use HDF5 predefined datatypes (integer) and consider -only simple dataspaces. Hence, only the creation of dataspace objects is -needed. -<P> - -To create an empty dataset (no data written) the following steps need to be -taken: -<OL> -<LI> Obtain the location identifier where the dataset is to be created. -<LI> Define the dataset characteristics and the dataset creation property list. - <UL> - <LI> Define a datatype. - <LI> Define a dataspace. - <LI> Specify the dataset creation property list. -</UL> -<LI> Create the dataset. -<LI> Close the datatype, the dataspace, and the property list if necessary. -<LI> Close the dataset. -</OL> -To create a simple dataspace, the calling program must contain a -call to create and close the dataspace. For example: -<P> -<I>C</I>: -<PRE> - space_id = H5Screate_simple (rank, dims, maxdims); - status = H5Sclose (space_id ); -</PRE> -<I>FORTRAN</I>: -<PRE> - CALL h5screate_simple_f (rank, dims, space_id, hdferr, maxdims=max_dims) - <i>or</i> - CALL h5screate_simple_f (rank, dims, space_id, hdferr) - - CALL h5sclose_f (space_id, hdferr) -</PRE> - -To create a dataset, the calling program must contain calls to create -and close the dataset. For example: -<P> -<I>C</I>: -<PRE> - dset_id = H5Dcreate (hid_t loc_id, const char *name, hid_t type_id, - hid_t space_id, hid_t creation_prp); - status = H5Dclose (dset_id); -</PRE> -<I>FORTRAN</I>: -<PRE> - CALL h5dcreate_f (loc_id, name, type_id, space_id, dset_id, & - hdferr, creation_prp=creat_plist_id) - <i>or</i> - CALL h5dcreate_f (loc_id, name, type_id, space_id, dset_id, hdferr) - - CALL h5dclose_f (dset_id, hdferr) -</PRE> -If using the pre-defined datatypes in FORTRAN, then a call must -be made to initialize and terminate access to the pre-defined datatypes: -<PRE> - CALL h5init_types_f (hdferr) - CALL h5close_types_f (hdferr) -</PRE> -<code>h5init_types_f</code> must be called before any HDF5 library -subroutine calls are made; -<code>h5close_types_f</code> must be called after the final HDF5 library -subroutine call. -See the programming example below for an illustration of the use of -these calls. - -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The following example shows how to create an empty dataset. -It creates a file called <code>dset.h5</code> in the C version -(<code>dsetf.h5</code> in Fortran), defines the dataset dataspace, creates a -dataset which is a 4x6 integer array, and then closes the dataspace, -the dataset, and the file. <BR> -<UL> -[ <A HREF="examples/h5_crtdat.c">C Example</A> ] - -- <code>h5_crtdat.c</code><BR> -[ <A HREF="examples/dsetexample.f90">Fortran Example</A> ] - -- <code>dsetexample.f90</code><BR> -[ <A HREF="examples/java/CreateDataset.java">Java Example</A> ] - -- <code>CreateDataset.java</code> -</UL> - -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page of this tutorial. - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><code>H5Screate_simple</code>/<code>h5screate_simple_f</code> -creates a new simple dataspace and returns a dataspace identifier. -<PRE> -<I>C</I>: - hid_t H5Screate_simple (int rank, const hsize_t * dims, - const hsize_t * maxdims) -<I>FORTRAN</I>: - h5screate_simple_f (rank, dims, space_id, hdferr, maxdims) - - rank INTEGER - dims(*) INTEGER(HSIZE_T) - space_id INTEGER(HID_T) - hdferr INTEGER - (Valid values: 0 on success and -1 on failure) - maxdims(*) INTEGER(HSIZE_T), OPTIONAL -</PRE> -<UL> - <LI> The <I>rank</I> parameter specifies the rank, i.e., the number of - dimensions, of the dataset. - - <LI> The <I>dims</I> parameter specifies the size of the dataset. - - <LI>The <I>maxdims</I> parameter specifies the upper limit on the - size of the dataset. - If this parameter is NULL in C (or not specified in FORTRAN), - then the upper limit is the same as the dimension - sizes specified by the <I>dims</I> parameter. - <LI>The function returns the dataspace identifier in C if successful; - otherwise it returns a negative value. - In FORTRAN, the dataspace identifier - is returned in the <I>space_id</I> parameter. If the call is successul - then a 0 is returned in <I>hdferr</I>; otherwise a -1 is returned. -</UL> -<P> -<LI><code>H5Dcreate</code>/<code>h5dcreate_f</code> creates a dataset -at the specified location and returns a dataset identifier. -<PRE> -<I>C</I>: - hid_t H5Dcreate (hid_t loc_id, const char *name, hid_t type_id, - hid_t space_id, hid_t creation_prp) -<I>FORTRAN</I>: - h5dcreate_f (loc_id, name, type_id, space_id, dset_id, & - hdferr, creation_prp) - - loc_id INTEGER(HID_T) - name CHARACTER(LEN=*) - type_id INTEGER(HID_T) - space_id INTEGER(HID_T) - dset_id INTEGER(HID_T) - hdferr INTEGER - (Valid values: 0 on success and -1 on failure) - creation_prp INTEGER(HID_T), OPTIONAL -</PRE> -<UL> - <LI> The <I>loc_id</I> parameter is the location identifier. -<P> - <LI> The <I>name</I> parameter is the name of the dataset to create. - -<P> - <LI> The <I>type_id</I> parameter specifies the datatype identifier. - -<P> - <LI> The <I>space_id</I> parameter is the dataspace identifier. - -<P> - <LI> The <I>creation_prp</I> parameter specifies the - dataset creation property list. - <code>H5P_DEFAULT</code> in C and <code>H5P_DEFAULT_F</code> in FORTRAN - specify the default dataset creation property list. - This parameter is optional in FORTRAN; if it is omitted, - the default dataset creation property list will be used. -<P> - <LI> The C function returns the dataset identifier if successful and - a negative value otherwise. The FORTRAN call returns the - dataset identifier in <I>dset_id</I>. If it is successful, then 0 is - returned in <I>hdferr</I>; otherwise a -1 is returned. - -</UL> -<P> -<LI><code>H5Dcreate</code>/<code>h5dcreate_f</code> creates an empty array -and initializes the data to 0. -<P> -<LI> When a dataset is no longer accessed by a program, -<code>H5Dclose</code>/<code>h5dclose_f</code> must be called to release -the resource used by the dataset. This call is mandatory. -<PRE> -<I>C</I>: - hid_t H5Dclose (hid_t dset_id) -<I>FORTRAN</I>: - h5dclose_f (dset_id, hdferr) - - dset_id INTEGER(HID_T) - hdferr INTEGER - (Valid values: 0 on success and -1 on failure) -</PRE> -</UL> - -<A NAME="fc"> -<H3><U>File Contents</U></H3> -The contents of the file <code>dset.h5</code> (<code>dsetf.h5</code> -for FORTRAN) are shown in <B>Figure 5.4</B> and <B>Figures 5.5a </B> -and <B>5.5b</B>. -<P> -<table border="0"> -<tr align=left><td> -<B>Figure 5.4</B> <I>Contents of <code>dset.h5</code> ( <code>dsetf.h5</code>)</i> -</td></tr><tr align=center><td> -<IMG src="img002.gif"> </PRE> -</td></tr></table> - -<table width="100%" border="1" cellspacing="4" bordercolor="#FFFFFF"> - <tr bordercolor="#FFFFFF"> - <td width="50%"><b>Figure 5.5a</b> <i><code>dset.h5</code> in DDL</i> </td> - <td width="50%"><b>Figure 5.5b</b> <i><code>dsetf.h5</code> in DDL</i> </td> - </tr> - <tr bordercolor="#000000"> - <td width="35%"> - <PRE> -HDF5 "dset.h5" { -GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 4, 6 ) / ( 4, 6 ) } - DATA { - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0 - } - } -} -} -</PRE> - </td> - <td width="35%"> - <pre> -HDF5 "dsetf.h5" { -GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 6, 4 ) / ( 6, 4 ) } - DATA { - 0, 0, 0, 0, - 0, 0, 0, 0, - 0, 0, 0, 0, - 0, 0, 0, 0, - 0, 0, 0, 0, - 0, 0, 0, 0 - } - } -} -} -</pre> - </td> - </tr> -</table> - -<p> -Note in Figures 5.5a and 5.5b that -<code>H5T_STD_I32BE</code>, a 32-bit Big Endian integer, -is an HDF atomic datatype. - - -<A NAME="ddl"> -<h3><U>Dataset Definition in DDL</U></H3> -The following is the simplified DDL dataset definition: -<P> - <B>Fig. 5.6</B> <I>HDF5 Dataset Definition</I> -<PRE> - <dataset> ::= DATASET "<dataset_name>" { <datatype> - <dataspace> - <data> - <dataset_attribute>* } - - <datatype> ::= DATATYPE { <atomic_type> } - - <dataspace> ::= DATASPACE { SIMPLE <current_dims> / <max_dims> } - - <dataset_attribute> ::= <attribute> -</PRE> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@@ncsa.uiuc.edu"> -hdfhelp@@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - diff --git a/doc/html/Tutor/crtfile.html b/doc/html/Tutor/crtfile.html deleted file mode 100644 index fc235c4..0000000 --- a/doc/html/Tutor/crtfile.html +++ /dev/null @@ -1,317 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating an HDF5 File -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating an HDF5 File</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">What is an HDF5 file</A>? - <LI>Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - <LI> <A HREF="#ddl">File Definition in DDL</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>What is an HDF5 file?</h2> -<P> -An HDF5 file is a binary file containing scientific data and supporting -metadata. The primary types of objects stored in an HDF5 file, groups and -datasets, will be discussed in other sections of this tutorial. -<P> -To create a file, an application must specify a filename, file -access mode, file creation property list, and file access property list. -<P> -<UL> - <LI><B> File access mode:</B><BR> - When creating a file, the file access mode specifies the action to - take if the file already exists: - <UL> - <LI><code>H5F_ACC_TRUNC</code> specifies that if the file already exists, - the current contents will be deleted so that the application can rewrite - the file with new data. - <LI><code>H5F_ACC_EXCL</code> specifies that the open is to fail if - the file already exists. - <LI>If the file does not already exist, the file access parameter is - ignored. - <LI>In all cases, the application has both read and write access to - a successfully created file. - </UL> -<P> - Note that there are two different access modes for opening exisitng files: - <UL> - <LI><code>H5F_ACC_RDONLY</code> specifies that the application has - read access but will not be allowed to write any data. - <LI><code>H5F_ACC_RDWR</code> specifies that the application has - read and write access. - </UL> -<P> - For further information, see - <a href="../Files.html">The File Interface (H5F)</a> section of the - <cite>HDF5 User's Guide</cite> and - the <a href="../RM_H5F.html#File-Create">H5F: File Interface</a> - section of the <cite>HDF5 Reference Manual</cite>. -<P> - <LI><B> File creation property list:</B><BR> - The file creation property list is used to control the file metadata. - File metadata contains information about the size of the user-block, the - size of various file data structures used by the HDF5 library, etc. - In this tutorial, the default file creation property list, - <code>H5P_DEFAULT</code>, is used. -<P> - The user-block is a fixed-length block of data located at the beginning - of the file which is ignored by the HDF5 library. - The user-block may be used to store - any data or information found to be useful to applications. -<P> - For further information, see - <a href="../Files.html">The File Interface (H5F)</a> section of the - <cite>HDF5 User's Guide</cite>. -<P> - <LI><B> File access property list:</B><BR> - The file access property list is used to control different methods of - performing I/O on files. - The default file access property list, <code>H5P_DEFAULT</code>, - is used in this tutorial. -<P> - For further information, see - <a href="../Files.html">The File Interface (H5F)</a> section of the - <cite>HDF5 User's Guide</cite>. -</UL> -<P> -The steps to create and close an HDF5 file are as follows: -<OL> - <LI> Specify the file creation and access property lists, if necessary. - <LI> Create the file. - <LI> Close the file and close the property lists, if necessary. -</OL> -To create an HDF5 file, the calling program must contain calls to -create and close the file. For example: -<P> -<I>C</I>:<PRE> - file_id = H5Fcreate (filename, access_mode, create_id, access_id); - status = H5Fclose (file_id); -</PRE> -<I>FORTRAN</I>:<PRE> - CALL h5fcreate_f (filename, access_mode, file_id, hdferr, & - creation_prp=create_id, access_prp=access_id) - <i>or</i> - CALL h5fcreate_f (filename, access_mode, file_id, hdferr) - - CALL h5fclose_f (file_id, hdferr) -</PRE> -In FORTRAN, the file creation property list, <code>creation_prp</code>, -and file access property list, <code>access_prp</code>, -are optional parameters; -they can be omitted if the default values are to be used. -<P> -<H2>Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The following example demonstrates how to create and close an HDF5 file. -It creates a file called <code>file.h5</code> in the C version, -<code>filef.h5</code> in FORTRAN, and then closes the file.<P> - -<UL> -[ <A HREF="examples/h5_crtfile.c" target="ExternalWin">C Example</A> ] - -- <code>h5_crtfile.c</code> <BR> -[ <A HREF="examples/fileexample.f90" target="ExternalWin">FORTRAN Example</A> ] - -- <code>fileexample.f90</code><BR> -[ <A HREF="examples/java/CreateFile.java" target="ExternalWin">Java Example</A> ] -- <code>CreateFile.java</code> -</UL> -<P> -<B>NOTE:</B> To download a tar file of all of the examples, including -a Makefile, please go to the <A HREF="references.html">References</A> page. - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><B>In C:</B> - The include file <code>hdf5.h</code> contains definitions and declarations - and must be included in any program that uses the HDF5 library. - <BR><B>In FORTRAN:</B> - The module <code>HDF5</code> contains definitions and declarations - and must be used in any program that uses the HDF5 library. -<P> -<LI><code>H5Fcreate</code>/<code>h5fcreate_f</code> creates - an HDF5 file and returns the file identifier. -<PRE> -<I>C</I>: - hid_t H5Fcreate (const char *name, unsigned access_mode, hid_t creation_prp, - hid_t access_prp) -<I>FORTRAN</I>: - h5fcreate_f (name, access_mode, file_id, hdferr, creation_prp, access_prp) - - name CHARACTER(LEN=*) - access_flag INTEGER - (Valid values: H5F_ACC_RDWR_F, H5F_ACC_RDONLY_F, - H5F_ACC_TRUNC_F, H5F_ACC_EXCL_F, H5F_ACC_DEBUG_F) - file_id INTEGER(HID_T) - hdferr INTEGER - (Valid values: 0 on success and -1 on failure) - creation_prp INTEGER(HID_T), OPTIONAL - (Default value: H5P_DEFAULT_F) - access_prp INTEGER(HID_T), OPTIONAL - (Default value: H5P_DEFAULT_F) - -</PRE> -<UL> - <LI> The <I>name</I> parameter specifies the name of the file to be created. -<P> - <LI> The <I>access_mode</I> parameter specifies the file access mode. - <code>H5F_ACC_TRUNC</code> (<code>H5F_ACC_TRUNC_F</code> in FORTRAN) - will truncate a file if it already exists. -<P> - <LI> The <I>creation_prp</I> parameter - specifies the file creation property list. - For C, using <code>H5P_DEFAULT</code> indicates that the - default file creation property list is to be used. - This option is optional in FORTRAN; if it is omitted, the default file - creation property list, <code>H5P_DEFAULT_F</code>, is used. -<P> - <LI> The <I>access_prp</I> parameter - specifies the file access property list. - For C, using <code>H5P_DEFAULT</code> indicates that the - default file creation property list is to be used. - This option is optional in FORTRAN; if it is omitted, the default file - creation property list, <code>H5P_DEFAULT_F</code>, is used. -<P> - <LI> In C, this function returns the file identifier if successful and - a negative value otherwise. - In FORTRAN, the file identifier is returned in the - <I>file_id</I> parameter. If the call is successful, 0 (zero) is - passed back in the <I>hdferr</I> parameter. Otherwise, <I>hdferr</I> - will have a value of -1. - -</UL> -<P> -<LI> When a file is no longer accessed by a program, - <code>H5Fclose</code>/<code>h5fclose_f</code> - must be called to release the resources used by the file. This call - is mandatory. -<PRE> -<I>C</I>: - herr_t H5Fclose (hid_t file_id) - -<I>FORTRAN</I>: - h5fclose_f(file_id, hdferr) -</PRE> -<P> -<LI>The root group is automatically created when a file is created. - Every file has a root group and the path name of the root group is - always <code>/</code>. -</UL> -<A NAME="fc"> -<H3><U>File Contents</U></H3> -The HDF team has developed tools for examining the contents of HDF5 files. -The tool used in this tutorial is the HDF5 dumper, <code>h5dump</code>, -which displays the file contents in human-readable form. -The output of <code>h5dump</code> is an ASCII display formatted according -to the HDF5 DDL grammar. -This grammar is defined, using Backus-Naur Form, in the -<a href="../ddl.html">DDL in BNF for HDF5</a>. -<p> -To view the file contents, type: -<PRE> - <B>h5dump <filename></B> -</PRE> - -Figure 4.1 describes the file contents of <code>file.h5</code> (<code>filef.h5</code>) -using a directed graph. -The directed graphs in this tutorial use an oval to represent an HDF5 group -and a rectangle to represent an HDF5 dataset (none in this example). -Arrows indicate the inclusion direction of the contents (none in this example). - -<P> -<B>Fig. 4.1</B> <I>Contents of <code>file.h5</code> (<code>filef.h5</code>)</I> -<PRE> -<!-- -<IMG src="fileh5.jpg" width="205" height="208"></PRE> --> -<IMG src="img001.gif"></PRE> - -Figure 4.2 is the text description of <code>file.h5</code>, as generated by -<code>h5dump</code>. The HDF5 file called <code>file.h5</code> contains -a group called <code>/</code>, or the <I>root group</I>. -(The file called <code>filef.h5</code>, -created by the FORTRAN version of the example, has the same output except -that the filename shown is <code>filef.h5</code>.) -<P> -<B> Fig. 4.2</B> <I><code>file.h5</code> in DDL</I> -<PRE> - - HDF5 "file.h5" { - GROUP "/" { - } - } - -</PRE> -<A NAME="ddl"> - -<h3><U>File Definition in DDL</U></H3> - -Figure 4.3 is the simplified DDL file definition for creating an HDF5 file. -For simplicity, a simplified DDL is used in this tutorial. A complete and -more rigorous DDL can be found in the -<a href="../ddl.html">DDL in BNF for HDF5</a>, a section of the -<cite>HDF5 User's Guide</cite>. -<P> -<B> Fig. 4.3</B> <I>HDF5 File Definition</I> -<P> - The following symbol definitions are used in the DDL: -<PRE> - - ::= defined as - <tname> a token with the name <I>tname</I> - <a> | <b> one of <a> or <b> - <a>* zero or more occurrences of <a> -</PRE> - The simplified DDL for file definition is as follows: -<PRE> - <file> ::= HDF5 "<file_name>" { <root_group> } - - <root_group> ::= GROUP "/" { <group_attribute>* <group_member>* } - - <group_attribute> ::= <attribute> - - <group_member> ::= <group> | <dataset> -</PRE> -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> - -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> diff --git a/doc/html/Tutor/crtgrp.html b/doc/html/Tutor/crtgrp.html deleted file mode 100644 index 028553d..0000000 --- a/doc/html/Tutor/crtgrp.html +++ /dev/null @@ -1,202 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating a Group -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating a Group</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">What is a Group</A>? - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>What is a Group?</h2> -<P> -An HDF5 group is a structure containing zero or more HDF5 objects. The two -primary HDF5 objects are groups and datasets. To create a group, the calling -program must: -<OL> - <LI> Obtain the location identifier where the group is to be created. - <LI> Create the group. - <LI> Close the group. -</OL> -To create a group, the calling program must call -<code>H5Gcreate</code>/<code>h5gcreate_f</code>. -To close the group, <code>H5Gclose</code>/<code>h5gclose_f</code> -must be called. For example: -<P> -<I>C:</I> -<PRE> - group_id = H5Gcreate (loc_id, name, size_hint); - status = H5Gclose (group_id); -</PRE> -<I>FORTRAN:</I> -<PRE> - CALL h5gcreate_f (loc_id, name, group_id, error, size_hint=size) - <i>or</i> - CALL h5gcreate_f (loc_id, name, group_id, error) - - - CALL h5gclose_f (group_id, error) -</PRE> - - -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The following example shows how to create and close a group. It creates a file -called <code>group.h5</code> (<code>groupf.h5</code> for FORTRAN), -creates a group called <code>MyGroup</code> in the root group, -and then closes the group and file. <BR> -<UL> -[ <A HREF="examples/h5_crtgrp.c">C Example</A> ] - - <code>h5_crtgrp.c</code><BR> -[ <A HREF="examples/groupexample.f90">FORTRAN Example</A> ] - - <code>groupexample.f90</code><BR> -[ <A HREF="examples/java/CreateGroup.java">Java Example</A> ] - - <code>CreateGroup.java</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - -</PRE> -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><code>H5Gcreate</code>/<code>h5gcreate_f</code> creates - a new empty group, named <code>MyGroup</code> and located in the - root group, and returns a group identifier. -<P> -<I>C:</I> -<PRE> - hid_t H5Gcreate (hid_t loc_id, const char *name, size_t size_hint) -</PRE> -<I>FORTRAN:</I> -<PRE> - h5gcreate_f (loc_id, name, group_id, hdferr, size_hint) - - loc_id INTEGER(HID_T) - name CHARACTER(LEN=*) - group_id INTEGER(HID_T) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - size_hint INTEGER(SIZE_T), OPTIONAL - (Default value: OBJECT_NAMELEN_DEFAULT_F) - -</PRE> -<UL> - <LI>The <I>loc_id</I> parameter specifies the location at which - to create the group. -<P> - <LI> The <I>name</I> parameter specifies the name of the group to be created. -<P> - <LI> The <I>size_hint</I> parameter specifies how much file space to - reserve to store the - names that will appear in the group. If a non-positive value is supplied, - then a default size is used. Passing a value of zero is usually adequate - since the library is able to dynamically resize the name heap. -<P> - <LI>In FORTRAN, the return value for the routine is passed in - <I>hdferr</I>: 0 if successful, -1 otherwise. The group identifier - is passed back in <I>group_id</I>. In C, the function returns a valid - group identifier if successful and a negative value otherwise. - -</UL> -<P> -<LI><code>H5Gclose</code>/<code>h5gclose_f</code> closes the group. - This call is mandatory. -<P> -<I>C:</I> -<PRE> - herr_t H5Gclose (hid_t group_id) -</PRE> -<I>FORTRAN:</I> -<PRE> - h5gclose_f (group_id, hdferr) - - group_id INTEGER(HID_T) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - -</PRE> -</UL> - -<A NAME="fc"> -<H3><U>File Contents</U></H3> -The contents of <code>group.h5</code> and the -definition of the group are shown below. (The FORTRAN program -creates the HDF5 file <code>groupf.h5</code> and the resulting DDL shows -<code>groupf.h5</code> in the first line.) -<P> -<table width="80%" border="1" bordercolor="#FFFFFF" cellpadding="6" cellspacing="6"> - <tr valign=top> - <td width="43%"><b>Fig. 8.1</b> <i>The Contents of <code>group.h5</code>.</i> - </td> - <td width="10%"> - </td> - <td width="47%"><b>Fig. 8.2</b> <i><code>group.h5</code> in DDL</i> </td> - </tr> - <tr bordercolor="#000000"> -<!-- <td width="47%"><IMG src="grouph5.jpg" width="205" height="333"></td> --> - <td align=center><IMG src="img003.gif"></td> - <td bordercolor="#FFFFFF"> </td> - <td valign="top"> - <pre> -HDF5 "group.h5" { -GROUP "/" { - GROUP "MyGroup" { - } -} -} -</pre> - </td> - </tr> -</table> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/crtgrpar.html b/doc/html/Tutor/crtgrpar.html deleted file mode 100644 index dfbf5ad..0000000 --- a/doc/html/Tutor/crtgrpar.html +++ /dev/null @@ -1,229 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating Groups using Absolute and Relative Names -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating Groups Using -Absolute and Relative Names</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">Absolute vs. Relative Names</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>Absolute vs. Relative Names</h2> -<P> -Recall that to create an HDF5 object, we have to specify the location where the -object is to be created. This location is determined by the identifier of an HDF5 -object and the name of the object to be created. The name of the created -object can be either an absolute name or a name relative to the specified -identifier. -In the previous example, we used the file identifier and the absolute name -<code>/MyGroup</code> to create a group. -<P> -In this section, we discuss HDF5 names and show how to use absolute and -relative names. - -<H3>Names</H3> - -HDF5 object names are a slash-separated list of components. There are few -restrictions on names: component names may be any length except zero and may -contain any character except slash (<code>/</code>) and the null terminator. -A full name -may be composed of any number of component names separated by slashes, with any -of the component names being the special name <code>.</code> (a dot or period). -A name which begins with a slash is an absolute name which is accessed -beginning with the root group of the file; -all other names are relative names and and the named object is -accessed beginning with the specified group. -Multiple consecutive slashes in a full name are treated as single slashes -and trailing slashes are not significant. A special case is the name <code>/</code> (or -equivalent) which refers to the root group. -<P> -Functions which operate on names generally take a location identifier, which -can be either a file identifier or a group identifier, and perform the lookup -with respect to that location. -Several possibilities are described in the following table: - -<center> -<table border="1" width=80% bordercolor="#000000" cellpadding="4"> - <tr bgcolor="#ffcc99" bordercolor="#FFFFFF"> - <td><b> Location Type </b></td> - <td><b>Object Name</b></td> - <td><b>Description</b></td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc" height="22">File identifier</td> - <td height="22" bgcolor="#CCCCCC"> - <div align="center"><code>/foo/bar</code></div> - </td> - <td height="22">The object <code>bar</code> in group <code>foo</code> - in the root group. </td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">Group identifier </td> - <td bgcolor="#CCCCCC"> - <div align="center"><code>/foo/bar</code></div> - </td> - <td>The object <code>bar</code> in group <code>foo</code> in the - root group of the file containing the specified group. - In other words, the group identifier's only purpose is to - specify a file. </td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">File identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center">/</div> - </td> - <td>The root group of the specified file.</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">Group identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center">/</div> - </td> - <td>The root group of the file containing the specified group.</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">Group identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center"><code>foo/bar</code></div> - </td> - <td>The object <code>bar</code> in group <code>foo</code> in - the specified group.</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">File identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center"><b>.</b></div> - </td> - <td>The root group of the file.</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">Group identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center"><b>.</b></div> - </td> - <td>The specified group.</td> - </tr> - <tr bordercolor="#FFFFFF"> - <td bgcolor="#99cccc">Other identifier</td> - <td bgcolor="#CCCCCC"> - <div align="center"><b>.</b></div> - </td> - <td>The specified object.</td> - </tr> -</table> -</center> - - -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The following example code shows how to create groups using absolute -and relative names. It creates three groups: the first two groups are -created using the file identifier and the group absolute names while the -third group is created using a group identifier and a name relative -to the specified group. <BR> -<UL> -[ <A HREF="examples/h5_crtgrpar.c">C Example</A> ] - <code>h5_crtgrpar.c</code><BR> -[ <A HREF="examples/grpsexample.f90">Fortran Example</A> ] - <code>grpsexample.f90</code><BR> -[ <A HREF="examples/java/CreateGroupAR.java">Java Example</A> ] - <code>CreateGroupAR.java</code> -</UL> - -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><code>H5Gcreate</code>/<code>h5gcreate_f</code> creates a group at the - location specified by a location identifier and a name. - The location identifier can be a file identifier or a group identifier - and the name can be relative or absolute. -<P> -<LI>The first <code>H5Gcreate</code>/<code>h5gcreate_f</code> creates the group - <code>MyGroup</code> in the root group of the specified file. -<P> -<LI>The second <code>H5Gcreate</code>/<code>h5gcreate_f</code> creates the group - <code>Group_A</code> in the group <code>MyGroup</code> in the root group - of the specified file. Note that the parent group (<code>MyGroup</code>) - already exists. -<P> -<LI>The third <code>H5Gcreate</code>/<code>h5gcreate_f</code> creates the group - <code>Group_B</code> in the specified group. -</UL> -<A NAME="fc"> -<H3><U>File Contents</U></H3> -The file contents are shown below: -<P> -<B>Fig. 9.1</B> <I>The Contents of <code>groups.h5</code> - (<code>groupsf.h5</code> for FORTRAN)</I> -<P> -<!--<IMG src="groupsh5.jpg" width="285" height="383"></P> --> -<IMG src="img004.gif"></P> - - - <B> Fig. 9.2</B> <I><code>groups.h5</code> in DDL - (for FORTRAN, the name in the first line is <code>groupsf.h5</code>)</I> -<PRE> - - HDF5 "groups.h5" { - GROUP "/" { - GROUP "MyGroup" { - GROUP "Group_A" { - } - GROUP "Group_B" { - } - } - } - } - -</PRE> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/crtgrpd.html b/doc/html/Tutor/crtgrpd.html deleted file mode 100644 index 97ae78c..0000000 --- a/doc/html/Tutor/crtgrpd.html +++ /dev/null @@ -1,163 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Creating Datasets in Groups -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Creating Datasets in Groups</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#ds"> Creating datasets in groups</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> -<!-- <LI> <A HREF="#rem">Remarks</A> --> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="ds"> -<H2><U>Creating datasets in groups</U></H2> -We have shown how to create groups, datasets, and attributes. -In this section, we show how to create datasets in groups. -Recall that <code>H5Dcreate</code>/<code>h5dcreate_f</code> -creates a dataset at the location specified by a location identifier and -a name. Similar to <code>H5Gcreate</code>/<code>h5gcreate_f</code>, -the location identifier can be a -file identifier or a group identifier and the name can be -relative or absolute. The location identifier and the name together determine -the location where the dataset is to be created. If the location identifier -and name refer to a group, then the dataset is created in that group. - - -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -This example shows how to create a dataset in a particular group. -It opens the file created in the previous example and creates two datasets.<BR> -<UL> -[ <A HREF="examples/h5_crtgrpd.c">C Example</A> ] - <code>h5_crtgrpd.c</code> -<BR> -[ <A HREF="examples/grpdsetexample.f90">FORTRAN Example</A> ] -- <code>grpdsetexample.f90</code><BR> -[ <A HREF="examples/java/CreateGroupDataset.java">Java Example</A> ] -- <code>CreateGroupDataset.java</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - - -<A NAME="fc"> -<H3><U>File Contents</U></H3> -<P> -<B>Fig. 10.1</B> <I>The Contents of <code>groups.h5</code> - (<code>groupsf.h5</code> for FORTRAN)</I> -<PRE> -<IMG src="img005.gif"></PRE> -<!-- <IMG src="groups2.jpg" width="324" height="433"></PRE> --> - -</PRE> - <B>Fig. 10.2a</B> <I><code>groups.h5</code> in DDL</I> -<PRE> - -HDF5 "groups.h5" { -GROUP "/" { - GROUP "MyGroup" { - GROUP "Group_A" { - DATASET "dset2" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 2, 10 ) / ( 2, 10 ) } - DATA { - 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, - 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 - } - } - } - GROUP "Group_B" { - } - DATASET "dset1" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 3, 3 ) / ( 3, 3 ) } - DATA { - 1, 2, 3, - 1, 2, 3, - 1, 2, 3 - } - } - } -} -} -</PRE> - <B>Fig. 10.2b</B> <I><code>groupsf.h5</code> in DDL</I> -<PRE> - -HDF5 "groupsf.h5" { -GROUP "/" { - GROUP "MyGroup" { - GROUP "Group_A" { - DATASET "dset2" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 10, 2 ) / ( 10, 2 ) } - DATA { - 1, 1, - 2, 2, - 3, 3, - 4, 4, - 5, 5, - 6, 6, - 7, 7, - 8, 8, - 9, 9, - 10, 10 - } - } - } - GROUP "Group_B" { - } - DATASET "dset1" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 3, 3 ) / ( 3, 3 ) } - DATA { - 1, 1, 1, - 2, 2, 2, - 3, 3, 3 - } - } - } -} -} -</PRE> -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br>The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois at Urbana-Champaign</a><br> -<!-- <A HREF="helpdesk.mail.html"> --> -<BR><A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/examples/Makefile.am b/doc/html/Tutor/examples/Makefile.am deleted file mode 100644 index d28abfc..0000000 --- a/doc/html/Tutor/examples/Makefile.am +++ /dev/null @@ -1,38 +0,0 @@ -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -## -## Makefile.am -## Run automake to generate a Makefile.in from this file. -# - -include $(top_srcdir)/config/commence-doc.am - -localdocdir = $(docdir)/hdf5/Tutor/examples - -# Public doc files (to be installed)... -localdoc_DATA=h5_compound.c h5_copy.c h5_crtatt.c h5_crtdat.c h5_crtfile.c \ - h5_crtgrp.c h5_crtgrpar.c h5_crtgrpd.c h5_extend.c h5_hyperslab.c \ - h5_iterate.c h5_mount.c h5_rdwt.c h5_read.c h5_ref2objr.c \ - h5_ref2objw.c h5_ref2regr.c h5_ref2regw.c h5_reference.c - -nobase_localdoc_DATA=java/Compound.java java/Copy.java java/CreateAttribute.java \ - java/CreateDataset.java java/CreateFile.java \ - java/CreateFileInput.java java/CreateGroup.java \ - java/CreateGroupAR.java java/CreateGroupDataset.java \ - java/DatasetRdWt.java java/HyperSlab.java java/Makefile \ - java/Makefile.in java/README java/readme.html \ - java/runCompound.sh java/runCompound.sh.in java/runCopy.sh \ - java/runCopy.sh.in java/runCreateAttribute.sh \ - java/runCreateAttribute.sh.in java/runCreateDataset.sh \ - java/runCreateDataset.sh.in java/runCreateFile.sh \ - java/runCreateFile.sh.in java/runCreateFileInput.sh \ - java/runCreateFileInput.sh.in java/runCreateGroup.sh \ - java/runCreateGroup.sh.in java/runCreateGroupAR.sh \ - java/runCreateGroupAR.sh.in java/runCreateGroupDataset.sh \ - java/runCreateGroupDataset.sh.in java/runDatasetRdWt.sh \ - java/runDatasetRdWt.sh.in java/runHyperSlab.sh \ - java/runHyperSlab.sh.in diff --git a/doc/html/Tutor/examples/Makefile.in b/doc/html/Tutor/examples/Makefile.in deleted file mode 100644 index 98ec3a0..0000000 --- a/doc/html/Tutor/examples/Makefile.in +++ /dev/null @@ -1,530 +0,0 @@ -# Makefile.in generated by automake 1.9.5 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005 Free Software Foundation, Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ - -# HDF5 Library Doc Makefile(.in) -# -# Copyright (C) 1997, 2002 -# National Center for Supercomputing Applications. -# All rights reserved. -# -# - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../../../.. -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -build_triplet = @build@ -host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(top_srcdir)/config/commence-doc.am \ - $(top_srcdir)/config/commence.am -subdir = doc/html/Tutor/examples -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.in -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(top_srcdir)/bin/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/src/H5config.h -CONFIG_CLEAN_FILES = -SOURCES = -DIST_SOURCES = -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -am__installdirs = "$(DESTDIR)$(localdocdir)" \ - "$(DESTDIR)$(localdocdir)" -localdocDATA_INSTALL = $(INSTALL_DATA) -nobase_localdocDATA_INSTALL = $(install_sh_DATA) -DATA = $(localdoc_DATA) $(nobase_localdoc_DATA) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -# Set the paths for AFS installs of autotools for Linux machines -# Ideally, these tools should never be needed during the build. -ACLOCAL = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/aclocal -I /afs/ncsa/projects/hdf/packages/libtool_1.5.14/Linux_2.4/share/aclocal -ADD_PARALLEL_FILES = @ADD_PARALLEL_FILES@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -AMTAR = @AMTAR@ -AM_MAKEFLAGS = @AM_MAKEFLAGS@ -AR = @AR@ -AUTOCONF = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoconf -AUTOHEADER = /afs/ncsa/projects/hdf/packages/autoconf_2.59/Linux_2.4/bin/autoheader -AUTOMAKE = /afs/ncsa/projects/hdf/packages/automake_1.9.5/Linux_2.4/bin/automake -AWK = @AWK@ -BUILD_CXX_CONDITIONAL_FALSE = @BUILD_CXX_CONDITIONAL_FALSE@ -BUILD_CXX_CONDITIONAL_TRUE = @BUILD_CXX_CONDITIONAL_TRUE@ -BUILD_FORTRAN_CONDITIONAL_FALSE = @BUILD_FORTRAN_CONDITIONAL_FALSE@ -BUILD_FORTRAN_CONDITIONAL_TRUE = @BUILD_FORTRAN_CONDITIONAL_TRUE@ -BUILD_HDF5_HL_CONDITIONAL_FALSE = @BUILD_HDF5_HL_CONDITIONAL_FALSE@ -BUILD_HDF5_HL_CONDITIONAL_TRUE = @BUILD_HDF5_HL_CONDITIONAL_TRUE@ -BUILD_PABLO_CONDITIONAL_FALSE = @BUILD_PABLO_CONDITIONAL_FALSE@ -BUILD_PABLO_CONDITIONAL_TRUE = @BUILD_PABLO_CONDITIONAL_TRUE@ -BUILD_PARALLEL_CONDITIONAL_FALSE = @BUILD_PARALLEL_CONDITIONAL_FALSE@ -BUILD_PARALLEL_CONDITIONAL_TRUE = @BUILD_PARALLEL_CONDITIONAL_TRUE@ -BUILD_PDB2HDF = @BUILD_PDB2HDF@ -BUILD_PDB2HDF_CONDITIONAL_FALSE = @BUILD_PDB2HDF_CONDITIONAL_FALSE@ -BUILD_PDB2HDF_CONDITIONAL_TRUE = @BUILD_PDB2HDF_CONDITIONAL_TRUE@ -BYTESEX = @BYTESEX@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CC_VERSION = @CC_VERSION@ -CFLAGS = @CFLAGS@ -CONFIG_DATE = @CONFIG_DATE@ -CONFIG_MODE = @CONFIG_MODE@ -CONFIG_USER = @CONFIG_USER@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CXX = @CXX@ -CXXCPP = @CXXCPP@ -CXXDEPMODE = @CXXDEPMODE@ -CXXFLAGS = @CXXFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEBUG_PKG = @DEBUG_PKG@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -DYNAMIC_DIRS = @DYNAMIC_DIRS@ -ECHO = @ECHO@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -F77 = @F77@ - -# Make sure that these variables are exported to the Makefiles -F9XMODEXT = @F9XMODEXT@ -F9XMODFLAG = @F9XMODFLAG@ -F9XSUFFIXFLAG = @F9XSUFFIXFLAG@ -FC = @FC@ -FCFLAGS = @FCFLAGS@ -FCLIBS = @FCLIBS@ -FFLAGS = @FFLAGS@ -FILTERS = @FILTERS@ -FSEARCH_DIRS = @FSEARCH_DIRS@ -H5_VERSION = @H5_VERSION@ -HADDR_T = @HADDR_T@ -HDF5_INTERFACES = @HDF5_INTERFACES@ -HID_T = @HID_T@ -HL = @HL@ -HL_FOR = @HL_FOR@ -HSIZET = @HSIZET@ -HSIZE_T = @HSIZE_T@ -HSSIZE_T = @HSSIZE_T@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -INSTRUMENT_LIBRARY = @INSTRUMENT_LIBRARY@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LIBTOOL = @LIBTOOL@ -LN_S = @LN_S@ -LTLIBOBJS = @LTLIBOBJS@ -LT_STATIC_EXEC = @LT_STATIC_EXEC@ -MAINT = @MAINT@ -MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ -MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ -MAKEINFO = @MAKEINFO@ -MPE = @MPE@ -OBJECT_NAMELEN_DEFAULT_F = @OBJECT_NAMELEN_DEFAULT_F@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PARALLEL = @PARALLEL@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PERL = @PERL@ -PTHREAD = @PTHREAD@ -RANLIB = @RANLIB@ -ROOT = @ROOT@ -RUNPARALLEL = @RUNPARALLEL@ -RUNSERIAL = @RUNSERIAL@ -R_INTEGER = @R_INTEGER@ -R_LARGE = @R_LARGE@ -SEARCH = @SEARCH@ -SETX = @SETX@ -SET_MAKE = @SET_MAKE@ - -# Hardcode SHELL to be /bin/sh. Most machines have this shell, and -# on at least one machine configure fails to detect its existence (janus). -# Also, when HDF5 is configured on one machine but run on another, -# configure's automatic SHELL detection may not work on the build machine. -SHELL = /bin/sh -SIZE_T = @SIZE_T@ -STATIC_SHARED = @STATIC_SHARED@ -STRIP = @STRIP@ -TESTPARALLEL = @TESTPARALLEL@ -TRACE_API = @TRACE_API@ -USE_FILTER_DEFLATE = @USE_FILTER_DEFLATE@ -USE_FILTER_FLETCHER32 = @USE_FILTER_FLETCHER32@ -USE_FILTER_NBIT = @USE_FILTER_NBIT@ -USE_FILTER_SCALEOFFSET = @USE_FILTER_SCALEOFFSET@ -USE_FILTER_SHUFFLE = @USE_FILTER_SHUFFLE@ -USE_FILTER_SZIP = @USE_FILTER_SZIP@ -VERSION = @VERSION@ -ac_ct_AR = @ac_ct_AR@ -ac_ct_CC = @ac_ct_CC@ -ac_ct_CXX = @ac_ct_CXX@ -ac_ct_F77 = @ac_ct_F77@ -ac_ct_FC = @ac_ct_FC@ -ac_ct_RANLIB = @ac_ct_RANLIB@ -ac_ct_STRIP = @ac_ct_STRIP@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ -am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build = @build@ -build_alias = @build_alias@ -build_cpu = @build_cpu@ -build_os = @build_os@ -build_vendor = @build_vendor@ -datadir = @datadir@ -exec_prefix = @exec_prefix@ -host = @host@ -host_alias = @host_alias@ -host_cpu = @host_cpu@ -host_os = @host_os@ -host_vendor = @host_vendor@ - -# Install directories that automake doesn't know about -includedir = $(exec_prefix)/include -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ - -# Shell commands used in Makefiles -RM = rm -f -CP = cp - -# Some machines need a command to run executables; this is that command -# so that our tests will run. -# We use RUNTESTS instead of RUNSERIAL directly because it may be that -# some tests need to be run with a different command. Older versions -# of the makefiles used the command -# $(LIBTOOL) --mode=execute -# in some directories, for instance. -RUNTESTS = $(RUNSERIAL) - -# Libraries to link to while building -LIBHDF5 = $(top_builddir)/src/libhdf5.la -LIBH5TEST = $(top_builddir)/test/libh5test.la -LIBH5F = $(top_builddir)/fortran/src/libhdf5_fortran.la -LIBH5FTEST = $(top_builddir)/fortran/test/libh5test_fortran.la -LIBH5CPP = $(top_builddir)/c++/src/libhdf5_cpp.la -LIBH5TOOLS = $(top_builddir)/tools/lib/libh5tools.la -LIBH5_HL = $(top_builddir)/hl/src/libhdf5_hl.la -LIBH5F_HL = $(top_builddir)/hl/fortran/src/libhdf5hl_fortran.la -LIBH5CPP_HL = $(top_builddir)/hl/c++/src/libhdf5_hl_cpp.la -docdir = $(exec_prefix)/doc - -# Scripts used to build examples -H5CC = $(bindir)/h5cc -H5CC_PP = $(bindir)/h5pcc -H5FC = $(bindir)/h5fc -H5FC_PP = $(bindir)/h5pfc - -# .chkexe and .chksh files are used to mark tests that have run successfully. -MOSTLYCLEANFILES = *.chkexe *.chksh -localdocdir = $(docdir)/hdf5/Tutor/examples - -# Public doc files (to be installed)... -localdoc_DATA = h5_compound.c h5_copy.c h5_crtatt.c h5_crtdat.c h5_crtfile.c \ - h5_crtgrp.c h5_crtgrpar.c h5_crtgrpd.c h5_extend.c h5_hyperslab.c \ - h5_iterate.c h5_mount.c h5_rdwt.c h5_read.c h5_ref2objr.c \ - h5_ref2objw.c h5_ref2regr.c h5_ref2regw.c h5_reference.c - -nobase_localdoc_DATA = java/Compound.java java/Copy.java java/CreateAttribute.java \ - java/CreateDataset.java java/CreateFile.java \ - java/CreateFileInput.java java/CreateGroup.java \ - java/CreateGroupAR.java java/CreateGroupDataset.java \ - java/DatasetRdWt.java java/HyperSlab.java java/Makefile \ - java/Makefile.in java/README java/readme.html \ - java/runCompound.sh java/runCompound.sh.in java/runCopy.sh \ - java/runCopy.sh.in java/runCreateAttribute.sh \ - java/runCreateAttribute.sh.in java/runCreateDataset.sh \ - java/runCreateDataset.sh.in java/runCreateFile.sh \ - java/runCreateFile.sh.in java/runCreateFileInput.sh \ - java/runCreateFileInput.sh.in java/runCreateGroup.sh \ - java/runCreateGroup.sh.in java/runCreateGroupAR.sh \ - java/runCreateGroupAR.sh.in java/runCreateGroupDataset.sh \ - java/runCreateGroupDataset.sh.in java/runDatasetRdWt.sh \ - java/runDatasetRdWt.sh.in java/runHyperSlab.sh \ - java/runHyperSlab.sh.in - -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/config/commence-doc.am $(top_srcdir)/config/commence.am $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ - && exit 0; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/html/Tutor/examples/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --foreign doc/html/Tutor/examples/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -mostlyclean-libtool: - -rm -f *.lo - -clean-libtool: - -rm -rf .libs _libs - -distclean-libtool: - -rm -f libtool -uninstall-info-am: -install-localdocDATA: $(localdoc_DATA) - @$(NORMAL_INSTALL) - test -z "$(localdocdir)" || $(mkdir_p) "$(DESTDIR)$(localdocdir)" - @list='$(localdoc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(localdocDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(localdocdir)/$$f'"; \ - $(localdocDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -uninstall-localdocDATA: - @$(NORMAL_UNINSTALL) - @list='$(localdoc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(localdocdir)/$$f'"; \ - rm -f "$(DESTDIR)$(localdocdir)/$$f"; \ - done -install-nobase_localdocDATA: $(nobase_localdoc_DATA) - @$(NORMAL_INSTALL) - test -z "$(localdocdir)" || $(mkdir_p) "$(DESTDIR)$(localdocdir)" - @$(am__vpath_adj_setup) \ - list='$(nobase_localdoc_DATA)'; for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - $(am__vpath_adj) \ - echo " $(nobase_localdocDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(localdocdir)/$$f'"; \ - $(nobase_localdocDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(localdocdir)/$$f"; \ - done - -uninstall-nobase_localdocDATA: - @$(NORMAL_UNINSTALL) - @$(am__vpath_adj_setup) \ - list='$(nobase_localdoc_DATA)'; for p in $$list; do \ - $(am__vpath_adj) \ - echo " rm -f '$(DESTDIR)$(localdocdir)/$$f'"; \ - rm -f "$(DESTDIR)$(localdocdir)/$$f"; \ - done -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - - -distdir: $(DISTFILES) - $(mkdir_p) $(distdir)/../../../../config - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkdir_p) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ - else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-am -all-am: Makefile $(DATA) -installdirs: - for dir in "$(DESTDIR)$(localdocdir)" "$(DESTDIR)$(localdocdir)"; do \ - test -z "$$dir" || $(mkdir_p) "$$dir"; \ - done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-am -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -test -z "$(MOSTLYCLEANFILES)" || rm -f $(MOSTLYCLEANFILES) - -clean-generic: - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-am - -clean-am: clean-generic clean-libtool mostlyclean-am - -distclean: distclean-am - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-libtool - -dvi: dvi-am - -dvi-am: - -html: html-am - -info: info-am - -info-am: - -install-data-am: install-localdocDATA install-nobase_localdocDATA - -install-exec-am: - -install-info: install-info-am - -install-man: - -installcheck-am: - -maintainer-clean: maintainer-clean-am - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-am - -mostlyclean-am: mostlyclean-generic mostlyclean-libtool - -pdf: pdf-am - -pdf-am: - -ps: ps-am - -ps-am: - -uninstall-am: uninstall-info-am uninstall-localdocDATA \ - uninstall-nobase_localdocDATA - -.PHONY: all all-am check check-am clean clean-generic clean-libtool \ - distclean distclean-generic distclean-libtool distdir dvi \ - dvi-am html html-am info info-am install install-am \ - install-data install-data-am install-exec install-exec-am \ - install-info install-info-am install-localdocDATA install-man \ - install-nobase_localdocDATA install-strip installcheck \ - installcheck-am installdirs maintainer-clean \ - maintainer-clean-generic mostlyclean mostlyclean-generic \ - mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \ - uninstall-info-am uninstall-localdocDATA \ - uninstall-nobase_localdocDATA - - -# Ignore most rules -lib progs check test _test check-p check-s: - @echo "Nothing to be done" - -tests dep depend: - @@SETX@; for d in X $(SUBDIRS); do \ - if test $$d != X; then \ - (cd $$d && $(MAKE) $(AM_MAKEFLAGS) $@) || exit 1; \ - fi; - done - -# In docs directory, install-doc is the same as install -install-doc install-all: - $(MAKE) $(AM_MAKEFLAGS) install -uninstall-doc uninstall-all: - $(MAKE) $(AM_MAKEFLAGS) uninstall -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: diff --git a/doc/html/Tutor/examples/attrexample.f90 b/doc/html/Tutor/examples/attrexample.f90 deleted file mode 100644 index 9198eb8..0000000 --- a/doc/html/Tutor/examples/attrexample.f90 +++ /dev/null @@ -1,87 +0,0 @@ -! This example shows how to create and write a dataset attribute. -! It opens the existing file 'dset.h5', obtains the identifier of -! the dataset "/dset", defines attribute's dataspace, -! creates dataset attribute, writes the attribute, and then closes -! the attribute's dataspace, attribute, dataset, and file. - - PROGRAM ATTREXAMPLE - - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=8), PARAMETER :: filename = "dsetf.h5" ! File name - CHARACTER(LEN=4), PARAMETER :: dsetname = "dset" ! Dataset name - CHARACTER(LEN=4), PARAMETER :: aname = "attr" ! Attribute name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - INTEGER(HID_T) :: attr_id ! Attribute identifier - INTEGER(HID_T) :: aspace_id ! Attribute Dataspace identifier - - INTEGER(HSIZE_T), DIMENSION(1) :: adims = (/2/) ! Attribute dimension - INTEGER, DIMENSION(2) :: attr_data = (/100,200/)! Attribute data - INTEGER :: arank = 1 ! Attribure rank - - INTEGER :: error ! Error flag - - - ! - ! Initialize FORTRAN predefined datatypes. - ! - CALL h5open_f(error) - - ! - ! Open an existing file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDWR_F, file_id, error) - - ! - ! Open an existing dataset. - ! - CALL h5dopen_f(file_id, dsetname, dset_id, error) - - ! - ! Create the data space for the attribute. - ! - CALL h5screate_simple_f(arank, adims, aspace_id, error) - - ! - ! Create dataset attribute. - ! - CALL h5acreate_f(dset_id, aname, H5T_NATIVE_INTEGER,aspace_id, & - attr_id, error) - - ! - ! Write the attribute data. - ! - CALL h5awrite_f(attr_id, H5T_NATIVE_INTEGER, attr_data, error) - - ! - ! Close the attribute. - ! - CALL h5aclose_f(attr_id, error) - - ! - ! Terminate access to the data space. - ! - CALL h5sclose_f(aspace_id, error) - - ! - ! End access to the dataset and release resources used by it. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM ATTREXAMPLE - diff --git a/doc/html/Tutor/examples/chunk.f90 b/doc/html/Tutor/examples/chunk.f90 deleted file mode 100644 index 2810b5c..0000000 --- a/doc/html/Tutor/examples/chunk.f90 +++ /dev/null @@ -1,310 +0,0 @@ -! -!This example shows how to work with extendible datasets. -!It creates a 3 x 3 extendible dataset, write to that dataset, -!extend the dataset to 10x3, and write to the dataset again -! - - - - - PROGRAM CHUNKEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - ! - !the dataset is stored in file "extf.h5" - ! - CHARACTER(LEN=7), PARAMETER :: filename = "extf.h5" - - ! - !dataset name is "ExtendibleArray" - ! - CHARACTER(LEN=15), PARAMETER :: dsetname = "ExtendibleArray" - - ! - !dataset rank is 2 - ! - INTEGER :: RANK = 2 - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - INTEGER(HID_T) :: dataspace ! Dataspace identifier - INTEGER(HID_T) :: filespace ! Dataspace identifier - INTEGER(HID_T) :: memspace ! memspace identifier - INTEGER(HID_T) :: cparms !dataset creatation property identifier - - ! - !dataset dimensions at creation time - ! - INTEGER(HSIZE_T), DIMENSION(2) :: dims = (/3,3/) - - ! - !data1 dimensions - ! - INTEGER(HSIZE_T), DIMENSION(2) :: dims1 = (/3,3/) - - ! - !data2 dimensions - ! - INTEGER(HSIZE_T), DIMENSION(2) :: dims2 = (/7,1/) - - ! - !Maximum dimensions - ! - INTEGER(HSIZE_T), DIMENSION(2) :: maxdims - - ! - !data1 dimensions - ! - INTEGER, DIMENSION(3,3) :: data1 - - ! - !data2 dimensions - ! - INTEGER, DIMENSION(7,1) :: data2 - - ! - !Size of the hyperslab in the file - ! - INTEGER(HSIZE_T), DIMENSION(2) :: size - - ! - !hyperslab offset in the file - ! - INTEGER(HSIZE_T), DIMENSION(2) :: offset - - ! - !general purpose integer - ! - INTEGER :: i, j, k - - ! - !flag to check operation success - ! - INTEGER :: error, error_n - - ! - !Variables used in reading data back - ! - INTEGER(HSIZE_T), DIMENSION(2) :: chunk_dims = (/5,2/) - INTEGER(HSIZE_T), DIMENSION(2) :: chunk_dimsr - INTEGER(HSIZE_T), DIMENSION(2) :: dimsr, maxdimsr - INTEGER, DIMENSION(10,3) :: data_out - INTEGER :: rankr, rank_chunk - - ! - !data initialization - ! - do i = 1, 3 - do j = 1, 3 - data1(i,j) = 1 - end do - end do - - do j = 1, 7 - data2(j,1) = 2 - end do - - - ! - !Initialize FORTRAN predifined datatypes - ! - CALL h5open_f(error) - - ! - !Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - - ! - !Create the data space with unlimited dimensions. - ! - maxdims = (/H5S_UNLIMITED_f, H5S_UNLIMITED_f/) - - CALL h5screate_simple_f(RANK, dims, dataspace, error, maxdims) - - ! - !Modify dataset creation properties, i.e. enable chunking - ! - CALL h5pcreate_f(H5P_DATASET_CREATE_F, cparms, error) - - CALL h5pset_chunk_f(cparms, RANK, chunk_dims, error) - - ! - !Create a new dataset within the file using cparms creation properties. - ! - !CALL h5dcreate_f(file_id, dsetname, H5T_NATIVE_INT_F, dataspace, & - CALL h5dcreate_f(file_id, dsetname, H5T_NATIVE_INTEGER, dataspace, & - dset_id, error, cparms) - - ! - !Extend the dataset. This call assures that dataset is 3 x 3. - ! - size(1) = 3 - size(2) = 3 - CALL h5dextend_f(dset_id, size, error) - - - ! - !Select a hyperslab. - ! - CALL h5dget_space_f(dset_id, filespace, error) - offset(1) = 0; - offset(2) = 0; - CALL h5sselect_hyperslab_f(filespace, H5S_SELECT_SET_F, & - offset, dims1, error) - - ! - !Write the data to the hyperslab. - ! - !CALL H5Dwrite_f(dset_id, H5T_NATIVE_INT_F, data1, error, & - CALL H5Dwrite_f(dset_id, H5T_NATIVE_INTEGER, data1, error, & - filespace, dataspace) - - ! - !Extend the dataset. Dataset becomes 10 x 3. - ! - dims(1) = dims1(1) + dims2(1); - size(1) = dims(1); - size(2) = dims(2); - CALL h5dextend_f(dset_id, size, error) - - ! - !Select a hyperslab. - ! - CALL h5dget_space_f(dset_id, filespace, error) - offset(1) = 3; - offset(2) = 0; - CALL h5sselect_hyperslab_f(filespace, H5S_SELECT_SET_F, & - offset, dims2, error) - - ! - !create memory dataspace. - ! - CALL h5screate_simple_f(RANK, dims2, memspace, error) - - ! - !Write the data to the hyperslab. - ! - !CALL H5Dwrite_f(dset_id, H5T_NATIVE_INT_F, data2, error, & - CALL H5Dwrite_f(dset_id, H5T_NATIVE_INTEGER, data2, error, & - mem_space_id=memspace, file_space_id=filespace) - - ! - !Close the dataspace for the dataset. - ! - CALL h5sclose_f(dataspace, error) - CALL h5sclose_f(filespace, error) - - ! - !Close the memoryspace. - ! - CALL h5sclose_f(memspace, error) - - ! - !Close the dataset. - ! - CALL h5dclose_f(dset_id, error) - - ! - !Close the property list. - ! - CALL h5pclose_f(cparms, error) - - ! - !Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - !read the data back - ! - !Open the file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDONLY_F, file_id, error) - - ! - !Open the dataset. - ! - CALL h5dopen_f(file_id, dsetname, dset_id, error) - - ! - !Get dataset's dataspace handle. - ! - CALL h5dget_space_f(dset_id, dataspace, error) - - ! - !Get dataspace's rank. - ! - CALL h5sget_simple_extent_ndims_f(dataspace, rankr, error) - - - ! - !Get dataspace's dimensinons. - ! - CALL h5sget_simple_extent_dims_f(dataspace, dimsr, maxdimsr, error) - - - ! - !Get creation property list. - ! - CALL h5dget_create_plist_f(dset_id, cparms, error) - - ! - !Get chunk dimensions. - ! - CALL h5pget_chunk_f(cparms, 2, chunk_dimsr, error) - - ! - !create memory dataspace. - ! - CALL h5screate_simple_f(rankr, dimsr, memspace, error) - - ! - !Read data - ! - !CALL H5Dread_f(dset_id, H5T_NATIVE_INT_F, data_out, error, & - CALL H5Dread_f(dset_id, H5T_NATIVE_INTEGER, data_out, error, & - memspace, dataspace) - - ! - !Print data - ! - do i = 1, dimsr(1) - print *, (data_out(i,j), j = 1,dimsr(2)) - end do - - ! - !Close the dataspace for the dataset. - ! - CALL h5sclose_f(dataspace, error) - - ! - !Close the memoryspace. - ! - CALL h5sclose_f(memspace, error) - - ! - !Close the dataset. - ! - CALL h5dclose_f(dset_id, error) - - ! - !Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - !Close the property list. - ! - CALL h5pclose_f(cparms, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM CHUNKEXAMPLE diff --git a/doc/html/Tutor/examples/compound.f90 b/doc/html/Tutor/examples/compound.f90 deleted file mode 100644 index a2bd6b0..0000000 --- a/doc/html/Tutor/examples/compound.f90 +++ /dev/null @@ -1,215 +0,0 @@ -! -! This program creates a dataset that is one dimensional array of -! structures { -! character*2 -! integer -! double precision -! real -! } -! Data is written and read back by fields. -! - - PROGRAM COMPOUNDEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=11), PARAMETER :: filename = "compound.h5" ! File name - CHARACTER(LEN=8), PARAMETER :: dsetname = "Compound" ! Dataset name - INTEGER, PARAMETER :: dimsize = 6 ! Size of the dataset - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - INTEGER(HID_T) :: dspace_id ! Dataspace identifier - INTEGER(HID_T) :: dtype_id ! Compound datatype identifier - INTEGER(HID_T) :: dt1_id ! Memory datatype identifier (for character field) - INTEGER(HID_T) :: dt2_id ! Memory datatype identifier (for integer field) - INTEGER(HID_T) :: dt3_id ! Memory datatype identifier (for double precision field) - INTEGER(HID_T) :: dt4_id ! Memory datatype identifier (for real field) - INTEGER(HID_T) :: dt5_id ! Memory datatype identifier - INTEGER(HID_T) :: plist_id ! Dataset trasfer property - INTEGER(SIZE_T) :: typesize - - - INTEGER(HSIZE_T), DIMENSION(1) :: dims = (/dimsize/) ! Dataset dimensions - INTEGER :: rank = 1 ! Dataset rank - - INTEGER :: error ! Error flag - INTEGER(SIZE_T) :: type_size ! Size of the datatype - INTEGER(SIZE_T) :: type_sizec ! Size of the character datatype - INTEGER(SIZE_T) :: type_sizei ! Size of the integer datatype - INTEGER(SIZE_T) :: type_sized ! Size of the double precision datatype - INTEGER(SIZE_T) :: type_sizer ! Size of the real datatype - INTEGER(SIZE_T) :: offset ! Member's offset - CHARACTER*2, DIMENSION(dimsize) :: char_member - CHARACTER*2, DIMENSION(dimsize) :: char_member_out ! Buffer to read data out - INTEGER, DIMENSION(dimsize) :: int_member - DOUBLE PRECISION, DIMENSION(dimsize) :: double_member - REAL, DIMENSION(dimsize) :: real_member - INTEGER :: i - ! - ! Initialize data buffer. - ! - do i = 1, dimsize - char_member(i)(1:1) = char(65+i) - char_member(i)(2:2) = char(65+i) - char_member_out(i)(1:1) = char(65) - char_member_out(i)(2:2) = char(65) - int_member(i) = i - double_member(i) = 2.* i - real_member(i) = 3. * i - enddo - - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - ! - ! Set dataset transfer property to preserve partially initialized fields - ! during write/read to/from dataset with compound datatype. - ! - CALL h5pcreate_f(H5P_DATASET_XFER_F, plist_id, error) - CALL h5pset_preserve_f(plist_id, 1, error) - - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create the dataspace. - ! - CALL h5screate_simple_f(rank, dims, dspace_id, error) - ! - ! Create compound datatype. - ! - ! First calculate total size by calculating sizes of each member - ! - CALL h5tcopy_f(H5T_NATIVE_CHARACTER, dt5_id, error) - typesize = 2 - CALL h5tset_size_f(dt5_id, typesize, error) - CALL h5tget_size_f(dt5_id, type_sizec, error) - CALL h5tget_size_f(H5T_NATIVE_INTEGER, type_sizei, error) - CALL h5tget_size_f(H5T_NATIVE_DOUBLE, type_sized, error) - CALL h5tget_size_f(H5T_NATIVE_REAL, type_sizer, error) - type_size = type_sizec + type_sizei + type_sized + type_sizer - CALL h5tcreate_f(H5T_COMPOUND_F, type_size, dtype_id, error) - ! - ! Insert memebers - ! - ! CHARACTER*2 memeber - ! - offset = 0 - CALL h5tinsert_f(dtype_id, "char_field", offset, dt5_id, error) - ! - ! INTEGER member - ! - offset = offset + type_sizec ! Offset of the second memeber is 2 - CALL h5tinsert_f(dtype_id, "integer_field", offset, H5T_NATIVE_INTEGER, error) - ! - ! DOUBLE PRECISION member - ! - offset = offset + type_sizei ! Offset of the third memeber is 6 - CALL h5tinsert_f(dtype_id, "double_field", offset, H5T_NATIVE_DOUBLE, error) - ! - ! REAL member - ! - offset = offset + type_sized ! Offset of the last member is 14 - CALL h5tinsert_f(dtype_id, "real_field", offset, H5T_NATIVE_REAL, error) - - ! - ! Create the dataset with compound datatype. - ! - CALL h5dcreate_f(file_id, dsetname, dtype_id, dspace_id, & - dset_id, error) - ! - ! Create memory types. We have to create a compound datatype - ! for each member we want to write. - ! - CALL h5tcreate_f(H5T_COMPOUND_F, type_sizec, dt1_id, error) - offset = 0 - CALL h5tinsert_f(dt1_id, "char_field", offset, dt5_id, error) - ! - CALL h5tcreate_f(H5T_COMPOUND_F, type_sizei, dt2_id, error) - offset = 0 - CALL h5tinsert_f(dt2_id, "integer_field", offset, H5T_NATIVE_INTEGER, error) - ! - CALL h5tcreate_f(H5T_COMPOUND_F, type_sized, dt3_id, error) - offset = 0 - CALL h5tinsert_f(dt3_id, "double_field", offset, H5T_NATIVE_DOUBLE, error) - ! - CALL h5tcreate_f(H5T_COMPOUND_F, type_sizer, dt4_id, error) - offset = 0 - CALL h5tinsert_f(dt4_id, "real_field", offset, H5T_NATIVE_REAL, error) - ! - ! Write data by fields in the datatype. Fields order is not important. - ! - CALL h5dwrite_f(dset_id, dt4_id, real_member, error, xfer_prp = plist_id) - CALL h5dwrite_f(dset_id, dt1_id, char_member, error, xfer_prp = plist_id) - CALL h5dwrite_f(dset_id, dt3_id, double_member, error, xfer_prp = plist_id) - CALL h5dwrite_f(dset_id, dt2_id, int_member, error, xfer_prp = plist_id) - - ! - ! End access to the dataset and release resources used by it. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Terminate access to the data space. - ! - CALL h5sclose_f(dspace_id, error) - ! - ! Terminate access to the datatype - ! - CALL h5tclose_f(dtype_id, error) - CALL h5tclose_f(dt1_id, error) - CALL h5tclose_f(dt2_id, error) - CALL h5tclose_f(dt3_id, error) - CALL h5tclose_f(dt4_id, error) - CALL h5tclose_f(dt5_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Open the file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDWR_F, file_id, error) - ! - ! Open the dataset. - ! - CALL h5dopen_f(file_id, dsetname, dset_id, error) - ! - ! Create memeory datatyoe to read character member of the compound datatype. - ! - CALL h5tcopy_f(H5T_NATIVE_CHARACTER, dt2_id, error) - typesize = 2 - CALL h5tset_size_f(dt2_id, typesize, error) - CALL h5tget_size_f(dt2_id, type_size, error) - CALL h5tcreate_f(H5T_COMPOUND_F, type_size, dt1_id, error) - offset = 0 - CALL h5tinsert_f(dt1_id, "char_field", offset, dt2_id, error) - ! - ! Read part of the datatset and display it. - ! - CALL h5dread_f(dset_id, dt1_id, char_member_out, error) - write(*,*) (char_member_out(i), i=1, dimsize) - - ! - ! Close all open objects. - ! - CALL h5dclose_f(dset_id, error) - CALL h5tclose_f(dt1_id, error) - CALL h5tclose_f(dt2_id, error) - CALL h5fclose_f(file_id, error) - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM COMPOUNDEXAMPLE - - diff --git a/doc/html/Tutor/examples/dsetexample.f90 b/doc/html/Tutor/examples/dsetexample.f90 deleted file mode 100644 index 9b69a3f..0000000 --- a/doc/html/Tutor/examples/dsetexample.f90 +++ /dev/null @@ -1,70 +0,0 @@ -! -! The following example shows how to create an empty dataset. -! It creates a file called 'dsetf.h5', defines the -! dataset dataspace, creates a dataset which is a 4x6 integer array, -! and then closes the dataspace, the dataset, and the file. -! - - PROGRAM DSETEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=8), PARAMETER :: filename = "dsetf.h5" ! File name - CHARACTER(LEN=4), PARAMETER :: dsetname = "dset" ! Dataset name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - INTEGER(HID_T) :: dspace_id ! Dataspace identifier - - - INTEGER(HSIZE_T), DIMENSION(2) :: dims = (/4,6/) ! Dataset dimensions - INTEGER :: rank = 2 ! Dataset rank - - INTEGER :: error ! Error flag - - ! - ! Initialize FORTRAN predefined datatypes. - ! - CALL h5open_f(error) - - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create the dataspace. - ! - CALL h5screate_simple_f(rank, dims, dspace_id, error) - - ! - ! Create the dataset with default properties. - ! - CALL h5dcreate_f(file_id, dsetname, H5T_NATIVE_INTEGER, dspace_id, & - dset_id, error) - - ! - ! End access to the dataset and release resources used by it. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Terminate access to the data space. - ! - CALL h5sclose_f(dspace_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM DSETEXAMPLE - - diff --git a/doc/html/Tutor/examples/fileexample.f90 b/doc/html/Tutor/examples/fileexample.f90 deleted file mode 100644 index e11dcaa..0000000 --- a/doc/html/Tutor/examples/fileexample.f90 +++ /dev/null @@ -1,34 +0,0 @@ -! -! The following example demonstrates how to create and close an HDF5 file. -! It creates a file called 'file.h5', and then closes the file. -! - - PROGRAM FILEEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=8), PARAMETER :: filename = "filef.h5" ! File name - INTEGER(HID_T) :: file_id ! File identifier - - INTEGER :: error ! Error flag - -! -! Initialize FORTRAN interface. -! - CALL h5open_f (error) - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Terminate access to the file. - ! - CALL h5fclose_f(file_id, error) -! -! Close FORTRAN interface. -! - CALL h5close_f(error) - END PROGRAM FILEEXAMPLE diff --git a/doc/html/Tutor/examples/groupexample.f90 b/doc/html/Tutor/examples/groupexample.f90 deleted file mode 100644 index d98d7cd..0000000 --- a/doc/html/Tutor/examples/groupexample.f90 +++ /dev/null @@ -1,49 +0,0 @@ -! -! The following example shows how to create and close a group. -! It creates a file called 'group.h5', creates a group -! called MyGroup in the root group, and then closes the group and file. -! - - - PROGRAM GROUPEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=9), PARAMETER :: filename = "groupf.h5" ! File name - CHARACTER(LEN=7), PARAMETER :: groupname = "MyGroup" ! Group name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: group_id ! Group identifier - - INTEGER :: error ! Error flag -! -! Initialize FORTRAN interface. -! - CALL h5open_f(error) - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create a group named "/MyGroup" in the file. - ! - CALL h5gcreate_f(file_id, groupname, group_id, error) - - ! - ! Close the group. - ! - CALL h5gclose_f(group_id, error) - - ! - ! Terminate access to the file. - ! - CALL h5fclose_f(file_id, error) -! -! Close FORTRAN interface. -! - CALL h5close_f(error) - - END PROGRAM GROUPEXAMPLE diff --git a/doc/html/Tutor/examples/grpdsetexample.f90 b/doc/html/Tutor/examples/grpdsetexample.f90 deleted file mode 100644 index ceb2fe9..0000000 --- a/doc/html/Tutor/examples/grpdsetexample.f90 +++ /dev/null @@ -1,136 +0,0 @@ -! -! This example shows how to create a dataset in a particular group. -! It opens the file created in the previous example and creates two datasets. -! Absolute and relative dataset names are used. -! - - - PROGRAM GRPDSETEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=10), PARAMETER :: filename = "groupsf.h5" ! File name - CHARACTER(LEN=15), PARAMETER :: groupname = "MyGroup/Group_A" ! Group name - CHARACTER(LEN=13), PARAMETER :: dsetname1 = "MyGroup/dset1" ! Dataset name - CHARACTER(LEN=5), PARAMETER :: dsetname2 = "dset2" ! dataset name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: group_id ! Group identifier - INTEGER(HID_T) :: dataset_id ! Dataset identifier - INTEGER(HID_T) :: dataspace_id ! Data space identifier - - INTEGER :: i, j - INTEGER :: error ! Error flag - - INTEGER, DIMENSION(3,3) :: dset1_data ! Data arrays - INTEGER, DIMENSION(2,10) :: dset2_data ! - - INTEGER(HSIZE_T), DIMENSION(2) :: dims1 = (/3,3/) ! Datasets dimensions - INTEGER(HSIZE_T), DIMENSION(2) :: dims2 = (/2,10/)! - - INTEGER :: rank = 2 ! Datasets rank - - ! - !Initialize dset1_data array - ! - do i = 1, 3 - do j = 1, 3 - dset1_data(i,j) = j; - end do - end do - - - ! - !Initialize dset2_data array - ! - do i = 1, 2 - do j = 1, 10 - dset2_data(i,j) = j; - end do - end do - - ! - ! Initialize FORTRAN predefined datatypes. - ! - CALL h5open_f(error) - - ! - ! Open an existing file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDWR_F, file_id, error) - - ! - ! Create the data space for the first dataset. - ! - CALL h5screate_simple_f(rank, dims1, dataspace_id, error) - - ! - ! Create a dataset in group "MyGroup" with default properties. - ! - CALL h5dcreate_f(file_id, dsetname1, H5T_NATIVE_INTEGER, dataspace_id, & - dataset_id, error) - - ! - ! Write the first dataset. - ! - CALL h5dwrite_f(dataset_id, H5T_NATIVE_INTEGER, dset1_data, error) - - ! - ! Close the dataspace for the first dataset. - ! - CALL h5sclose_f(dataspace_id, error) - - ! - ! Close the first dataset. - ! - CALL h5dclose_f(dataset_id, error) - - ! - ! Open an existing group in the specified file. - ! - CALL h5gopen_f(file_id, groupname, group_id, error) - - ! - !Create the data space for the second dataset. - ! - CALL h5screate_simple_f(rank, dims2, dataspace_id, error) - - ! - ! Create the second dataset in group "Group_A" with default properties. - ! - CALL h5dcreate_f(group_id, dsetname2, H5T_NATIVE_INTEGER, dataspace_id, & - dataset_id, error) - - ! - ! Write the second dataset. - ! - CALL h5dwrite_f(dataset_id, H5T_NATIVE_INTEGER, dset2_data, error) - - ! - ! Close the dataspace for the second dataset. - ! - CALL h5sclose_f(dataspace_id, error) - - ! - ! Close the second dataset. - ! - CALL h5dclose_f(dataset_id, error) - - ! - ! Close the group. - ! - CALL h5gclose_f(group_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM GRPDSETEXAMPLE diff --git a/doc/html/Tutor/examples/grpit.f90 b/doc/html/Tutor/examples/grpit.f90 deleted file mode 100644 index 3aff2ad..0000000 --- a/doc/html/Tutor/examples/grpit.f90 +++ /dev/null @@ -1,194 +0,0 @@ -! -! In this example we iterate through the members of the groups. -! - - - PROGRAM GRPITEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=11), PARAMETER :: filename = "iteratef.h5" ! File name - CHARACTER(LEN=7), PARAMETER :: groupname1 = "MyGroup" ! Group name - CHARACTER(LEN=15), PARAMETER :: groupname2 = "Group_A" ! Group name - CHARACTER(LEN=13), PARAMETER :: dsetname1 = "dset1" ! Dataset name - CHARACTER(LEN=5), PARAMETER :: dsetname2 = "dset2" ! - - CHARACTER(LEN=20) :: name_buffer ! Buffer to hold object's name - INTEGER :: type ! Type of the object - INTEGER :: nmembers ! Number of group members - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dataset1_id ! Dataset1 identifier - INTEGER(HID_T) :: dataset2_id ! Dataset2 identifier - INTEGER(HID_T) :: dataspace1_id ! Data space identifier - INTEGER(HID_T) :: dataspace2_id ! Data space identifier - INTEGER(HID_T) :: group1_id, group2_id ! Group identifiers - - INTEGER :: i, j - - INTEGER :: error ! Error flag - - INTEGER, DIMENSION(3,3) :: dset1_data ! Arrays to hold data - INTEGER, DIMENSION(2,10) :: dset2_data ! - - INTEGER(HSIZE_T), DIMENSION(2) :: dims1 = (/3,3/) ! Dataset dimensions - INTEGER(HSIZE_T), DIMENSION(2) :: dims2 = (/2,10/)! - INTEGER :: rank = 2 ! Datasets rank - - ! - ! Initialize dset1_data array. - ! - do i = 1, 3 - do j = 1, 3 - dset1_data(i,j) = j; - end do - end do - - - ! - ! Initialize dset2_data array. - ! - do i = 1, 2 - do j = 1, 10 - dset2_data(i,j) = j; - end do - end do - - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create group "MyGroup" in the root group using absolute name. - ! - CALL h5gcreate_f(file_id, groupname1, group1_id, error) - - ! - ! Create group "Group_A" in group "MyGroup" using relative name. - ! - CALL h5gcreate_f(group1_id, groupname2, group2_id, error) - - ! - ! Create the data space for the first dataset. - ! - CALL h5screate_simple_f(rank, dims1, dataspace1_id, error) - - ! - ! Create a dataset in group "MyGroup" with default properties. - ! - CALL h5dcreate_f(group1_id, dsetname1, H5T_NATIVE_INTEGER, dataspace1_id, & - dataset1_id, error) - - ! - ! Write the first dataset. - ! - CALL h5dwrite_f(dataset1_id, H5T_NATIVE_INTEGER, dset1_data, error) - - ! - ! Create the data space for the second dataset. - ! - CALL h5screate_simple_f(rank, dims2, dataspace2_id, error) - - ! - ! Create the second dataset in group "Group_A" with default properties - ! - CALL h5dcreate_f(group2_id, dsetname2, H5T_NATIVE_INTEGER, dataspace2_id, & - dataset2_id, error) - - ! - ! Write the second dataset - ! - CALL h5dwrite_f(dataset2_id, H5T_NATIVE_INTEGER, dset2_data, error) - - ! - ! Get number of members in the root group. - ! - CALL h5gn_members_f(file_id, "/", nmembers, error) - write(*,*) "Number of root group member is " , nmembers - - ! - ! Print each group member's name and type. - ! - do i = 0, nmembers - 1 - CALL h5gget_obj_info_idx_f(file_id, "/", i, name_buffer, type, & - error) - write(*,*) name_buffer, type - end do - - ! - ! Get number of members in MyGroup. - ! - CALL h5gn_members_f(file_id, "MyGroup", nmembers, error) - write(*,*) "Number of group MyGroup member is ", nmembers - - ! - ! Print each group member's name and type in "MyGroup" group. - ! - do i = 0, nmembers - 1 - CALL h5gget_obj_info_idx_f(file_id, groupname1, i, name_buffer, type, & - error) - write(*,*) name_buffer, type - end do - - - ! - ! Get number of members in MyGroup/Group_A. - ! - CALL h5gn_members_f(file_id, "MyGroup/Group_A", nmembers, error) - write(*,*) "Number of group MyGroup/Group_A member is ", nmembers - - ! - ! Print each group member's name and type in "MyGroup/Group_A" group. - ! - do i = 0, nmembers - 1 - CALL h5gget_obj_info_idx_f(file_id,"MyGroup/Group_A" , i, name_buffer, type, & - error) - write(*,*) name_buffer, type - end do - - ! - ! Close the dataspace for the first dataset. - ! - CALL h5sclose_f(dataspace1_id, error) - - ! - ! Close the first dataset. - ! - CALL h5dclose_f(dataset1_id, error) - - ! - ! Close the dataspace for the second dataset. - ! - CALL h5sclose_f(dataspace2_id, error) - - ! - ! Close the second dataset. - ! - CALL h5dclose_f(dataset2_id, error) - - ! - ! Close the groups. - ! - CALL h5gclose_f(group1_id, error) - - CALL h5gclose_f(group2_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM GRPITEXAMPLE diff --git a/doc/html/Tutor/examples/grpsexample.f90 b/doc/html/Tutor/examples/grpsexample.f90 deleted file mode 100644 index 4b53bf0..0000000 --- a/doc/html/Tutor/examples/grpsexample.f90 +++ /dev/null @@ -1,68 +0,0 @@ -! -! The following example code shows how to create groups -! using absolute and relative names. It creates three groups: -! the first two groups are created using the file identifier and -! the group absolute names, and the third group is created using -! a group identifier and the name relative to the specified group. -! - - - PROGRAM GRPSEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=10), PARAMETER :: filename = "groupsf.h5" ! File name - CHARACTER(LEN=8), PARAMETER :: groupname1 = "/MyGroup" ! Group name - CHARACTER(LEN=16), PARAMETER :: groupname2 = "/MyGroup/Group_A" - ! Group name - CHARACTER(LEN=7), PARAMETER :: groupname3 = "Group_B" ! Group name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: group1_id, group2_id, group3_id ! Group identifiers - - INTEGER :: error ! Error flag - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create group "MyGroup" in the root group using absolute name. - ! - CALL h5gcreate_f(file_id, groupname1, group1_id, error) - - ! - ! Create group "Group_A" in group "MyGroup" using absolute name. - ! - CALL h5gcreate_f(file_id, groupname2, group2_id, error) - - ! - ! Create group "Group_B" in group "MyGroup" using relative name. - ! - CALL h5gcreate_f(group1_id, groupname3, group3_id, error) - - ! - ! Close the groups. - ! - CALL h5gclose_f(group1_id, error) - CALL h5gclose_f(group2_id, error) - CALL h5gclose_f(group3_id, error) - - ! - ! Terminate access to the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM GRPSEXAMPLE diff --git a/doc/html/Tutor/examples/h5_compound.c b/doc/html/Tutor/examples/h5_compound.c deleted file mode 100644 index 4bb4ad1..0000000 --- a/doc/html/Tutor/examples/h5_compound.c +++ /dev/null @@ -1,153 +0,0 @@ -/* - * This example shows how to create a compound data type, - * write an array which has the compound data type to the file, - * and read back fields' subsets. - */ - -#include "hdf5.h" - -#define FILE "SDScompound.h5" -#define DATASETNAME "ArrayOfStructures" -#define LENGTH 10 -#define RANK 1 - -int -main(void) -{ - - /* First structure and dataset*/ - typedef struct s1_t { - int a; - float b; - double c; - } s1_t; - s1_t s1[LENGTH]; - hid_t s1_tid; /* File datatype identifier */ - - /* Second structure (subset of s1_t) and dataset*/ - typedef struct s2_t { - double c; - int a; - } s2_t; - s2_t s2[LENGTH]; - hid_t s2_tid; /* Memory datatype handle */ - - /* Third "structure" ( will be used to read float field of s1) */ - hid_t s3_tid; /* Memory datatype handle */ - float s3[LENGTH]; - - int i; - hid_t file, dataset, space; /* Handles */ - herr_t status; - hsize_t dim[] = {LENGTH}; /* Dataspace dimensions */ - - - /* - * Initialize the data - */ - for (i = 0; i< LENGTH; i++) { - s1[i].a = i; - s1[i].b = i*i; - s1[i].c = 1./(i+1); - } - - /* - * Create the data space. - */ - space = H5Screate_simple(RANK, dim, NULL); - - /* - * Create the file. - */ - file = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* - * Create the memory data type. - */ - s1_tid = H5Tcreate (H5T_COMPOUND, sizeof(s1_t)); - H5Tinsert(s1_tid, "a_name", HOFFSET(s1_t, a), H5T_NATIVE_INT); - H5Tinsert(s1_tid, "c_name", HOFFSET(s1_t, c), H5T_NATIVE_DOUBLE); - H5Tinsert(s1_tid, "b_name", HOFFSET(s1_t, b), H5T_NATIVE_FLOAT); - - /* - * Create the dataset. - */ - dataset = H5Dcreate(file, DATASETNAME, s1_tid, space, H5P_DEFAULT); - - /* - * Wtite data to the dataset; - */ - status = H5Dwrite(dataset, s1_tid, H5S_ALL, H5S_ALL, H5P_DEFAULT, s1); - - /* - * Release resources - */ - H5Tclose(s1_tid); - H5Sclose(space); - H5Dclose(dataset); - H5Fclose(file); - - /* - * Open the file and the dataset. - */ - file = H5Fopen(FILE, H5F_ACC_RDONLY, H5P_DEFAULT); - - dataset = H5Dopen(file, DATASETNAME); - - /* - * Create a data type for s2 - */ - s2_tid = H5Tcreate(H5T_COMPOUND, sizeof(s2_t)); - - H5Tinsert(s2_tid, "c_name", HOFFSET(s2_t, c), H5T_NATIVE_DOUBLE); - H5Tinsert(s2_tid, "a_name", HOFFSET(s2_t, a), H5T_NATIVE_INT); - - /* - * Read two fields c and a from s1 dataset. Fields in the file - * are found by their names "c_name" and "a_name". - */ - status = H5Dread(dataset, s2_tid, H5S_ALL, H5S_ALL, H5P_DEFAULT, s2); - - /* - * Display the fields - */ - printf("\n"); - printf("Field c : \n"); - for( i = 0; i < LENGTH; i++) printf("%.4f ", s2[i].c); - printf("\n"); - - printf("\n"); - printf("Field a : \n"); - for( i = 0; i < LENGTH; i++) printf("%d ", s2[i].a); - printf("\n"); - - /* - * Create a data type for s3. - */ - s3_tid = H5Tcreate(H5T_COMPOUND, sizeof(float)); - - status = H5Tinsert(s3_tid, "b_name", 0, H5T_NATIVE_FLOAT); - - /* - * Read field b from s1 dataset. Field in the file is found by its name. - */ - status = H5Dread(dataset, s3_tid, H5S_ALL, H5S_ALL, H5P_DEFAULT, s3); - - /* - * Display the field - */ - printf("\n"); - printf("Field b : \n"); - for( i = 0; i < LENGTH; i++) printf("%.4f ", s3[i]); - printf("\n"); - - /* - * Release resources - */ - H5Tclose(s2_tid); - H5Tclose(s3_tid); - H5Dclose(dataset); - H5Fclose(file); - - return 0; -} diff --git a/doc/html/Tutor/examples/h5_copy.c b/doc/html/Tutor/examples/h5_copy.c deleted file mode 100644 index 357596b..0000000 --- a/doc/html/Tutor/examples/h5_copy.c +++ /dev/null @@ -1,148 +0,0 @@ -/***********************************************************************/ -/* */ -/* PROGRAM: h5_copy.c */ -/* PURPOSE: Shows how to use the H5SCOPY function. */ -/* DESCRIPTION: */ -/* This program creates two files, copy1.h5, and copy2.h5. */ -/* In copy1.h5, it creates a 3x4 dataset called 'Copy1', */ -/* and write 0's to this dataset. */ -/* In copy2.h5, it create a 3x4 dataset called 'Copy2', */ -/* and write 1's to this dataset. */ -/* It closes both files, reopens both files, selects two */ -/* points in copy1.h5 and writes values to them. Then it */ -/* does an H5Scopy from the first file to the second, and */ -/* writes the values to copy2.h5. It then closes the */ -/* files, reopens them, and prints the contents of the */ -/* two datasets. */ -/* */ -/***********************************************************************/ - -#include "hdf5.h" -#define FILE1 "copy1.h5" -#define FILE2 "copy2.h5" - -#define RANK 2 -#define DIM1 3 -#define DIM2 4 -#define NUMP 2 - -int main (void) -{ - hid_t file1, file2, dataset1, dataset2; - hid_t mid1, mid2, fid1, fid2; - hsize_t fdim[] = {DIM1, DIM2}; - hsize_t mdim[] = {DIM1, DIM2}; - hsize_t start[2], stride[2], count[2], block[2]; - int buf1[DIM1][DIM2]; - int buf2[DIM1][DIM2]; - int bufnew[DIM1][DIM2]; - int val[] = {53, 59}; - hsize_t marray[] = {2}; - hsize_t coord[NUMP][RANK]; - herr_t ret; - uint i, j; - -/***********************************************************************/ -/* */ -/* Create two files containing identical datasets. Write 0's to one */ -/* and 1's to the other. */ -/* */ -/***********************************************************************/ - - for ( i = 0; i < DIM1; i++ ) - for ( j = 0; j < DIM2; j++ ) - buf1[i][j] = 0; - - for ( i = 0; i < DIM1; i++ ) - for ( j = 0; j < DIM2; j++ ) - buf2[i][j] = 1; - - file1 = H5Fcreate(FILE1, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - file2 = H5Fcreate(FILE2, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - fid1 = H5Screate_simple (RANK, fdim, NULL); - fid2 = H5Screate_simple (RANK, fdim, NULL); - - dataset1 = H5Dcreate (file1, "Copy1", H5T_NATIVE_INT, fid1, H5P_DEFAULT); - dataset2 = H5Dcreate (file2, "Copy2", H5T_NATIVE_INT, fid2, H5P_DEFAULT); - - ret = H5Dwrite(dataset1, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, buf1); - ret = H5Dwrite(dataset2, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, buf2); - - ret = H5Dclose (dataset1); - ret = H5Dclose (dataset2); - - ret = H5Sclose (fid1); - ret = H5Sclose (fid2); - - ret = H5Fclose (file1); - ret = H5Fclose (file2); - -/***********************************************************************/ -/* */ -/* Open the two files. Select two points in one file, write values to */ -/* those point locations, then do H5Scopy and write the values to the */ -/* other file. Close files. */ -/* */ -/***********************************************************************/ - - file1 = H5Fopen (FILE1, H5F_ACC_RDWR, H5P_DEFAULT); - file2 = H5Fopen (FILE2, H5F_ACC_RDWR, H5P_DEFAULT); - dataset1 = H5Dopen (file1, "Copy1"); - dataset2 = H5Dopen (file2, "Copy2"); - fid1 = H5Dget_space (dataset1); - mid1 = H5Screate_simple(1, marray, NULL); - coord[0][0] = 0; coord[0][1] = 3; - coord[1][0] = 0; coord[1][1] = 1; - - ret = H5Sselect_elements (fid1, H5S_SELECT_SET, NUMP, (const hsize_t **)coord); - - ret = H5Dwrite (dataset1, H5T_NATIVE_INT, mid1, fid1, H5P_DEFAULT, val); - - fid2 = H5Scopy (fid1); - - ret = H5Dwrite (dataset2, H5T_NATIVE_INT, mid1, fid2, H5P_DEFAULT, val); - - ret = H5Dclose (dataset1); - ret = H5Dclose (dataset2); - ret = H5Sclose (fid1); - ret = H5Sclose (fid2); - ret = H5Fclose (file1); - ret = H5Fclose (file2); - ret = H5Sclose (mid1); - -/***********************************************************************/ -/* */ -/* Open both files and print the contents of the datasets. */ -/* */ -/***********************************************************************/ - - file1 = H5Fopen (FILE1, H5F_ACC_RDWR, H5P_DEFAULT); - file2 = H5Fopen (FILE2, H5F_ACC_RDWR, H5P_DEFAULT); - dataset1 = H5Dopen (file1, "Copy1"); - dataset2 = H5Dopen (file2, "Copy2"); - - ret = H5Dread (dataset1, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, - H5P_DEFAULT, bufnew); - - printf ("\nDataset 'Copy1' in file 'copy1.h5' contains: \n"); - for (i=0;i<DIM1; i++) { - for (j=0;j<DIM2;j++) printf ("%3d ", bufnew[i][j]); - printf("\n"); - } - - printf ("\nDataset 'Copy2' in file 'copy2.h5' contains: \n"); - - ret = H5Dread (dataset2, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, - H5P_DEFAULT, bufnew); - - for (i=0;i<DIM1; i++) { - for (j=0;j<DIM2;j++) printf ("%3d ", bufnew[i][j]); - printf("\n"); - } - ret = H5Dclose (dataset1); - ret = H5Dclose (dataset2); - ret = H5Fclose (file1); - ret = H5Fclose (file2); - -} diff --git a/doc/html/Tutor/examples/h5_crtatt.c b/doc/html/Tutor/examples/h5_crtatt.c deleted file mode 100644 index a2b887c..0000000 --- a/doc/html/Tutor/examples/h5_crtatt.c +++ /dev/null @@ -1,46 +0,0 @@ -/* - * Creating a dataset attribute. - */ - -#include <hdf5.h> -#define FILE "dset.h5" - -main() { - - hid_t file_id, dataset_id, attribute_id, dataspace_id; /* identifiers */ - hsize_t dims; - int attr_data[2]; - herr_t status; - - /* Initialize the attribute data. */ - attr_data[0] = 100; - attr_data[1] = 200; - - /* Open an existing file. */ - file_id = H5Fopen(FILE, H5F_ACC_RDWR, H5P_DEFAULT); - - /* Open an existing dataset. */ - dataset_id = H5Dopen(file_id, "/dset"); - - /* Create the data space for the attribute. */ - dims = 2; - dataspace_id = H5Screate_simple(1, &dims, NULL); - - /* Create a dataset attribute. */ - attribute_id = H5Acreate(dataset_id, "attr", H5T_STD_I32BE, dataspace_id, H5P_DEFAULT); - - /* Write the attribute data. */ - status = H5Awrite(attribute_id, H5T_NATIVE_INT, attr_data); - - /* Close the attribute. */ - status = H5Aclose(attribute_id); - - /* Close the dataspace. */ - status = H5Sclose(dataspace_id); - - /* Close to the dataset. */ - status = H5Dclose(dataset_id); - - /* Close the file. */ - status = H5Fclose(file_id); -} diff --git a/doc/html/Tutor/examples/h5_crtdat.c b/doc/html/Tutor/examples/h5_crtdat.c deleted file mode 100644 index d704cf1..0000000 --- a/doc/html/Tutor/examples/h5_crtdat.c +++ /dev/null @@ -1,34 +0,0 @@ -/* - * Creating and closing a dataset. - */ - -#include <hdf5.h> -#define FILE "dset.h5" - -main() { - - hid_t file_id, dataset_id, dataspace_id; /* identifiers */ - hsize_t dims[2]; - herr_t status; - - /* Create a new file using default properties. */ - file_id = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create the data space for the dataset. */ - dims[0] = 4; - dims[1] = 6; - dataspace_id = H5Screate_simple(2, dims, NULL); - - /* Create the dataset. */ - dataset_id = H5Dcreate(file_id, "/dset", H5T_STD_I32BE, dataspace_id, H5P_DEFAULT); - - /* End access to the dataset and release resources used by it. */ - status = H5Dclose(dataset_id); - - /* Terminate access to the data space. */ - status = H5Sclose(dataspace_id); - - /* Close the file. */ - status = H5Fclose(file_id); -} - diff --git a/doc/html/Tutor/examples/h5_crtfile.c b/doc/html/Tutor/examples/h5_crtfile.c deleted file mode 100644 index 680cde8..0000000 --- a/doc/html/Tutor/examples/h5_crtfile.c +++ /dev/null @@ -1,19 +0,0 @@ -/* - * Creating and closing a file. - */ - -#include <hdf5.h> -#define FILE "file.h5" - -main() { - - hid_t file_id; /* file identifier */ - herr_t status; - - /* Create a new file using default properties. */ - file_id = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Terminate access to the file. */ - status = H5Fclose(file_id); -} - diff --git a/doc/html/Tutor/examples/h5_crtgrp.c b/doc/html/Tutor/examples/h5_crtgrp.c deleted file mode 100644 index a6aad93..0000000 --- a/doc/html/Tutor/examples/h5_crtgrp.c +++ /dev/null @@ -1,24 +0,0 @@ -/* - * Creating and closing a group. - */ - -#include <hdf5.h> -#define FILE "group.h5" - -main() { - - hid_t file_id, group_id; /* identifiers */ - herr_t status; - - /* Create a new file using default properties. */ - file_id = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create a group named "/MyGroup" in the file. */ - group_id = H5Gcreate(file_id, "/MyGroup", 0); - - /* Close the group. */ - status = H5Gclose(group_id); - - /* Terminate access to the file. */ - status = H5Fclose(file_id); -} diff --git a/doc/html/Tutor/examples/h5_crtgrpar.c b/doc/html/Tutor/examples/h5_crtgrpar.c deleted file mode 100644 index 6dcc003..0000000 --- a/doc/html/Tutor/examples/h5_crtgrpar.c +++ /dev/null @@ -1,32 +0,0 @@ -/* - * Creating groups using absolute and relative names. - */ - -#include <hdf5.h> -#define FILE "groups.h5" - -main() { - - hid_t file_id, group1_id, group2_id, group3_id; /* identifiers */ - herr_t status; - - /* Create a new file using default properties. */ - file_id = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create group "MyGroup" in the root group using absolute name. */ - group1_id = H5Gcreate(file_id, "/MyGroup", 0); - - /* Create group "Group_A" in group "MyGroup" using absolute name. */ - group2_id = H5Gcreate(file_id, "/MyGroup/Group_A", 0); - - /* Create group "Group_B" in group "MyGroup" using relative name. */ - group3_id = H5Gcreate(group1_id, "Group_B", 0); - - /* Close groups. */ - status = H5Gclose(group1_id); - status = H5Gclose(group2_id); - status = H5Gclose(group3_id); - - /* Close the file. */ - status = H5Fclose(file_id); -} diff --git a/doc/html/Tutor/examples/h5_crtgrpd.c b/doc/html/Tutor/examples/h5_crtgrpd.c deleted file mode 100644 index e497764..0000000 --- a/doc/html/Tutor/examples/h5_crtgrpd.c +++ /dev/null @@ -1,74 +0,0 @@ -/* - * Create two datasets within groups. - */ - -#include <hdf5.h> -#define FILE "groups.h5" - -main() { - - hid_t file_id, group_id, dataset_id, dataspace_id; /* identifiers */ - hsize_t dims[2]; - herr_t status; - int i, j, dset1_data[3][3], dset2_data[2][10]; - - /* Initialize the first dataset. */ - for (i = 0; i < 3; i++) - for (j = 0; j < 3; j++) - dset1_data[i][j] = j + 1; - - /* Initialize the second dataset. */ - for (i = 0; i < 2; i++) - for (j = 0; j < 10; j++) - dset2_data[i][j] = j + 1; - - /* Open an existing file. */ - file_id = H5Fopen(FILE, H5F_ACC_RDWR, H5P_DEFAULT); - - /* Create the data space for the first dataset. */ - dims[0] = 3; - dims[1] = 3; - dataspace_id = H5Screate_simple(2, dims, NULL); - - /* Create a dataset in group "MyGroup". */ - dataset_id = H5Dcreate(file_id, "/MyGroup/dset1", H5T_STD_I32BE, dataspace_id, - H5P_DEFAULT); - - /* Write the first dataset. */ - status = H5Dwrite(dataset_id, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, - dset1_data); - - /* Close the data space for the first dataset. */ - status = H5Sclose(dataspace_id); - - /* Close the first dataset. */ - status = H5Dclose(dataset_id); - - /* Open an existing group of the specified file. */ - group_id = H5Gopen(file_id, "/MyGroup/Group_A"); - - /* Create the data space for the second dataset. */ - dims[0] = 2; - dims[1] = 10; - dataspace_id = H5Screate_simple(2, dims, NULL); - - /* Create the second dataset in group "Group_A". */ - dataset_id = H5Dcreate(group_id, "dset2", H5T_STD_I32BE, dataspace_id, H5P_DEFAULT); - - /* Write the second dataset. */ - status = H5Dwrite(dataset_id, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, - dset2_data); - - /* Close the data space for the second dataset. */ - status = H5Sclose(dataspace_id); - - /* Close the second dataset */ - status = H5Dclose(dataset_id); - - /* Close the group. */ - status = H5Gclose(group_id); - - /* Close the file. */ - status = H5Fclose(file_id); -} - diff --git a/doc/html/Tutor/examples/h5_extend.c b/doc/html/Tutor/examples/h5_extend.c deleted file mode 100644 index 1f81827..0000000 --- a/doc/html/Tutor/examples/h5_extend.c +++ /dev/null @@ -1,141 +0,0 @@ -/************************************************************** - * - * This example shows how to work with extendible datasets. - * In the current version of the library a dataset MUST be - * chunked in order to be extendible. - * - * This example is derived from the h5_extend_write.c and - * h5_read_chunk.c examples that are in the "Introduction - * to HDF5". - * - *************************************************************/ - -#include "hdf5.h" - -#define FILE "ext.h5" -#define DATASETNAME "ExtendibleArray" -#define RANK 2 - -int -main (void) -{ - hid_t file; /* handles */ - hid_t dataspace, dataset; - hid_t filespace; - hid_t cparms; - hid_t memspace; - - hsize_t dims[2] = { 3, 3}; /* dataset dimensions - at creation time */ - hsize_t dims1[2] = { 3, 3}; /* data1 dimensions */ - hsize_t dims2[2] = { 7, 1}; /* data2 dimensions */ - - hsize_t maxdims[2] = {H5S_UNLIMITED, H5S_UNLIMITED}; - hsize_t size[2]; - hsize_t offset[2]; - hsize_t i,j; - herr_t status, status_n; - int data1[3][3] = { {1, 1, 1}, /* data to write */ - {1, 1, 1}, - {1, 1, 1} }; - - int data2[7] = { 2, 2, 2, 2, 2, 2, 2}; - - /* Variables used in reading data back */ - hsize_t chunk_dims[2] ={2, 5}; - hsize_t chunk_dimsr[2]; - hsize_t dimsr[2]; - int data_out[10][3]; - int rank, rank_chunk; - - /* Create the data space with unlimited dimensions. */ - dataspace = H5Screate_simple (RANK, dims, maxdims); - - /* Create a new file. If file exists its contents will be overwritten. */ - file = H5Fcreate (FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Modify dataset creation properties, i.e. enable chunking */ - cparms = H5Pcreate (H5P_DATASET_CREATE); - status = H5Pset_chunk ( cparms, RANK, chunk_dims); - - /* Create a new dataset within the file using cparms - creation properties. */ - dataset = H5Dcreate (file, DATASETNAME, H5T_NATIVE_INT, dataspace, - cparms); - - /* Extend the dataset. This call assures that dataset is 3 x 3.*/ - size[0] = 3; - size[1] = 3; - status = H5Dextend (dataset, size); - - /* Select a hyperslab */ - filespace = H5Dget_space (dataset); - offset[0] = 0; - offset[1] = 0; - status = H5Sselect_hyperslab (filespace, H5S_SELECT_SET, offset, NULL, - dims1, NULL); - - /* Write the data to the hyperslab */ - status = H5Dwrite (dataset, H5T_NATIVE_INT, dataspace, filespace, - H5P_DEFAULT, data1); - - /* Extend the dataset. Dataset becomes 10 x 3 */ - dims[0] = dims1[0] + dims2[0]; - size[0] = dims[0]; - size[1] = dims[1]; - status = H5Dextend (dataset, size); - - /* Select a hyperslab */ - filespace = H5Dget_space (dataset); - offset[0] = 3; - offset[1] = 0; - status = H5Sselect_hyperslab (filespace, H5S_SELECT_SET, offset, NULL, - dims2, NULL); - - /* Define memory space */ - dataspace = H5Screate_simple (RANK, dims2, NULL); - - /* Write the data to the hyperslab */ - status = H5Dwrite (dataset, H5T_NATIVE_INT, dataspace, filespace, - H5P_DEFAULT, data2); - - /* Close resources */ - status = H5Dclose (dataset); - status = H5Sclose (dataspace); - status = H5Sclose (filespace); - status = H5Fclose (file); - -/**************************************************************** - Read the data back - ***************************************************************/ - - file = H5Fopen (FILE, H5F_ACC_RDONLY, H5P_DEFAULT); - dataset = H5Dopen (file, DATASETNAME); - filespace = H5Dget_space (dataset); - rank = H5Sget_simple_extent_ndims (filespace); - status_n = H5Sget_simple_extent_dims (filespace, dimsr, NULL); - - cparms = H5Dget_create_plist (dataset); - if (H5D_CHUNKED == H5Pget_layout (cparms)) - { - rank_chunk = H5Pget_chunk (cparms, 2, chunk_dimsr); - } - - memspace = H5Screate_simple (rank,dimsr,NULL); - status = H5Dread (dataset, H5T_NATIVE_INT, memspace, filespace, - H5P_DEFAULT, data_out); - printf("\n"); - printf("Dataset: \n"); - for (j = 0; j < dimsr[0]; j++) - { - for (i = 0; i < dimsr[1]; i++) - printf("%d ", data_out[j][i]); - printf("\n"); - } - - status = H5Pclose (cparms); - status = H5Dclose (dataset); - status = H5Sclose (filespace); - status = H5Sclose (memspace); - status = H5Fclose (file); -} diff --git a/doc/html/Tutor/examples/h5_hyperslab.c b/doc/html/Tutor/examples/h5_hyperslab.c deleted file mode 100644 index 120e30d..0000000 --- a/doc/html/Tutor/examples/h5_hyperslab.c +++ /dev/null @@ -1,192 +0,0 @@ -/************************************************************ - - This example shows how to write and read a hyperslab. It - is derived from the h5_read.c and h5_write.c examples in - the "Introduction to HDF5". - - ************************************************************/ - -#include "hdf5.h" - -#define FILE "sds.h5" -#define DATASETNAME "IntArray" -#define NX_SUB 3 /* hyperslab dimensions */ -#define NY_SUB 4 -#define NX 7 /* output buffer dimensions */ -#define NY 7 -#define NZ 3 -#define RANK 2 -#define RANK_OUT 3 - -#define X 5 /* dataset dimensions */ -#define Y 6 - -int -main (void) -{ - hsize_t dimsf[2]; /* dataset dimensions */ - int data[X][Y]; /* data to write */ - - /* - * Data and output buffer initialization. - */ - hid_t file, dataset; /* handles */ - hid_t dataspace; - hid_t memspace; - hsize_t dimsm[3]; /* memory space dimensions */ - hsize_t dims_out[2]; /* dataset dimensions */ - herr_t status; - - int data_out[NX][NY][NZ ]; /* output buffer */ - - hsize_t count[2]; /* size of the hyperslab in the file */ - hsize_t offset[2]; /* hyperslab offset in the file */ - hsize_t count_out[3]; /* size of the hyperslab in memory */ - hsize_t offset_out[3]; /* hyperslab offset in memory */ - int i, j, k, status_n, rank; - - - -/********************************************************* - This writes data to the HDF5 file. - *********************************************************/ - - /* - * Data and output buffer initialization. - */ - for (j = 0; j < X; j++) { - for (i = 0; i < Y; i++) - data[j][i] = i + j; - } - /* - * 0 1 2 3 4 5 - * 1 2 3 4 5 6 - * 2 3 4 5 6 7 - * 3 4 5 6 7 8 - * 4 5 6 7 8 9 - */ - - /* - * Create a new file using H5F_ACC_TRUNC access, - * the default file creation properties, and the default file - * access properties. - */ - file = H5Fcreate (FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* - * Describe the size of the array and create the data space for fixed - * size dataset. - */ - dimsf[0] = X; - dimsf[1] = Y; - dataspace = H5Screate_simple (RANK, dimsf, NULL); - - /* - * Create a new dataset within the file using defined dataspace and - * default dataset creation properties. - */ - dataset = H5Dcreate (file, DATASETNAME, H5T_STD_I32BE, dataspace, - H5P_DEFAULT); - - /* - * Write the data to the dataset using default transfer properties. - */ - status = H5Dwrite (dataset, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, - H5P_DEFAULT, data); - - /* - * Close/release resources. - */ - H5Sclose (dataspace); - H5Dclose (dataset); - H5Fclose (file); - - -/************************************************************* - - This reads the hyperslab from the sds.h5 file just - created, into a 2-dimensional plane of the 3-dimensional - array. - - ************************************************************/ - - for (j = 0; j < NX; j++) { - for (i = 0; i < NY; i++) { - for (k = 0; k < NZ ; k++) - data_out[j][i][k] = 0; - } - } - - /* - * Open the file and the dataset. - */ - file = H5Fopen (FILE, H5F_ACC_RDONLY, H5P_DEFAULT); - dataset = H5Dopen (file, DATASETNAME); - - dataspace = H5Dget_space (dataset); /* dataspace handle */ - rank = H5Sget_simple_extent_ndims (dataspace); - status_n = H5Sget_simple_extent_dims (dataspace, dims_out, NULL); - printf("\nRank: %d\nDimensions: %lu x %lu \n", rank, - (unsigned long)(dims_out[0]), (unsigned long)(dims_out[1])); - - /* - * Define hyperslab in the dataset. - */ - offset[0] = 1; - offset[1] = 2; - count[0] = NX_SUB; - count[1] = NY_SUB; - status = H5Sselect_hyperslab (dataspace, H5S_SELECT_SET, offset, NULL, - count, NULL); - - /* - * Define the memory dataspace. - */ - dimsm[0] = NX; - dimsm[1] = NY; - dimsm[2] = NZ; - memspace = H5Screate_simple (RANK_OUT, dimsm, NULL); - - /* - * Define memory hyperslab. - */ - offset_out[0] = 3; - offset_out[1] = 0; - offset_out[2] = 0; - count_out[0] = NX_SUB; - count_out[1] = NY_SUB; - count_out[2] = 1; - status = H5Sselect_hyperslab (memspace, H5S_SELECT_SET, offset_out, NULL, - count_out, NULL); - - /* - * Read data from hyperslab in the file into the hyperslab in - * memory and display. - */ - status = H5Dread (dataset, H5T_NATIVE_INT, memspace, dataspace, - H5P_DEFAULT, data_out); - printf ("Data:\n "); - for (j = 0; j < NX; j++) { - for (i = 0; i < NY; i++) printf("%d ", data_out[j][i][0]); - printf("\n "); - } - printf("\n"); - /* - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 3 4 5 6 0 0 0 - * 4 5 6 7 0 0 0 - * 5 6 7 8 0 0 0 - * 0 0 0 0 0 0 0 - */ - - /* - * Close and release resources. - */ - H5Dclose (dataset); - H5Sclose (dataspace); - H5Sclose (memspace); - H5Fclose (file); - -} diff --git a/doc/html/Tutor/examples/h5_iterate.c b/doc/html/Tutor/examples/h5_iterate.c deleted file mode 100644 index db58183..0000000 --- a/doc/html/Tutor/examples/h5_iterate.c +++ /dev/null @@ -1,111 +0,0 @@ -#include <hdf5.h> - -#define FILE "iterate.h5" -#define FALSE 0 - -/* 1-D dataset with fixed dimensions */ -#define SPACE1_NAME "Space1" -#define SPACE1_RANK 1 -#define SPACE1_DIM1 4 - -herr_t file_info(hid_t loc_id, const char *name, void *opdata); - /* Operator function */ -int -main(void) { - hid_t file; /* HDF5 File IDs */ - hid_t dataset; /* Dataset ID */ - hid_t group; /* Group ID */ - hid_t sid; /* Dataspace ID */ - hid_t tid; /* Datatype ID */ - hsize_t dims[] = {SPACE1_DIM1}; - herr_t ret; /* Generic return value */ - -/* Compound datatype */ -typedef struct s1_t { - unsigned int a; - unsigned int b; - float c; -} s1_t; - - /* Create file */ - file = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create dataspace for datasets */ - sid = H5Screate_simple(SPACE1_RANK, dims, NULL); - - /* Create a group */ - group=H5Gcreate(file,"Group1",-1); - - /* Close a group */ - ret = H5Gclose(group); - - /* Create a dataset */ - dataset=H5Dcreate(file,"Dataset1",H5T_STD_U32LE,sid,H5P_DEFAULT); - - /* Close Dataset */ - ret = H5Dclose(dataset); - - /* Create a datatype */ - tid = H5Tcreate (H5T_COMPOUND, sizeof(s1_t)); - - /* Insert fields */ - ret=H5Tinsert (tid, "a", HOFFSET(s1_t,a), H5T_NATIVE_INT); - - ret=H5Tinsert (tid, "b", HOFFSET(s1_t,b), H5T_NATIVE_INT); - - ret=H5Tinsert (tid, "c", HOFFSET(s1_t,c), H5T_NATIVE_FLOAT); - - /* Save datatype for later */ - ret=H5Tcommit (file, "Datatype1", tid); - - /* Close datatype */ - ret = H5Tclose(tid); - - /* Iterate through the file to see members of the root group */ - - printf(" Objects in the root group are:\n"); - printf("\n"); - - H5Giterate(file, "/", NULL, file_info, NULL); - - /* Close file */ - ret = H5Fclose(file); - - return 0; -} - -/* - * Operator function. - */ -herr_t file_info(hid_t loc_id, const char *name, void *opdata) -{ - H5G_stat_t statbuf; - - /* - * Get type of the object and display its name and type. - * The name of the object is passed to this function by - * the Library. Some magic :-) - */ - H5Gget_objinfo(loc_id, name, FALSE, &statbuf); - switch (statbuf.type) { - case H5G_GROUP: - printf(" Object with name %s is a group \n", name); - break; - case H5G_DATASET: - printf(" Object with name %s is a dataset \n", name); - break; - case H5G_TYPE: - printf(" Object with name %s is a named datatype \n", name); - break; - default: - printf(" Unable to identify an object "); - } - return 0; - } - - - - - - - diff --git a/doc/html/Tutor/examples/h5_mount.c b/doc/html/Tutor/examples/h5_mount.c deleted file mode 100644 index 452ad6e..0000000 --- a/doc/html/Tutor/examples/h5_mount.c +++ /dev/null @@ -1,119 +0,0 @@ -/* - * This program shows the concept of "mounting files". - * Program creates one file with group G in it, and another - * file with dataset D. Then second file is mounted in the first one - * under the "mounting point" G. Dataset D is accessed in the first file - * under name /G/D and data is printed out. - */ - -#include<hdf5.h> - -#define FILE1 "mount1.h5" -#define FILE2 "mount2.h5" - -#define RANK 2 -#define NX 4 -#define NY 5 - -int main(void) -{ - - hid_t fid1, fid2, gid; /* Files and group identifiers */ - hid_t did, tid, sid; /* Dataset and datatype identifiers */ - - herr_t status; - hsize_t dims[] = {NX,NY}; /* Dataset dimensions */ - - int i, j; - int bm[NX][NY], bm_out[NX][NY]; /* Data buffers */ - - /* - * Initialization of buffer matrix "bm" - */ - for(i =0; i<NX; i++) { - for(j = 0; j<NY; j++) - bm[i][j] = i + j; - } - - /* - * Create first file and a group in it. - */ - fid1 = H5Fcreate(FILE1, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - gid = H5Gcreate(fid1, "/G", 0); - - /* - * Close group and file - */ - H5Gclose(gid); - H5Fclose(fid1); - - /* - * Create second file and dataset "D" in it. - */ - fid2 = H5Fcreate(FILE2, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - dims[0] = NX; - dims[1] = NY; - sid = H5Screate_simple(RANK, dims, NULL); - did = H5Dcreate(fid2, "D", H5T_NATIVE_INT, sid, H5P_DEFAULT); - - /* - * Write data to the dataset. - */ - status = H5Dwrite(did, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, bm); - - /* - * Close all identifiers. - */ - H5Sclose(sid); - H5Dclose(did); - H5Fclose(fid2); - - /* - * Reopen both files - */ - fid1 = H5Fopen(FILE1, H5F_ACC_RDONLY, H5P_DEFAULT); - fid2 = H5Fopen(FILE2, H5F_ACC_RDONLY, H5P_DEFAULT); - - /* - * Mount second file under G in the first file. - */ - H5Fmount(fid1, "/G", fid2, H5P_DEFAULT); - - /* - * Access dataset D in the first file under /G/D name. - */ - did = H5Dopen(fid1,"/G/D"); - tid = H5Dget_type(did); - status = H5Dread(did, tid, H5S_ALL, H5S_ALL, H5P_DEFAULT, bm_out); - - /* - * Print out the data. - */ - for(i=0; i<NX; i++){ - for(j=0; j<NY; j++) - printf(" %d", bm_out[i][j]); - printf("\n"); - } - - /* - * Close all identifers - */ - H5Tclose(tid); - H5Dclose(did); - - /* - * Unmounting second file - */ - H5Funmount(fid1, "/G"); - - /* - * Close both files - */ - H5Fclose(fid1); - H5Fclose(fid2); - - return 0; -} - - - diff --git a/doc/html/Tutor/examples/h5_rdwt.c b/doc/html/Tutor/examples/h5_rdwt.c deleted file mode 100644 index e651a29..0000000 --- a/doc/html/Tutor/examples/h5_rdwt.c +++ /dev/null @@ -1,37 +0,0 @@ -/* - * Writing and reading an existing dataset. - */ - -#include <hdf5.h> -#define FILE "dset.h5" - -main() { - - hid_t file_id, dataset_id; /* identifiers */ - herr_t status; - int i, j, dset_data[4][6]; - - /* Initialize the dataset. */ - for (i = 0; i < 4; i++) - for (j = 0; j < 6; j++) - dset_data[i][j] = i * 6 + j + 1; - - /* Open an existing file. */ - file_id = H5Fopen(FILE, H5F_ACC_RDWR, H5P_DEFAULT); - - /* Open an existing dataset. */ - dataset_id = H5Dopen(file_id, "/dset"); - - /* Write the dataset. */ - status = H5Dwrite(dataset_id, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, - dset_data); - - status = H5Dread(dataset_id, H5T_NATIVE_INT, H5S_ALL, H5S_ALL, H5P_DEFAULT, - dset_data); - - /* Close the dataset. */ - status = H5Dclose(dataset_id); - - /* Close the file. */ - status = H5Fclose(file_id); -} diff --git a/doc/html/Tutor/examples/h5_read.c b/doc/html/Tutor/examples/h5_read.c deleted file mode 100644 index 8f2f179..0000000 --- a/doc/html/Tutor/examples/h5_read.c +++ /dev/null @@ -1,136 +0,0 @@ -/* - * This example reads hyperslab from the SDS.h5 file - * created by h5_write.c program into two-dimensional - * plane of the three-dimensional array. - * Information about dataset in the SDS.h5 file is obtained. - */ - -#include "hdf5.h" - -#define FILE "SDS.h5" -#define DATASETNAME "IntArray" -#define NX_SUB 3 /* hyperslab dimensions */ -#define NY_SUB 4 -#define NX 7 /* output buffer dimensions */ -#define NY 7 -#define NZ 3 -#define RANK 2 -#define RANK_OUT 3 - -int -main (void) -{ - hid_t file, dataset; /* handles */ - hid_t datatype, dataspace; - hid_t memspace; - H5T_class_t class; /* data type class */ - H5T_order_t order; /* data order */ - size_t size; /* - * size of the data element - * stored in file - */ - hsize_t dimsm[3]; /* memory space dimensions */ - hsize_t dims_out[2]; /* dataset dimensions */ - herr_t status; - - int data_out[NX][NY][NZ ]; /* output buffer */ - - hsize_t count[2]; /* size of the hyperslab in the file */ - hsize_t offset[2]; /* hyperslab offset in the file */ - hsize_t count_out[3]; /* size of the hyperslab in memory */ - hsize_t offset_out[3]; /* hyperslab offset in memory */ - int i, j, k, status_n, rank; - - for (j = 0; j < NX; j++) { - for (i = 0; i < NY; i++) { - for (k = 0; k < NZ ; k++) - data_out[j][i][k] = 0; - } - } - - /* - * Open the file and the dataset. - */ - file = H5Fopen(FILE, H5F_ACC_RDONLY, H5P_DEFAULT); - dataset = H5Dopen(file, DATASETNAME); - - /* - * Get datatype and dataspace handles and then query - * dataset class, order, size, rank and dimensions. - */ - datatype = H5Dget_type(dataset); /* datatype handle */ - class = H5Tget_class(datatype); - if (class == H5T_INTEGER) printf("Data set has INTEGER type \n"); - order = H5Tget_order(datatype); - if (order == H5T_ORDER_LE) printf("Little endian order \n"); - - size = H5Tget_size(datatype); - printf(" Data size is %d \n", size); - - dataspace = H5Dget_space(dataset); /* dataspace handle */ - rank = H5Sget_simple_extent_ndims(dataspace); - status_n = H5Sget_simple_extent_dims(dataspace, dims_out, NULL); - printf("rank %d, dimensions %lu x %lu \n", rank, - (unsigned long)(dims_out[0]), (unsigned long)(dims_out[1])); - - /* - * Define hyperslab in the dataset. - */ - offset[0] = 1; - offset[1] = 2; - count[0] = NX_SUB; - count[1] = NY_SUB; - status = H5Sselect_hyperslab(dataspace, H5S_SELECT_SET, offset, NULL, - count, NULL); - - /* - * Define the memory dataspace. - */ - dimsm[0] = NX; - dimsm[1] = NY; - dimsm[2] = NZ ; - memspace = H5Screate_simple(RANK_OUT,dimsm,NULL); - - /* - * Define memory hyperslab. - */ - offset_out[0] = 3; - offset_out[1] = 0; - offset_out[2] = 0; - count_out[0] = NX_SUB; - count_out[1] = NY_SUB; - count_out[2] = 1; - status = H5Sselect_hyperslab(memspace, H5S_SELECT_SET, offset_out, NULL, - count_out, NULL); - - /* - * Read data from hyperslab in the file into the hyperslab in - * memory and display. - */ - status = H5Dread(dataset, H5T_NATIVE_INT, memspace, dataspace, - H5P_DEFAULT, data_out); - for (j = 0; j < NX; j++) { - for (i = 0; i < NY; i++) printf("%d ", data_out[j][i][0]); - printf("\n"); - } - /* - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 3 4 5 6 0 0 0 - * 4 5 6 7 0 0 0 - * 5 6 7 8 0 0 0 - * 0 0 0 0 0 0 0 - */ - - /* - * Close/release resources. - */ - H5Tclose(datatype); - H5Dclose(dataset); - H5Sclose(dataspace); - H5Sclose(memspace); - H5Fclose(file); - - return 0; -} diff --git a/doc/html/Tutor/examples/h5_ref2objr.c b/doc/html/Tutor/examples/h5_ref2objr.c deleted file mode 100644 index a226778..0000000 --- a/doc/html/Tutor/examples/h5_ref2objr.c +++ /dev/null @@ -1,93 +0,0 @@ -#include <stdlib.h> -#include <hdf5.h> - -#define FILE1 "trefer1.h5" - -/* dataset with fixed dimensions */ -#define SPACE1_NAME "Space1" -#define SPACE1_RANK 1 -#define SPACE1_DIM1 4 - -int -main(void) -{ - hid_t fid1; /* HDF5 File IDs */ - hid_t dataset, /* Dataset ID */ - dset2; /* Dereferenced dataset ID */ - hid_t group; /* Group ID */ - hid_t sid1; /* Dataspace ID */ - hid_t tid1; /* Datatype ID */ - hobj_ref_t *rbuf; /* buffer to read from disk */ - int *tu32; /* temp. buffer read from disk */ - int i; /* counting variables */ - char read_comment[10]; - herr_t ret; /* Generic return value */ - - /* Allocate read buffers */ - rbuf = malloc(sizeof(hobj_ref_t)*SPACE1_DIM1); - tu32 = malloc(sizeof(int)*SPACE1_DIM1); - - /* Open the file */ - fid1 = H5Fopen(FILE1, H5F_ACC_RDWR, H5P_DEFAULT); - - /* Open the dataset */ - dataset=H5Dopen(fid1,"/Dataset3"); - - /* Read selection from disk */ - ret=H5Dread(dataset,H5T_STD_REF_OBJ,H5S_ALL,H5S_ALL,H5P_DEFAULT,rbuf); - - /* Open dataset object */ - dset2 = H5Rdereference(dataset,H5R_OBJECT,&rbuf[0]); - - /* Check information in referenced dataset */ - sid1 = H5Dget_space(dset2); - - ret=H5Sget_simple_extent_npoints(sid1); - - /* Read from disk */ - ret=H5Dread(dset2,H5T_NATIVE_INT,H5S_ALL,H5S_ALL,H5P_DEFAULT,tu32); - printf("Dataset data : \n"); - for (i=0; i < SPACE1_DIM1 ; i++) printf (" %d ", tu32[i]); - printf("\n"); - printf("\n"); - - /* Close dereferenced Dataset */ - ret = H5Dclose(dset2); - - /* Open group object */ - group = H5Rdereference(dataset,H5R_OBJECT,&rbuf[2]); - - /* Get group's comment */ - ret=H5Gget_comment(group,".",10,read_comment); - printf("Group comment is %s \n", read_comment); - printf(" \n"); - /* Close group */ - ret = H5Gclose(group); - - /* Open datatype object */ - tid1 = H5Rdereference(dataset,H5R_OBJECT,&rbuf[3]); - - /* Verify correct datatype */ - { - H5T_class_t tclass; - - tclass= H5Tget_class(tid1); - if ((tclass == H5T_COMPOUND)) - printf ("Number of compound datatype members is %d \n", H5Tget_nmembers(tid1)); - printf(" \n"); - } - - /* Close datatype */ - ret = H5Tclose(tid1); - - /* Close Dataset */ - ret = H5Dclose(dataset); - - /* Close file */ - ret = H5Fclose(fid1); - - /* Free memory buffers */ - free(rbuf); - free(tu32); - return 0; -} diff --git a/doc/html/Tutor/examples/h5_ref2objw.c b/doc/html/Tutor/examples/h5_ref2objw.c deleted file mode 100644 index d499f8e..0000000 --- a/doc/html/Tutor/examples/h5_ref2objw.c +++ /dev/null @@ -1,120 +0,0 @@ - -#include <hdf5.h> - -#define FILE1 "trefer1.h5" - -/* 1-D dataset with fixed dimensions */ -#define SPACE1_NAME "Space1" -#define SPACE1_RANK 1 -#define SPACE1_DIM1 4 - -/* 2-D dataset with fixed dimensions */ -#define SPACE2_NAME "Space2" -#define SPACE2_RANK 2 -#define SPACE2_DIM1 10 -#define SPACE2_DIM2 10 - -int -main(void) { - hid_t fid1; /* HDF5 File IDs */ - hid_t dataset; /* Dataset ID */ - hid_t group; /* Group ID */ - hid_t sid1; /* Dataspace ID */ - hid_t tid1; /* Datatype ID */ - hsize_t dims1[] = {SPACE1_DIM1}; - hobj_ref_t *wbuf; /* buffer to write to disk */ - int *tu32; /* Temporary pointer to int data */ - int i; /* counting variables */ - const char *write_comment="Foo!"; /* Comments for group */ - herr_t ret; /* Generic return value */ - -/* Compound datatype */ -typedef struct s1_t { - unsigned int a; - unsigned int b; - float c; -} s1_t; - - /* Allocate write buffers */ - wbuf=(hobj_ref_t *)malloc(sizeof(hobj_ref_t)*SPACE1_DIM1); - tu32=malloc(sizeof(int)*SPACE1_DIM1); - - /* Create file */ - fid1 = H5Fcreate(FILE1, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create dataspace for datasets */ - sid1 = H5Screate_simple(SPACE1_RANK, dims1, NULL); - - /* Create a group */ - group=H5Gcreate(fid1,"Group1",-1); - - /* Set group's comment */ - ret=H5Gset_comment(group,".",write_comment); - - /* Create a dataset (inside Group1) */ - dataset=H5Dcreate(group,"Dataset1",H5T_STD_U32LE,sid1,H5P_DEFAULT); - - for(i=0; i<SPACE1_DIM1; i++) - tu32[i] = i*3; - - /* Write selection to disk */ - ret=H5Dwrite(dataset,H5T_NATIVE_INT,H5S_ALL,H5S_ALL,H5P_DEFAULT,tu32); - - /* Close Dataset */ - ret = H5Dclose(dataset); - - /* Create another dataset (inside Group1) */ - dataset=H5Dcreate(group,"Dataset2",H5T_NATIVE_UCHAR,sid1,H5P_DEFAULT); - - /* Close Dataset */ - ret = H5Dclose(dataset); - - /* Create a datatype to refer to */ - tid1 = H5Tcreate (H5T_COMPOUND, sizeof(s1_t)); - - /* Insert fields */ - ret=H5Tinsert (tid1, "a", HOFFSET(s1_t,a), H5T_NATIVE_INT); - - ret=H5Tinsert (tid1, "b", HOFFSET(s1_t,b), H5T_NATIVE_INT); - - ret=H5Tinsert (tid1, "c", HOFFSET(s1_t,c), H5T_NATIVE_FLOAT); - - /* Save datatype for later */ - ret=H5Tcommit (group, "Datatype1", tid1); - - /* Close datatype */ - ret = H5Tclose(tid1); - - /* Close group */ - ret = H5Gclose(group); - - /* Create a dataset to store references */ - dataset=H5Dcreate(fid1,"Dataset3",H5T_STD_REF_OBJ,sid1,H5P_DEFAULT); - - /* Create reference to dataset */ - ret = H5Rcreate(&wbuf[0],fid1,"/Group1/Dataset1",H5R_OBJECT,-1); - - /* Create reference to dataset */ - ret = H5Rcreate(&wbuf[1],fid1,"/Group1/Dataset2",H5R_OBJECT,-1); - - /* Create reference to group */ - ret = H5Rcreate(&wbuf[2],fid1,"/Group1",H5R_OBJECT,-1); - - /* Create reference to named datatype */ - ret = H5Rcreate(&wbuf[3],fid1,"/Group1/Datatype1",H5R_OBJECT,-1); - - /* Write selection to disk */ - ret=H5Dwrite(dataset,H5T_STD_REF_OBJ,H5S_ALL,H5S_ALL,H5P_DEFAULT,wbuf); - - /* Close disk dataspace */ - ret = H5Sclose(sid1); - - /* Close Dataset */ - ret = H5Dclose(dataset); - - /* Close file */ - ret = H5Fclose(fid1); - free(wbuf); - free(tu32); - return 0; -} diff --git a/doc/html/Tutor/examples/h5_ref2regr.c b/doc/html/Tutor/examples/h5_ref2regr.c deleted file mode 100644 index 9f747ae..0000000 --- a/doc/html/Tutor/examples/h5_ref2regr.c +++ /dev/null @@ -1,119 +0,0 @@ -#include <stdlib.h> -#include <hdf5.h> - -#define FILE2 "trefer2.h5" -#define NPOINTS 10 - -/* 1-D dataset with fixed dimensions */ -#define SPACE1_NAME "Space1" -#define SPACE1_RANK 1 -#define SPACE1_DIM1 4 - -/* 2-D dataset with fixed dimensions */ -#define SPACE2_NAME "Space2" -#define SPACE2_RANK 2 -#define SPACE2_DIM1 10 -#define SPACE2_DIM2 10 - -int -main(void) -{ - hid_t fid1; /* HDF5 File IDs */ - hid_t dset1, /* Dataset ID */ - dset2; /* Dereferenced dataset ID */ - hid_t sid1, /* Dataspace ID #1 */ - sid2; /* Dataspace ID #2 */ - hsize_t * coords; /* Coordinate buffer */ - hsize_t low[SPACE2_RANK]; /* Selection bounds */ - hsize_t high[SPACE2_RANK]; /* Selection bounds */ - hdset_reg_ref_t *rbuf; /* buffer to to read disk */ - int *drbuf; /* Buffer for reading numeric data from disk */ - int i, j; /* counting variables */ - herr_t ret; /* Generic return value */ - - /* Output message about test being performed */ - - /* Allocate write & read buffers */ - rbuf=malloc(sizeof(hdset_reg_ref_t)*SPACE1_DIM1); - drbuf=calloc(sizeof(int),SPACE2_DIM1*SPACE2_DIM2); - - /* Open the file */ - fid1 = H5Fopen(FILE2, H5F_ACC_RDWR, H5P_DEFAULT); - - /* Open the dataset */ - dset1=H5Dopen(fid1,"/Dataset1"); - - /* Read selection from disk */ - ret=H5Dread(dset1,H5T_STD_REF_DSETREG,H5S_ALL,H5S_ALL,H5P_DEFAULT,rbuf); - - /* Try to open objects */ - dset2 = H5Rdereference(dset1,H5R_DATASET_REGION,&rbuf[0]); - - /* Check information in referenced dataset */ - sid1 = H5Dget_space(dset2); - - ret=H5Sget_simple_extent_npoints(sid1); - printf(" Number of elements in the dataset is : %d\n",ret); - - /* Read from disk */ - ret=H5Dread(dset2,H5T_NATIVE_INT,H5S_ALL,H5S_ALL,H5P_DEFAULT,drbuf); - - for(i=0; i<SPACE2_DIM1; i++) { - for (j=0; j<SPACE2_DIM2; j++) printf (" %d ", drbuf[i*SPACE2_DIM2+j]); - printf("\n"); } - - /* Get the hyperslab selection */ - sid2=H5Rget_region(dset1,H5R_DATASET_REGION,&rbuf[0]); - - /* Verify correct hyperslab selected */ - ret = H5Sget_select_npoints(sid2); - printf(" Number of elements in the hyperslab is : %d \n", ret); - ret = H5Sget_select_hyper_nblocks(sid2); - coords=malloc(ret*SPACE2_RANK*sizeof(hsize_t)*2); /* allocate space for the hyperslab blocks */ - ret = H5Sget_select_hyper_blocklist(sid2,0,ret,coords); - printf(" Hyperslab coordinates are : \n"); - printf (" ( %lu , %lu ) ( %lu , %lu ) \n", \ -(unsigned long)coords[0],(unsigned long)coords[1],(unsigned long)coords[2],(unsigned long)coords[3]); - free(coords); - ret = H5Sget_select_bounds(sid2,low,high); - - /* Close region space */ - ret = H5Sclose(sid2); - - /* Get the element selection */ - sid2=H5Rget_region(dset1,H5R_DATASET_REGION,&rbuf[1]); - - /* Verify correct elements selected */ - ret = H5Sget_select_elem_npoints(sid2); - printf(" Number of selected elements is : %d\n", ret); - - /* Allocate space for the element points */ - coords= malloc(ret*SPACE2_RANK*sizeof(hsize_t)); - ret = H5Sget_select_elem_pointlist(sid2,0,ret,coords); - printf(" Coordinates of selected elements are : \n"); - for (i=0; i<2*NPOINTS; i=i+2) - printf(" ( %lu , %lu ) \n", (unsigned long)coords[i],(unsigned long)coords[i+1]); - - free(coords); - ret = H5Sget_select_bounds(sid2,low,high); - - /* Close region space */ - ret = H5Sclose(sid2); - - /* Close first space */ - ret = H5Sclose(sid1); - - /* Close dereferenced Dataset */ - ret = H5Dclose(dset2); - - /* Close Dataset */ - ret = H5Dclose(dset1); - - /* Close file */ - ret = H5Fclose(fid1); - - /* Free memory buffers */ - free(rbuf); - free(drbuf); - return 0; -} diff --git a/doc/html/Tutor/examples/h5_ref2regw.c b/doc/html/Tutor/examples/h5_ref2regw.c deleted file mode 100644 index 35352f8..0000000 --- a/doc/html/Tutor/examples/h5_ref2regw.c +++ /dev/null @@ -1,112 +0,0 @@ -#include <stdlib.h> -#include <hdf5.h> - -#define FILE2 "trefer2.h5" -#define SPACE1_NAME "Space1" -#define SPACE1_RANK 1 -#define SPACE1_DIM1 4 - -/* Dataset with fixed dimensions */ -#define SPACE2_NAME "Space2" -#define SPACE2_RANK 2 -#define SPACE2_DIM1 10 -#define SPACE2_DIM2 10 - -/* Element selection information */ -#define POINT1_NPOINTS 10 - -int -main(void) -{ - hid_t fid1; /* HDF5 File IDs */ - hid_t dset1, /* Dataset ID */ - dset2; /* Dereferenced dataset ID */ - hid_t sid1, /* Dataspace ID #1 */ - sid2; /* Dataspace ID #2 */ - hsize_t dims1[] = {SPACE1_DIM1}, - dims2[] = {SPACE2_DIM1, SPACE2_DIM2}; - hsize_t start[SPACE2_RANK]; /* Starting location of hyperslab */ - hsize_t stride[SPACE2_RANK]; /* Stride of hyperslab */ - hsize_t count[SPACE2_RANK]; /* Element count of hyperslab */ - hsize_t block[SPACE2_RANK]; /* Block size of hyperslab */ - hsize_t coord1[POINT1_NPOINTS][SPACE2_RANK]; - /* Coordinates for point selection */ - hdset_reg_ref_t *wbuf; /* buffer to write to disk */ - int *dwbuf; /* Buffer for writing numeric data to disk */ - int i; /* counting variables */ - herr_t ret; /* Generic return value */ - - - /* Allocate write & read buffers */ - wbuf=calloc(sizeof(hdset_reg_ref_t), SPACE1_DIM1); - dwbuf=malloc(sizeof(int)*SPACE2_DIM1*SPACE2_DIM2); - - /* Create file */ - fid1 = H5Fcreate(FILE2, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* Create dataspace for datasets */ - sid2 = H5Screate_simple(SPACE2_RANK, dims2, NULL); - - /* Create a dataset */ - dset2=H5Dcreate(fid1,"Dataset2",H5T_STD_U8LE,sid2,H5P_DEFAULT); - - for(i=0; i<SPACE2_DIM1*SPACE2_DIM2; i++) - dwbuf[i]=i*3; - - /* Write selection to disk */ - ret=H5Dwrite(dset2,H5T_NATIVE_INT,H5S_ALL,H5S_ALL,H5P_DEFAULT,dwbuf); - - /* Close Dataset */ - ret = H5Dclose(dset2); - - /* Create dataspace for the reference dataset */ - sid1 = H5Screate_simple(SPACE1_RANK, dims1, NULL); - - /* Create a dataset */ - dset1=H5Dcreate(fid1,"Dataset1",H5T_STD_REF_DSETREG,sid1,H5P_DEFAULT); - - /* Create references */ - - /* Select 6x6 hyperslab for first reference */ - start[0]=2; start[1]=2; - stride[0]=1; stride[1]=1; - count[0]=6; count[1]=6; - block[0]=1; block[1]=1; - ret = H5Sselect_hyperslab(sid2,H5S_SELECT_SET,start,stride,count,block); - - /* Store first dataset region */ - ret = H5Rcreate(&wbuf[0],fid1,"/Dataset2",H5R_DATASET_REGION,sid2); - - /* Select sequence of ten points for second reference */ - coord1[0][0]=6; coord1[0][1]=9; - coord1[1][0]=2; coord1[1][1]=2; - coord1[2][0]=8; coord1[2][1]=4; - coord1[3][0]=1; coord1[3][1]=6; - coord1[4][0]=2; coord1[4][1]=8; - coord1[5][0]=3; coord1[5][1]=2; - coord1[6][0]=0; coord1[6][1]=4; - coord1[7][0]=9; coord1[7][1]=0; - coord1[8][0]=7; coord1[8][1]=1; - coord1[9][0]=3; coord1[9][1]=3; - ret = H5Sselect_elements(sid2,H5S_SELECT_SET,POINT1_NPOINTS,(const hsize_t **)coord1); - - /* Store second dataset region */ - ret = H5Rcreate(&wbuf[1],fid1,"/Dataset2",H5R_DATASET_REGION,sid2); - - /* Write selection to disk */ - ret=H5Dwrite(dset1,H5T_STD_REF_DSETREG,H5S_ALL,H5S_ALL,H5P_DEFAULT,wbuf); - - /* Close all objects */ - ret = H5Sclose(sid1); - ret = H5Dclose(dset1); - ret = H5Sclose(sid2); - - /* Close file */ - ret = H5Fclose(fid1); - - free(wbuf); - free(dwbuf); - return 0; -} - - diff --git a/doc/html/Tutor/examples/h5_reference.c b/doc/html/Tutor/examples/h5_reference.c deleted file mode 100644 index a69afe2..0000000 --- a/doc/html/Tutor/examples/h5_reference.c +++ /dev/null @@ -1,146 +0,0 @@ - /* - * This program illustrates how references to the objects can be used. - * Program creates two datasets in the file. It also creates the third - * dataset, and references to the first two datasets are stored in it. - * Program reopens the file and reads dataset with the references. - * References are used to open first two datasets and read datatspace - * and datatype information about them. - * - */ - -#include<hdf5.h> - -#define FILE "refere.h5" - -int -main(void) { - hid_t fid; /* File, datasets, datatypes and */ - hid_t did_a, sid_a; /* dataspaces identifiers for three */ - hid_t did_b, tid_b, sid_b; /* datasets. */ - hid_t did_r, tid_r, sid_r; - herr_t status; - - hobj_ref_t *wbuf; /* buffer to write to disk */ - hobj_ref_t *rbuf; /* buffer to read from disk */ - - - hsize_t dim_r[1]; - hsize_t dim_a[1]; - hsize_t dim_b[2]; - - herr_t ret; /* return values */ - - /* - * Create a file using default properties. - */ - fid = H5Fcreate(FILE, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT); - - /* - * Create dataset "A" in the file. - */ - dim_a[0] = 5; - sid_a = H5Screate_simple(1, dim_a, NULL); - did_a = H5Dcreate(fid, "A", H5T_NATIVE_INT, sid_a, H5P_DEFAULT); - - /* - * Create dataset "B" in the file. - */ - dim_b[0] = 2; - dim_b[1] = 6; - sid_b = H5Screate_simple(2, dim_b, NULL); - did_b = H5Dcreate(fid, "B", H5T_NATIVE_FLOAT, sid_b, H5P_DEFAULT); - - /* - * Create dataset "R" to store references to the datasets "A" and "B". - */ - dim_r[0] = 2; - sid_r = H5Screate_simple(1, dim_r, NULL); - tid_r = H5Tcopy(H5T_STD_REF_OBJ); - did_r = H5Dcreate(fid, "R", tid_r, sid_r, H5P_DEFAULT ); - - /* - * Allocate write and read buffers. - */ - wbuf = malloc(sizeof(hobj_ref_t)*2); - rbuf = malloc(sizeof(hobj_ref_t)*2); - - /* - * Create references to the datasets "A" and "B" - * and store them in the wbuf. - */ - H5Rcreate(&wbuf[0], fid, "A", H5R_OBJECT, -1); - H5Rcreate(&wbuf[1], fid, "B", H5R_OBJECT, -1); - - /* - * Write dataset R using default transfer properties. - */ - status = H5Dwrite(did_r, H5T_STD_REF_OBJ, H5S_ALL, H5S_ALL, - H5P_DEFAULT, wbuf); - - /* - * Close all objects. - */ - H5Sclose(sid_a); - H5Dclose(did_a); - - H5Sclose(sid_b); - H5Dclose(did_b); - - H5Tclose(tid_r); - H5Sclose(sid_r); - H5Dclose(did_r); - - H5Fclose(fid); - - /* - * Reopen the file. - */ - fid = H5Fopen(FILE, H5F_ACC_RDWR, H5P_DEFAULT); - - /* - * Open and read dataset "R". - */ - did_r = H5Dopen(fid, "R"); - status = H5Dread(did_r, H5T_STD_REF_OBJ, H5S_ALL, H5S_ALL, - H5P_DEFAULT, rbuf); - - /* - * Open dataset A using reference to it. - */ - did_a = H5Rdereference(did_r, H5R_OBJECT, &rbuf[0]); - - /* - * Get rank of the dataset "A" - */ - - printf("\n"); - sid_a = H5Dget_space(did_a); - ret = H5Sget_simple_extent_ndims(sid_a); - - if(ret == 1) printf("Rank of A is %d.\n", ret); - printf("\n"); - - /* - * Get datatype of the dataset "B" - */ - did_b = H5Rdereference(did_r, H5R_OBJECT, &rbuf[1]); - tid_b = H5Dget_type(did_b); - if(H5Tequal(tid_b, H5T_NATIVE_FLOAT)) - printf("Datatype of B is H5T_NATIVE_FLOAT.\n"); - printf("\n"); - - /* - * Close all objects. - */ - H5Dclose(did_a); - H5Sclose(sid_a); - H5Dclose(did_b); - H5Tclose(tid_b); - H5Fclose(fid); - - return 0; - - } - - - diff --git a/doc/html/Tutor/examples/hyperslab.f90 b/doc/html/Tutor/examples/hyperslab.f90 deleted file mode 100644 index e49f18b..0000000 --- a/doc/html/Tutor/examples/hyperslab.f90 +++ /dev/null @@ -1,199 +0,0 @@ -! -! This example shows how to write and read a hyperslab. -! - - PROGRAM SELECTEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=7), PARAMETER :: filename = "sdsf.h5" ! File name - CHARACTER(LEN=8), PARAMETER :: dsetname = "IntArray" ! Dataset name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - INTEGER(HID_T) :: dataspace ! Dataspace identifier - INTEGER(HID_T) :: memspace ! memspace identifier - - INTEGER(HSIZE_T), DIMENSION(3) :: dimsm = (/7,7,3/) ! Dataset dimensions - ! in memory - INTEGER(HSIZE_T), DIMENSION(2) :: dims_out ! Buffer to read in dataset - ! dimesions - INTEGER(HSIZE_T), DIMENSION(2) :: dimsf = (/5,6/) ! Dataset dimensions. - - INTEGER(HSIZE_T), DIMENSION(2) :: count = (/3,4/) - ! Size of the hyperslab in the file - INTEGER(HSIZE_T), DIMENSION(2) :: offset = (/1,2/) - !hyperslab offset in the file - INTEGER(HSIZE_T), DIMENSION(3) :: count_out = (/3,4,1/) - !Size of the hyperslab in memory - INTEGER(HSIZE_T), DIMENSION(3) :: offset_out = (/3,0,0/) - !hyperslab offset in memory - INTEGER, DIMENSION(5,6) :: data ! Data to write - INTEGER, DIMENSION(7,7,3) :: data_out ! Output buffer - INTEGER :: dsetrank = 2 ! Dataset rank ( in file ) - INTEGER :: memrank = 3 ! Dataset rank ( in memory ) - INTEGER :: rank - INTEGER :: i, j, k - - INTEGER :: error, error_n ! Error flags - - - ! - ! Write data to the HDF5 file. - ! - - ! - ! Data initialization. - ! - do i = 1, 5 - do j = 1, 6 - data(i,j) = (i-1) + (j-1); - end do - end do - ! - ! 0, 1, 2, 3, 4, 5 - ! 1, 2, 3, 4, 5, 6 - ! 2, 3, 4, 5, 6, 7 - ! 3, 4, 5, 6, 7, 8 - ! 4, 5, 6, 7, 8, 9 - ! - - ! - ! Initialize FORTRAN predefined datatypes - ! - CALL h5open_f(error) - - ! - ! Create a new file using default properties. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - - ! - ! Create the data space for the dataset. - ! - CALL h5screate_simple_f(dsetrank, dimsf, dataspace, error) - - ! - ! Create the dataset with default properties. - ! - CALL h5dcreate_f(file_id, dsetname, H5T_NATIVE_INTEGER, dataspace, & - dset_id, error) - - ! - ! Write the dataset. - ! - CALL h5dwrite_f(dset_id, H5T_NATIVE_INTEGER, data, error) - - ! - ! Close the dataspace for the dataset. - ! - CALL h5sclose_f(dataspace, error) - - ! - ! Close the dataset. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! This part of the code reads the hyperslab from the sds.h5 file just - ! created, into a 2-dimensional plane of the 3-dimensional dataset. - ! - - ! - ! Initialize data_out array. - ! - do i = 1, 7 - do j = 1, 7 - do k = 1,3 - data_out(i,j,k) = 0; - end do - end do - end do - - ! - ! Open the file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDONLY_F, file_id, error) - - ! - ! Open the dataset. - ! - CALL h5dopen_f(file_id, dsetname, dset_id, error) - - ! - ! Get dataset's dataspace identifier. - ! - CALL h5dget_space_f(dset_id, dataspace, error) - - ! - ! Select hyperslab in the dataset. - ! - CALL h5sselect_hyperslab_f(dataspace, H5S_SELECT_SET_F, & - offset, count, error) - ! - ! Create memory dataspace. - ! - CALL h5screate_simple_f(memrank, dimsm, memspace, error) - - ! - ! Select hyperslab in memory. - ! - CALL h5sselect_hyperslab_f(memspace, H5S_SELECT_SET_F, & - offset_out, count_out, error) - - ! - ! Read data from hyperslab in the file into the hyperslab in - ! memory and display. - ! - CALL H5Dread_f(dset_id, H5T_NATIVE_INTEGER, data_out, error, & - memspace, dataspace) - - ! - ! Display data_out array - ! - do i = 1, 7 - print *, (data_out(i,j,1), j = 1,7) - end do - - ! 0 0 0 0 0 0 0 - ! 0 0 0 0 0 0 0 - ! 0 0 0 0 0 0 0 - ! 3 4 5 6 0 0 0 - ! 4 5 6 7 0 0 0 - ! 5 6 7 8 0 0 0 - ! 0 0 0 0 0 0 0 - ! - - ! - ! Close the dataspace for the dataset. - ! - CALL h5sclose_f(dataspace, error) - - ! - ! Close the memoryspace. - ! - CALL h5sclose_f(memspace, error) - - ! - ! Close the dataset. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM SELECTEXAMPLE diff --git a/doc/html/Tutor/examples/java/Compound.java b/doc/html/Tutor/examples/java/Compound.java deleted file mode 100644 index 219e1c1..0000000 --- a/doc/html/Tutor/examples/java/Compound.java +++ /dev/null @@ -1,540 +0,0 @@ -/****************************************************************** - * Compound.java (for HDF5 tutorial lesson 11) - * - * -- Creating a compound data type - * (a java conversion from compound.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class Compound -{ - public static void main (String []argv) - { - final String FILE = "SDScompound.h5"; - final String DATASETNAME = "ArrayOfStructures"; - final int LENGTH = 10; - final int RANK = 1; - - /* First structure and dataset */ - /* an array of LENGTH 'complex' numbers */ - byte[] data1 = new byte[LENGTH * 16]; - - int[] AR = new int[1]; - float[] BR = new float[1]; - double[] CR = new double[1]; - - byte [] ARec = new byte[4]; - byte [] BRec = new byte[4]; - byte [] CRec = new byte[8]; - - int s1_tid; /* File datatype identifier */ - - /* Second structure (subset of s1_t) and dataset*/ - byte[] data2 = new byte[LENGTH * 12]; - int s2_tid; /* Memory datatype handle */ - - /* Third "structure" ( will be used to read float field of s1) */ - int s3_tid; /* Memory datatype handle */ - float[] s3 = new float[LENGTH]; - - int i; - int file, dataset, space; /* Handles */ - int status; - long[] dim = new long[1]; /* Dataspace dimensions */ - dim[0] = LENGTH; - - /* - * Initialize the data - */ - for (i = 0; i < LENGTH; i++) - { - AR[0] = (int) i; - BR[0] = (float) i * i; - CR[0] = (double) 1. / (i + 1); - - ARec = HDFNativeData.intToByte (0, 1, AR); - BRec = HDFNativeData.floatToByte (0, 1, BR); - CRec = HDFNativeData.doubleToByte (0, 1, CR); - - System.arraycopy (ARec, 0, data1, (i * 16), 4); - System.arraycopy (BRec, 0, data1, (i * 16) + 4, 4); - System.arraycopy (CRec, 0, data1, (i * 16) + 8, 8); - } - - /* - * Create the data space. - */ - space = H5Screate_simple_wrap (RANK, dim, null); - - /* - * Create the file. - */ - file = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - /* - * Create the memory data type. - */ - s1_tid = H5Tcreate_wrap (HDF5Constants.H5T_COMPOUND, 16); - H5Tinsert_wrap (s1_tid, "a_name", 0, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT)); - H5Tinsert_wrap (s1_tid, "b_name", 4, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_FLOAT)); - H5Tinsert_wrap (s1_tid, "c_name", 8, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_DOUBLE)); - - /* - * Create the dataset. - */ - dataset = H5Dcreate_wrap (file, DATASETNAME, s1_tid, - space, HDF5Constants.H5P_DEFAULT); - - /* - * Wtite data to the dataset; - */ - status = H5Dwrite_wrap (dataset, s1_tid, - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, data1); - - /* - * Release resources - */ - H5Tclose_wrap (s1_tid); - H5Sclose_wrap (space); - H5Dclose_wrap (dataset); - H5Fclose_wrap (file); - - /* - * Open the file and the dataset. - */ - file = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDONLY, - HDF5Constants.H5P_DEFAULT); - - dataset = H5Dopen_wrap (file, DATASETNAME); - - /* - * Create a data type for s2 - */ - s2_tid = H5Tcreate_wrap (HDF5Constants.H5T_COMPOUND, 12); - H5Tinsert_wrap (s2_tid, "c_name", 0, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_DOUBLE)); - H5Tinsert_wrap (s2_tid, "a_name", 8, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT)); - - /* - * Read two fields c and a from s1 dataset. Fields in the file - * are found by their names "c_name" and "a_name". - */ - status = H5Dread_wrap (dataset, s2_tid, HDF5Constants.H5S_ALL, - HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, data2); - - /* - * Display the fields. Convert from bytes into numbers. - */ - System.out.println ("\nField c : "); - for( i = 0; i < LENGTH; i++) { - System.arraycopy (data2, (i*12), CRec, 0, 8); - CR = HDFNativeData.byteToDouble(0, 1, CRec); - System.out.print (CR[0]+" "); - } - System.out.println (); - - System.out.println("\nField a :"); - for( i = 0; i < LENGTH; i++) { - System.arraycopy (data2, (i*12)+8, ARec, 0, 4); - AR = HDFNativeData.byteToInt(0, 1, ARec); - System.out.print (AR[0]+" "); - } - System.out.println (); - - /* - * Create a data type for s3. - */ - s3_tid = H5Tcreate_wrap (HDF5Constants.H5T_COMPOUND, 4); - - status = - H5Tinsert_wrap (s3_tid, "b_name", 0, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_FLOAT)); - - /* - * Read field b from s1 dataset. Field in the file is found by its name. - */ - status = H5Dread_wrap (dataset, s3_tid, HDF5Constants.H5S_ALL, - HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, s3); - - /* - * Display the field. Data is read directly into array of 'float'. - */ - System.out.println (); - System.out.println ("Field b :"); - for( i = 0; i < LENGTH; i++) { - System.out.print (s3[i]+" "); - } - System.out.println (); - - /* - * Release resources - */ - H5Tclose_wrap (s2_tid); - H5Tclose_wrap (s3_tid); - H5Dclose_wrap (dataset); - H5Fclose_wrap (file); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for adding another member to the compound - // datatype datatype_id. - public static int H5Tinsert_wrap (int type_id, String name, - long offset, int field_id) - { - int status = -1; - try - { - // Adding another member to the compound datatype datatype_id. - status = H5.H5Tinsert (type_id, name, offset, field_id); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Tinsert_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Tinsert_wrap() with HDF5Exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for creating the memory data type. - public static int H5Tcreate_wrap (int dclass, int size) - { - int datatype_id = -1; // memory data type identifier - try - { - // Create the memory data type. - datatype_id = H5.H5Tcreate (dclass, size); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Tcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Tcreate_wrap() with other Exception: " - + e.getMessage()); - } - return datatype_id; - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing dataset - public static int H5Dopen_wrap (int loc_id, String name) - { - int dataset_id = -1; // dataset identifier - - try - { - // Opening an existing dataset - dataset_id = H5.H5Dopen (loc_id, name); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Dopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Dopen_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for creating a new simple dataspace and opening it - // for access - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for creating a dataset - public static int H5Dcreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist_id) - { - int dataset_id = -1; // dataset identifier - - try - { - // Create the dataset - dataset_id = H5.H5Dcreate (loc_id, name, type_id, space_id, - create_plist_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Dcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Dcreate_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for writing the dataset - public static int H5Dwrite_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object buf) - { - int status = -1; - - try - { - // Write the dataset. - status = H5.H5Dwrite (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Dwrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Dwrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for reading the dataset - public static int H5Dread_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object obj) - { - int status = -1; - - try - { - // Read the dataset. - status = H5.H5Dread (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, obj); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Dread_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Dread_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - - // Help function for terminating access to the data space. - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for releasing a datatype. - public static int H5Tclose_wrap (int type_id) - { - int status = -1; - - try - { - // Releasing a datatype. - status = H5.H5Tclose (type_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Tclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Tclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Compound.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Compound.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/Copy.java b/doc/html/Tutor/examples/java/Copy.java deleted file mode 100644 index f174210..0000000 --- a/doc/html/Tutor/examples/java/Copy.java +++ /dev/null @@ -1,541 +0,0 @@ -/****************************************************************** - * Copy.java (for HDF5 tutorial lesson 13) - * - * -- Showing how to use the H5SCOPY function. - * (a java conversion from h5_copy.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class Copy -{ - public static void main (String []argv) - { - final String FILE1 = "copy1.h5"; - final String FILE2 = "copy2.h5"; - - final int RANK = 2; - final int DIM1 = 3; - final int DIM2 = 4; - final int NUMP = 2; - - int file1, file2, dataset1, dataset2; - int mid1, mid2, fid1, fid2; - long[] fdim = new long[2]; - fdim[0] = DIM1; - fdim[1] = DIM2; - long[] mdim = new long[2]; - fdim[0] = DIM1; - fdim[1] = DIM2; - - long[] start = new long[2]; - long[] stride = new long[2]; - long[] count = new long[2]; - long[] block = new long[2]; - - int[][] buf1 = new int[DIM1][DIM2]; - int[][] buf2 = new int[DIM1][DIM2]; - int[][] bufnew = new int[DIM1][DIM2]; - - int[] val = new int[2]; - val[0] = 53; - val[1] = 59; - - long[] marray = {2}; - long[][] coord = new long[NUMP][RANK]; - int ret; - int i, j; - - -/***********************************************************************/ -/* */ -/* Create two files containing identical datasets. Write 0's to one */ -/* and 1's to the other. */ -/* */ -/***********************************************************************/ - - for ( i = 0; i < DIM1; i++ ) - for ( j = 0; j < DIM2; j++ ) - buf1[i][j] = 0; - - for ( i = 0; i < DIM1; i++ ) - for ( j = 0; j < DIM2; j++ ) - buf2[i][j] = 1; - - file1 = H5Fcreate_wrap (FILE1, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - file2 = H5Fcreate_wrap (FILE2, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - fid1 = H5Screate_simple_wrap (RANK, fdim, null); - fid2 = H5Screate_simple_wrap (RANK, fdim, null); - - dataset1 = H5Dcreate_wrap - (file1, "Copy1", H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), fid1, - HDF5Constants.H5P_DEFAULT); - - dataset2 = H5Dcreate_wrap - (file2, "Copy2", H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), fid2, - HDF5Constants.H5P_DEFAULT); - - - ret = H5Dwrite_wrap (dataset1, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, buf1); - - ret = H5Dwrite_wrap (dataset2, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, buf2); - - ret = H5Dclose_wrap (dataset1); - ret = H5Dclose_wrap (dataset2); - - ret = H5Sclose_wrap (fid1); - ret = H5Sclose_wrap (fid2); - - ret = H5Fclose_wrap (file1); - ret = H5Fclose_wrap (file2); - - -/***********************************************************************/ -/* */ -/* Open the two files. Select two points in one file, write values to */ -/* those point locations, then do H5Scopy and write the values to the */ -/* other file. Close files. */ -/* */ -/***********************************************************************/ - - file1 = H5Fopen_wrap (FILE1, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - - file2 = H5Fopen_wrap (FILE2, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - - dataset1 = H5Dopen_wrap (file1, "Copy1"); - dataset2 = H5Dopen_wrap (file2, "Copy2"); - - fid1 = H5Dget_space_wrap (dataset1); - mid1 = H5Screate_simple_wrap (1, marray, null); - - coord[0][0] = 0; coord[0][1] = 3; - coord[1][0] = 0; coord[1][1] = 1; - - ret = H5Sselect_elements_wrap (fid1, HDF5Constants.H5S_SELECT_SET, - NUMP, coord); - - ret = H5Dwrite_wrap (dataset1, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - mid1, fid1, HDF5Constants.H5P_DEFAULT, val); - - fid2 = H5Scopy_wrap (fid1); - - ret = H5Dwrite_wrap (dataset2, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - mid1, fid2, HDF5Constants.H5P_DEFAULT, val); - - ret = H5Dclose_wrap (dataset1); - ret = H5Dclose_wrap (dataset2); - ret = H5Sclose_wrap (fid1); - ret = H5Sclose_wrap (fid2); - ret = H5Fclose_wrap (file1); - ret = H5Fclose_wrap (file2); - ret = H5Sclose_wrap (mid1); - - -/***********************************************************************/ -/* */ -/* Open both files and print the contents of the datasets. */ -/* */ -/***********************************************************************/ - - file1 = H5Fopen_wrap (FILE1, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - file2 = H5Fopen_wrap (FILE2, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - dataset1 = H5Dopen_wrap (file1, "Copy1"); - dataset2 = H5Dopen_wrap (file2, "Copy2"); - - ret = H5Dread_wrap (dataset1, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, bufnew); - - System.out.println ("\nDataset 'Copy1' in file 'copy1.h5' contains: "); - - for (i = 0;i < DIM1; i++) - { - for (j = 0;j < DIM2; j++) - System.out.print (bufnew[i][j]); - System.out.println (); - } - - System.out.println ("\nDataset 'Copy2' in file 'copy2.h5' contains: "); - - ret = H5Dread_wrap (dataset2, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, bufnew); - - for (i = 0;i < DIM1; i++) - { - for (j = 0;j < DIM2; j++) - System.out.print (bufnew[i][j]); - System.out.println (); - } - - ret = H5Dclose_wrap (dataset1); - ret = H5Dclose_wrap (dataset2); - ret = H5Fclose_wrap (file1); - ret = H5Fclose_wrap (file2); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing dataset - public static int H5Dopen_wrap (int loc_id, String name) - { - int dataset_id = -1; // dataset identifier - - try - { - // Opening an existing dataset - dataset_id = H5.H5Dopen (loc_id, name); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dopen_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for creating a new simple dataspace and opening it - // for access - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for getting an identifier for a copy of - // the dataspace for a dataset - public static int H5Dget_space_wrap (int dataset_id) - { - int dataspace_id = -1; - - try - { - // Returning an identifier for a copy of the dataspace for a dataset - dataspace_id = H5.H5Dget_space (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dget_space_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dget_space_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for selecting array elements to be included in - // the selection for the space_id dataspace. - public static int H5Sselect_elements_wrap (int space_id, int op, - int num_elements, - long coord2D[][]) - { - int status = -1; - - try - { - status = H5.H5Sselect_elements (space_id, op, num_elements, - coord2D); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Sselect_elements_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Sselect_elements_wrap() with other Exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for creating a new dataspace which is an exact - // copy of the dataspace identified by space_id. - public static int H5Scopy_wrap (int space_id) - { - int dataspace_id = -1; - - try - { - dataspace_id = H5.H5Scopy(space_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println ("Copy.H5Scopy_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println ("Copy.H5Scopy_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for creating a dataset - public static int H5Dcreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist_id) - { - int dataset_id = -1; // dataset identifier - - try - { - // Create the dataset - dataset_id = H5.H5Dcreate (loc_id, name, type_id, space_id, - create_plist_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dcreate_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for writing the dataset - public static int H5Dwrite_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object buf) - { - int status = -1; - - try - { - // Write the dataset. - status = H5.H5Dwrite (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dwrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dwrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for reading the dataset - public static int H5Dread_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object obj) - { - int status = -1; - - try - { - // Read the dataset. - status = H5.H5Dread (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, obj); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dread_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dread_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the data space. - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("Copy.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("Copy.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/CreateAttribute.java b/doc/html/Tutor/examples/java/CreateAttribute.java deleted file mode 100644 index c926422..0000000 --- a/doc/html/Tutor/examples/java/CreateAttribute.java +++ /dev/null @@ -1,302 +0,0 @@ -/****************************************************************** - * CreateAttribute.java (for HDF5 tutorial lesson 7) - * - * -- Creating and Writing a dataset attribute - * (a java conversion from h5_crtatt.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateAttribute -{ - public static void main(String []argv) - { - final String FILE = "dset.h5"; - int file_id = -1; // file identifier - int dataset_id = -1; // dataset identifier - int attribute_id = -1; - int dataspace_id = -1; // dataspace identifier - long[] dims = new long[1]; - int[] attr_data = new int[2]; - int status = -1; - - // Initialize the attribute data. - attr_data[0] = 100; - attr_data[1] = 200; - - // Open an existing file. - file_id = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - - // Open an existing dataset. - dataset_id = H5Dopen_wrap (file_id, "/dset"); - - // Create the data space for the attribute. - dims[0] = 2; - dataspace_id = H5Screate_simple_wrap (1, dims, null); - - // Create a dataset attribute. - attribute_id = H5Acreate_wrap - (dataset_id, "attr", - H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), - dataspace_id, HDF5Constants.H5P_DEFAULT); - - // Write the attribute data. - status = H5Awrite_wrap - (attribute_id, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - attr_data); - - // Close the attribute. - status = H5Aclose_wrap (attribute_id); - - // Close the dataspace. - status = H5Sclose_wrap (dataspace_id); - - // Close to the dataset. - status = H5Dclose_wrap (dataset_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing dataset - public static int H5Dopen_wrap (int loc_id, String name) - { - int dataset_id = -1; // dataset identifier - - try - { - // Opening an existing dataset - dataset_id = H5.H5Dopen (loc_id, name); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Dopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Dopen_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Create the data space for the attribute. - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for creating a dataset attribute. - public static int H5Acreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist) - { - int attribute_id = -1; // attribute identifier - - try - { - // Create the dataset - attribute_id = H5.H5Acreate (loc_id, name, type_id, space_id, - create_plist); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Acreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Acreate_wrap() with other Exception: " - + e.getMessage()); - } - return attribute_id; - } - - - // Help function for writing the attribute data. - public static int H5Awrite_wrap (int attr_id, int mem_type_id, - Object buf) - { - int status = -1; - - try - { - // Write the attribute data. - status = H5.H5Awrite (attr_id, mem_type_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Awrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Awrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for closing the attribute - public static int H5Aclose_wrap (int attribute_id) - { - int status = -1; - - try - { - // Close the dataset - status = H5.H5Aclose (attribute_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Aclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Aclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for closing the dataset - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // Close the dataset - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for closing the dataspace - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateAttribute.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateAttribute.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/CreateDataset.java b/doc/html/Tutor/examples/java/CreateDataset.java deleted file mode 100644 index 05f3f6b..0000000 --- a/doc/html/Tutor/examples/java/CreateDataset.java +++ /dev/null @@ -1,210 +0,0 @@ -/****************************************************************** - * CreateDataset.java (for HDF5 tutorial lesson 5) - * - * -- Creating a HDF5 Dataset - * (a java conversion from h5_crtdat.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateDataset -{ - public static void main(String []argv) - { - final String FILE = "dset.h5"; - int file_id = -1; // file identifier - int dataset_id = -1; // dataset identifier - int dataspace_id = -1; // dataspace identifier - long[] dims = new long[2]; - int status = -1; - - // Create a new file using default properties. - file_id = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - // Create the data space for the dataset. - dims[0] = 4; - dims[1] = 6; - dataspace_id = H5Screate_simple_wrap (2, dims, null); - - // Create the dataset. - dataset_id = - H5Dcreate_wrap (file_id, "/dset", - H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), - dataspace_id, HDF5Constants.H5P_DEFAULT); - - // End access to the dataset and release resources used by it. - status = H5Dclose_wrap (dataset_id); - - // Terminate access to the data space. - status = H5Sclose_wrap (dataspace_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for creating a new simple dataspace and opening it - // for access - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for creating a dataset - public static int H5Dcreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist_id) - { - int dataset_id = -1; // dataset identifier - - try - { - // Create the dataset - dataset_id = H5.H5Dcreate (loc_id, name, type_id, space_id, - create_plist_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Dcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Dcreate_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the data space. - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateDataset.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateDataset.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} - diff --git a/doc/html/Tutor/examples/java/CreateFile.java b/doc/html/Tutor/examples/java/CreateFile.java deleted file mode 100644 index 550b263..0000000 --- a/doc/html/Tutor/examples/java/CreateFile.java +++ /dev/null @@ -1,83 +0,0 @@ -/****************************************************************** - * CreateFile.java (for HDF5 tutorial lesson 4) - * - * -- Creating a HDF5 file - * (a java conversion from h5_crtfile.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateFile -{ - public static void main(String []argv) - { - final String FILE = "file.h5"; - int file_id = -1; // file identifier - int status = -1; - - file_id = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - status = H5Fclose_wrap (file_id); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateFile.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateFile.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - - System.out.println ("\nThe file name is: " + name); - System.out.println ("The file ID is: " + file_id); - - return file_id; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateFile.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateFile.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} - - diff --git a/doc/html/Tutor/examples/java/CreateFileInput.java b/doc/html/Tutor/examples/java/CreateFileInput.java deleted file mode 100644 index 0e7fd4d..0000000 --- a/doc/html/Tutor/examples/java/CreateFileInput.java +++ /dev/null @@ -1,118 +0,0 @@ -/****************************************************************** - * CreateFileInput.java (for HDF5 tutorial Lesson 4) - * - * -- Creating a HDF5 file - * (another java conversion from h5_crtfile.c, give user two options: - * one for library path and one for file name, if user chooses - * nothing, then the default file name is used.) - * - ******************************************************************/ - -import java.lang.System; -import java.util.*; -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateFileInput -{ - // The run command should be like: - // "./runCreateFileInput -l /usr/lib/hdf5.dll -f ./open.h5" - public static void main(String []argv) - { - int file_id = -1; // file identifier - int status = -1; - String libpath = null; - String filename = null; - - for (int i = 0; i < argv.length; i++) - { - if ("-l".equalsIgnoreCase (argv[i])) - libpath = argv[++i]; - - if ("-f".equalsIgnoreCase (argv[i])) - filename = argv[++i]; - } - - if (libpath != null) - { - Properties pros = System.getProperties (); - pros.put (H5.H5PATH_PROPERTY_KEY, libpath); - - /* - this function call could be used in Java 1.2 - System.setProperty (H5.H5PATH_PROPERTY_KEY, libpath); - */ - } - - if (filename == null) - { - filename = "file.h5"; // if no input file name, use the default name - } - - file_id = H5Fcreate_wrap (filename, - HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - status = H5Fclose_wrap (filename, file_id); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateFileInput.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateFileInput.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - - System.out.println ("\nThe file name is: " + name); - System.out.println ("The file ID is: " + file_id); - - return file_id; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (String name, int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateFileInput.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateFileInput.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - - return status; - } -} - - diff --git a/doc/html/Tutor/examples/java/CreateGroup.java b/doc/html/Tutor/examples/java/CreateGroup.java deleted file mode 100644 index 48ef4af..0000000 --- a/doc/html/Tutor/examples/java/CreateGroup.java +++ /dev/null @@ -1,139 +0,0 @@ -/****************************************************************** - * CreateGroup.java (for HDF5 tutorial lesson 8) - * - * -- Creating and closing a group - * (a java conversion from h5_crtgrp.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateGroup -{ - public static void main(String []argv) - { - final String FILE = "group.h5"; - int file_id = -1; // file identifier - int group_id = -1; // group identifier - int status = -1; - - // Create a new file using default properties. - file_id = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - // Create a group named "/MyGroup" in the file. - group_id = H5Gcreate_wrap (file_id, "/MyGroup", 0); - - // Close the group. - status = H5Gclose_wrap (group_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroup.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroup.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for creating a group named "/MyGroup" in the file. - public static int H5Gcreate_wrap (int loc_id, String name, int size_hint) - { - int group_id = -1; // group identifier - try - { - // Create a group - group_id = H5.H5Gcreate (loc_id, name, size_hint); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroup.H5Gcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroup.H5Gcreate_wrap() with other Exception: " - + e.getMessage()); - } - return group_id; - } - - - // Help function for closing the group - public static int H5Gclose_wrap (int group_id) - { - int status = -1; - - try - { - // Close the group - status = H5.H5Gclose (group_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroup.H5Gclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroup.H5Gclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroup.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroup.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/CreateGroupAR.java b/doc/html/Tutor/examples/java/CreateGroupAR.java deleted file mode 100644 index 672f1d1..0000000 --- a/doc/html/Tutor/examples/java/CreateGroupAR.java +++ /dev/null @@ -1,152 +0,0 @@ -/****************************************************************** - * CreateGroupAR.java (for HDF5 tutorial lesson 9) - * - * -- Creating groups using absolute and relative names. - * (a java conversion from h5_crtgrpar.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateGroupAR -{ - public static void main(String []argv) - { - final String FILE = "groups.h5"; - int file_id = -1; // file identifier - int group1_id = -1; // group identifier - int group2_id = -1; - int group3_id = -1; - - int status = -1; - - // Create a new file using default properties. - file_id = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - // Create group "MyGroup" in the root group using absolute name. - group1_id = H5Gcreate_wrap (file_id, "/MyGroup", 0); - - - // Create group "Group_A" in group "MyGroup" using absolute name. - group2_id = H5Gcreate_wrap (file_id, "/MyGroup/Group_A", 0); - - // Create group "Group_B" in group "MyGroup" using relative name. - group3_id = H5Gcreate_wrap (group1_id, "Group_B", 0); - - // Close groups. - status = H5Gclose_wrap (group1_id); - status = H5Gclose_wrap (group2_id); - status = H5Gclose_wrap (group3_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupAR.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupAR.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for creating a group named "/MyGroup" in the file. - public static int H5Gcreate_wrap (int loc_id, String name, int size_hint) - { - int group_id = -1; // group identifier - try - { - // Create a group - group_id = H5.H5Gcreate (loc_id, name, size_hint); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupAR.H5Gcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupAR.H5Gcreate_wrap() with other Exception: " - + e.getMessage()); - } - return group_id; - } - - - // Help function for closing the group - public static int H5Gclose_wrap (int group_id) - { - int status = -1; - - try - { - // Close the group - status = H5.H5Gclose (group_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupAR.H5Gclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupAR.H5Gclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupAR.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupAR.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/CreateGroupDataset.java b/doc/html/Tutor/examples/java/CreateGroupDataset.java deleted file mode 100644 index f0fbeaa..0000000 --- a/doc/html/Tutor/examples/java/CreateGroupDataset.java +++ /dev/null @@ -1,340 +0,0 @@ -/****************************************************************** - * CreateGroupDataset.java (for HDF5 tutorial lesson 10) - * - * -- Creating a dataset in a particular group - * (a java conversion from h5_crtgrpd.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class CreateGroupDataset -{ - public static void main(String []argv) - { - final String FILE = "groups.h5"; - int file_id = -1; // file identifier - int group_id = -1; // group identifier - int dataset_id; - int dataspace_id; - int status = -1; - - long[] dims = new long[2]; - int[][] dset1_data = new int[3][3]; - int[][] dset2_data = new int[2][10]; - int i = -1, j = -1; - - // Initialize the first dataset. - for (i = 0; i < 3; i++) - for (j = 0; j < 3; j++) - dset1_data[i][j] = j + 1; - - // Initialize the second dataset. - for (i = 0; i < 2; i++) - for (j = 0; j < 10; j++) - dset2_data[i][j] = j + 1; - - // Open an existing file. - file_id = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - - // Create the data space for the first dataset. - dims[0] = 3; - dims[1] = 3; - dataspace_id = H5Screate_simple_wrap (2, dims, null); - - // Create a dataset in group "MyGroup". - dataset_id = - H5Dcreate_wrap (file_id, "/MyGroup/dset1", - H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), - dataspace_id, HDF5Constants.H5P_DEFAULT); - - // Write the first dataset. - status = H5Dwrite_wrap - (dataset_id, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, dset1_data); - - // Close the data space for the first dataset. - status = H5Sclose_wrap (dataspace_id); - - // Close the first dataset. - status = H5Dclose_wrap (dataset_id); - - // Open an existing group of the specified file. - group_id = H5Gopen_wrap (file_id, "/MyGroup/Group_A"); - - // Create the data space for the second dataset. - dims[0] = 2; - dims[1] = 10; - dataspace_id = H5Screate_simple_wrap (2, dims, null); - - // Create the second dataset in group "Group_A". - dataset_id = - H5Dcreate_wrap (group_id, "dset2", - H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), - dataspace_id, HDF5Constants.H5P_DEFAULT); - - // Write the second dataset. - status = H5Dwrite_wrap - (dataset_id, - H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, dset2_data); - - // Close the data space for the second dataset. - status = H5Sclose_wrap (dataspace_id); - - // Close the second dataset - status = H5Dclose_wrap (dataset_id); - - // Close the group. - status = H5Gclose_wrap (group_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for creating a new simple dataspace and opening it - // for access - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for creating a dataset - public static int H5Dcreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist_id) - { - int dataset_id = -1; // dataset identifier - - try - { - // Create the dataset - dataset_id = H5.H5Dcreate (loc_id, name, type_id, space_id, - create_plist_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Dcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Dcreate_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for writing the dataset - public static int H5Dwrite_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object buf) - { - int status = -1; - - try - { - // Write the dataset. - status = H5.H5Dwrite (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Dwrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Dwrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the data space. - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for opening a group - public static int H5Gopen_wrap (int loc_id, String name) - { - int group_id = -1; // group identifier - try - { - // Create a group - group_id = H5.H5Gopen (loc_id, name); - - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Gopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Gopen_wrap() with other Exception: " - + e.getMessage()); - } - return group_id; - } - - - // Help function for closing the group - public static int H5Gclose_wrap (int group_id) - { - int status = -1; - - try - { - // Close the group - status = H5.H5Gclose (group_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Gclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Gclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("CreateGroupDataset.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("CreateGroupDataset.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/DatasetRdWt.java b/doc/html/Tutor/examples/java/DatasetRdWt.java deleted file mode 100644 index 4c26d0f..0000000 --- a/doc/html/Tutor/examples/java/DatasetRdWt.java +++ /dev/null @@ -1,213 +0,0 @@ -/****************************************************************** - * DatasetRdWt.java (for HDF5 tutorial lesson 6) - * - * -- Reading and Writing an existing Dataset - * (a java conversion from h5_rdwt.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class DatasetRdWt -{ - public static void main(String []argv) - { - final String FILE = "dset.h5"; - int file_id = -1; // file identifier - int dataset_id = -1; // dataset identifier - int status = -1; - int[][] dset_data = new int[4][6]; - - // Initialize the dataset. - for (int i = 0; i < 4; i++) - for (int j = 0; j < 6; j++) - dset_data[i][j] = i * 6 + j + 1; - - // Open an existing file - file_id = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDWR, - HDF5Constants.H5P_DEFAULT); - - // Open an existing dataset. - dataset_id = H5Dopen_wrap (file_id, "/dset"); - - // Write the dataset. - status = H5Dwrite_wrap - (dataset_id, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, dset_data); - - status = H5Dread_wrap - (dataset_id, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, dset_data); - - // Close the dataset. - status = H5Dclose_wrap (dataset_id); - - // Close the file. - status = H5Fclose_wrap (file_id); - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing dataset - public static int H5Dopen_wrap (int loc_id, String name) - { - int dataset_id = -1; // dataset identifier - - try - { - // Opening an existing dataset - dataset_id = H5.H5Dopen (loc_id, name); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Dopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Dopen_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for writing the dataset - public static int H5Dwrite_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object buf) - { - int status = -1; - - try - { - // Write the dataset. - status = H5.H5Dwrite (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Dwrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Dwrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for reading the dataset - public static int H5Dread_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object obj) - { - int status = -1; - - try - { - // Read the dataset. - status = H5.H5Dread (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, obj); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Dread_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Dread_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/Dependencies b/doc/html/Tutor/examples/java/Dependencies deleted file mode 100644 index e69de29..0000000 --- a/doc/html/Tutor/examples/java/Dependencies +++ /dev/null diff --git a/doc/html/Tutor/examples/java/HyperSlab.java b/doc/html/Tutor/examples/java/HyperSlab.java deleted file mode 100644 index 5f8818d..0000000 --- a/doc/html/Tutor/examples/java/HyperSlab.java +++ /dev/null @@ -1,590 +0,0 @@ -/****************************************************************** - * HyperSlab.java (for HDF5 tutorial lesson 12) - * - * -- Writing and reading a hyperslab - * (a java conversion from h5_hyperslab.c) - * - ******************************************************************/ - -import ncsa.hdf.hdf5lib.*; -import ncsa.hdf.hdf5lib.exceptions.*; - -public class HyperSlab -{ - public static void main (String []argv) - { - final String FILE = "sds.h5"; - final String DATASETNAME = "IntArray"; - final int NX_SUB = 3; /* hyperslab dimensions */ - final int NY_SUB = 4; - final int NX = 7; /* output buffer dimensions */ - final int NY = 7; - final int NZ = 3; - final int RANK = 2; - final int RANK_OUT = 3; - final int X = 5; /* dataset dimensions */ - final int Y = 6; - - long[] dimsf = new long[2]; /* dataset dimensions */ - int[][] data = new int[X][Y]; /* data to write */ - - /* - * Data and output buffer initialization. - */ - int file, dataset; /* handles */ - int dataspace; - int memspace; - long[] dimsm = new long[3]; /* memory space dimensions */ - long[] dims_out = new long[2]; /* dataset dimensions */ - int status; - - int[][][] data_out = new int[NX][NY][NZ]; /* output buffer */ - - long[] count = new long[2]; /* size of the hyperslab in the file */ - long[] offset = new long[2]; /* hyperslab offset in the file */ - long[] count_out = new long[3]; /* size of the hyperslab in memory */ - long[] offset_out = new long[3]; /* hyperslab offset in memory */ - int i, j, k, status_n, rank; - - /********************************************************* - This writes data to the HDF5 file. - *********************************************************/ - - /* - * Data and output buffer initialization. - */ - for (j = 0; j < X; j++) - { - for (i = 0; i < Y; i++) - data[j][i] = i + j; - } - /* - * 0 1 2 3 4 5 - * 1 2 3 4 5 6 - * 2 3 4 5 6 7 - * 3 4 5 6 7 8 - * 4 5 6 7 8 9 - */ - - /* - * Create a new file using H5F_ACC_TRUNC access, - * the default file creation properties, and the default file - * access properties. - */ - file = H5Fcreate_wrap (FILE, HDF5Constants.H5F_ACC_TRUNC, - HDF5Constants.H5P_DEFAULT, - HDF5Constants.H5P_DEFAULT); - - /* - * Describe the size of the array and create the data space for fixed - * size dataset. - */ - dimsf[0] = X; - dimsf[1] = Y; - dataspace = H5Screate_simple_wrap (RANK, dimsf, null); - - /* - * Create a new dataset within the file using defined dataspace and - * default dataset creation properties. - */ - dataset = H5Dcreate_wrap - (file, DATASETNAME, H5.J2C (HDF5CDataTypes.JH5T_STD_I32BE), - dataspace, HDF5Constants.H5P_DEFAULT); - - /* - * Write the data to the dataset using default transfer properties. - */ - status = H5Dwrite_wrap - (dataset, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - HDF5Constants.H5S_ALL, HDF5Constants.H5S_ALL, - HDF5Constants.H5P_DEFAULT, data); - - /* - * Close/release resources. - */ - H5Sclose_wrap (dataspace); - H5Dclose_wrap (dataset); - H5Fclose_wrap (file); - - /************************************************************* - - This reads the hyperslab from the sds.h5 file just - created, into a 2-dimensional plane of the 3-dimensional - array. - - ************************************************************/ - - for (j = 0; j < NX; j++) - { - for (i = 0; i < NY; i++) - { - for (k = 0; k < NZ ; k++) - data_out[j][i][k] = 0; - } - } - - /* - * Open the file and the dataset. - */ - file = H5Fopen_wrap (FILE, HDF5Constants.H5F_ACC_RDONLY, - HDF5Constants.H5P_DEFAULT); - dataset = H5Dopen_wrap (file, DATASETNAME); - - dataspace = H5Dget_space_wrap (dataset); /* dataspace handle */ - rank = H5Sget_simple_extent_ndims_wrap (dataspace); - status_n = H5Sget_simple_extent_dims_wrap (dataspace, dims_out, null); - - System.out.println ("Rank: " + rank); - System.out.println ("Dimensions: "+ dims_out[0] + " x " + dims_out[1]); - - /* - * Define hyperslab in the dataset. - */ - offset[0] = 1; - offset[1] = 2; - count[0] = NX_SUB; - count[1] = NY_SUB; - status = H5Sselect_hyperslab_wrap (dataspace, - HDF5Constants.H5S_SELECT_SET, - offset, null, count, null); - - /* - * Define the memory dataspace. - */ - dimsm[0] = NX; - dimsm[1] = NY; - dimsm[2] = NZ; - memspace = H5Screate_simple_wrap (RANK_OUT, dimsm, null); - - /* - * Define memory hyperslab. - */ - offset_out[0] = 3; - offset_out[1] = 0; - offset_out[2] = 0; - count_out[0] = NX_SUB; - count_out[1] = NY_SUB; - count_out[2] = 1; - status = H5Sselect_hyperslab_wrap (memspace, - HDF5Constants.H5S_SELECT_SET, - offset_out, null, count_out, null); - - /* - * Read data from hyperslab in the file into the hyperslab in - * memory and display. - */ - status = - H5Dread_wrap (dataset, H5.J2C (HDF5CDataTypes.JH5T_NATIVE_INT), - memspace, dataspace, HDF5Constants.H5P_DEFAULT, - data_out); - - System.out.println ("Data:"); - for (j = 0; j < NX; j++) - { - for (i = 0; i < NY; i++) - System.out.print (data_out[j][i][0]); - System.out.println (); - } - System.out.println (); - - /* - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 0 0 0 0 0 0 0 - * 3 4 5 6 0 0 0 - * 4 5 6 7 0 0 0 - * 5 6 7 8 0 0 0 - * 0 0 0 0 0 0 0 - */ - - /* - * Close and release resources. - */ - H5Dclose_wrap (dataset); - H5Sclose_wrap (dataspace); - H5Sclose_wrap (memspace); - H5Fclose_wrap (file); - } - - - // Help function for creating a new file - public static int H5Fcreate_wrap (String name, int flags, - int create_id, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fcreate (name, flags, create_id, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Fcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Fcreate_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing file - public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - } - - - // Help function for opening an existing dataset - public static int H5Dopen_wrap (int loc_id, String name) - { - int dataset_id = -1; // dataset identifier - - try - { - // Opening an existing dataset - dataset_id = H5.H5Dopen (loc_id, name); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dopen_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for creating a new simple dataspace and opening it - // for access - public static int H5Screate_simple_wrap (int rank, long dims[], - long maxdims[]) - { - int dataspace_id = -1; // dataspace identifier - - try - { - // Create the data space for the dataset. - dataspace_id = H5.H5Screate_simple (rank, dims, maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Screate_simple_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Screate_simple_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for getting an identifier for a copy of - // the dataspace for a dataset - public static int H5Dget_space_wrap (int dataset_id) - { - int dataspace_id = -1; - - try - { - // Returning an identifier for a copy of the dataspace for a dataset - dataspace_id = H5.H5Dget_space (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dget_space_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dget_space_wrap() with other Exception: " - + e.getMessage()); - } - return dataspace_id; - } - - - // Help function for determining the dimensionality (or rank) of - // a dataspace - public static int H5Sget_simple_extent_ndims_wrap (int space_id) - { - int rank = -1; - - try - { - // Determine the dimensionality (or rank) of a dataspace. - rank = H5.H5Sget_simple_extent_ndims (space_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Sget_simple_extent_ndims_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Sget_simple_extent_ndims_wrap() with other Exception: " - + e.getMessage()); - } - return rank; - } - - - // Help function for returning the size and maximum sizes of each - // dimension of a dataspace through the dims and maxdims parameters. - public static int H5Sget_simple_extent_dims_wrap (int space_id, - long dims[], - long maxdims[]) - { - int dimension_number = -1; - - try - { - dimension_number = H5.H5Sget_simple_extent_dims (space_id, dims, - maxdims); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Sget_simple_extent_dims_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Sget_simple_extent_dims_wrap() with other Exception: " - + e.getMessage()); - } - return dimension_number; - } - - - // Help function for selecting a hyperslab region to add to the - // current selected region for the dataspace specified by space_id. - public static int H5Sselect_hyperslab_wrap (int space_id, int op, - long start[], long stride[], - long count[], long block[]) - { - int status = -1; - - try - { - status = H5.H5Sselect_hyperslab (space_id, op, start, stride, - count, block); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Sselect_hyperslab_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Sselect_hyperslab_wrap() with other Exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for creating a dataset - public static int H5Dcreate_wrap (int loc_id, String name, int type_id, - int space_id, int create_plist_id) - { - int dataset_id = -1; // dataset identifier - - try - { - // Create the dataset - dataset_id = H5.H5Dcreate (loc_id, name, type_id, space_id, - create_plist_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dcreate_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dcreate_wrap() with other Exception: " - + e.getMessage()); - } - return dataset_id; - } - - - // Help function for writing the dataset - public static int H5Dwrite_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object buf) - { - int status = -1; - - try - { - // Write the dataset. - status = H5.H5Dwrite (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, buf); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dwrite_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dwrite_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for reading the dataset - public static int H5Dread_wrap (int dataset_id, int mem_type_id, - int mem_space_id, int file_space_id, - int xfer_plist_id, Object obj) - { - int status = -1; - - try - { - // Read the dataset. - status = H5.H5Dread (dataset_id, mem_type_id, mem_space_id, - file_space_id, xfer_plist_id, obj); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dread_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dread_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the data space. - public static int H5Sclose_wrap (int dataspace_id) - { - int status = -1; - - try - { - // Terminate access to the data space. - status = H5.H5Sclose (dataspace_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Sclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Sclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for ending access to the dataset and releasing - // resources used by it. - public static int H5Dclose_wrap (int dataset_id) - { - int status = -1; - - try - { - // End access to the dataset and release resources used by it. - status = H5.H5Dclose (dataset_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Dclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Dclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } - - - // Help function for terminating access to the file. - public static int H5Fclose_wrap (int file_id) - { - int status = -1; - - try - { - // Terminate access to the file. - status = H5.H5Fclose (file_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("HyperSlab.H5Fclose_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("HyperSlab.H5Fclose_wrap() with other exception: " - + e.getMessage()); - } - return status; - } -} diff --git a/doc/html/Tutor/examples/java/Makefile b/doc/html/Tutor/examples/java/Makefile deleted file mode 100644 index a70ab0b..0000000 --- a/doc/html/Tutor/examples/java/Makefile +++ /dev/null @@ -1,92 +0,0 @@ -# Generated automatically from Makefile.in by configure. -# /*======================================================================= -# UNIVERSITY OF ILLINOIS (UI), NATIONAL CENTER FOR SUPERCOMPUTING -# APPLICATIONS (NCSA), Software Distribution Policy for Public Domain -# Software -# -# NCSA HDF Version 5 source code and documentation are in the public -# domain, available without fee for education, research, non-commercial and -# commercial purposes. Users may distribute the binary or source code to -# third parties provided that this statement appears on all copies and that -# no charge is made for such copies. -# -# UI MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THE SOFTWARE FOR ANY -# PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. THE -# UI SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY THE USER OF THIS -# SOFTWARE. The software may have been developed under agreements between -# the UI and the Federal Government which entitle the Government to certain -# rights. -# -# We ask, but do not require that the following message be include in all -# derived works: -# -# Portions developed at the National Center for Supercomputing Applications -# at the University of Illinois at Urbana-Champaign. -# -# By copying this program, you, the user, agree to abide by the conditions -# and understandings with respect to any software which is marked with a -# public domain notice. -# -# =======================================================================*/ -# - - -JAVAC = /usr/java1.2/bin/javac -FIND = /bin/find - -CLASSPATH=/usr/java1.2/jre/lib/rt.jar:/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 - - -.SUFFIXES: .java .class - -.java.class: - $(JAVAC) -classpath $(CLASSPATH) $< - -tutorial: ./Compound.class \ - ./Copy.class \ - ./CreateAttribute.class \ - ./CreateDataset.class \ - ./CreateFile.class \ - ./CreateFileInput.class \ - ./CreateGroup.class \ - ./CreateGroupAR.class \ - ./CreateGroupDataset.class \ - ./DatasetRdWt.class \ - ./HyperSlab.class - chmod u+x *.sh - -clean: clean-classes - -distclean: clean-classes clean-data - rm config.cache config.status config.log - rm -rf ./Makefile - -clean-classes: - $(FIND) . \( -name '#*' -o -name '*~' -o -name '*.class' \) -exec rm -f {} \; ;\ - -clean-data: - rm -rf *.h5 - -Compound: ./Compound.class -Copy: ./Copy.class -CreateAttribute: ./CreateAttribute.class -CreateDataset: ./CreateDataset.class -CreateFile: ./CreateFile.class -CreateFileInput: ./CreateFileInput.class -CreateGroup: ./CreateGroup.class -CreateGroupAR: ./CreateGroupAR.class -CreateGroupDataset: ./CreateGroupDataset.class -DatasetRdWt: ./DatasetRdWt.class -HyperSlab: ./HyperSlab.class - -CLASSES= ./Compound.class \ - ./Copy.class \ - ./CreateAttribute.class \ - ./CreateDataset.class \ - ./CreateFileInput.class \ - ./CreateFile.class \ - ./CreateGroup.class \ - ./CreateGroupAR.class \ - ./CreateGroupDataset.class \ - ./DatasetRdWt.class \ - ./HyperSlab.class diff --git a/doc/html/Tutor/examples/java/Makefile.in b/doc/html/Tutor/examples/java/Makefile.in deleted file mode 100644 index e6bd408..0000000 --- a/doc/html/Tutor/examples/java/Makefile.in +++ /dev/null @@ -1,91 +0,0 @@ -# /*======================================================================= -# UNIVERSITY OF ILLINOIS (UI), NATIONAL CENTER FOR SUPERCOMPUTING -# APPLICATIONS (NCSA), Software Distribution Policy for Public Domain -# Software -# -# NCSA HDF Version 5 source code and documentation are in the public -# domain, available without fee for education, research, non-commercial and -# commercial purposes. Users may distribute the binary or source code to -# third parties provided that this statement appears on all copies and that -# no charge is made for such copies. -# -# UI MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THE SOFTWARE FOR ANY -# PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. THE -# UI SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY THE USER OF THIS -# SOFTWARE. The software may have been developed under agreements between -# the UI and the Federal Government which entitle the Government to certain -# rights. -# -# We ask, but do not require that the following message be include in all -# derived works: -# -# Portions developed at the National Center for Supercomputing Applications -# at the University of Illinois at Urbana-Champaign. -# -# By copying this program, you, the user, agree to abide by the conditions -# and understandings with respect to any software which is marked with a -# public domain notice. -# -# =======================================================================*/ -# - - -JAVAC = @JAVAC@ -FIND = @FIND@ - -CLASSPATH=@CLASSPATH@ - - -.SUFFIXES: .java .class - -.java.class: - $(JAVAC) -classpath $(CLASSPATH) $< - -tutorial: ./Compound.class \ - ./Copy.class \ - ./CreateAttribute.class \ - ./CreateDataset.class \ - ./CreateFile.class \ - ./CreateFileInput.class \ - ./CreateGroup.class \ - ./CreateGroupAR.class \ - ./CreateGroupDataset.class \ - ./DatasetRdWt.class \ - ./HyperSlab.class - chmod u+x *.sh - -clean: clean-classes - -distclean: clean-classes clean-data - rm config.cache config.status config.log - rm -rf ./Makefile - -clean-classes: - $(FIND) . \( -name '#*' -o -name '*~' -o -name '*.class' \) -exec rm -f {} \; ;\ - -clean-data: - rm -rf *.h5 - -Compound: ./Compound.class -Copy: ./Copy.class -CreateAttribute: ./CreateAttribute.class -CreateDataset: ./CreateDataset.class -CreateFile: ./CreateFile.class -CreateFileInput: ./CreateFileInput.class -CreateGroup: ./CreateGroup.class -CreateGroupAR: ./CreateGroupAR.class -CreateGroupDataset: ./CreateGroupDataset.class -DatasetRdWt: ./DatasetRdWt.class -HyperSlab: ./HyperSlab.class - -CLASSES= ./Compound.class \ - ./Copy.class \ - ./CreateAttribute.class \ - ./CreateDataset.class \ - ./CreateFileInput.class \ - ./CreateFile.class \ - ./CreateGroup.class \ - ./CreateGroupAR.class \ - ./CreateGroupDataset.class \ - ./DatasetRdWt.class \ - ./HyperSlab.class diff --git a/doc/html/Tutor/examples/java/README b/doc/html/Tutor/examples/java/README deleted file mode 100644 index 95c9360..0000000 --- a/doc/html/Tutor/examples/java/README +++ /dev/null @@ -1,21 +0,0 @@ -These files are Java versions of the example programs used in -the HDF-5 tutoral: - http://hdf.ncsa.uiuc.edu/training/hdf5/ - -The examples here correspond to the examples explained in the first 13 -sections of the tutorial. - -Lesson C program Java program Topic - -4 h5_crtfile.c CreateFile.java Create an HDF-5 file. -5 h5_crtdat.c CreateDataset.java Create a dataset. -6 h5_rdwt.c DatasetRdWt.java Write/Read a dataset. -7 h5_crtatt.c CreateAttribute.java Create an attribute. -8 h5_crtgrp.c CreateGroup.java Create a group. -9 h5_crtgrpar.c CreateGroupAR.java Abs. and Rel. paths. -10 h5_crtgrpd.c CreateGroupDataset.java Create dataset in grp. - -11 h5_compound.c Compound.java Compound datatype -12 h5_hyperslab.c Hyperslab.java Selection of hyperslab -13 h5_copy.c Copy.java Selection of elements - diff --git a/doc/html/Tutor/examples/java/readme.html b/doc/html/Tutor/examples/java/readme.html deleted file mode 100644 index ac96004..0000000 --- a/doc/html/Tutor/examples/java/readme.html +++ /dev/null @@ -1,192 +0,0 @@ -<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> -<html> -<head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> - <meta name="GENERATOR" content="Mozilla/4.61 [en] (WinNT; I) [Netscape]"> - <title>readme</title> -</head> -<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000"> - -<h3> -<b>HDF 5 Tutorial Examples in Java</b></h3> - -<p><br>These files are Java versions of the example programs used in the -HDF-5 tutoral: -<br> <a href="http://hdf.ncsa.uiuc.edu/training/hdf5/">http://hdf.ncsa.uiuc.edu/training/hdf5/</a> -<p>The examples here correspond to the examples explained in the first -13 sections of the tutorial. -<br> -<br> -<table BORDER CELLPADDING=2 WIDTH="100%" > -<tr> -<td> -<center><b>Lesson</b></center> -</td> - -<td> -<center><b>Topic</b></center> -</td> - -<td> -<center><b>C file</b></center> -</td> - -<td> -<center><b>Java file</b></center> -</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtfile.html">Lesson -4</a></td> - -<td>Create an HDF-5 file.</td> - -<td>h5_crtfile.c</td> - -<td>CreateFile.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtdat.html">Lesson -5</a></td> - -<td>Create a Dataset in an HDF-5 file</td> - -<td>h5_crtdat.c</td> - -<td>CreateDataset.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/rdwt.html">Lesson 6</a></td> - -<td>Write and Read data in a dataset</td> - -<td>h5_rdwt.c</td> - -<td>DatasetRdWt.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtatt.html">Lesson -7</a></td> - -<td>Create an attribute.</td> - -<td>h5_crtatt.c</td> - -<td>CreateAttribute.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtgrp.html">Lesson -8</a></td> - -<td>Create a group.</td> - -<td>h5_crtgrp.c</td> - -<td>CreateGroup.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtgrpar.html">Lesson -9</a></td> - -<td>Using Absolute and relative paths</td> - -<td>h5_crtgrpar.c</td> - -<td>CreateGroupAR.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/crtgrpd.html">Lesson -10</a></td> - -<td>Create a dataset in a group.</td> - -<td>h5_crtgrpd.c</td> - -<td>CreateGroupDataset.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/compound.html">Lesson -11</a></td> - -<td>Using Compound Datatypes</td> - -<td>h5_compound.c</td> - -<td>Compound.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/select.html">Lesson -12</a></td> - -<td>Selection of a hyperslab.</td> - -<td>h5_hyperslab.c</td> - -<td>Hyperslab.java</td> -</tr> - -<tr> -<td><a href="http://hdf.ncsa.uiuc.edu/training/hdf5/selectc.html">Lesson -13</a></td> - -<td>Selection of elements.</td> - -<td>h5_copy.c</td> - -<td>Copy.java</td> -</tr> -</table> - -<p> -<hr><b>Some Explanation About Tutorial Examples</b> -<p>The Java tutorial programs try to stay close to the corresponding C -program. The main function's structure almost same as C program, with one -call for each HDF5 library function. For example, where the C program has -a call to <b>H5Fopen()</b>, the Java program has a call to <b>H5Fopen_wrap()</b>. -<p>The wrapper functions call the HDF-5 library using the Java HDF-5 Interface -(JHI5). The HDF-5 C interface returns error codes; these are represented -by Java Exceptions in the JHI5. The wrapper function catches the exception -and prints a message. -<p>For example, the <b>H5Fopen_wrap() </b>method calls the JHI5, and catches -any exceptions which may occur: -<pre> <b>public static int H5Fopen_wrap (String name, int flags, int access_id) - { - int file_id = -1; // file identifier - try - { - // Create a new file using default file properties. - file_id = H5.H5Fopen (name, flags, access_id); - } - catch (HDF5Exception hdf5e) - { - System.out.println - ("DatasetRdWt.H5Fopen_wrap() with HDF5Exception: " - + hdf5e.getMessage()); - } - catch (Exception e) - { - System.out.println - ("DatasetRdWt.H5Fopen_wrap() with other Exception: " - + e.getMessage()); - } - return file_id; - }</b></pre> - -<p><br> -<hr noshade size=1><a href="http://www.ncsa.uiuc.edu/"><img SRC="http://www.ncsa.uiuc.edu/Images/NCSAhome/footerlogo.gif" ALT="NCSA" BORDER=0 ></a> -<br><font face="arial,helvetica"><font size=-1><a href="http://www.ncsa.uiuc.edu/">The -National Center for Supercomputing Applications</a></font></font> -<br><font face="arial,helvetica"><font size=-1><a href="http://www.uiuc.edu/">University -of Illinois at Urbana-Champaign</a></font></font> -<p><font face="arial,helvetica"><font size=-1><a href="mailto:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</a></font></font> -</body> -</html> diff --git a/doc/html/Tutor/examples/java/runCompound.sh b/doc/html/Tutor/examples/java/runCompound.sh deleted file mode 100644 index ef2be38..0000000 --- a/doc/html/Tutor/examples/java/runCompound.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java Compound $* diff --git a/doc/html/Tutor/examples/java/runCompound.sh.in b/doc/html/Tutor/examples/java/runCompound.sh.in deleted file mode 100644 index bc58088..0000000 --- a/doc/html/Tutor/examples/java/runCompound.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ Compound $* diff --git a/doc/html/Tutor/examples/java/runCopy.sh b/doc/html/Tutor/examples/java/runCopy.sh deleted file mode 100644 index de71783..0000000 --- a/doc/html/Tutor/examples/java/runCopy.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java Copy $* diff --git a/doc/html/Tutor/examples/java/runCopy.sh.in b/doc/html/Tutor/examples/java/runCopy.sh.in deleted file mode 100644 index 2fd8a46..0000000 --- a/doc/html/Tutor/examples/java/runCopy.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ Copy $* diff --git a/doc/html/Tutor/examples/java/runCreateAttribute.sh b/doc/html/Tutor/examples/java/runCreateAttribute.sh deleted file mode 100644 index 419abce..0000000 --- a/doc/html/Tutor/examples/java/runCreateAttribute.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateAttribute $* diff --git a/doc/html/Tutor/examples/java/runCreateAttribute.sh.in b/doc/html/Tutor/examples/java/runCreateAttribute.sh.in deleted file mode 100644 index 83bcdc7..0000000 --- a/doc/html/Tutor/examples/java/runCreateAttribute.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateAttribute $* diff --git a/doc/html/Tutor/examples/java/runCreateDataset.sh b/doc/html/Tutor/examples/java/runCreateDataset.sh deleted file mode 100644 index 371e811..0000000 --- a/doc/html/Tutor/examples/java/runCreateDataset.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateDataset $* diff --git a/doc/html/Tutor/examples/java/runCreateDataset.sh.in b/doc/html/Tutor/examples/java/runCreateDataset.sh.in deleted file mode 100644 index 606e153..0000000 --- a/doc/html/Tutor/examples/java/runCreateDataset.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateDataset $* diff --git a/doc/html/Tutor/examples/java/runCreateFile.sh b/doc/html/Tutor/examples/java/runCreateFile.sh deleted file mode 100644 index e32c0ab..0000000 --- a/doc/html/Tutor/examples/java/runCreateFile.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateFile $* diff --git a/doc/html/Tutor/examples/java/runCreateFile.sh.in b/doc/html/Tutor/examples/java/runCreateFile.sh.in deleted file mode 100644 index bf48b9c..0000000 --- a/doc/html/Tutor/examples/java/runCreateFile.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateFile $* diff --git a/doc/html/Tutor/examples/java/runCreateFileInput.sh b/doc/html/Tutor/examples/java/runCreateFileInput.sh deleted file mode 100644 index fa12f06..0000000 --- a/doc/html/Tutor/examples/java/runCreateFileInput.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateFileInput $* diff --git a/doc/html/Tutor/examples/java/runCreateFileInput.sh.in b/doc/html/Tutor/examples/java/runCreateFileInput.sh.in deleted file mode 100644 index 776eac5..0000000 --- a/doc/html/Tutor/examples/java/runCreateFileInput.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateFileInput $* diff --git a/doc/html/Tutor/examples/java/runCreateGroup.sh b/doc/html/Tutor/examples/java/runCreateGroup.sh deleted file mode 100644 index ee9deee..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroup.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateGroup $* diff --git a/doc/html/Tutor/examples/java/runCreateGroup.sh.in b/doc/html/Tutor/examples/java/runCreateGroup.sh.in deleted file mode 100644 index e2eadb5..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroup.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateGroup $* diff --git a/doc/html/Tutor/examples/java/runCreateGroupAR.sh b/doc/html/Tutor/examples/java/runCreateGroupAR.sh deleted file mode 100644 index 2619a11..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroupAR.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateGroupAR $* diff --git a/doc/html/Tutor/examples/java/runCreateGroupAR.sh.in b/doc/html/Tutor/examples/java/runCreateGroupAR.sh.in deleted file mode 100644 index d61d852..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroupAR.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateGroupAR $* diff --git a/doc/html/Tutor/examples/java/runCreateGroupDataset.sh b/doc/html/Tutor/examples/java/runCreateGroupDataset.sh deleted file mode 100644 index 15b7bfa..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroupDataset.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java CreateGroupDataset $* diff --git a/doc/html/Tutor/examples/java/runCreateGroupDataset.sh.in b/doc/html/Tutor/examples/java/runCreateGroupDataset.sh.in deleted file mode 100644 index af2b4b5..0000000 --- a/doc/html/Tutor/examples/java/runCreateGroupDataset.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ CreateGroupDataset $* diff --git a/doc/html/Tutor/examples/java/runDatasetRdWt.sh b/doc/html/Tutor/examples/java/runDatasetRdWt.sh deleted file mode 100644 index a049ea8..0000000 --- a/doc/html/Tutor/examples/java/runDatasetRdWt.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java DatasetRdWt $* diff --git a/doc/html/Tutor/examples/java/runDatasetRdWt.sh.in b/doc/html/Tutor/examples/java/runDatasetRdWt.sh.in deleted file mode 100644 index ad3a049..0000000 --- a/doc/html/Tutor/examples/java/runDatasetRdWt.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ DatasetRdWt $* diff --git a/doc/html/Tutor/examples/java/runHyperSlab.sh b/doc/html/Tutor/examples/java/runHyperSlab.sh deleted file mode 100644 index 549f807..0000000 --- a/doc/html/Tutor/examples/java/runHyperSlab.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=/afs/ncsa/projects/hdf/java/java2/mcgrath/arabica/New5 -HDF5LIB=/afs/ncsa/projects/hdf/release/prehdf5-1.2.1/SunOS_5.7/lib - -#make this relative to the source root... -PWD=/afs/ncsa.uiuc.edu/projects/hdf/java/java2/mcgrath/arabica/java-hdf5 -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/solaris" - -export CLASSPATH -export LD_LIBRARY_PATH - -/usr/java1.2/bin/java HyperSlab $* diff --git a/doc/html/Tutor/examples/java/runHyperSlab.sh.in b/doc/html/Tutor/examples/java/runHyperSlab.sh.in deleted file mode 100644 index f515fc9..0000000 --- a/doc/html/Tutor/examples/java/runHyperSlab.sh.in +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/sh - -JH5INSTALLDIR=@JH5INST@ -HDF5LIB=@HDF5LIB@ - -#make this relative to the source root... -PWD=@PWD@ -LIBDIR=$JH5INSTALLDIR"/lib" - -CLASSPATH=".:"$LIBDIR"/jhdf5.jar" - -LD_LIBRARY_PATH=$HDF5LIB":"$LIBDIR"/@JAVATARG@" - -export CLASSPATH -export LD_LIBRARY_PATH - -@JAVA@ HyperSlab $* diff --git a/doc/html/Tutor/examples/mountexample.f90 b/doc/html/Tutor/examples/mountexample.f90 deleted file mode 100644 index f4341b2..0000000 --- a/doc/html/Tutor/examples/mountexample.f90 +++ /dev/null @@ -1,187 +0,0 @@ -! -!In the following example we create one file with a group in it, -!and another file with a dataset. Mounting is used to -!access the dataset from the second file as a member of a group -!in the first file. -! - - PROGRAM MOUNTEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - ! - ! Filenames are "mount1.h5" and "mount2.h5" - ! - CHARACTER(LEN=9), PARAMETER :: filename1 = "mount1.h5" - CHARACTER(LEN=9), PARAMETER :: filename2 = "mount2.h5" - - ! - !data space rank and dimensions - ! - INTEGER, PARAMETER :: RANK = 2 - INTEGER, PARAMETER :: NX = 4 - INTEGER, PARAMETER :: NY = 5 - - ! - ! File identifiers - ! - INTEGER(HID_T) :: file1_id, file2_id - - ! - ! Group identifier - ! - INTEGER(HID_T) :: gid - - ! - ! Dataset identifier - ! - INTEGER(HID_T) :: dset_id - - ! - ! Data space identifier - ! - INTEGER(HID_T) :: dataspace - - ! - ! Data type identifier - ! - INTEGER(HID_T) :: dtype_id - - ! - ! The dimensions for the dataset. - ! - INTEGER(HSIZE_T), DIMENSION(2) :: dims = (/NX,NY/) - - ! - ! Flag to check operation success - ! - INTEGER :: error - - ! - ! General purpose integer - ! - INTEGER :: i, j - - ! - ! Data buffers - ! - INTEGER, DIMENSION(NX,NY) :: data_in, data_out - - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - - ! - ! Initialize data_in buffer - ! - do i = 1, NX - do j = 1, NY - data_in(i,j) = (i-1) + (j-1) - end do - end do - - ! - ! Create first file "mount1.h5" using default properties. - ! - CALL h5fcreate_f(filename1, H5F_ACC_TRUNC_F, file1_id, error) - - ! - ! Create group "/G" inside file "mount1.h5". - ! - CALL h5gcreate_f(file1_id, "/G", gid, error) - - ! - ! Close file and group identifiers. - ! - CALL h5gclose_f(gid, error) - CALL h5fclose_f(file1_id, error) - - ! - ! Create second file "mount2.h5" using default properties. - ! - CALL h5fcreate_f(filename2, H5F_ACC_TRUNC_F, file2_id, error) - - ! - ! Create data space for the dataset. - ! - CALL h5screate_simple_f(RANK, dims, dataspace, error) - - ! - ! Create dataset "/D" inside file "mount2.h5". - ! - CALL h5dcreate_f(file2_id, "/D", H5T_NATIVE_INTEGER, dataspace, & - dset_id, error) - - ! - ! Write data_in to the dataset - ! - CALL h5dwrite_f(dset_id, H5T_NATIVE_INTEGER, data_in, error) - - ! - ! Close file, dataset and dataspace identifiers. - ! - CALL h5sclose_f(dataspace, error) - CALL h5dclose_f(dset_id, error) - CALL h5fclose_f(file2_id, error) - - ! - ! Reopen both files. - ! - CALL h5fopen_f (filename1, H5F_ACC_RDWR_F, file1_id, error) - CALL h5fopen_f (filename2, H5F_ACC_RDWR_F, file2_id, error) - - ! - ! Mount the second file under the first file's "/G" group. - ! - CALL h5fmount_f (file1_id, "/G", file2_id, error) - - - ! - ! Access dataset D in the first file under /G/D name. - ! - CALL h5dopen_f(file1_id, "/G/D", dset_id, error) - - ! - ! Get dataset's data type. - ! - CALL h5dget_type_f(dset_id, dtype_id, error) - - ! - ! Read the dataset. - ! - CALL h5dread_f(dset_id, dtype_id, data_out, error) - - ! - ! Print out the data. - ! - do i = 1, NX - print *, (data_out(i,j), j = 1, NY) - end do - - - ! - !Close dset_id and dtype_id. - ! - CALL h5dclose_f(dset_id, error) - CALL h5tclose_f(dtype_id, error) - - ! - ! Unmount the second file. - ! - CALL h5funmount_f(file1_id, "/G", error); - - ! - ! Close both files. - ! - CALL h5fclose_f(file1_id, error) - CALL h5fclose_f(file2_id, error) - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM MOUNTEXAMPLE - diff --git a/doc/html/Tutor/examples/refobjexample.f90 b/doc/html/Tutor/examples/refobjexample.f90 deleted file mode 100644 index fdbb26d..0000000 --- a/doc/html/Tutor/examples/refobjexample.f90 +++ /dev/null @@ -1,142 +0,0 @@ -! -! This program shows how to create and store references to the objects. -! Program creates a file, two groups, a dataset to store integer data and -! a dataset to store references to the objects. -! Stored references are used to open the objects they are point to. -! Data is written to the dereferenced dataset, and class type is displayed for -! the shared datatype. -! - PROGRAM OBJ_REFERENCES - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - CHARACTER(LEN=10), PARAMETER :: filename = "FORTRAN.h5" ! File - CHARACTER(LEN=8), PARAMETER :: dsetnamei = "INTEGERS" ! Dataset with the integer data - CHARACTER(LEN=17), PARAMETER :: dsetnamer = "OBJECT_REFERENCES" ! Dataset wtih object - ! references - CHARACTER(LEN=6), PARAMETER :: groupname1 = "GROUP1" ! Groups in the file - CHARACTER(LEN=6), PARAMETER :: groupname2 = "GROUP2" ! - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: grp1_id ! Group identifiers - INTEGER(HID_T) :: grp2_id ! - INTEGER(HID_T) :: dset_id ! Dataset identifiers - INTEGER(HID_T) :: dsetr_id ! - INTEGER(HID_T) :: type_id ! Type identifier - INTEGER(HID_T) :: space_id ! Dataspace identifiers - INTEGER(HID_T) :: spacer_id ! - INTEGER :: error - INTEGER(HSIZE_T), DIMENSION(1) :: dims = (/5/) - INTEGER(HSIZE_T), DIMENSION(1) :: dimsr= (/4/) - INTEGER(HSIZE_T), DIMENSION(1) :: my_maxdims = (/5/) - INTEGER :: rank = 1 - INTEGER :: rankr = 1 - TYPE(hobj_ref_t_f), DIMENSION(4) :: ref - TYPE(hobj_ref_t_f), DIMENSION(4) :: ref_out - INTEGER, DIMENSION(5) :: data = (/1, 2, 3, 4, 5/) - INTEGER :: class, ref_size - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - ! - ! Create a file - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - ! Default file access and file creation - ! properties are used. - ! - ! Create a group in the file - ! - CALL h5gcreate_f(file_id, groupname1, grp1_id, error) - ! - ! Create a group inside the created gorup - ! - CALL h5gcreate_f(grp1_id, groupname2, grp2_id, error) - ! - ! Create dataspaces for datasets - ! - CALL h5screate_simple_f(rank, dims, space_id, error, maxdims=my_maxdims) - CALL h5screate_simple_f(rankr, dimsr, spacer_id, error) - ! - ! Create integer dataset - ! - CALL h5dcreate_f(file_id, dsetnamei, H5T_NATIVE_INTEGER, space_id, & - dset_id, error) - ! - ! Create dataset to store references to the objects - ! - CALL h5dcreate_f(file_id, dsetnamer, H5T_STD_REF_OBJ, spacer_id, & - dsetr_id, error) - ! - ! Create a datatype and store in the file - ! - CALL h5tcopy_f(H5T_NATIVE_REAL, type_id, error) - CALL h5tcommit_f(file_id, "MyType", type_id, error) - ! - ! Close dataspaces, groups and integer dataset - ! - CALL h5sclose_f(space_id, error) - CALL h5sclose_f(spacer_id, error) - CALL h5tclose_f(type_id, error) - CALL h5dclose_f(dset_id, error) - CALL h5gclose_f(grp1_id, error) - CALL h5gclose_f(grp2_id, error) - ! - ! Create references to two groups, integer dataset and shared datatype - ! and write it to the dataset in the file - ! - CALL h5rcreate_f(file_id, groupname1, ref(1), error) - CALL h5rcreate_f(file_id, "/GROUP1/GROUP2", ref(2), error) - CALL h5rcreate_f(file_id, dsetnamei, ref(3), error) - CALL h5rcreate_f(file_id, "MyType", ref(4), error) - ref_size = size(ref) - CALL h5dwrite_f(dsetr_id, H5T_STD_REF_OBJ, ref, ref_size, error) - ! - ! Close the dataset - ! - CALL h5dclose_f(dsetr_id, error) - ! - ! Reopen the dataset with object references and read references to the buffer - ! - CALL h5dopen_f(file_id, dsetnamer,dsetr_id,error) - ref_size = size(ref_out) - CALL h5dread_f(dsetr_id, H5T_STD_REF_OBJ, ref_out, ref_size, error) - ! - ! Dereference the third reference. We know that it is a dataset. On practice - ! one should use h5rget_object_type_f function to find out - ! the type of an object the reference points to. - ! - CALL h5rdereference_f(dsetr_id, ref(3), dset_id, error) - ! - ! Write data to the dataset. - ! - CALL h5dwrite_f(dset_id, H5T_NATIVE_INTEGER, data, error) - if (error .eq. 0) write(*,*) "Data has been successfully written to the dataset " - ! - ! Dereference the fourth reference. We know that it is a datatype. On practice - ! one should use h5rget_object_type_f function to find out - ! the type of an object the reference points to. - ! - CALL h5rdereference_f(dsetr_id, ref(4), type_id, error) - ! - ! Get datatype class and display it if it is of a FLOAT class. - ! - CALL h5tget_class_f(type_id, class, error) - if(class .eq. H5T_FLOAT_F) write(*,*) "Stored datatype is of a FLOAT class" - ! - ! Close all objects. - ! - CALL h5dclose_f(dset_id, error) - CALL h5tclose_f(type_id, error) - CALL h5dclose_f(dsetr_id, error) - CALL h5fclose_f(file_id, error) - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM OBJ_REFERENCES - - diff --git a/doc/html/Tutor/examples/refregexample.f90 b/doc/html/Tutor/examples/refregexample.f90 deleted file mode 100644 index 5d72f1e..0000000 --- a/doc/html/Tutor/examples/refregexample.f90 +++ /dev/null @@ -1,162 +0,0 @@ -! -! This program shows how to create, store and dereference references -! to the dataset regions. -! Program creates a file and writes two dimensional integer dataset -! to it. Then program creates and stores references to the hyperslab -! and 3 points selected in the integer dataset, in the second dataset. -! Program reopens the second dataset, reads and dereferences region -! references, and then reads and displays selected data from the -! integer dataset. -! - PROGRAM REG_REFERENCE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - CHARACTER(LEN=10), PARAMETER :: filename = "FORTRAN.h5" - CHARACTER(LEN=6), PARAMETER :: dsetnamev = "MATRIX" - CHARACTER(LEN=17), PARAMETER :: dsetnamer = "REGION_REFERENCES" - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: space_id ! Dataspace identifier - INTEGER(HID_T) :: spacer_id ! Dataspace identifier - INTEGER(HID_T) :: dsetv_id ! Dataset identifier - INTEGER(HID_T) :: dsetr_id ! Dataset identifier - INTEGER :: error - TYPE(hdset_reg_ref_t_f) , DIMENSION(2) :: ref ! Buffers to store references - TYPE(hdset_reg_ref_t_f) , DIMENSION(2) :: ref_out ! - INTEGER(HSIZE_T), DIMENSION(2) :: dims = (/2,9/) ! Datasets dimensions - INTEGER(HSIZE_T), DIMENSION(1) :: dimsr = (/2/) ! - INTEGER(HSIZE_T), DIMENSION(2) :: start - INTEGER(HSIZE_T), DIMENSION(2) :: count - INTEGER :: rankr = 1 - INTEGER :: rank = 2 - INTEGER , DIMENSION(2,9) :: data - INTEGER , DIMENSION(2,9) :: data_out = 0 - INTEGER(HSIZE_T) , DIMENSION(2,3) :: coord - INTEGER(SIZE_T) ::num_points = 3 ! Number of selected points - INTEGER :: i, j - INTEGER :: ref_size - coord = reshape((/1,1,2,7,1,9/), (/2,3/)) ! Coordinates of selected points - data = reshape ((/1,1,1,2,2,2,3,3,3,4,4,4,5,5,5,6,6,6/), (/2,9/)) - ! - ! Initialize FORTRAN interface. - ! - CALL h5open_f(error) - ! - ! Create a new file. - ! - CALL h5fcreate_f(filename, H5F_ACC_TRUNC_F, file_id, error) - ! Default file access and file creation - ! properties are used. - ! - ! Create dataspaces: - ! - ! for dataset with references to dataset regions - ! - CALL h5screate_simple_f(rankr, dimsr, spacer_id, error) - ! - ! for integer dataset - ! - CALL h5screate_simple_f(rank, dims, space_id, error) - ! - ! Create and write datasets: - ! - ! Integer dataset - ! - CALL h5dcreate_f(file_id, dsetnamev, H5T_NATIVE_INTEGER, space_id, & - dsetv_id, error) - CALL h5dwrite_f(dsetv_id, H5T_NATIVE_INTEGER, data, error) - CALL h5dclose_f(dsetv_id, error) - ! - ! Dataset with references - ! - CALL h5dcreate_f(file_id, dsetnamer, H5T_STD_REF_DSETREG, spacer_id, & - dsetr_id, error) - ! - ! Create a reference to the hyperslab selection. - ! - start(1) = 0 - start(2) = 3 - count(1) = 2 - count(2) = 3 - CALL h5sselect_hyperslab_f(space_id, H5S_SELECT_SET_F, & - start, count, error) - CALL h5rcreate_f(file_id, dsetnamev, space_id, ref(1), error) - ! - ! Create a reference to elements selection. - ! - CALL h5sselect_none_f(space_id, error) - CALL h5sselect_elements_f(space_id, H5S_SELECT_SET_F, rank, num_points,& - coord, error) - CALL h5rcreate_f(file_id, dsetnamev, space_id, ref(2), error) - ! - ! Write dataset with the references. - ! - ref_size = size(ref) - CALL h5dwrite_f(dsetr_id, H5T_STD_REF_DSETREG, ref, ref_size, error) - ! - ! Close all objects. - ! - CALL h5sclose_f(space_id, error) - CALL h5sclose_f(spacer_id, error) - CALL h5dclose_f(dsetr_id, error) - CALL h5fclose_f(file_id, error) - ! - ! Reopen the file to test selections. - ! - CALL h5fopen_f (filename, H5F_ACC_RDWR_F, file_id, error) - CALL h5dopen_f(file_id, dsetnamer, dsetr_id, error) - ! - ! Read references to the dataset regions. - ! - ref_size = size(ref_out) - CALL h5dread_f(dsetr_id, H5T_STD_REF_DSETREG, ref_out, ref_size, error) - ! - ! Dereference the first reference. - ! - CALL H5rdereference_f(dsetr_id, ref_out(1), dsetv_id, error) - CALL H5rget_region_f(dsetr_id, ref_out(1), space_id, error) - ! - ! Read selected data from the dataset. - ! - CALL h5dread_f(dsetv_id, H5T_NATIVE_INTEGER, data_out, error, & - mem_space_id = space_id, file_space_id = space_id) - write(*,*) "Hypeslab selection" - write(*,*) - do i = 1,2 - write(*,*) (data_out (i,j), j = 1,9) - enddo - write(*,*) - CALL h5sclose_f(space_id, error) - CALL h5dclose_f(dsetv_id, error) - data_out = 0 - ! - ! Dereference the second reference. - ! - CALL H5rdereference_f(dsetr_id, ref_out(2), dsetv_id, error) - CALL H5rget_region_f(dsetr_id, ref_out(2), space_id, error) - ! - ! Read selected data from the dataset. - ! - CALL h5dread_f(dsetv_id, H5T_NATIVE_INTEGER, data_out, error, & - mem_space_id = space_id, file_space_id = space_id) - write(*,*) "Point selection" - write(*,*) - do i = 1,2 - write(*,*) (data_out (i,j), j = 1,9) - enddo - ! - ! Close all objects - ! - CALL h5sclose_f(space_id, error) - CALL h5dclose_f(dsetv_id, error) - CALL h5dclose_f(dsetr_id, error) - ! - ! Close FORTRAN interface. - ! - CALL h5close_f(error) - - END PROGRAM REG_REFERENCE - - diff --git a/doc/html/Tutor/examples/rwdsetexample.f90 b/doc/html/Tutor/examples/rwdsetexample.f90 deleted file mode 100644 index 729e84d..0000000 --- a/doc/html/Tutor/examples/rwdsetexample.f90 +++ /dev/null @@ -1,78 +0,0 @@ -! -! The following example shows how to write and read to/from an existing dataset. -! It opens the file created in the previous example, obtains the dataset -! identifier, writes the data to the dataset in the file, -! then reads the dataset to memory. -! - - - PROGRAM RWDSETEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=8), PARAMETER :: filename = "dsetf.h5" ! File name - CHARACTER(LEN=4), PARAMETER :: dsetname = "dset" ! Dataset name - - INTEGER(HID_T) :: file_id ! File identifier - INTEGER(HID_T) :: dset_id ! Dataset identifier - - INTEGER :: error ! Error flag - INTEGER :: i, j - - INTEGER, DIMENSION(4,6) :: dset_data, data_out ! Data buffers - - ! - ! Initialize the dset_data array. - ! - do i = 1, 4 - do j = 1, 6 - dset_data(i,j) = (i-1)*6 + j; - end do - end do - - ! - ! Initialize FORTRAN predefined datatypes - ! - CALL h5open_f(error) - - ! - ! Open an existing file. - ! - CALL h5fopen_f (filename, H5F_ACC_RDWR_F, file_id, error) - - ! - ! Open an existing dataset. - ! - CALL h5dopen_f(file_id, dsetname, dset_id, error) - - ! - ! Write the dataset. - ! - CALL h5dwrite_f(dset_id, H5T_NATIVE_INTEGER, dset_data, error) - - ! - ! Read the dataset. - ! - CALL h5dread_f(dset_id, H5T_NATIVE_INTEGER, data_out, error) - - ! - ! Close the dataset. - ! - CALL h5dclose_f(dset_id, error) - - ! - ! Close the file. - ! - CALL h5fclose_f(file_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM RWDSETEXAMPLE - - - diff --git a/doc/html/Tutor/examples/selectele.f90 b/doc/html/Tutor/examples/selectele.f90 deleted file mode 100644 index 8727bd9..0000000 --- a/doc/html/Tutor/examples/selectele.f90 +++ /dev/null @@ -1,282 +0,0 @@ -! -! This program creates two files, copy1.h5, and copy2.h5. -! In copy1.h5, it creates a 3x4 dataset called 'Copy1', -! and write 0's to this dataset. -! In copy2.h5, it create a 3x4 dataset called 'Copy2', -! and write 1's to this dataset. -! It closes both files, reopens both files, selects two -! points in copy1.h5 and writes values to them. Then it -! uses an H5Scopy to write the same selection to copy2.h5. -! Program reopens the files, and reads and prints the contents of -! the two datasets. -! - - PROGRAM SELECTEXAMPLE - - USE HDF5 ! This module contains all necessary modules - - IMPLICIT NONE - - CHARACTER(LEN=8), PARAMETER :: filename1 = "copy1.h5" ! File name - CHARACTER(LEN=8), PARAMETER :: filename2 = "copy2.h5" ! - CHARACTER(LEN=5), PARAMETER :: dsetname1 = "Copy1" ! Dataset name - CHARACTER(LEN=5), PARAMETER :: dsetname2 = "Copy2" ! - - INTEGER, PARAMETER :: RANK = 2 ! Dataset rank - - INTEGER(SIZE_T), PARAMETER :: NUMP = 2 ! Number of points selected - - INTEGER(HID_T) :: file1_id ! File1 identifier - INTEGER(HID_T) :: file2_id ! File2 identifier - INTEGER(HID_T) :: dset1_id ! Dataset1 identifier - INTEGER(HID_T) :: dset2_id ! Dataset2 identifier - INTEGER(HID_T) :: dataspace1 ! Dataspace identifier - INTEGER(HID_T) :: dataspace2 ! Dataspace identifier - INTEGER(HID_T) :: memspace ! memspace identifier - - INTEGER(HSIZE_T), DIMENSION(1) :: dimsm = (/2/) - ! Memory dataspace dimensions - INTEGER(HSIZE_T), DIMENSION(2) :: dimsf = (/3,4/) - ! File dataspace dimensions - INTEGER(HSIZE_T), DIMENSION(RANK,NUMP) :: coord ! Elements coordinates - ! in the file - - INTEGER, DIMENSION(3,4) :: buf1, buf2, bufnew ! Data buffers - INTEGER, DIMENSION(2) :: val = (/53, 59/) ! Values to write - - INTEGER :: memrank = 1 ! Rank of the dataset in memory - - INTEGER :: i, j - - INTEGER :: error ! Error flag - LOGICAL :: status - - - ! - ! Create two files containing identical datasets. Write 0's to one - ! and 1's to the other. - ! - - ! - ! Data initialization. - ! - do i = 1, 3 - do j = 1, 4 - buf1(i,j) = 0; - end do - end do - - do i = 1, 3 - do j = 1, 4 - buf2(i,j) = 1; - end do - end do - - ! - ! Initialize FORTRAN predefined datatypes - ! - CALL h5open_f(error) - - ! - ! Create file1, file2 using default properties. - ! - CALL h5fcreate_f(filename1, H5F_ACC_TRUNC_F, file1_id, error) - - CALL h5fcreate_f(filename2, H5F_ACC_TRUNC_F, file2_id, error) - - ! - ! Create the data space for the datasets. - ! - CALL h5screate_simple_f(RANK, dimsf, dataspace1, error) - - CALL h5screate_simple_f(RANK, dimsf, dataspace2, error) - - ! - ! Create the datasets with default properties. - ! - CALL h5dcreate_f(file1_id, dsetname1, H5T_NATIVE_INTEGER, dataspace1, & - dset1_id, error) - - CALL h5dcreate_f(file2_id, dsetname2, H5T_NATIVE_INTEGER, dataspace2, & - dset2_id, error) - - ! - ! Write the datasets. - ! - CALL h5dwrite_f(dset1_id, H5T_NATIVE_INTEGER, buf1, error) - - CALL h5dwrite_f(dset2_id, H5T_NATIVE_INTEGER, buf2, error) - - ! - ! Close the dataspace for the datasets. - ! - CALL h5sclose_f(dataspace1, error) - - CALL h5sclose_f(dataspace2, error) - - ! - ! Close the datasets. - ! - CALL h5dclose_f(dset1_id, error) - - CALL h5dclose_f(dset2_id, error) - - ! - ! Close the files. - ! - CALL h5fclose_f(file1_id, error) - - CALL h5fclose_f(file2_id, error) - - ! - ! Open the two files. Select two points in one file, write values to - ! those point locations, then do H5Scopy and write the values to the - ! other file. Close files. - ! - - ! - ! Open the files. - ! - CALL h5fopen_f (filename1, H5F_ACC_RDWR_F, file1_id, error) - - CALL h5fopen_f (filename2, H5F_ACC_RDWR_F, file2_id, error) - - ! - ! Open the datasets. - ! - CALL h5dopen_f(file1_id, dsetname1, dset1_id, error) - - CALL h5dopen_f(file2_id, dsetname2, dset2_id, error) - - ! - ! Get dataset1's dataspace identifier. - ! - CALL h5dget_space_f(dset1_id, dataspace1, error) - - ! - ! Create memory dataspace. - ! - CALL h5screate_simple_f(memrank, dimsm, memspace, error) - - ! - ! Set the selected point positions. Because Fortran array index starts - ! from 1, so add one to the actual select points in C. - ! - coord(1,1) = 1 - coord(2,1) = 2 - coord(1,2) = 1 - coord(2,2) = 4 - - ! - ! Select the elements in file space. - ! - CALL h5sselect_elements_f(dataspace1, H5S_SELECT_SET_F, RANK, NUMP,& - coord, error) - - ! - ! Write value into the selected points in dataset1. - ! - CALL H5dwrite_f(dset1_id, H5T_NATIVE_INTEGER, val, error, & - mem_space_id=memspace, file_space_id=dataspace1) - - ! - ! Copy the daspace1 into dataspace2. - ! - CALL h5scopy_f(dataspace1, dataspace2, error) - - ! - ! Write value into the selected points in dataset2. - ! - CALL H5dwrite_f(dset2_id, H5T_NATIVE_INTEGER, val, error, & - mem_space_id=memspace, file_space_id=dataspace2) - - ! - ! Close the dataspace for the datasets. - ! - CALL h5sclose_f(dataspace1, error) - - CALL h5sclose_f(dataspace2, error) - - ! - ! Close the memoryspace. - ! - CALL h5sclose_f(memspace, error) - - ! - ! Close the datasets. - ! - CALL h5dclose_f(dset1_id, error) - - CALL h5dclose_f(dset2_id, error) - - ! - ! Close the files. - ! - CALL h5fclose_f(file1_id, error) - - CALL h5fclose_f(file2_id, error) - - ! - ! Open both files and print the contents of the datasets. - ! - - ! - ! Open the files. - ! - CALL h5fopen_f (filename1, H5F_ACC_RDWR_F, file1_id, error) - - CALL h5fopen_f (filename2, H5F_ACC_RDWR_F, file2_id, error) - - ! - ! Open the datasets. - ! - CALL h5dopen_f(file1_id, dsetname1, dset1_id, error) - - CALL h5dopen_f(file2_id, dsetname2, dset2_id, error) - - ! - ! Read dataset from the first file. - ! - CALL h5dread_f(dset1_id, H5T_NATIVE_INTEGER, bufnew, error) - - ! - ! Display the data read from dataset "Copy1" - ! - write(*,*) "The data in dataset Copy1 is: " - do i = 1, 3 - print *, (bufnew(i,j), j = 1,4) - end do - - ! - ! Read dataset from the second file. - ! - CALL h5dread_f(dset2_id, H5T_NATIVE_INTEGER, bufnew, error) - - ! - ! Display the data read from dataset "Copy2" - ! - write(*,*) "The data in dataset Copy2 is: " - do i = 1, 3 - print *, (bufnew(i,j), j = 1,4) - end do - - ! - ! Close datasets. - ! - CALL h5dclose_f(dset1_id, error) - - CALL h5dclose_f(dset2_id, error) - - ! - ! Close files. - ! - CALL h5fclose_f(file1_id, error) - - CALL h5fclose_f(file2_id, error) - - ! - ! Close FORTRAN predefined datatypes. - ! - CALL h5close_f(error) - - END PROGRAM SELECTEXAMPLE diff --git a/doc/html/Tutor/extend.html b/doc/html/Tutor/extend.html deleted file mode 100644 index 326a946..0000000 --- a/doc/html/Tutor/extend.html +++ /dev/null @@ -1,284 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Chunking and Extendible Datasets -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Chunking and Extendible Datasets</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#def">Creating an Extendible Dataset</A> - <LI>Programming Example -<UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> -<!-- - <LI> <A HREF="#fc">File Contents</A> - <LI> <A HREF="#ddl">Dataset Definition in DDL</A> ---> -</UL> -</UL> -<HR> -<A NAME="def"> -<H2>Creating an Extendible Dataset</H2> -An extendible dataset is one whose dimensions can grow. -HDF5 allows you to define a dataset to have certain initial dimensions, -then to later increase the size of any of the initial dimensions. -<P> -HDF5 requires you to use chunking to define extendible datasets. -This makes it possible to extend datasets efficiently without -having to excessively reorganize storage. -<P> -The following operations are required in order to write an extendible dataset: -<OL> - <LI>Declare the dataspace of the dataset to have unlimited dimensions for all dimensions that might eventually be extended. - <LI>Set dataset creation properties to enable chunking. - <LI>Create the dataset. - <LI>Extend the size of the dataset. -</OL> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -This example shows how to create a 3 x 3 extendible dataset, write to that -dataset, extend the dataset to 10x3, and write to the dataset again. -<UL> -[<A HREF="examples/h5_extend.c">C example</A> ] - - <code>h5_extend.c</code><BR> -[<A HREF="examples/chunk.f90">FORTRAN example</A> ] - - <code>chunk.f90</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<P> -<UL> -<LI>The routine <CODE>H5Pcreate</CODE> / <CODE>h5pcreate_f</CODE> -creates a new property as an instance of - a property list. The signature is as follows: -<P> -<I><B>C:</B></I> -<pre> - hid_t H5Pcreate (H5P_class_t classtype) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5pcreate_f (classtype, prp_id, hdferr) - - classtype IN: INTEGER - prp_id OUT: INTEGER(HID_T) - hdferr OUT: INTEGER -</pre> -<P> -<UL> -<LI>The parameter <I>classtype</I> is the type of property list to create. - Valid class types are as follows: -<center> -<table border=1> - <tr align=center> - <td><b>C</b></td> - <td><b>FORTRAN</b></td> - </tr><tr align=left> - <td><code> <BR> - H5P_FILE_CREATE <BR> - H5P_FILE_ACCESS <BR> - H5P_DATASET_CREATE<BR> - H5P_DATASET_XFER <BR> - H5P_MOUNT <BR><BR> - </code></td> - <td><code> <BR> - H5P_FILE_CREATE_F <BR> - H5P_FILE_ACCESS_F <BR> - H5P_DATASET_CREATE_F<BR> - H5P_DATASET_XFER_F <BR> - H5P_MOUNT_F <BR><BR> - </code></td> - </tr> -</table> -</center> -<LI>In C, the property list identifier is returned if successful; -otherwise a negative value is returned, if not. -In FORTRAN, the property list identifier is returned in <I>prp_id</I> -and the return value for the call is returned in <I>hdferr</I>. -</UL> -<P> -<LI>The routine <CODE>H5Pset_chunk</CODE> / <CODE>h5pset_chunk_f</CODE> -sets the size of the chunks used - to store a chunked layout dataset. - The signature of this routine is as follows: -<P> -<I><B>C:</B></I> -<pre> - herr_t H5Pset_chunk (hid_t prp_id, int ndims, - const hsize_t * dims) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5pset_chunk_f (prp_id, ndims, dims, hdferr) - - prp_id IN: INTEGER(HID_T) - ndims IN: INTEGER - dims IN: INTEGER(HSIZE_T), DIMENSION(ndims) - hdferr OUT: INTEGER - -</pre> -<P> -<UL> -<LI>The <em>prp_id</em> parameter is the identifier for the property - list to query. -<LI>The <em>ndims</em> parameter is the number of dimensions of - each chunk. -<LI>The <em>dims</em> parameter is an array containing the size of - each chunk. -<LI>In C, a non-negative value is returned if successful; otherwise a - negative value is returned. - In FORTRAN, the return value is returned in <em>hdferr</em>: 0 if - successful and -1 otherwise. -</UL> -<P> -<LI>The <CODE>H5Dextend</CODE> / <CODE>h5dextend_f</CODE> routine -extends a dataset that has an unlimited - dimension. The signature is as follows: -<P> -<I><B>C:</B></I> -<pre> - herr_t H5Dextend (hid_t dset_id, const hsize_t * size) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5dextend_f (dset_id, size, hdferr) - - dset_id IN: INTEGER(HID_T) - size IN: INTEGER(HSIZE_T), DIMENSION(*) - hdferr OUT: INTEGER<BR> -</pre> -<P> -<UL> -<LI>The <em>dset_id</em> parameter is the dataset identifier. -<LI>The <em>size</em> parameter, is an array containing the - new magnitude of each dimension. -<LI>In C, this function returns a non-negative value if successful and - a negative value otherwise. - In FORTRAN, the return value is returned in <em>hdferr</em>: - 0 if successful and -1 otherwise. -</UL> -<P> -<LI>The <CODE>H5Dget_create_plist</CODE> / <CODE>h5dget_create_plist_f</CODE> -routine returns an identifier for a -copy of the dataset creation property list for a dataset. -<P> -<LI>The C function, <CODE>H5Pget_layout</CODE>, returns the layout of the raw data for a -dataset. Valid types are <CODE>H5D_CONTIGUOUS</CODE> and -<CODE>H5D_CHUNKED</CODE>. -A FORTRAN routine for <CODE>H5Pget_layout</CODE> does not yet exist. -<P> -<LI>The <CODE>H5Pget_chunk</CODE> / <CODE>h5pget_chunk_f</CODE> -routine retrieves the size of chunks -for the raw data of a chunked layout dataset. -The signature is as follows: -<P> -<I><B>C:</B></I> -<pre> - int H5Pget_chunk (hid_t prp_id, int ndims, hsize_t * dims) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5pget_chunk_f (prp_id, ndims, dims, hdferr) - - prp_id IN: INTEGER(HID_T) - ndims IN: INTEGER - dims OUT: INTEGER(HSIZE_T), DIMENSION(ndims) - hdferr OUT: INTEGER -</pre> -<P> -<UL> - -<LI>The <em>prp_id</em> parameter is the identifier of the - property list to query. -<LI>The <em>ndims</em> parameter is the size of the <em>dims</em> - array. -<LI>The <em>dims</em> parameter is the array in which to store the chunk - dimensions. -<LI>In C, this function returns the chunk dimensionality if successful - and a negative value otherwise. - In FORTRAN, the return value is returned in <em>hdferr</em>: - the chunked rank if successful and -1 otherwise. -</UL> -<P> -<LI>The <CODE>H5Pclose</CODE> / <CODE>h5pclose_f</CODE> routine - terminates access to a property list. - The signature is as follows: -<P> -<I><B>C:</B></I> -<pre> - herr_t H5Pclose (hid_t prp_id) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5pclose_f (prp_id, hdferr) - - prp_id IN: INTEGER(HID_T) - hdferr OUT: INTEGER -</pre> -<P> -<ul> -<li>The <em>prp_id</em> parameter is the identifier of the property list - to terminate access to. -</ul> -</UL> - - -<!-- -<A NAME="fc"> -<H3><U>File Contents</U></H3> ---> - - - - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/fileorg.html b/doc/html/Tutor/fileorg.html deleted file mode 100644 index 9efe0e6..0000000 --- a/doc/html/Tutor/fileorg.html +++ /dev/null @@ -1,102 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 File Organization -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">HDF5 File Organization</FONT> -</BIG></BIG></BIG></H1> - - -<hr noshade size=1> - -<BODY> -<P> -An HDF5 file is a container for storing a variety of scientific data -is composed of two primary types of objects: groups and datasets. -<UL> - <LI><B>HDF5 group:</B> a grouping structure containing zero or more HDF5 - objects, together with supporting metadata - - <LI><B>HDF5 dataset:</B> a multidimensional array of data elements, together - with supporting metadata -</UL> -Any HDF5 group or dataset may have an associated attribute list. An <B>HDF5 -attribute</B> is a user-defined HDF5 structure that provides extra information -about an HDF5 object. -<P> -Working with groups and datasets is similar in many -ways to working with directories and files in UNIX. As with UNIX directories -and files, an HDF5 object in an HDF5 file is often referred to by its -<B>full path name</B> (also called an <B>absolute path name</B>). -<UL> - <CODE>/</CODE> signifies the root group.<BR> - <CODE>/foo</CODE> signifies a member of the root group called <code>foo</code>. -<BR> - <CODE>/foo/zoo</CODE> signifies a member of the group <code>foo</code>, which in - turn is a member of the root group. -</UL> -<P> -<!-- -In this tutorial, we consider: -<UL> -<LI>how to create a file -<LI>how to create a group -<LI>how to create/read/write datasets -<LI>how to create an attribute -<LI>how to create a grouping structure -<LI>how to create datasets in groups -</UL> -The rest of the tutorial is organized as follows: -<UL> - <LI> Section 3 describes the HDF5 APIs. - <LI> Section 4 shows how to create an HDF5 file. - <LI> Section 5 shows how to create a dataset. - <LI> Section 6 shows how to read from and write to a dataset. - <LI> Section 7 shows how to create an attribute. - <LI> Section 8 shows how to create a group. - <LI> Section 9 discusses HDF5 names and shows how to create groups using absolute and relative names. - <LI> Section 10 shows how to create datasets in groups. -</UL> - -Each section contains step by step instructions and an example. After the -example, an HDF5 tool is used to examine the file contents. A formal definition -of HDF5 objects in Backus-Naur Form is given last. - -The tutorial ends with a glossary and references. ---> -<P> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/footer-ncsalogo.gif b/doc/html/Tutor/footer-ncsalogo.gif Binary files differdeleted file mode 100644 index 6c23ce8..0000000 --- a/doc/html/Tutor/footer-ncsalogo.gif +++ /dev/null diff --git a/doc/html/Tutor/glossary.html b/doc/html/Tutor/glossary.html deleted file mode 100644 index 6105150..0000000 --- a/doc/html/Tutor/glossary.html +++ /dev/null @@ -1,261 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Glossary -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Glossary</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<DL> -<DT><B>ATTRIBUTE</B> -<DD>An HDF5 attribute is a small dataset that can be used to describe - the nature and/or the intended usage of the object it is attached - to. - -<P> -<DT><B>BOOT BLOCK</B> -<DD>HDF5 files are composed of a "boot block" describing information required to portably access files on multiple platforms, followed by information -about the groups in a file and the datasets in the file. The boot block contains information about the size of offsets and lengths of objects, the -number of entries in symbol tables (used to store groups) and additional version information for the file. -<P> -<DT><B>DATASET</B> -<DD>An HDF5 dataset is a multi-dimensional array of data elements, - together with supporting metadata. - -<P> -<DT><B>DATASPACE</B> -<DD>An HDF5 dataspace is an object that describes the dimensionality - of the data array. A dataspace is either a regular N-dimensional - array of data points, called a simple dataspace, or a more - general collection of data points organized in another - manner, called a complex dataspace. - -<P> -<DT><B>DATATYPE</B> -<DD>An HDF5 Datatype is an object that describes the type of the - element in an HDF5 multi-dimensional array. There are two - categories of datatypes: atomic and compound data types. An - atomic type is a type which cannot be decomposed into smaller - units at the API level. A compound is a collection of one or - more atomic types or small arrays of such types. - -<P> -<DT><B>DATASET CREATION PROPERTY LIST</B> -<DD> The Dataset Creation Property List contains information on how - raw data is organized on disk and how the raw data is compressed. - The dataset API partitions these terms by layout, compression, - and external storage: -<UL> -<B> Layout:</B> -<UL> -<LI> H5D_COMPACT: Data is small and can be stored in object header (not - implemented yet). This eliminates disk seek/read requests. -<LI> H5D_CONTIGUOUS: (<B>default</B>) The data is large, non-extendible, - non-compressible, non-sparse, and can be stored - externally. -<LI> H5D_CHUNKED: The data is large and can be extended in any dimension. - It is partitioned into chunks so each chunk is the same - logical size. -</UL> -<B>Compression:</B> (gzip compression)<BR> -<B>External Storage Properties:</B> The data must be contiguous to be stored - externally. It allows you to store the data - in one or more non-HDF5 files. - -</UL> - -<P> -<DT><B>DATA TRANSFER PROPERTY LIST</B> -<DD> The data transfer property list is used to control various aspects - of the I/O, such as caching hints or collective I/O information. -<P> -<DT><B>DDL</B> -<DD>DDL is a Data Description Language that describes HDF5 objects - in Backus-Naur Form. - -<P> - -<DT><B>FILE ACCESS MODES</B> -<DD>The file access modes determine whether an existing file will be -overwritten. All newly created files are opened for both reading and -writing. Possible values are: -<PRE> - H5F_ACC_RDWR: Allow read and write access to file. - H5F_ACC_RDONLY: Allow read-only access to file. - H5F_ACC_TRUNC: Truncate file, if it already exists, erasing all data - previously stored in the file. - H5F_ACC_EXCL: Fail if file already exists. - H5F_ACC_DEBUG: Print debug information. - H5P_DEFAULT: Apply default file access and creation properties. -</PRE> -<P> -<DT><B>FILE ACCESS PROPERTY LIST</B> - <DD> File access property lists are used to control different methods - of performing I/O on files: -<UL> -<B>Unbuffered I/O:</B> Local permanent files can be accessed with the functions - described in Section 2 of the Posix manual, namely open(), lseek(), read(), - write(), and close(). <BR> -<B>Buffered I/O:</B> Local permanent files can be accessed with the functions - declared in the stdio.h header file, namely fopen(), fseek(), fread(), - fwrite(), and fclose().<BR> -<B>Memory I/O:</B> Local temporary files can be created and accessed directly from - memory without ever creating permanent storage. The library uses malloc() - and free() to create storage space for the file<BR> -<B>Parallel Files using MPI I/O:</B> This driver allows parallel access to a file - through the MPI I/O library. The parameters which can be modified are the - MPI communicator, the info object, and the access mode. The communicator - and info object are saved and then passed to MPI_File_open() during file - creation or open. The access_mode controls the kind of parallel access the - application intends.<BR> -<B>Data Alignment:</B> Sometimes file access is faster if certain things are aligned - on file blocks. This can be controlled by setting alignment properties of - a file access property list with the H5Pset_alignment() function. -</UL> -<P> -<DT><B>FILE CREATION PROPERTY LIST</B> -<DD> The file creation property list is used to control the file - metadata. The parameters that can be modified are: -<UL> - <B>User-Block Size:</B> The "user-block" is a fixed length block of data located - at the beginning of the file which is ignored by the HDF5 library and may - be used to store any data information found to be useful to applications. -<BR> -<B> Offset and Length Sizes:</B> The number of bytes used to store the offset and - length of objects in the HDF5 file can be controlled with this parameter. - Symbol Table Parameters: The size of symbol table B-trees can be controlled - by setting the 1/2 rank and 1/2 node size parameters of the B-tree. -<BR> -<B> Indexed Storage Parameters:</B> The size of indexed storage B-trees can be - controlled by setting the 1/2 rank and 1/2 node size parameters of the - B-tree. -</UL> -<P> - -<DT><B>GROUP</B> -<DD>A Group is a structure containing zero or more HDF5 objects, - together with supporting metadata. The two primary HDF5 objects - are datasets and groups. -<P> - -<DT><B>HDF5</B> -<DD>HDF5 is an abbreviation for Hierarchical Data Format Version 5. - This file format is intended to make it easy to write and read - scientific data -<P> -<UL> - <LI> by including the information needed to understand the data - within the file -<P> - <LI> by providing a library of C, FORTRAN, and other language - programs that reduce the work required to provide efficient - writing and reading - even with parallel IO -</UL> -<P> - -<DT><B>HDF5 FILE</B> -<DD>An HDF5 file is a container for storing grouped collections - of multi-dimensional arrays containing scientific data. -<P> - -<DT><B>H5DUMP</B> -<DD>h5dump is an HDF5 tool that describes the HDF5 file contents in DDL. -<P> - -<DT><B>HYPERSLAB</B> -<DD> -A hyperslab is a portion of a dataset. A hyperslab selection can be a -logically contiguous collection of points in a dataspace, or it -can be a regular pattern of points or blocks in a dataspace. -<P> -<DT><B>MOUNTING FILES</B> -<DD> -HDF5 allows you to combine two or more HDF5 files in a manner similar -to mounting files in UNIX. The group structure and metadata -from one file appear as though they exist in another file. -<P> - -<DT><B>NAMES</B> -<DD>HDF5 object names are a slash-separated list of components. A name - which begins with a slash is an absolute name which is accessed - beginning with the root group of the file while all other relative - names are accessed beginning with the specified group. -<P> -<DT><B>PARALLEL I/O (HDF5)</B> -<DD>The parallel I/O version of HDF5 supports parallel file access using -MPI (Message Passing Interface). -<P> - -<DT><B>REFERENCE</B> -<DD> -<B>OBJECT REFERENCE:</B><BR> - A reference to an entire object in the current HDF5 file. - <P> - An object - reference points to an entire object in the current HDF5 file by storing - the relative file address (OID) of the object header for the object - pointed to. The relative file address of an object header is constant - for the life of the object. An object reference is of a fixed size in - the file. -<P> -<B>DATASET REGION REFERENCE:</B><BR> - Reference to a specific dataset region. - <P> - A dataset region reference points to a region of a dataset in the - current HDF5 file by storing the OID of the dataset and the global - heap offset of the region referenced. The region referenced is - located by retrieving the coordinates of the areas in the region - from the global heap. A dataset region reference is of a variable - size in the file. -<P> -<DT><B>THREADSAFE (HDF5)</B> -<DD>A "thread-safe" version of HDF-5 (TSHDF5) is one that can be called from any thread of a multi-threaded program. Any calls to HDF -can be made in any order, and each individual HDF call will perform correctly. A calling program does not have to explicitly lock the HDF -library in order to do I/O. Applications programmers may assume that the TSHDF5 guarantees the following: -<UL> - <LI> the HDF-5 library does not create or destroy threads. - <LI> the HDF-5 library uses modest amounts of per-thread private memory. - <LI> the HDF-5 library only locks/unlocks it's own locks (no locks are passed in or returned from HDF), and the internal locking is guaranteed to be deadlock free. -</UL> -<P> -These properties mean that the TSHDF5 library will not interfere with an application's use of threads. A TSHDF5 library is the same -library as regular HDF-5 library, with additional code to synchronize access to the HDF-5 library's internal data structures. - -</DL> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/img001.gif b/doc/html/Tutor/img001.gif Binary files differdeleted file mode 100644 index b79c6d6..0000000 --- a/doc/html/Tutor/img001.gif +++ /dev/null diff --git a/doc/html/Tutor/img002.gif b/doc/html/Tutor/img002.gif Binary files differdeleted file mode 100644 index 67585ef..0000000 --- a/doc/html/Tutor/img002.gif +++ /dev/null diff --git a/doc/html/Tutor/img003.gif b/doc/html/Tutor/img003.gif Binary files differdeleted file mode 100644 index ac1dcf9..0000000 --- a/doc/html/Tutor/img003.gif +++ /dev/null diff --git a/doc/html/Tutor/img004.gif b/doc/html/Tutor/img004.gif Binary files differdeleted file mode 100644 index d48dbab..0000000 --- a/doc/html/Tutor/img004.gif +++ /dev/null diff --git a/doc/html/Tutor/img005.gif b/doc/html/Tutor/img005.gif Binary files differdeleted file mode 100644 index 3383dc6..0000000 --- a/doc/html/Tutor/img005.gif +++ /dev/null diff --git a/doc/html/Tutor/index.html b/doc/html/Tutor/index.html deleted file mode 100644 index 15cfa5b..0000000 --- a/doc/html/Tutor/index.html +++ /dev/null @@ -1,29 +0,0 @@ -<html> -<head> -<title>HDF5 Tutorial</title> -</head> - - -<frameset cols="110,*" border=0> - <frame src="Contents.html" scrolling="auto" name="BUTTONS"> - <frame src="title.html" scrolling="auto" name="CONTENT"> -</frameset> - -<noframes> - <b>HDF5 Tutorial</b> - <p> - If you are reading this message, your browser is not capable of - interpreting HTML frames. A no-frames version of the tutorial - is available by viewing the file <a href="title.html">title.html</a>. - <p> - If you owuld like to upgrade to a frames-capable browser, - we suggest upgrading to the most recent version of - Nestscape Communicator, Microsoft Internet Explorer, or - an equivalent browser. - <p> - In the meantime, you can view this tutorial by starting with the - file <a href="title.html">title.html</a>. -</noframes> - - -</html> diff --git a/doc/html/Tutor/intro.html b/doc/html/Tutor/intro.html deleted file mode 100644 index 47285ae..0000000 --- a/doc/html/Tutor/intro.html +++ /dev/null @@ -1,92 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Introduction -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<h1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Introduction</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -Welcome to the HDF5 Tutorial provided by the HDF User Support Group. -<P> -HDF5 is a file format and library for storing scientific data. -It was designed and implemented - to meet growing and ever-changing scientific data-storage - and data-handling needs, - to take advantage of the power and features of today's - computing systems, and - to address the deficiencies of HDF4.x. -HDF5 has a powerful and flexible data model, - supports files larger than 2 GB (the limit of HDF4.x files), and - supports parallel I/O. -Thread-safety is designed and is to be implemented in the near future. -For a short overview of the HDF5 data model, library, and tools, see -the slide presentation at the following URL: -<PRE> - <A HREF="http://hdf.ncsa.uiuc.edu/HDF5/papers/HDF5_overview/index.htm">http://hdf.ncsa.uiuc.edu/HDF5/papers/HDF5_overview/index.htm</A> -</PRE> -This tutorial covers the basic HDF5 data objects and file structure, -the HDF5 programming model, and the API functions necessary for creating and -modifying data objects. It also introduces the available HDF5 tools for accessing -HDF5 files. -<P> -The examples used in this tutorial, along with a Makefile to compile them, -can be found in <A HREF="./examples/">./examples/</A>. You can also download -a <A HREF="http://hdf.ncsa.uiuc.edu/training/other-ex5/examples.tar">tar -file</A> with the examples and Makefile. -To use the Makefile, you may have to edit it and update the -compiler and compiler options, as well as the path for the HDF5 -binary distribution. -The Java examples can be found in -a subdirectory of the ./examples/ directory called java/. The java/ -directory contains a Makefile and shell scripts for running the java -programs. -<P> -Please check the <A HREF="references.html">References</A> for pointers to -other examples of HDF5 Programs. -<P> -We hope that the step-by-step examples and instructions will give you a quick -start with HDF5. -<P> -Please send your comments and suggestions to hdfhelp@ncsa.uiuc.edu. - - -</BODY> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/iterate.html b/doc/html/Tutor/iterate.html deleted file mode 100644 index 3311509..0000000 --- a/doc/html/Tutor/iterate.html +++ /dev/null @@ -1,290 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Iterating over Group Members -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Iterating over Group Members</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#def">How to Iterate over Group Members Using C </A> - <LI><A HREF="#deff">How to Iterate over Group Members Using FORTRAN</A> - <LI>Programming Example -<UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#remc">Remarks for C Example</A> - <LI> <A HREF="#remf">Remarks for FORTRAN Example</A> -<!-- - <LI> <A HREF="#fc">File Contents</A> - <LI> <A HREF="#ddl">Dataset Definition in DDL</A> ---> -</UL> -</UL> -<HR> -<A NAME="def"> -<H2>How to Iterate over Group Members Using C</H2> -This section discusses how to find names and object types of HDF5 group -members using C. -<P> -The HDF5 Group interface includes the <CODE>H5Giterate</CODE> function, -which iterates over the group members. -<P> -Operations on each group member can be performed during the iteration process -by passing the operator function and its data to the iterator as parameters. -There are no restrictions on what kind of operations can be performed on -group members during the iteration procedure. -<P> -The following steps are involved: -<OL> - -<LI> Write an operator function which will be used during the iteration process. - The HDF5 library defines the operator function signature and return values. -<LI> Open the group to iterate through. -<LI> Iterate through the group or just a few members of the group. -</OL> -<A NAME="deff"> -<H2>How to Iterate Over Group Members using FORTRAN</H2> -There is no FORTRAN call to iterate over group members. -Instead, this functionality is provided by two FORTRAN calls: -<ul> - <li><CODE>hgn_members_f</CODE> returns the number of group members. - <li><CODE>h5gget_obj_info_idx_f</CODE> returns the name and type of the - group member, which is identified by its index. -</ul> -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -In this example we iterate through the members of the root group. -<UL> -[ <A HREF="examples/h5_iterate.c">C example</A> ] - - <code>h5_iterate.c</code><BR> -[ <A HREF="examples/grpit.f90">FORTRAN example</A> ] - - <code>grpit.f90</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. -<P> -Following is the output from these examples: -<P> -<I><U>Output from C Example</U></I> -<PRE> - Objects in the root group are: - - Object with name Dataset1 is a dataset - Object with name Datatype1 is a named datatype - Object with name Group1 is a group -</PRE> -<I><U>Output from FORTRAN Example</U></I> -<PRE> - Number of root group member is 1 - MyGroup 1 - Number of group MyGroup member is 2 - Group_A 1 - dset1 2 - Number of group MyGroup/Group_A member is 1 - dset2 2 -</PRE> -<A NAME="remc"> -<H3><U>Remarks for C Example</U></H3> -<P> -<UL> -<LI> The operator function in this example is called <I>file_info</I>. - The signature of the operator function is as follows: -<PRE> - herr_t *(H5G_operator_t) (hid group_id, const char* name, - void *operator_data) -</PRE> -<UL> - <LI>The <em>group_id</em> parameter is a group identifier for the - group being iterated over. - It is passed to the operator by the iterator function, - <CODE>H5Giterate</CODE>. -<P> - <LI>The <em>name</em> parameter is the name of the current object. - The name is passed to the operator function by the HDF5 library. -<P> - <LI> The <em>operator_data</em> parameter is the operator data. - It is passed to and from - the operator by the iterator, <CODE>H5Giterate</CODE>. -</UL> -<P> - The operator function in this example simply prints the name and type - of the current object and then exits. - This information can also be used to open the object and perform - different operations or queries. For example a named datatype object's - name can be used to open the datatype and query its properties. -<P> - The operator return value defines the behavior of the iterator. - <UL> -<P> - <LI>A zero return value causes the iterator to continue, returning - zero when all group members have been processed. -<P> - <LI>A positive value causes the iterator to immediately return that - value, indicating a short-circuit success. The iterator can be restarted - at the next group member. -<P> - <LI>A negative value causes the iterator to immediately return that value, - indicating failure. The iterator can be restarted at the next group - member. - </UL> -<P> - In this example the operator function returns 0, which causes the iterator - to continue and go through all group members. -<P> -<LI>The function <CODE>H5Gget_objinfo</CODE> is used to determine the type of the object. - It also returns the modification time, number of hard links, and some - other information. -<P> - The signature of this function is as follows: -<PRE> - herr_t H5Gget_objinfo (hid_t loc_id, const char * name, - hbool_t follow_link, - H5G_stat_t *statbuf) -</PRE> -<UL> - <LI>The <em>loc_id</em> and <em>name</em> arguments - specify the object by its location and name. - This example uses the group identifier and name relative to the group - to specify the object. -<P> - <LI>The <em>follow_link</em> argument is a flag which indicates - whether a symbolic link should be followed. A zero value indicates - that information should be returned for the link itself, but not - about the object it points to. -<P> - The root group in this example does not have objects that are - links, so this flag is not important for our example. -<P> - <LI>The <em>statbuf</em> argument is the buffer in which to return - information. - Type information is returned into the field <em>type</em> of the - <CODE>H5G_stat_t</CODE> data structure (<code>statbuf.type</code>). - Valid values are - <CODE>H5G_GROUP</CODE>, <CODE>H5G_DATASET</CODE>, - <CODE>H5G_TYPE</CODE>, and <CODE>H5G_LINK</CODE>. -</UL> -<P> -<LI> The <CODE>H5Giterate</CODE> function has the following signature: -<PRE> - int H5Giterate (hid_t loc_id, const char *name , int *idx, - H5G_operator_t operator, void * operator_data) -</PRE> -<UL> - <LI> The <em>loc_id</em> parameter is the group identifier for the - group being iterated over. - <LI> The <em>name</em> parameter is the group name. - <LI> The <em>idx</em> parameter is an index specifying that iteration - begins with the <em>idx</em>-th object in the group. - Upon the function's return, the index of the next element - to be processed is returned in <I>idx</I>. In our example, NULL is - used to start at the first group member. Since no stopping point - is returned in this case, the iterator cannot be restarted if one - of the calls to its operator returns a non-zero value. - <LI> The <em>operator</em> parameter is the operator function. - <LI> The <em>operator_data</em> argument is the operator data. - We used NULL since no data was passed to or from the operator. -</UL> -</UL> - -<A NAME="remf"> -<H3><U>Remarks for FORTRAN Example</U></H3> -<P> -<UL> -<LI>This program creates an HDF5 file with groups in it and - then uses <CODE>h5gn_members_f</CODE> to get the number of members in - each group and <CODE>h5gget_obj_idx_f</CODE> to obtain the group member's - name and type. -<P> -<LI>The number of members in a group are obtained with the -<CODE>h5gn_members_f</CODE> call: -<PRE> - h5gn_members_f (loc_id, name, nmembers, hdferr) - - loc_id IN: INTEGER (HID_T) - name IN: CHARACTER (LEN=*) - nmembers OUT: INTEGER - hdferr OUT: INTEGER -</PRE> -<UL> - <LI>The <I>loc_id</I> parameter is the file or group identifier. - <LI>The <I>name</I> parameter is the name of the group to obtain the number - of members in. - <LI>The number of members in the group is returned in <I>nmembers</I>. - <LI>The <I>hdferr</I> parameter contains the return code from the - call: 0 if successful and -1 otherwise. -</UL> -<P> -<LI>The name of each group and its type are obtained with the -<CODE>h5gget_obj_info_idx_f</CODE> call: -<PRE> - h5gget_obj_info_idx_f (loc_id, name, idx, & - obj_name, obj_type, hdferr) - - loc_id IN: INTEGER (HID_T) - name IN: CHARACTER (LEN=*) - idx IN: INTEGER - obj_name OUT: CHARACTER (LEN=*) - obj_type OUT: INTEGER - hdferr OUT: INTEGER - </PRE> -<UL> -<LI>The <I>loc_id</I> parameter is the file or group identifier. -<LI>The <I>name</I> parameter is the name of the group. -<LI>The <I>idx</I> parameter is the index of the member object. -<LI>The <I>obj_name</I> parameter is the name of the object that gets returned. -<LI>The <I>obj_type</I> parameter is the object type that gets returned. - Valid values are as follows: -<PRE> - H5G_LINK_F - H5G_GROUP_F - H5G_DATASET_F - H5G_TYPE_F -</PRE> -<LI>The <I>hdferr</I> parameter contains the return code from the - call: 0 if successful and -1 otherwise. -</UL> -</UL> - - - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/mount.html b/doc/html/Tutor/mount.html deleted file mode 100644 index 1094231..0000000 --- a/doc/html/Tutor/mount.html +++ /dev/null @@ -1,255 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Mounting Files -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Mounting Files</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">Mounting Files</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> -<!-- - <LI> <A HREF="#fc">File Contents</A> ---> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>Mounting Files</H2> - -HDF5 allows you to combine two or more HDF5 files in memory -in a manner similar to mounting files in UNIX. -The group structure and metadata from one file appear as though -they exist in another file. The following steps are involved: -<OL> -<LI>Open the files. - -<LI>Choose the <strong>mount point</strong> in the first file - (the parent file). The mount point in - HDF5 is a group, which CANNOT be the root group. - -<LI>Use the HDF5 routine <CODE>H5Fmount</CODE> / <CODE>h5fmount_f</CODE> - to mount the second file (the child file) in the first file. - -<LI>Work with the objects in the second file as if they were members of - the mount point group in the first file. The previous contents of - the mount point group are temporarily hidden. - -<LI>Unmount the second file using <CODE>H5Funmount</CODE> / - <CODE>h5funmount_f</CODE> when the work is done. -</OL> - -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> - -In the following example, we create one file containing a group and -another file containing a dataset. -Mounting is used to access the dataset from the second -file as a member of a group in the first file. -The following figures illustrate this concept. -<PRE> - - FILE1 FILE2 - - -------------------- -------------------- - ! ! ! ! - ! / ! ! / ! - ! | ! ! | ! - ! | ! ! | ! - ! V ! ! V ! - ! -------- ! ! ---------- ! - ! ! Group ! ! ! ! Dataset! ! - ! --------- ! ! ---------- ! - !------------------! !------------------! -</PRE> -After mounting <code>FILE2</code> under the group in <code>FILE1</code>, -the parent file has the following structure: -<PRE> - - FILE1 - - -------------------- - ! ! - ! / ! - ! | ! - ! | ! - ! V ! - ! -------- ! - ! ! Group ! ! - ! --------- ! - ! | ! - ! | ! - ! V ! - ! ----------- ! - ! ! Dataset ! ! - ! !---------- ! - ! ! - !------------------! - -</PRE> -[ <A HREF="examples/h5_mount.c">C program</A> ] - - <code>h5_mount.c</code><BR> -[ <A HREF="examples/mountexample.f90">FORTRAN program</A> ] - - <code>mountexample.f90</code> -<P> - -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI> The first part of the program creates a group in one file and creates - and writes a dataset to another file. -<P> -<LI> Both files are reopened and the second file is mounted in the first - using <CODE>H5Fmount</CODE> / <CODE>h5fmount_f</CODE>. - If no objects will be modified, the - files can be opened with <CODE>H5F_ACC_RDONLY</CODE> - (<CODE>H5F_ACC_RDONLY_F</CODE> in FORTRAN). - If the data is to be modified, the files should be opened with - <CODE>H5F_ACC_RDWR</CODE> (<CODE>H5F_ACC_RDWR_F</CODE> in FORTRAN). -<P> -<I><B>C:</B></I> -<pre> - herr_t H5Fmount (hid_t loc_id, const char *dsetname, - hid_t file_id, hid_t access_prp) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5fmount_f (loc_id, dsetname, file_id, hdferr, access_prp) - - loc_id IN: INTEGER (HID_T) - dsetname IN: CHARACTER (LEN=*) - file_id IN: INTEGER (HID_T) - hdferr OUT: INTEGER - access_prp IN: INTEGER (HID_T), OPTIONAL - (Default value: H5P_DEFAULT_F) -</pre> -<P> -<UL> - <LI> The <em>loc_id</em> and <em>dsetname</em> arguments - specify the location of the mount point. - In this example, the mount point is a group <code>/G</code> in the - specified file. Since the group <code>/G</code> is in the root - group of the first file, one can also use just <code>G</code> to - identify it. -<P> - Below is a description of another scenario: - <p> - Suppose the group <code>G</code> were a member of - the group <code>H</code> in the first file. - Then the mount point <code>G</code> can be specified in - two different ways: -<P> -<UL> - <LI> <em>loc_id</em> is the file identifier for the first file.<BR> - <em>dsetname</em> is <code>H/G</code>. -<P> - <LI> <em>loc_id</em> is the identifier for the group <code>H</code>.<BR> - <em>dsetname</em> is <code>G</code>. -</UL> - <P> - <LI> The <em>file_id</em> argument is the identifier for the file - which will be mounted. - Only one file can be mounted per mount point. -<P> - <LI> The <I>access_prp</I> argument is the identifier for the property list - to be used. Currently, only the default property list, - <CODE>H5P_DEFAULT</CODE>, can be used in C. - In FORTRAN, this argument can be omitted or - <CODE>H5P_DEFAULT_F</CODE> can be used. -<P> - <LI> The C function <CODE>H5Fmount</CODE> returns a non-negative - value if successful and a negative value otherwise. - With the FORTRAN routine, <CODE>h5fmount_f</CODE>, - the return value of the call is returned in <em>hdferr</em>: - 0 if successful and -1 otherwise. -</UL> -<P> -<LI>In this example, we only read data from the dataset <code>D</code>. - One can also modify data. - If the dataset is modified while the file is mounted, it is - modified in the original file after the file is unmounted. -<P> -<LI> The file is unmounted with <CODE>H5Funmount</CODE> / -<CODE>h5funmount_f</CODE>: -<P> -<I><B>C:</B></I> -<pre> - herr_t H5Funmount (hid_t loc_id, const char *dsetname) -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - h5funmount_f (loc_id, dsetname, hdferr) - - loc_id IN: INTEGER (HID_T) - dsetname IN: CHARACTER (LEN=*) - hdferr OUT: INTEGER -</pre> -<P> -<ul> - <li>The <I>loc_id</I> and <I>dsetname</I> arguments specify the location - of the mount point. - In our example <I>loc_id</I> is the first file's file identifier - and <I>dsetname</I> is the name of group <code>/G</code>. -</ul> -<P> -<li>Note that <CODE>H5Funmount</CODE> / <CODE>h5funmount_f</CODE> - does not close files. Files are closed with the respective calls to - the <CODE>H5Fclose</CODE> / <CODE>h5fclose_f</CODE> function. -<P> -<li>Closing the parent file automatically unmounts the child file. -<P> -<LI>The <code>h5dump</code> utility cannot display files in memory. - Therefore, no output of <code>FILE1</code> after <code>FILE2</code> - was mounted is provided. -</UL> -</UL> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/property.html b/doc/html/Tutor/property.html deleted file mode 100644 index 13035f2..0000000 --- a/doc/html/Tutor/property.html +++ /dev/null @@ -1,167 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Property Lists -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Property Lists</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<!-- -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">Definition of Property Lists</A> -</UL> -<HR> -<A NAME="def"> ---> -<P> -The property list interface provides a mechanism for adding functionality -to HDF5 calls, without increasing the number of arguments used -for a given call. -<P> -A property list is a collection of values which can -be passed to various HDF5 functions to control features that -are typically unimportant or whose default values are usually used -(by specifying <code>H5P_DEFAULT</code> / <CODE>H5P_DEFAULT_F</CODE>). -<P> -It supports unusual cases when: - -<UL> -<LI><A HREF="#cf">Creating Files</A> -<LI><A HREF="#fa">Accessing Files</A> -<LI><A HREF="#cd">Creating Datasets</A> -<LI><A HREF="#rdwt">Reading or Writing Data</A> -</UL> - - -<A NAME="cf"> -<H3>Creating Files</H3> -The File Creation property list, H5P_FILE_CREATE, applies to H5Fcreate() -only and is used to control the file metadata which is maintained in the -super block of the file. The parameters that can be modified are: -user-block size, offset and length sizes, symbol table parameters, -and index storage parameters. -<P> -The following example shows how to create a file with 64-bit object -offsets and lengths: -<PRE> - hid_t create_plist; - hid_t file_id; - - create_plist = H5Pcreate(H5P_FILE_CREATE); - H5Pset_sizes(create_plist, 8, 8); - - file_id = H5Fcreate("test.h5", H5F_ACC_TRUNC, - create_plist, H5P_DEFAULT); - . - . - . - H5Fclose(file_id); -</PRE> - -<A NAME="fa"> -<H3>Accessing Files</H3> -The File Access property list, H5P_FILE_ACCESS, applies to H5Fcreate() and -H5Fopen() and is used to control different methods of -performing I/O on files. The different types of I/O are: unbuffered I/O, -buffered I/O, memory I/O, parallel files using MPI I/O, and data alignment. -<P> -Following is an example of using the H5P_FILE_ACCESS property list for creating -HDF5 files with the metadata and data split into different files: -<BR> -[ <A HREF="examples/h5split.c">C program</A> ] - - <code>h5split.c</code><BR> -<P> - -<A NAME="cd"> -<h3>Creating Datasets</H3> -The Dataset Creation property list, H5P_DATASET_CREATE, applies to -H5Dcreate() and controls information on how raw data -is organized on disk and how the raw data is compressed. The dataset API -partitions these terms by layout, compression, and external storage: -<P> -<UL> - <LI>Layout: -<UL> -<LI>H5D_COMPACT: Data is small and can be stored in object header (<I>not - implemented yet</I>). This eliminates disk seek/read requests. -<P> -<LI>H5D_CONTIGUOUS: (default) The data is large, non-extendible, -non-compressible, non-sparse, and can be stored externally. -<P> -<LI>H5D_CHUNKED: The data is large and can be extended in any dimension. -It is partitioned into chunks so each chunk is the same logical size. -Following is an example that uses the H5P_DATASET_CREATE property list to create -a chunked and extendible dataset: -<BR> -[ <A HREF="examples/h5_extend.c">C program</A> ] - - <code>h5_extend.c</code><BR> -<P> -</UL> -<LI>Compression: (gzip compression) -<LI>External Storage Properties: The data must be contiguous to be stored - externally. It allows you to store the data in one or more non-HDF5 files. -Following is an example of using the H5P_DATASET_CREATE property list to -create a dataset in an external file: -<BR> -[ <A HREF="examples/h5_crtextd.c">C program</A> ] - - <code>h5_crtextd.c</code><BR> -<P> -</UL> -</UL> -<A NAME="rdwt"> -<H3>Reading or Writing Data</H3> - -The Data Transfer property list, H5P_DATASET_XFER, is used to control -various aspects of I/O, such as caching hints or collective I/O information. -<P> -The following code sets the maximum size for the type conversion buffer -and background buffer: -<PRE> - plist_xfer = H5Pcreate (H5P_DATASET_XFER); - H5Pset_buffer(plist_xfer, (hsize_t)NX*NY*NZ, NULL, NULL); - status = H5Dread (dataset, H5T_NATIVE_UCHAR, memspace, dataspace, - plist_xfer); -</PRE> -<!-- -See:<BR> - [ <A HREF="examples/h5_xfer.c">C program</A> ] - - <code> h5_xfer.c</code><BR> ---> - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/questions.html b/doc/html/Tutor/questions.html deleted file mode 100644 index d0d3b51..0000000 --- a/doc/html/Tutor/questions.html +++ /dev/null @@ -1,159 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Introductory Topics Quiz -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Introductory Topics Quiz</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - - -<h3>Section 2: HDF File Organization</h3> - -<ol> -<li>Name and describe the two primary objects that can be stored in an HDF5 - file. - -<p> -<li>What is an attribute? - -<p> -<li>Give the path name for an object called <code>harry</code> that is a member of a - group called <code>dick</code>, which, in turn, is a member of the root group. -</ol> - - -<h3>Section 3: The HDF5 API</h3> - -<ol> -<li>Describe the purpose of each of the following HDF5 APIs: - <dir> - H5A, H5D, H5E, H5F, H5G, H5T, H5Z - </dir> -</ol> - - -<h3>Section 4: Creating an HDF5 File</h3> - -<ol> -<li>What two HDF5 routines must be called to create an HDF5 file? - -<p> -<li>What include file must be included in any file that uses the HDF5 library? - -<p> -<li>An HDF5 file is never completely empty because as soon as it is created, - it automatically contains a certain primary object. What is that object? -</ol> - - -<h3>Section 5: Creating a Dataset</h3> - -<ol> -<li>Name and describe two major datatype categories. - -<p> -<li>List the HDF5 atomic datatypes. Give an example of a predefined datatype. - -<p> -<li>What does the dataspace describe? What are the major characteristics of - the simple dataspace? - -<p> -<li>What information needs to be passed to the <code>H5Dcreate</code> - function, i.e., what information is needed to describe a dataset at - creation time? -</ol> - - -<h3>Section 6: Reading from and Writing to a Dataset</h3> - -<ol> -<li>What are six pieces of information which need to be specified for - reading and writing a dataset? - -<p> -<li>Why are both the memory dataspace and file dataspace needed for - read/write operations, while only the memory datatype is required? - -<p> -<li>What does the line - <br> - <code>DATASPACE { SIMPLE (4 , 6 ) / ( 4 , 6 ) } </code> - <br>in Figure 6.1 mean? -</ol> - - -<h3>Section 7: Creating an Attribute</h3> - -<ol> -<li>What is an attribute? - -<p> -<li>Can partial I/O operations be performed on attributes? -</ol> - - -<h3>Section 8: Creating a Group</h3> - -<ol> -<li>What are the two primary objects that can be included in a group? -</ol> - - -<h3>Section 9: Creating Groups Using Absolute and Relative Names</h3> - -<ol> -<li>Group names can be specified in two ways. What are these two types - of group names? - -<p> -<li>You have a dataset named <code>moo</code> in the group <code>boo</code>, which is - in the group <code>foo</code>, which, in turn, is in the root group. - How would you specify an absolute name to access this dataset? -</ol> - - -<h3>Section 10: Creating Datasets in Groups</h3> - -<ol> -<li>Describe a way to access the dataset <code>moo</code> described in the -previous section (Section 9, question 2) using a relative name. -Describe a way to access the same dataset using an absolute name. -</ol> - -</PRE> -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/rdwt.html b/doc/html/Tutor/rdwt.html deleted file mode 100644 index 391a0bc..0000000 --- a/doc/html/Tutor/rdwt.html +++ /dev/null @@ -1,409 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Reading from and Writing to a Dataset -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Reading from and Writing to a Dataset</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#rdwr">Reading from and Writing to a Dataset</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description </A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> - </UL> -<HR> -<A NAME="rdwr"> -<H2>Reading from and Writing to a Dataset</h2> -<P> -During a dataset I/O operation, the library transfers raw data between memory -and the file. The data in memory can have a datatype different from that of -the file and can also be of a different size -(i.e., the data in memory is a subset of the dataset elements, or vice versa). -Therefore, to perform read or write operations, the application -program must specify: -<UL> - <LI> The dataset - - <LI> The dataset's datatype in memory - - <LI> The dataset's dataspace in memory - - <LI> The dataset's dataspace in the file - - <LI>The dataset transfer property list - (The dataset transfer property list controls various aspects of the - I/O operations, such as the number of processes participating in a - collective I/O request or hints to the library to control caching of - raw data. In this tutorial, we use the default dataset transfer - property list.) - - <LI> The data buffer -</UL> - - -<P> -The steps to read from or write to a dataset are -as follows: -<OL> - <LI> Obtain the dataset identifier. - <LI> Specify the memory datatype. - <LI> Specify the memory dataspace. - <LI> Specify the file dataspace. - <LI> Specify the transfer properties. - <LI> Perform the desired operation on the dataset. - <LI> Close the dataset. - <LI> Close the dataspace, datatype, and property list if necessary. -</OL> - -To read from or write to a dataset, -the <code>H5Dread</code>/<code>h5dread_f</code> and -<code>H5Dwrite</code>/<code>h5dwrite_f</code> -routines are used. <P> -<I>C</I>: -<PRE> - status = H5Dread (set_id, mem_type_id, mem_space_id, file_space_id, - xfer_prp, buf ); - status = H5Dwrite (set_id, mem_type_id, mem_space_id, file_space_id, - xfer_prp, buf); - -</PRE> -<I>FORTRAN</I>: -<PRE> - CALL h5dread_f(dset_id, mem_type_id, buf, error, & - mem_space_id=mspace_id, file_space_id=fspace_id, & - xfer_prp=xfer_plist_id) - <font face=times><i>or</i></font> - CALL h5dread_f(dset_id, mem_type_id, buf, error) - - - CALL h5dwrite_f(dset_id, mem_type_id, buf, error, & - mem_space_id=mspace_id, file_space_id=fspace_id, & - xfer_prp=xfer_plist_id) - <font face=times><i>or</i></font> - CALL h5dwrite_f(dset_id, mem_type_id, buf, error) -</PRE> - - -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The following example shows how to read and write an existing dataset. -It opens the file created in the previous example, obtains the dataset -identifier for the dataset <code>/dset</code>, -writes the dataset to the file, then reads the dataset back from -memory. It then closes the dataset and file. <BR> -<UL> -[ <A HREF="examples/h5_rdwt.c">C Example</A> ] - <code>h5_rdwt.c</code> <BR> -[ <A HREF="examples/rwdsetexample.f90">FORTRAN Example</A> ] - <code>rwdsetexample.f90</code><BR> -[ <A HREF="examples/java/DatasetRdWt.java">Java Example</A> ] - <code>DatasetRdWt.java</code> <BR> -</UL> - -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - -</PRE> -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><code>H5Fopen</code>/<code>h5fopen_f</code> opens an existing file and - returns a file identifier. -<PRE> -<I>C</I>: - hid_t H5Fopen (const char *name, unsigned access_mode, hid_t access_prp) - -<I>FORTRAN</I>: - h5fopen_f (name, access_mode, file_id, hdferr, access_prp) - - name CHARACTER(LEN=*) - access_mode INTEGER - (Possible values: H5F_ACC_RDWR_F, H5F_ACC_RDONLY_F) - file_id INTEGER(HID_T) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - access_prp INTEGER(HID_T), OPTIONAL - -</PRE> -<UL> - <LI> The argument <I>name</I> is the filename. - <P> - <LI> The <I>access_mode</I> parameter is the file access mode. - <code>H5F_ACC_RDWR</code> in C - (<code>H5F_ACC_RDWR_F</code> in FORTRAN) - allows read/write access - while <code>H5F_ACC_RDONLY</code> in C - (<code>H5F_ACC_RDONLY_F</code> in FORTRAN) - allows read-only access. - - <P> - <LI> The <I>access_prp</I> parameter identifies the file access property list. - <code>H5P_DEFAULT</code> in C and <code>H5P_DEFAULT_F</code> in FORTRAN - specify the default file access property list. - This parameter is optional in FORTRAN; if it is omitted, the default file - access property list is used. - - <P> - <LI>In FORTRAN, the return code is passed back in the <I>hdferr</I> - parameter: 0 if successful, -1 if not. In C, the function returns - the file identifier if successful, and a negative value otherwise. -</UL> -<P> -<LI> <code>H5Dopen</code>/<code>h5dopen_f</code> opens an existing dataset - with the name specified by <i>name</i> at the location specified by - <i>loc_id</i>. - For FORTRAN, the return value is passed in the <I>hdferr</I> parameter: - 0 if successful, -1 if not. For C, the function returns the dataset - identifier if successful, and a negative value if not. - <P> -<I>C</I>: -<PRE> - hid_t H5Dopen (hid_t loc_id, const char *name) -</PRE> -<I>FORTRAN</I>: -<PRE> - h5dopen_f(loc_id, name, hdferr) - - loc_id INTEGER(HID_T) - name CHARACTER(LEN=*) - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) -</PRE> - -<P> -<LI><code>H5Dwrite</code>/<code>h5dwrite_f</code> writes raw data - from an application buffer to the specified - dataset, converting from the datatype and dataspace of the dataset in - memory to the datatype and dataspace of the dataset in the file. -<P> -<I>C</I>: -<PRE> - herr_t H5Dwrite (hid_t dset_id, hid_t mem_type_id, hid_t mem_space_id, - hid_t file_space_id, hid_t xfer_prp, const void * buf) -</PRE> -<I>FORTRAN</I>: -<PRE> - h5dwrite_f (dset_id, mem_type_id, buf, hdferr, mem_space_id, & - file_space_id, xfer_prp) - - dset_id INTEGER(HID_T) - mem_type_id INTEGER(HID_T) - buf(*,...*) TYPE - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - mem_space_id INTEGER(HID_T), OPTIONAL - (Default value: H5S_ALL_F) - file_space_id INTEGER(HID_T), OPTIONAL - (Default value: H5S_ALL_F) - xfer_prp INTEGER(HID_T), OPTIONAL - (Default value: H5P_DEFAULT_F) -</PRE> -<UL> - <LI> The <I>dset_id</I> is the dataset identifier. - <P> - - <LI> The <I>mem_type_id</I> parameter is the identifier of the dataset's - memory datatype. <code>H5T_NATIVE_INT</code> in C - (<code>H5T_NATIVE_INTEGER</code> in FORTRAN) is an integer datatype - for the machine on which the library was compiled. - <P> - - <LI> The <I>mem_space_id</I> parameter is the identifier of the dataset's - memory dataspace. <code>H5S_ALL</code> in C (<code>H5S_ALL_F</code> - in FORTRAN) is the default value and indicates that the whole dataspace - in memory is selected for the I/O operation. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - <P> - - <LI> The <I>file_space_id</I> parameter is the identifier of the - dataset's file dataspace. - <code>H5S_ALL</code> in C (<code>H5S_ALL_F</code> in FORTRAN) - is the default value and indicates that the entire dataspace of - the dataset in the file is selected for the I/O operation. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - <P> - - <LI> The <I>xfer_prp</I> parameter is the data transfer propery list - identifier. - <code>H5P_DEFAULT</code> in C - (<code>H5P_DEFAULT_F</code> in FORTRAN) is the default value and - indicates that the default data transfer property list is used. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - <P> - - <LI> The <I>buf</I> parameter is the data buffer to write. - <P> - - <LI> In FORTRAN, the <I>hdferr</I> parameter is for the error code - passed back: 0 if successful, -1 if not. In C, this function - returns a non-negative value if successful; otherwise it returns - a negative value. -</UL> -<P> -<LI><code>H5Dread</code>/<code>h5dread_f</code> reads raw data from the - specified dataset to an application buffer, - converting from the file datatype and dataspace to the memory datatype and - dataspace. -<P> -<I>C</I>: -<PRE> - herr_t H5Dread (hid_t dset_id, hid_t mem_type_id, hid_t mem_space_id, - hid_t file_space_id, hid_t xfer_prp, void * buf) -</PRE> -<I>FORTRAN</I>: -<PRE> - h5dread_f (dset_id, mem_type_id, buf, hdferr, mem_space_id, & - file_space_id, xfer_prp) - - dset_id INTEGER(HID_T) - mem_type_id INTEGER(HID_T) - buf(*,...*) TYPE - hdferr INTEGER - (Possible values: 0 on success and -1 on failure) - mem_space_id INTEGER(HID_T), OPTIONAL - (Default value: H5S_ALL_F) - file_space_id INTEGER(HID_T), OPTIONAL - (Default value: H5S_ALL_F) - xfer_prp INTEGER(HID_T), OPTIONAL - (Default value: H5P_DEFAULT_F) - -</PRE> - -<p> -<UL> - <LI>The <I>dset_id</I> parameter is the dataset identifier. - <P> - - <LI>The <I>mem_type_id</I> parameter is the identifier of the dataset's - memory datatype. <code>H5T_NATIVE_INT</code> in C - (<code>H5T_NATIVE_INTEGER</code> in FORTRAN) is an integer datatype - for the machine on which the library was compiled. - <P> - - <LI>The <I>mem_space_id</I> parameter is the identifier of the dataset's - memory dataspace. <code>H5S_ALL</code> in C (<code>H5S_ALL_F</code> - in FORTRAN) is the default value and indicates that the whole dataspace - in memory is selected for the I/O operation. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - <P> - - <LI>The <I>file_space_id</I> parameter is the identifier of the - dataset's file dataspace. - <code>H5S_ALL</code> in C (<code>H5S_ALL_F</code> in FORTRAN) - is the default value and indicates that the entire dataspace of - the dataset in the file is selected for the I/O operation. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - - <P> - <LI>The <I>xfer_prp</I> parameter is the data transfer propery list - identifier. - <code>H5P_DEFAULT</code> in C - (<code>H5P_DEFAULT_F</code> in FORTRAN) is the default value and - indicates that the default data transfer property list is used. - This parameter is optional in FORTRAN; if it is omitted, the default - will be used. - <P> - - <LI> The <I>buf</I> parameter is the data buffer to read into. - <P> - - <LI> In FORTRAN, the <I>hdferr</I> parameter is for the error code - passed back: 0 if successful, -1 if not. In C, this function - returns a non-negative value if successful; otherwise it returns - a negative value. -</UL> -</UL> -<A NAME="fc"> -<H3><U>File Contents</U></H3> -Figure 6.1a shows the contents of <code>dset.h5</code> (created by the C program). -<BR> -Figure 6.1b shows the contents of <code>dsetf.h5</code> (created by the FORTRAN -program). -<P> - <B>Fig. 6.1a</B> <I><code>dset.h5</code> in DDL</I> -<PRE> - HDF5 "dset.h5" { - GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 4, 6 ) / ( 4, 6 ) } - DATA { - 1, 2, 3, 4, 5, 6, - 7, 8, 9, 10, 11, 12, - 13, 14, 15, 16, 17, 18, - 19, 20, 21, 22, 23, 24 - } - } - } - } -</PRE> -<P> - <B>Fig. 6.1b</B> <I><code>dsetf.h5</code> in DDL</I> -<PRE> -HDF5 "dsetf.h5" { -GROUP "/" { - DATASET "dset" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 6, 4 ) / ( 6, 4 ) } - DATA { - 1, 7, 13, 19, - 2, 8, 14, 20, - 3, 9, 15, 21, - 4, 10, 16, 22, - 5, 11, 17, 23, - 6, 12, 18, 24 - } - } -} -} -</PRE> - - - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/references.html b/doc/html/Tutor/references.html deleted file mode 100644 index 3787e88..0000000 --- a/doc/html/Tutor/references.html +++ /dev/null @@ -1,66 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - References -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">References</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<UL> - <LI><B>HDF Home Page:</B> - <A HREF="http://hdf.ncsa.uiuc.edu/">http://hdf.ncsa.uiuc.edu/</A> -<P> - <LI><B>HDF5 Home Page and Documentation:</B> - <A HREF="http://hdf.ncsa.uiuc.edu/HDF5/">http://hdf.ncsa.uiuc.edu/HDF5/</A> -<P> - <LI><B>HDF5 DDL:</B> - <A HREF="http://hdf.ncsa.uiuc.edu/HDF5/doc/ddl.html">http://hdf.ncsa.uiuc.edu/HDF5/doc/ddl.html</A> -<P> - <LI><B>Introduction to HDF5:</B> - <A HREF="http://hdf.ncsa.uiuc.edu/HDF5/doc/H5.intro.html">http://hdf.ncsa.uiuc.edu/HDF5/doc/H5.intro.html</A> <BR> -Overview of HDF5 with example programs. -<P> - <LI><B>Tar file of HDF5 Tutorial Examples</B>: - <A HREF="http://hdf.ncsa.uiuc.edu/training/other-ex5/examples.tar">http://hdf.ncsa.uiuc.edu/training/other-ex5/examples.tar</A> -<P> - <LI><B>Other Miscellaneous HDF5 Example Programs:</B> - <A HREF="http://hdf.ncsa.uiuc.edu/training/other-ex5/">http://hdf.ncsa.uiuc.edu/training/other-ex5/</A> -</UL> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 -src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/reftoobj.html b/doc/html/Tutor/reftoobj.html deleted file mode 100644 index ad996d1..0000000 --- a/doc/html/Tutor/reftoobj.html +++ /dev/null @@ -1,318 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - References to Objects -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<h1> -<BIG><BIG><BIG><FONT COLOR="#c101cd"> References to Objects</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#def">References to Objects</A> - <LI> <A HREF="#def1">Creating and Storing References to Objects</A> - <LI> <A HREF="#def2">Reading References and Accessing Objects Using - References</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>References to Objects</H2> -In HDF5, objects (i.e. groups, datasets, and named datatypes) are usually -accessed by name. This access method was discussed in previous sections. -There is another way to access stored objects - by reference. -<P> -An object reference is based on the relative file address of the object header -in the file and is constant for the life of the object. Once a reference to -an object is created and stored in a dataset in the file, it can be used -to dereference the object it points to. References are handy for creating -a file index or for grouping related objects by storing references to them in -one dataset. -<P> -<A NAME="def1"> -<H2>Creating and Storing References to Objects</H2> -The following steps are involved in creating and storing file references -to objects: -<OL> -<LI> Create the objects or open them if they already exist in the file. -<P> -<LI> Create a dataset to store references to the objects. -<P> -<LI> Create and store references to the objects in a buffer. -<P> -<LI> Write the buffer containing the references to the dataset. -</OL> - -<A NAME="def2"> -<H2>Reading References and Accessing Objects Using References</H2> - -The following steps are involved in reading references to objects and -accessing objects using references: -<OL> -<LI> Open the dataset with the references and read them. The -<CODE>H5T_STD_REF_OBJ</CODE> - datatype must be used to describe the memory datatype. -<P> -<LI> Use the read reference to obtain the identifier of the object the - reference points to. -<P> -<LI> Open the dereferenced object and perform the desired operations. -<P> -<LI> Close all objects when the task is complete. -</OL> - -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The example below first creates a group in the file. -It then creates two datasets and a named datatype in that group. -References to these four objects are stored in a dataset in the root group. -<P> -After that, it opens and reads the reference dataset from the file created -previously, then dereferences the references. - -<UL> -[<A HREF="examples/h5_ref2obj.c">C example</A> ] - - <code>h5_ref2obj.c</code><BR> -[<A HREF="examples/refobjexample.f90">FORTRAN example</A> ] - - <code>refobjexample.f90</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. -<P> -Following is the output from the examples: -<PRE> - Data has been successfully written to the dataset - Stored datatype is of a FLOAT class -</PRE> - - -<A NAME="rem"> -<H3><U>Remarks</U></H3> - -<UL> -<LI> The following code creates a dataset in which to store the references. -<P> -<I><B>C:</B></I> <pre> - dset2_id = H5Dcreate (file_id, dsetname, H5T_STD_REF_OBJ, - space_id, H5P_DEFAULT); -</pre> -<P> -<I><B>FORTRAN:</B></I><pre> - CALL h5dcreate_f (file_id, dsetname, H5T_STD_REF_OBJ, & - space_id, dset2_id, hdferr) -</pre> -<P> - Notice that the <CODE>H5T_SDT_REF_OBJ</CODE> - datatype is used to specify that references to objects will be - stored. The datatype <CODE>H5T_STD_REF_DSETREG</CODE> is - used to store the dataset - region references and will be discussed later in this tutorial. -<P> -<LI>The next few calls to <CODE>H5Rcreate</CODE> / <CODE>h5rcreate_f</CODE> - create references to the objects. The signature of - <CODE>H5Rcreate</CODE> / <CODE>h5rcreate_f</CODE> is as follows: -<P> -<I><B>C:</B></I> <pre> - herr_t H5Rcreate (void* ref, hid_t loc_id, const char *name, - H5R_type_t ref_type, hid_t space_id) -</pre> -<P> -<I><B>FORTRAN:</B></I> <pre> - h5rcreate_f (loc_id, name, ref, hdferr) - - loc_id IN: INTEGER (HID_T) - name IN: CHARACTER(LEN=*) - ref OUT: TYPE (hobj_ref_t_f) - hdferr OUT: INTEGER -</pre> -<P> - - -<UL> - <LI> The <em>ref</em> argument specifies the buffer - in which to store the reference. -<P> - <LI> The <I>loc_id</I> and <I>name</I> arguments specify the name of - the referenced object. -<P> - <LI> In C, the <I>ref_type</I> argument specifies the type of the - reference. - Our example uses references to objects, <CODE>H5R_OBJECT</CODE>. - References to dataset regions, <CODE>H5R_DATASET_REGION</CODE>, - will be discussed later in this tutorial. -<P> - <LI> In C, the <I>space_id</I> argument specifies the dataspace - identifier. When references - to the objects are created, this argument should be set to -1. -<P> - <LI> In FORTRAN, the return value from the <CODE>h5rcreate_f</CODE> - call is in <I>hdferr</I>: 0 if successful, -1 otherwise. - In C, <CODE>H5Rcreate</CODE> returns a non-negative value if - successful and a negative value otherwise. -</UL> -<P> -<LI><CODE>H5Dwrite</CODE> / <CODE>h5dwrite_f</CODE> writes a - dataset containing the references. - Notice that the <CODE>H5T_SDT_REF_OBJ</CODE> datatype is used to - describe the dataset's memory datatype. -<P> -</UL> -<UL> -<LI> <CODE>H5Dread</CODE> / <CODE>h5dread_f</CODE> - reads the dataset containing the - references to the objects. The <CODE>H5T_STD_REF_OBJ</CODE> memory - datatype was - used to read references to memory. -<P> -<LI> <CODE>H5Rdereference</CODE> / <CODE>h5rdereference_f</CODE> obtains - the object's identifier. The signature is as follows: -<P> -<I><B>C</B></I>: <pre> - hid_t H5Rdereference (hid_t dset_id, H5R_type_t ref_type, - void *ref) -</pre> -<P> -<I><B>FORTRAN</B></I>: <pre> - h5rdereference_f (dset_id, ref, obj_id, hdferr) - - dset_id IN: INTEGER (HID_T) - ref IN: TYPE (hobj_ref_t_f) - obj_id OUT: INTEGER (HID_T) - hdferr OUT: INTEGER -</pre> -<P> - <UL> - <LI> The <I>dset_id</I> argument is the identifier of the dataset - containing the references. -<P> - <LI> In C, the <I>ref_type</I> argument specifies the reference type. -<P> - <LI> The <I>ref</I> argument is a buffer containing the reference - to be dereferenced. -<P> - <LI> The C function returns the identifier of the object that the - reference points to or a negative value if it is unsuccessful. - In FORTRAN, the object identifier is returned in <I>obj_id</I> - and the return code is returned in <I>hdferr</I>. -<P> - In our simplified situation, we know what type of object was - stored in the dataset. When the type of the object is unknown, - <CODE>H5Rget_object_type</CODE> should be used to identify the type - of object the reference points to. - </UL> -</UL> - - -<A NAME="fc"> -<H3><U>File Contents</U></H3> -<P> -<I><U>HDF5 File Created by C Example</U></I> -<p> -<B>Fig. A</B> <I><code>REF_OBJ.h5</code> in DDL</I> - -<PRE> -HDF5 "REF_OBJ.h5" { -GROUP "/" { - GROUP "GROUP1" { - GROUP "GROUP2" { - } - } - DATASET "INTEGERS" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 5 ) / ( 5 ) } - DATA { - 1, 2, 3, 4, 5 - } - } - DATATYPE "MYTYPE" { - } - DATASET "OBJECT_REFERENCES" { - DATATYPE { H5T_REFERENCE } - DATASPACE { SIMPLE ( 4 ) / ( 4 ) } - DATA { - GROUP 0:1320, GROUP 0:2272, DATASET 0:2648, DATATYPE 0:3244 - } - } -} -} - - -</PRE> -<I><U>HDF5 File Created by FORTRAN Example</U></I>: -<p> -<B>Fig. B</B> <I><code>FORTRAN.h5</code> in DDL</I> - -<PRE> -HDF5 "FORTRAN.h5" { -GROUP "/" { - GROUP "GROUP1" { - GROUP "GROUP2" { - } - } - DATASET "INTEGERS" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 5 ) / ( 5 ) } - DATA { - 1, 2, 3, 4, 5 - } - } - DATATYPE "MyType" { - } - DATASET "OBJECT_REFERENCES" { - DATATYPE { H5T_REFERENCE } - DATASPACE { SIMPLE ( 4 ) / ( 4 ) } - DATA { - GROUP 0:1344, GROUP 0:2320, DATASET 0:2696, DATATYPE 0:3292 - } - } -} -} -</PRE> -<P> - -Notice how the data in the reference dataset is described. The two numbers -separated by a colon represent a unique identifier of the object. These -numbers are constant for the life of the object. - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/reftoreg.html b/doc/html/Tutor/reftoreg.html deleted file mode 100644 index 3745d91..0000000 --- a/doc/html/Tutor/reftoreg.html +++ /dev/null @@ -1,366 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - References to Dataset Regions -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - -[ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1><BIG><BIG><BIG><FONT COLOR="#c101cd"> References to Dataset Regions</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">References to Dataset Regions</A> - <LI> <A HREF="#def1">Creating and Storing References to Dataset Regions</A> - <LI> <A HREF="#def2">Reading References to Dataset Regions</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>References to Dataset Regions</H2> -Previously you learned about creating, reading, and writing -dataset selections. Here you will learn how to store dataset -selections in a file, and how to read them back using references -to dataset regions. -<P> -A dataset region reference points to the dataset selection by storing the -relative file address of the dataset header and the global heap offset of -the referenced selection. The selection referenced is located by retrieving -the coordinates of the areas in the selection from the global heap. This -internal mechanism of storing and retrieving dataset selections is transparent -to the user. A reference to a dataset selection (a region) is constant for -the life of the dataset. -<A NAME="def1"> -<H2>Creating and Storing References to Dataset Regions</H2> -The following steps are involved in creating and storing references to -dataset regions: -<OL> - -<LI> Create a dataset in which to store the dataset regions (the selections). -<P> -<LI> Create selections in the dataset(s). -The dataset(s) should already exist in the file. -<P> -<LI> Create references to the selections and store them in a buffer. -<P> -<LI> Write the dataset region references to the file. -<P> -<LI> Close all objects. -</OL> - -<A NAME="def2"> -<H2>Reading References to Dataset Regions</H2> - -The following steps are involved in reading references to dataset -regions and referenced dataset regions (selections). -<OL> -<LI> Open and read the dataset containing references to the dataset regions. - The datatype <CODE>H5T_STD_REF_DSETREG</CODE> must be used during -the read operation. -<P> -<LI>Use <CODE>H5Rdereference</CODE> / <CODE>h5rdeference_f</CODE> to -obtain the dataset identifier from the read - dataset region reference. - <dir><dir><dir> - <B><font size=-1>OR</font></B> - </dir></dir></dir> - Use <CODE>H5Rget_region</CODE> / <CODE>h5rget_region_f</CODE> to obtain - the dataspace identifier for the dataset - containing the selection from the read dataset region reference. -<P> -<LI> Obtain information about the selection or read selected data from - the dataset. -<P> -<LI> Close all objects when they are no longer needed. -</OL> - -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -The example below first creates a dataset in the file. Then it creates a -dataset to store references to the dataset regions (selections). -The first selection is a 6 x 6 hyperslab. The second selection is a point -selection in the same dataset. -References to both selections are created and stored in the buffer and then -written to the dataset in the file. -<P> -After creating the dataset and references, the program reads the dataset -containing the dataset region references. -It reads data from the dereferenced dataset and displays the number of -elements and raw data. Then it reads two selections, a hyperslab selection -and a point selection. The program queries a number of points in the -hyperslab and their coordinates and displays them. Then it queries a number of -selected points and their coordinates and displays the information.<BR> -<P> -To obtain the example, download: -<UL> -[<A HREF="examples/h5_ref2reg.c">C example</A> ] - - <code>h5_ref2reg.c</code><BR> -[<A HREF="examples/refregexample.f90">FORTRAN example</A> ] - - <code>refregexample.f90</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. -<P> - -Following is the output from the examples: -<P> -<I><U>Output of C Example</U></I> -<PRE> -Selected hyperslab: -0 0 0 3 3 4 0 0 0 -0 0 0 3 4 4 0 0 0 -Selected points: -1 0 0 0 0 0 0 0 6 -0 0 0 0 0 0 5 0 0 -</PRE> -<I><U>Output of FORTRAN Example</U></I> -<PRE> - Hyperslab selection - - 3*0, 2*3, 4, 3*0 - 3*0, 3, 2*4, 3*0 - - Point selection - - 1, 7*0, 6 - 6*0, 5, 2*0 -</PRE> - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI> The following code creates a dataset to store references to the - dataset(s) regions (selections). Notice that the - <CODE>H5T_STD_REF_DSETREG</CODE> datatype is used. -<P> -<I><B>C:</I></B> -<pre> - dset1 = H5Dcreate (file_id, dsetnamer, H5T_STD_REF_DSETREG, - spacer_id, creation_prp); -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - CALL h5dcreate_f (file_id, dsetnamer, H5T_STD_REF_DSETREG, & - spacer_id, dset1, hdferr, creation_prp) -</pre> -<P> - -<LI> This program uses hyperslab and point selections. We used the dataspace - identifier for the calls to <CODE>H5Sselect_hyperslab</CODE> / - <CODE>h5sselect_hyperslab_f</CODE> and - <CODE>H5Sselect_elements</CODE> / <CODE>h5sselect_elements_f</CODE>. - The identifier was obtained when the dataset was - created and it describes the dataset's dataspace. We did not close it when - the dataset was closed to decrease the number of function calls used - in the example. - In a real application program, one should open the dataset and determine - its dataspace using the <CODE>H5Dget_space</CODE> / - <CODE>h5dget_space_f</CODE> function. -<P> -<LI> <CODE>H5Rcreate</CODE> / <CODE>h5rcreate_f</CODE> is used to create a -dataset region reference. The signature of the function is as follows: -<P> -<I><B>C</B></I>: -<pre> - herr_t H5Rcreate (void *ref, hid_t loc_id, const char *name, - H5R_type_t ref_type, hid_t space_id) -</pre> -<P> -<I><B>FORTRAN</B></I>: -<pre> - h5rcreate_f (loc_id, name, space_id, ref, hdferr) - - loc_id IN: INTEGER (HID_T) - name IN: CHARACTER (LEN=*) - space_id IN: INTEGER (HID_T) - ref_type OUT: TYPE(hdset_reg_ref_t_f) - hdferr OUT: INTEGER -</pre> -<P> -<UL> - <LI> The <em>ref</em> argument specifies the buffer in which - to store the reference. -<P> - <LI> The <I>loc_id</I> and <I>name</I> arguments specify the - referenced dataset. -<P> - <LI> In C, the <I>ref_type</I> argument specifies the reference type. - Since we are creating references to the dataset regions, - the <CODE>H5R_DATASET_REGION</CODE> datatype is used. -<P> - <LI> The <I>space_id</I> argument is a dataspace identifier. - This dataspace includes a selection in the referenced dataset. -<P> - <LI> In C, the function <CODE>H5Rcreate</CODE> returns a non-negative - value if successful and a negative value otherwise. In FORTRAN, the - return code from the <CODE>h5rcreate_f</CODE> subroutine is - returned in <I>hdferr</I>: 0 if succesful and -1 otherwise. -</UL> -<P> -<LI> The dataset with the region references was read by - <CODE>H5Dread</CODE> / <CODE>h5dread_f</CODE> with - the <CODE>H5T_STD_REF_DSETREG</CODE> datatype specified. -<P> -<LI> The read reference can be used to obtain the dataset identifier, as we - did with the following call: -<P> -<I><B>C:</B></I> -<pre> - dset2 = H5Rdereference (dset1, H5R_DATASET_REGION, &ref_out[0]); -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - CALL h5rdereference_f (dset1, ref_out(1), dset2, hdferr) -</pre> -<P> - or to obtain spacial information ( dataspace and selection ) with the call - to <CODE>H5Rget_region</CODE> / <CODE>h5rget_region_f</CODE>: -<P> -<I><B>C:</B></I> -<pre> - dspace2 = H5Rget_region (dset1, H5R_DATASET_REGION, &ref_out[0]); -</pre> -<P> -<I><B>FORTRAN:</B></I> -<pre> - CALL H5rget_region_f (dset1, ref_out(1), dspace2, hdferr) -</pre> -<P> - The reference to the dataset region has information for both the dataset - itself and its selection. In both calls, -<UL> - <LI> the <em>dset1</em> parameter is the identifier for the dataset - with the region references and -<P> - <LI> the <em>ref_out</em> parameter specifies the type of reference - stored. In this example a reference to the dataset region is stored. -</UL> -<P> - The C function returns the dataspace identifier or a - negative value if it is not successful. - In FORTRAN, the dataset identifier or dataspace identifier - is returned in <I>dset2</I> or <I>dspace2</I> - and the return code for the call is returned in <I>hdferr</I>: - 0 if successful and -1 otherwise. -<P> -</UL> - - -</UL> -<A NAME="fc"> -<H3><U>File Contents</U></H3> -<P> -<I><U>HDF5 File Created by C Example</U></I> -<P> -<B>Fig. A</B> <I><code>REF_REG.h5</code> in DDL</I> -<PRE> - -HDF5 "REF_REG.h5" { -GROUP "/" { - DATASET "MATRIX" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 2, 9 ) / ( 2, 9 ) } - DATA { - 1, 1, 2, 3, 3, 4, 5, 5, 6, - 1, 2, 2, 3, 4, 4, 5, 6, 6 - } - } - DATASET "REGION_REFERENCES" { - DATATYPE { H5T_REFERENCE } - DATASPACE { SIMPLE ( 2 ) / ( 2 ) } - DATA { - DATASET 0:744 {(0,3)-(1,5)}, DATASET 0:744 {(0,0), (1,6), (0,8)} - } - } -} -} - -</PRE> -<I><U>HDF5 File Created by FORTRAN Example</U></I>: -<P> -<B>Fig. B</B> <I><code>FORTRAN.h5</code> in DDL</I> -<PRE> - -HDF5 "FORTRAN.h5" { -GROUP "/" { - DATASET "MATRIX" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 9, 2 ) / ( 9, 2 ) } - DATA { - 1, 1, - 1, 2, - 2, 2, - 3, 3, - 3, 4, - 4, 4, - 5, 5, - 5, 6, - 6, 6 - } - } - DATASET "REGION_REFERENCES" { - DATATYPE { H5T_REFERENCE } - DATASPACE { SIMPLE ( 2 ) / ( 2 ) } - DATA { - DATASET 0:744 {(3,0)-(5,1)}, DATASET 0:744 {(0,0), (6,1), (8,0)} - } - } -} -} -</PRE> - -Notice how the raw data in the dataset with the dataset regions is displayed. -Each element of the raw data consists of a reference to the dataset -(DATASET number1:number2) and its selected region. -If the selection is a hyperslab, the corner coordinates of the hyperslab -are displayed. -For the point selection, the coordinates of each point are displayed. -<!-- -Since only two selections were stored, the third and fourth elements of the -dataset are set to NULL. This was done by the buffer -inizialization in the program. ---> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/select.html b/doc/html/Tutor/select.html deleted file mode 100644 index b4109b0..0000000 --- a/doc/html/Tutor/select.html +++ /dev/null @@ -1,309 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Hyperslab Selections -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Hyperslab Selections</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI><A HREF="#def">Selecting a Portion of a Dataspace</A> - <LI>Programming Example -<UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> -<!-- - <LI> <A HREF="#fc">File Contents</A> ---> -</UL> -</UL> -<HR> -<A NAME="def"> -<H2>Selecting a Portion of a Dataspace</H2> -Hyperslabs are portions of datasets. A hyperslab selection can be a -logically contiguous collection of points in a dataspace, or it -can be a regular pattern of points or blocks in a dataspace. -You can select a hyperslab to write to or read from with the function -<CODE>H5Sselect_hyperslab</CODE> / <CODE>h5sselect_hyperslab_f</CODE>. -<P> -<H2> Programming Example</H2> -<A NAME="desc"> -<H3><U>Description</U></H3> -This example creates a 5 x 6 integer array in a file called <code>sds.h5</code> -(<code>sdsf.h5</code> in FORTRAN). It -selects a 3 x 4 hyperslab from the dataset as follows (Dimension 0 is -offset by 1 and Dimension 1 is offset by 2): -<P> -<B>5 x 6 array:</B> -<TABLE BORDER CELLSPACING=1 CELLPADDING=7 WIDTH=172> -<TR><TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -</TR> -<TR><TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -</TR> -<TR><TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="17%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -</TR> -<TR><TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -<TD WIDTH="17%" VALIGN="TOP"> </TD> -</TR> -</TABLE> -<P> -Then it reads the hyperslab from this file into a 2-dimensional plane -(size 7 x 7) of a 3-dimensional array (size 7 x 7 x 3), as -follows (with Dimension 0 offset by 3): -<P> -<TABLE BORDER CELLSPACING=1 CELLPADDING=7 WIDTH=201> -<TR><TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> -<FONT SIZE=2><P> X</FONT></TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -<TR><TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -<TD WIDTH="14%" VALIGN="TOP"> </TD> -</TR> -</TABLE> -<P> - -To obtain the example, download: -<UL> -[ <A HREF="examples/h5_hyperslab.c">C example</A> ] - - <code>h5_hyperslab.c</code><BR> -[ <A HREF="examples/hyperslab.f90">FORTRAN example</A> ] - - <code>hyperslab.f90</code><BR> -[ <A HREF="examples/java/HyperSlab.java">Java example</A> ] - - <code>HyperSlab.java</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. -<P> - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><CODE>H5Sselect_hyperslab</CODE> / <CODE>h5sselect_hyperslab_f</CODE> -selects a hyperslab region to -add to the current selected region for a specified dataspace. -<P> -<I><B>C</B></I>: -<pre> - herr_t H5Sselect_hyperslab (hid_t space_id, H5S_seloper_t operator, - const hsize_t *start, const hsize_t *stride, - const hsize_t *count, const hsize_t *block ) -</pre> -<P> -<I><B>FORTRAN</B></I>: -<pre> - h5sselect_hyperslab_f (space_id, operator, start, count, & - hdferr, stride, block) - - space_id IN: INTEGER(HID_T) - operator IN: INTEGER - start IN: INTEGER(HSIZE_T), DIMENSION(*) - count IN: INTEGER(HSIZE_T), DIMENSION(*) - hdferr OUT: INTEGER - stride IN: INTEGER(HSIZE_T), DIMENSION(*), OPTIONAL - block IN: INTEGER(HSIZE_T), DIMENSION(*), OPTIONAL -</pre> -<P> -<UL> -<LI>The parameter <I>space_id</I> is the dataspace identifier for the - specified dataspace. -<P> -<LI>The parameter <I>operator</I> can be set to one of the following: - <dir><DL> - <dt><CODE>H5S_SELECT_SET</CODE> (<CODE>H5S_SELECT_SET_F</CODE> in FORTRAN) - <dd>Replace the existing selection with the parameters from this call. - Overlapping blocks are not supported with this operator. - - <dt><CODE>H5S_SELECT_OR</CODE> (<CODE>H5S_SELECT_OR_F</CODE> in FORTRAN) - <dd>Add the new selection to the existing selection. - </DL></dir> - -<P> -<LI>The <I>start</I> array determines the starting coordinates of the -hyperslab to select. -<P> -<LI>The <I>stride</I> array indicates which elements along a dimension are to -be selected. -<P> -<LI>The <I>count</I> array determines how many positions to select from the - dataspace in each dimension. -<P> -<LI>The <I>block</I> array determines the size of the element block selected - by the dataspace. -<P> -<LI>In C, a non-negative value is returned if successful, and a negative -value otherwise. In FORTRAN, the return value is returned in <I>hdferr</I>: -0 if successful and -1 otherwise. -</UL> -<P> -The <I>start</I>, <I>stride</I>, <I>count</I>, and <I>block</I> arrays must -be the same size as the rank of the dataspace. -<P> -<LI>The examples introduce the following call: -<dir><dl> - <dt><code>H5Dget_space / h5dget_space_f:</code> - <dd>Returns an identifier for a copy of the dataspace of a dataset.<P> -</dl></dir> -<LI>The C example also introduces the following calls: -<dir><dl> - <dt><code>H5Sget_simple_extent_dims:</code> - <dd>Returns the size and maximum size of each dimension of a dataspace. - <dt><code>H5Sget_simple_extent_ndims:</code> - <dd>Determines the dimensionality (or rank) of a dataspace. -</dl></dir> -<P> -The FORTRAN example does not use these calls, though they -are available as <CODE>h5sget_simple_extent_dims_f</CODE> and -<CODE>h5sget_simple_extent_ndims_f</CODE>. - -</UL> -</UL> -</UL> -</PRE> -<P> - -<!-- -<A NAME="fc"> -<H3><U>File Contents</U></H3> ---> - - - - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/selectc.html b/doc/html/Tutor/selectc.html deleted file mode 100644 index 59c464c..0000000 --- a/doc/html/Tutor/selectc.html +++ /dev/null @@ -1,265 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Selecting Individual Points and Copying a Dataspace -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Selecting Individual Points and Copying -a Dataspace</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -<H2>Contents:</H2> -<UL> - <LI> <A HREF="#def">Description</A> - <LI> Programming Example - <UL> - <LI> <A HREF="#desc">Description</A> - <LI> <A HREF="#rem">Remarks</A> - <LI> <A HREF="#fc">File Contents</A> - </UL> -</UL> -<HR> -<A NAME="def"> -<H2>Description</h2> -You can select independent points to read from or write to in a -dataspace by use of the <CODE>H5Sselect_elements</CODE> / -<CODE>h5sselect_elements_f</CODE> function. -<P> -The <CODE>H5Scopy</CODE> / <CODE>h5scopy_f</CODE> function allows -you to make an exact copy of a dataspace. -This can reduce the number of function calls needed when -selecting a dataspace. -<P> -<H2> Programming Example</H2> - -<A NAME="desc"> -<H3><U>Description</U></H3> -This example shows how to use <CODE>H5Sselect_elements</CODE> / -<CODE>h5sselect_elements_f</CODE> -to select individual points in a dataset and how to use -<CODE>H5Scopy</CODE> / <CODE>h5scopy_f</CODE> -to make a copy of a dataspace. -<UL> -[ <A HREF="examples/h5_copy.c">C example</A> ] - - <code>h5_copy.c</code><BR> -[ <A HREF="examples/selectele.f90">FORTRAN example</A> ] - - <code>selectele.f90</code><BR> -[ <A HREF="examples/java/Copy.java">Java example</A> ] - - <code>Copy.java</code> -</UL> -<B>NOTE:</B> To download a tar file of the examples, including a Makefile, -please go to the <A HREF="references.html">References</A> page. - - -<A NAME="rem"> -<H3><U>Remarks</U></H3> -<UL> -<LI><CODE>H5Sselect_elements</CODE> / <CODE>h5sselect_elements_f</CODE> -selects array elements to be -included in the selection for a dataspace: -<P> -<I><B>C</B></I>: -<pre> - herr_t H5Sselect_elements (hid_t space_id, H5S_seloper_t operator, - size_t num_elements, - const hsize_t **coord ) -</pre> -<P> -<I><B>FORTRAN</B></I>: -<pre> - h5sselect_elements_f (space_id, operator, num_elements, coord, hdferr) - - space_id IN: INTEGER(HID_T) - operator IN: INTEGER - num_elements IN: INTEGER - coord IN: INTEGER(HSIZE_T), DIMENSION(*,*) - hdferr OUT: INTEGER -</pre> -<P> -<UL> -<LI>The <I>space_id</I> parameter is the dataspace identifier. -<P> -<LI>The <I>operator</I> parameter can be set to one of the following values: -<dir><DL> - <dt><CODE>H5S_SELECT_SET</CODE> (<CODE>H5S_SELECT_SET_F</CODE> in FORTRAN) - <dd>Replace the existing selection with the parameters from this call. - Overlapping blocks are not supported with this operator. - <dt><CODE>H5S_SELECT_OR</CODE> (<CODE>H5S_SELECT_OR_F</CODE> in FORTRAN) - <dd>Add the new selection to the existing selection. -</DL></dir> -<P> -<LI>The <I>coord</I> array is a two-dimensional array of size -<code><em>NUMP</em> x <em>RANK</em></code> in C -(<code><em>RANK</em> x <em>NUMP</em></code> in FORTRAN) -where <code><em>NUMP</em></code> is the number of selected points -and <code><em>RANK</em></code> is the rank of the dataset. -Note that these coordinates are 0-based in C and 1-based in FORTRAN. -<p> - Consider the non-zero elements of the following array: - <pre> - 0 59 0 53 - 0 0 0 0 - 0 0 1 0 </pre> - In C, the <em>coord</em> array selecting these points would be as follows: - <pre> - 0 1 - 0 3 - 2 2 </pre> - While in FORTRAN, the <em>coord</em> array would be as follows: - <pre> - 1 1 3 - 2 4 3 </pre> -<P> -<LI>In C, this function returns a non-negative value if successful and -a negative value otherwise. In FORTRAN, the value returned in <I>hdferr</I> -indicates whether it was successful (0) or not (-1). -</UL> -<P> -<LI><CODE>H5Scopy</CODE> / <CODE>h5scopy_f</CODE> creates an exact copy of a dataspace: -<P> -<I><B>C</B></I>: - -<PRE> - hid_t H5Scopy (hid_t space_id) -</PRE> -<I><B>FORTRAN</B></I>: -<PRE> - h5scopy_f (space_id, new_space_id, hdferr) - - space_id IN: INTEGER(HID_T) - new_space_id OUT: INTEGER(HID_T) - hdferr OUT: INTEGER -</PRE> -<P> -<UL> -<LI>The <I>space_id</I> parameter is the dataspace identifier to copy. -<P> -<LI>In C, the identifier to the dataspace's copy is returned if the -function is successful and a negative value is returned if not. In -FORTRAN, the new dataspace identifier is returned in <I>new_space_id</I> -and the return value is returned in <I>hdferr</I> ( 0 if successful and --1 if not). -</UL> -</UL> -</UL> -<P> - -<A NAME="fc"> -<H3><U>File Contents</U></H3> - -Following is the DDL for <I>copy1.h5</I> and <I>copy2.h5</I>, as viewed with -the following commands:<br> - -<code>h5dump copy1.h5</code> <br> - -<code>h5dump copy2.h5</code> - -<P> -<HR> -<B><I><U>C</U></B></I>:<P> -<B>Fig. S.1a</B> <I><code>copy1.h5</code> in DDL</I> -<PRE> - HDF5 "copy1.h5" { - GROUP "/" { - DATASET "Copy1" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 3, 4 ) / ( 3, 4 ) } - DATA { - 0, 59, 0, 53, - 0, 0, 0, 0, - 0, 0, 0, 0 - } - } - } - } -</PRE> -<B>Fig. S.1b</B> <I><code>copy2.h5</code> in DDL</I> -<PRE> - HDF5 "copy2.h5" { - GROUP "/" { - DATASET "Copy2" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 3, 4 ) / ( 3, 4 ) } - DATA { - 1, 59, 1, 53, - 1, 1, 1, 1, - 1, 1, 1, 1 - } - } - } - } -</PRE> -<HR> -<I><B><U>FORTRAN</U></B></I>:<P> -<B>Fig. S.2a</B> <I><code>copy1.h5</code> in DDL</I> -<PRE> - HDF5 "copy1.h5" { - GROUP "/" { - DATASET "Copy1" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 4, 3 ) / ( 4, 3 ) } - DATA { - 0, 0, 0, - 53, 0, 0, - 0, 0, 0, - 59, 0, 0 - } - } - } - } -</PRE> -<B>Fig. S.2b</B> <I><code>copy2.h5</code> in DDL</I> -<PRE> - HDF5 "copy2.h5" { - GROUP "/" { - DATASET "Copy2" { - DATATYPE { H5T_STD_I32BE } - DATASPACE { SIMPLE ( 4, 3 ) / ( 4, 3 ) } - DATA { - 1, 1, 1, - 53, 1, 1, - 1, 1, 1, - 59, 1, 1 - } - } - } - } -</PRE> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/software.html b/doc/html/Tutor/software.html deleted file mode 100644 index 074bfc8..0000000 --- a/doc/html/Tutor/software.html +++ /dev/null @@ -1,85 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Obtaining HDF5 Software</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Obtaining HDF5 Software</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -<BODY> -If you will be compiling in: -<DL> -<DT><B>C:</B> -<DD>You will need the HDF5 library. We provide pre-compiled binaries -for the platforms on which we tested at: -<BR> -<A HREF="ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/bin/">ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/bin/</A> -<P> -If using the pre-compiled binaries you must -also obtain the GZIP library, as they were compiled with GZIP included, but do -not include this library. We provide the GZIP library for the platforms on -which we tested at: -<BR> -<A HREF="ftp://ftp.ncsa.uiuc.edu/HDF/gzip/">ftp://ftp.ncsa.uiuc.edu/HDF/gzip/</A> -<P> -You can build the HDF5 library yourself, if need be. The source code -can be obtained from: -<BR> -<A HREF="ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/src/">ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/src/</A> -<P> -For further information regarding HDF5, check the HDF5 home page: -<BR> -<A HREF="http://hdf.ncsa.uiuc.edu/HDF5/">http://hdf.ncsa.uiuc.edu/HDF5/</A> -<P> -<DT><B>FORTRAN 90:</B> -<DD> With HDF5-1.4.0, support for Fortran 90 is included as part of -the installation of the HDF5 library. The pre-compiled binaries include -the Fortran library. If you need to build from source, download the -HDF5-1.4.0 source code and compile it with the <I>--enable-fortran</I> flag. -Read the instructions in the -<A HREF="ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/current/src/unpacked/RELEASE.txt">RELEASE.txt</A> -file for further details. - -<P> -<DT><B>Java:</B> -<DD>You will need the JHI5 code. Go to the -<A HREF="http://hdf.ncsa.uiuc.edu/java-hdf5-html">Java HDF5 web page</A> -for information on the Java-HDF5 software. The Java Tutorial examples -are included with this tutorial: -<BR> - <A HREF="./examples/java/">./examples/java/</A> -</DL> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@@ncsa.uiuc.edu"> -hdfhelp@@ncsa.uiuc.edu</A> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@@ncsa.uiuc.edu --> -<!-- modified by Frank Baker - fbaker@@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - diff --git a/doc/html/Tutor/title.html b/doc/html/Tutor/title.html deleted file mode 100644 index e045353..0000000 --- a/doc/html/Tutor/title.html +++ /dev/null @@ -1,105 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - -<h1> <A HREF="http://hdf.ncsa.uiuc.edu/whatishdf5.html"> -<img align=left border=0 src="bighdf2sp.JPG" alt="What is HDF5?"></A> -<BIG><BIG><BIG> <FONT COLOR="#c101cd">HDF5 Tutorial</FONT> -</BIG></BIG></BIG></H1> - - - -<hr noshade size=1> -<CENTER> -<FONT SIZE="3" FACE="arial,helvetica" COLOR="#c80028"> - <B>[</B> <A HREF="http://hdf.ncsa.uiuc.edu/index.html">Home</A> <B>]</B> - <B>[</B> <A HREF="http://hdf.ncsa.uiuc.edu/hdfindex.html">Index</A> <B>]</B> - <B>[</B> <A HREF="http://hdf.ncsa.uiuc.edu/products.html">Products</A> <B>]</B> - <B>[</B> <A HREF="http://hdf.ncsa.uiuc.edu/newsletters.html">Newsletters</A> <B>]</B> - <B>[</B> <A HREF="http://hdf.ncsa.uiuc.edu/docs.html">Documentation</A> <B>]</B> -<BR> - -</FONT> -<BR> -</CENTER> - -<BR CLEAR=ALL><BR> -<BODY> - -<BIG><B>NOTE:</B></BIG> -This tutorial does NOT include the software needed to -<BR> - -compile the examples. You will need to -<A HREF="./software.html">obtain</A> it first. - -<H2>Contents:</H2> -<H3>Introductory Topics</H3> -<OL> -<LI><A HREF="intro.html">Introduction</A> -<LI><A HREF="fileorg.html">HDF5 File Organization</A> -<LI><A HREF="api.html">The HDF5 API</A> -<LI><A HREF="crtfile.html">Creating an HDF5 File</A> -<LI><A HREF="crtdat.html">Creating a Dataset</A> -<LI><A HREF="rdwt.html">Reading from or Writing to a Dataset</A> -<LI><A HREF="crtatt.html">Creating an Attribute</A> -<LI><A HREF="crtgrp.html">Creating a Group</A> -<LI><A HREF="crtgrpar.html">Creating Groups Using Absolute and - Relative Names</A> -<LI><A HREF="crtgrpd.html">Creating Datasets in Groups</A> -</OL> -<UL> -<A HREF="questions.html">Questions</A><BR> -<A HREF="answers.html">Answers</A><BR> -</UL> -<H3>Advanced Topics</H3> -<UL> -<LI><A HREF="property.html">Property Lists</A> -<LI><A HREF="compound.html">Compound Datatypes</A> -<LI><A HREF="select.html">Dataspace Selection - Hyperslab</A> -<LI><A HREF="selectc.html">Dataspace Selection - Individual Points</A> -<LI><A HREF="reftoobj.html">References to Objects</A> -<LI><A HREF="reftoreg.html">References to Dataset Regions</A> -<LI><A HREF="extend.html">Chunking and Extendible Datasets</A> -<LI><A HREF="mount.html">Mounting Files</A> -<LI><A HREF="iterate.html">Group Iteration</A> -</UL> -<P> -<A HREF="util.html">HDF5 Utilities - h5ls/h5dump</A><BR> -<A HREF="glossary.html">Glossary</A><BR> -<A HREF="references.html">References</A><BR> -<A HREF="examples/">Example Programs from this Tutorial</A> <BR> -</OL> - - -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<BR> <H6>Last Modified: June 23, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - - - diff --git a/doc/html/Tutor/util.html b/doc/html/Tutor/util.html deleted file mode 100644 index 7397029..0000000 --- a/doc/html/Tutor/util.html +++ /dev/null @@ -1,85 +0,0 @@ -<HTML><HEAD> -<TITLE>HDF5 Tutorial - Utilities (h5dump, h5ls) -</TITLE> -</HEAD> - -<body bgcolor="#ffffff"> - -<!-- BEGIN MAIN BODY --> - - - [ <A HREF="title.html"><I>HDF5 Tutorial Top</I></A> ] -<H1> -<BIG><BIG><BIG><FONT COLOR="#c101cd">Utilities (h5dump, h5ls)</FONT> -</BIG></BIG></BIG></H1> - -<hr noshade size=1> - -The h5dump and h5ls utilities can be used to examine the contents of an -hdf5 file. -<P> -<A NAME="dmp"> -<H2>h5dump</H2> -<PRE> -h5dump [-h] [-bb] [-header] [-a <names>] [-d <names>] [-g <names>] - [-l <names>] [-t <names>] <file> - - -h Print information on this command. - -bb Display the content of the boot block. The default is not to display. - -header Display header only; no data is displayed. - -a <names> Display the specified attribute(s). - -d <names> Display the specified dataset(s). - -g <names> Display the specified group(s) and all the members. - -l <names> Displays the value(s) of the specified soft link(s). - -t <names> Display the specified named data type(s). - - <names> is one or more appropriate object names. -</PRE> -<A NAME="ls"> -<H2>h5ls</H2> -<PRE> -h5ls [OPTIONS] FILE [OBJECTS...] - - OPTIONS - -h, -?, --help Print a usage message and exit - -d, --dump Print the values of datasets - -f, --full Print full path names instead of base names - -l, --label Label members of compound datasets - -r, --recursive List all groups recursively, avoiding cycles - -s, --string Print 1-byte integer datasets as ASCII - -wN, --width=N Set the number of columns of output - -v, --verbose Generate more verbose output - -V, --version Print version number and exit - FILE - The file name may include a printf(3C) integer format such as - "%05d" to open a file family. - OBJECTS - The names of zero or more objects about which information should be - displayed. If a group is mentioned then information about each of its - members is displayed. If no object names are specified then - information about all of the objects in the root group is displayed. -</PRE> -<!-- BEGIN FOOTER INFO --> - -<P><hr noshade size=1> -<font face="arial,helvetica" size="-1"> - <a href="http://www.ncsa.uiuc.edu/"><img border=0 - src="footer-ncsalogo.gif" - width=78 height=27 alt="NCSA"><br> - The National Center for Supercomputing Applications</A><br> - <a href="http://www.uiuc.edu/">University of Illinois - at Urbana-Champaign</a><br> - <br> -<!-- <A HREF="helpdesk.mail.html"> --> -<A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> -hdfhelp@ncsa.uiuc.edu</A> -<br> -<BR> <H6>Last Modified: June 22, 2001</H6><BR> -<!-- modified by Barbara Jones - bljones@ncsa.uiuc.edu --> -</FONT> -<BR> -<!-- <A HREF="mailto:hdfhelp@ncsa.uiuc.edu"> --> - -</BODY> -</HTML> - |
