mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
b9a4294cd0
Add html format document. Description: It is easy for windows users to read and follow. Solution: Platforms tested: Misc. update:
1911 lines
82 KiB
HTML
Executable File
1911 lines
82 KiB
HTML
Executable File
<html>
|
|
|
|
<head>
|
|
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
|
|
<meta name="ProgId" content="FrontPage.Editor.Document">
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
|
|
<title>HDF5 Build and Install Instructions for Windows XP (Full Version)</title>
|
|
<style type="text/css">
|
|
|
|
h1 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 180%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
}
|
|
h2 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 160%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
|
|
}
|
|
h3 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 140%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-transform:capitalize;
|
|
}
|
|
h4 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 120%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
}
|
|
h5 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
}
|
|
|
|
p.right{text-align:right;color:#A52A2A;}
|
|
p {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
|
|
}
|
|
p.note{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
color:#FF0000
|
|
}
|
|
|
|
ul.normal
|
|
{
|
|
margin-left:10%;
|
|
list-style-type:none;
|
|
margin-bottom:15px;
|
|
}
|
|
ul.intable
|
|
{
|
|
text-align: left;
|
|
list-style-type:none;
|
|
}
|
|
td {font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
padding:10;
|
|
}
|
|
a {text-decoration:none}
|
|
a:link {color:#0000FF;}
|
|
a:visited {color:purple;}
|
|
a:hover {background-color:#FAEBD7;}
|
|
table {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
text-align:left;
|
|
border:thin solid blue;
|
|
}
|
|
|
|
body {
|
|
margin-left:5%;
|
|
margin-right:5%
|
|
}
|
|
hr.first {color:#0000FF; height:4px;width:100%;magin-top:10px;margin-bottom:10px;border:thick double blue;}
|
|
hr.second{color:#0000FF;height:2px; width:100%;magin-top:5px;margin-bottom:5px;border:thin dotted;}
|
|
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h1>HDF5 Build and Install Instructions for Windows XP (Full Version)</h1>
|
|
<hr class="first" >
|
|
<p class="note">Notes:</p>
|
|
<p>The following instructions assume that the HDF5 source code package from<a href="http://hdf.ncsa.uiuc.edu" target="_blank">
|
|
HDF website (http://hdf.ncsa.uiuc.edu)</a>
|
|
is used.
|
|
</p>
|
|
<h3 style="COLOR: #a52a2a"><a name="content_table">Table of Contents:</a></h3></TD>
|
|
|
|
<h3><A href="#preconditions">Preconditions</A></h3>
|
|
<h3><A href="#section1">Section I: What do we build and install</A></h3>
|
|
<h3><A href="#section2">Section II: How to build and test HDF5 libraries and tools</A></h3>
|
|
<h3><A href="#section3">Section III: How to build an application using the HDF5 library or DLL</A></h3>
|
|
<h3><A href="#section4">Section IV: Helpful pointers</A></h3>
|
|
<h3><A href="#section5">Section V: How to disable Gzip(Zlib)/Szip compression </A></h3>
|
|
<h3><A href="#section6">Section VI: How to build HDF5 in VS 7.0(.NET)</A></h3>
|
|
<h3><A href="#section7">Section VII: How to build HDF5 with INTEL Compiler</A></h3>
|
|
<h3><A href="#section8">Section VIII: How to build and test HDF5 snapshot release</A></h3>
|
|
<h3><A href="#section9">Section VIIII: Misc.</A></h3>
|
|
|
|
<hr class="second" >
|
|
|
|
<h2><a name="preconditions">Preconditions</a> </h2>
|
|
<hr class="second" >
|
|
|
|
<p>Please read CAREFULLY about the following preconditions and notes first.</p>
|
|
|
|
<h4>1. Installed Microsoft Visual C++ 6.0 or Intel C compiler and WinZip.</h4>
|
|
<p>Installed Compaq Visual Fortran compiler(6.0 or higher version),
|
|
or Intel Fortran compiler if you want to build HDF5 Fortran
|
|
libraries.
|
|
</p>
|
|
<p class="note">Notes:</p>
|
|
<p> By default, WinZip will convert the Unix end of line format
|
|
when extracting .tar file. This conversion will cause
|
|
"false" failure in some HDF5 tools testings.
|
|
|
|
Please uncheck the "TAR file smart CR/LF conversion" option
|
|
in your WinZip to prevent the conversion when extracting
|
|
.tar file.
|
|
|
|
To uncheck the "TAR file smart CR/LF conversion" option:
|
|
|
|
Invoke WinZip, go to "Options", select "Configuration..."
|
|
|
|
Click the "Miscellaneous" tab and uncheck "TAR file smart
|
|
CR/LF conversion" option, then click OK.
|
|
|
|
</p>
|
|
<h4>2. Set up a directory structure to unpack the library.</h4>
|
|
<p> For example:</p>
|
|
<p>c:\ (any drive)</p>
|
|
<p>MyHDFstuff\ (any folder name)</p>
|
|
<h4>3. Download the hdf5-1.8.x source code package </h4>
|
|
<p>Use WinZip to extract the HDF5 package into c:\MyHDFstuff. This creates a
|
|
directory called 'hdf5-1.8.x' under MyHDFstuff which contains
|
|
several files and directories. Rename "hdf5-1.8.x" to "hdf5".
|
|
</p>
|
|
<h4>4. HDF5 provide options to do in-memory compress within HDF5 library.</h4>
|
|
<p>Currently, two external compression libraries Zlib and
|
|
Szip can be used with HDF5.
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p> 1. HDF5 uses Zlib version 1.2.2 for compression and Zlib is NOT
|
|
distributed with HDF5 library in 1.8.x release. To use Zlib
|
|
library, you have to install your own Zlib DLL library or go
|
|
to <A href="ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin" target=_blank>
|
|
ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin
|
|
</A>
|
|
to download the Zlib library.</p>
|
|
|
|
<p class="note">Notes:</p>
|
|
<p> Zlib 1.2.2 DLL library can also be downloaded from</p>
|
|
<p>
|
|
<a href="http://www.zlib.net/zlib122-dll.zip" target="_blank">
|
|
http://www.zlib.net/zlib122-dll.zip
|
|
</a>
|
|
</p>
|
|
|
|
<li><p>2. HDF5 uses Szip version 2.0 for compression and Szip
|
|
compression software is provided with HDF5 products in
|
|
1.8.0 release. To use Szip 2.0 library, you can
|
|
download Szip source codes and binaries from</p>
|
|
<p><A href="ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows" target=_blank>
|
|
ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows
|
|
</A>
|
|
</p>
|
|
|
|
<p class="note">Notes:</p>
|
|
<p>Please note that Szip is not a totally open-source free
|
|
software. For licensing issue of Szip, please check
|
|
"Licensing terms" at
|
|
<a href="http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/index.html" target="_blank">
|
|
http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/index.html.</a>
|
|
</p>
|
|
<p>Szip compression feature inside HDF5 is optional.</p>
|
|
|
|
</li>
|
|
</ul>
|
|
<h4>5. Define the following environment variables: </h4>
|
|
|
|
<ul class="normal">
|
|
<li>HDF5_EXT_ZLIB
|
|
|
|
<li>HDF5_EXT_SZIP</li>
|
|
</ul>
|
|
|
|
<p>In this section, Zlib and Szip compression packages are assumed
|
|
to be used. Please read <A href="#section5" target=_blank>Section V</A> as well as this section if you
|
|
do not want to use compression feature inside HDF5.
|
|
</p>
|
|
<p>To define these environment variables:</p>
|
|
<p>Click "Start", click "Control Panel", and then double-click
|
|
"System". On the "Advanced" tab, click "Environment Variables".
|
|
|
|
If you are logged on as administrator to the local computer AND
|
|
want to let all other users use these two environment variables,
|
|
click "New" under "System Variables" box; otherwise, click "New"
|
|
under "User Variables" box.
|
|
|
|
In the New Variable window, set "Variable name" as HDF5_EXT_ZLIB
|
|
and "Variable value" as zdll.lib, then click OK.
|
|
</p>
|
|
<p>Similarly, you can set:</p>
|
|
<p>HDF5_EXT_SZIP environment variable as szlibdll.lib</p>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<ul class="intable">
|
|
<li><p>a. You might have to close and reopen running programs for
|
|
the new environment variable settings to take effect.
|
|
</p>
|
|
<li><p>b. c:\zlib122\zlib1.dll and c:\szip\dll\szlibdll.dll should
|
|
be copied into the location that the application can find,
|
|
one suggestion is to use the c:\WINDOWS\system.
|
|
</p></li>
|
|
</ul>
|
|
<h4><a name="precondition6">6. Set up path for external libraries and headers</a></h4>
|
|
|
|
|
|
<p>Skip this part if you don't want to use ANY compression features
|
|
provided by HDF5. Please do read <A href="#section5" target=_blank>Section V</A>.</p>
|
|
<p>You have to read this part even if you want to only use Zlib
|
|
or Szip. You also need to read <A href="#section5" target=_blank>Section V</A>.
|
|
</p>
|
|
<p>Invoke Microsoft Visual C++ and go to "Tools" and select
|
|
"Options", find "Directories";
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>
|
|
1. Find the box "Show directories for", choose
|
|
"Include files", if you can not find your Zlib and Szip
|
|
header path
|
|
(for example, c:\zlib122\include, c:\szip\include)
|
|
from the directory list, add the header path
|
|
(c:\zlib122\include, c:\szip\include) to the
|
|
included directories.
|
|
|
|
</p>
|
|
<li><p>
|
|
2. Find the box "Show directories for", choose "Library files",
|
|
If you cannot find your Zlib and Szip library path
|
|
(for example, c:\zlib122\lib, c:\szip\dll)
|
|
from the directory list, add the library path
|
|
(c:\zlib122\lib, c:\szip\dll) to the library directories.
|
|
|
|
</p></li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<ul class="intable">
|
|
<li><p>
|
|
1. In release 1.8.0, all.zip is deprecated. Users should go to
|
|
hdf5/windows directory, run copy_hdf.bat first and then open
|
|
all.dsw under hdf5/windows/proj/all to start building process.
|
|
|
|
</p>
|
|
<li><p>
|
|
2. To build HDF5 C++ and FORTRAN libraries, please read through
|
|
this document.
|
|
|
|
</p>
|
|
<li><p>
|
|
3. For users who want to quickly build HDF5 library or do not
|
|
want to know HDF5 building and installation details, please
|
|
read INSATLL_Windows_Short.txt.
|
|
|
|
</p>
|
|
<li><p>
|
|
4. For users who would like to build and test HDF5 package from the
|
|
command line, please read INSATLL_Windows_From_Command_Line.txt.
|
|
|
|
|
|
</p>
|
|
<li><p>
|
|
5. HDF4-related tools are not built and released with HDF5 library packages any more
|
|
. To obtain HDF4-releated tools, please check</p>
|
|
<p><a href="http://hdf.ncsa.uiuc.edu/h4toh5/" target="blank" ,>http://hdf.ncsa.uiuc.edu/h4toh5/</a></p>
|
|
<p> <A href="ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/" target=blank ,>ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/</A>
|
|
</p>
|
|
<li><p>
|
|
6. For DLL users, please do read and follow <A href="#dll_hints_section4" target=_blank>"DLL Hints" Section IV.</A>
|
|
</p>
|
|
<li><p>
|
|
7. For .NET users, please read <A href="#section6" target=_blank>Section VI.</a>
|
|
|
|
</p>
|
|
<li><p>
|
|
8. For users who would like to build, test and use HDF5 snapshot
|
|
release, please read <A href="#section8" target=_blank>Section VIII.</a>
|
|
</p>
|
|
<li><p>
|
|
9. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
|
|
Intel 8.1 only works with MSVS .net 2003 when you build
|
|
HDF5-1.8.x.
|
|
</p></li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
|
|
<h2><a name="section1">Section I: What do we build and install? </a> </h2>
|
|
<hr class="second" >
|
|
<ul class="intable">
|
|
<li><h4>1. Build and Install</h4>
|
|
<ul class="normal">
|
|
<li><p>HDF5 Static Library: debug and release version</p>
|
|
<li><p>HDF5 Dynamic Link Library(DLL): debug and release version as well as export libraries for DLL</p>
|
|
<li><p>HDF5 High-Level Library (Optional):HDF5 C++ Library and HDF5 HL-Fortran Library</p>
|
|
<li><p>HDF5 Tools: HDF5 tools </p></li>
|
|
</ul>
|
|
|
|
<li><h4>2. Build Only (Not included in the binary distribution)</h4>
|
|
<ul class="normal">
|
|
<li><p>HDF5 tool library: debug and release version</p>
|
|
<li><p>HDF5 tool export library for DLL: debug and release version</p>
|
|
<li><p>HDF5 library testing programs: HDF5 library comprehensive tests</p>
|
|
<li><p>HDF5 related tools testing programs: HDF5 tools comprehensive tests</p></li>
|
|
</ul>
|
|
<li><h4>3. Examples (Not included in the binary distribution)</h4>
|
|
<ul class="normal">
|
|
<li><p>HDF5 examples: simple HDF5 C/C++/Fortran examples</p></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section2">Section II: How to build and test HDF5 libraries and tools
|
|
</a> </h2>
|
|
<hr class="second" >
|
|
|
|
<h3><a name="#step1_section1">STEP 1: Building HDF5 libraries and tools</a></h3>
|
|
<ul class="intable">
|
|
<li><h4>1. Run batch file copy_hdf.bat.</h4>
|
|
<p> Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This
|
|
process will copy all the necessary batch files,windows specific
|
|
source codes and text files saved under c:\MyHDFstuff\hdf5\windows
|
|
directory to the corresponding directories under hdf5.
|
|
</p>
|
|
<li><h4><a name="step1_2_section1">2. Invoke Microsoft Visual C++ compiler</a></h4>
|
|
<p>Invoke Microsoft Visual C++. From the main menu, go to "File"
|
|
and select the "Open Workspace" option. Then open the
|
|
c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw workspace.
|
|
</p>
|
|
<p>You should find windows project files listed as "all files,
|
|
big files etc." on the left.
|
|
</p>
|
|
|
|
<li><h4>3. (Optional)HDF5 C++, Fortran libraries, HL-CPP, HL-Fortran and Intel compiler</h4>
|
|
<ul class="intable">
|
|
<li><h5><a name="section1_3.1">3.1 Skip this step if you do not want to build HDF5 C++ libraries</a></h5>
|
|
<p>Go to "Project" and select "dependencies";
|
|
Select "all" in the "Select project to modify:" box,
|
|
then enable the desired projects:
|
|
</p>
|
|
<ul class="normal">
|
|
<li>dsets_cpp
|
|
<li>dsets_cppdll
|
|
<li>hdf5_cpp
|
|
<li>hdf5_cppdll
|
|
<li>testhdf5_cpp
|
|
<li>testhdf5_cppdll</li>
|
|
</ul>
|
|
<li><h5><a name="section1_3.2">3.2 Skip this step if you do not want to build HDF5 Fortran libraries</a></h5>
|
|
<p>Go to "Project" and select "dependencies"; Select "all" in the "Select project to modify:" box,then enable the desired projects:</p>
|
|
<ul class="normal">
|
|
<li>flush1_fortran
|
|
<li>flush1_fortrandll
|
|
<li>flush2_fortran
|
|
<li>flush2_fortrandll
|
|
<li>hdf5_f90cstub
|
|
<li>hdf5_f90cstubdll
|
|
<li>hdf5_fortran
|
|
<li>hdf5_fortrandll
|
|
<li>libtest_cstubdll
|
|
<li>libtest_fortran
|
|
<li>libtest_fortrandll
|
|
<li>testhdf5_fortran
|
|
<li>testhdf5_fortrandll</li>
|
|
</ul>
|
|
<li><h5>3.3 Skip this step if you do not want to build HDF5 High-Level libraries</h5>
|
|
<p>Go to "Project" and select "dependencies"; Select "all" in the "Select project to modify:" box, then enable the desired projects: </p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl
|
|
<li>hl_test_image
|
|
<li>hl_test_lite
|
|
<li>hl_test_table
|
|
<li>hl_test_ds
|
|
<li>hl_test_packet</li>
|
|
</ul>
|
|
<li><h5>3.4 Skip this step if you do not want to build HDF5 High-Level C++ libraries</h5>
|
|
<p>Go to "Project" and select "dependencies"; Select "all" in the "Select project to modify:" box, then enable all of the project
|
|
files listed in <A href="#section1_3.1" target=_blank>Section II, Step 1(3.1)</A> and the following desired projects: </p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl_cpp
|
|
<li>hl_test_table_cpp</li>
|
|
</ul>
|
|
<li><h5>3.5 Skip this step if you do not want to build HDF5 High-Level Fortran libraries</h5>
|
|
<p>Go to "Project" and select "dependencies"; Select "all" in the "Select project to modify:" box, then enable all
|
|
of the project files listed in <A href="#section1_3.2" target=_blank>Section II, Step 1(3.2)</A> and the following desired projects: </p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl_fortran
|
|
<li>hl_test_image_fortran
|
|
<li>hl_test_lite_fortran
|
|
<li>hl_test_table_fortran<li></li>
|
|
</ul>
|
|
<li><h5>3.6 If you are using Intel compilers, please read <A href="#section7" target=_blank>Section VII.</A></h5>
|
|
</li>
|
|
</ul>
|
|
<li><h4>4. Select "Build", then Select "Set Active Configuration".</h4>
|
|
<ul class="intable">
|
|
<li><h5>4.1 To build debug versions of single-threaded static libraries, Debug multithreaded DLLs and tests</h5>
|
|
<p>In "Project configurations", select "all -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build debug version of project "all".
|
|
</p>
|
|
<li><h5>4.2 To build release versions of single-threaded static libraries, multithreaded DLLs and tests</h5>
|
|
<p>In "Project configurations", select "all -- Win32 Release", select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build release version of project "all".
|
|
</p>
|
|
<OL></OL>
|
|
<p class="note">Notes:</p>
|
|
<ol>
|
|
<li><p>Both debug and release versions must be built.</p>
|
|
<li><p>Warning messages can be ignored. </p></li></ol>
|
|
</li>
|
|
</ul>
|
|
<p>When the debug or release build is done the directories listed below will contain the following files:</p>
|
|
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid">
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5\debug</td>
|
|
<td>hdf5d.lib</td>
|
|
<td>the hdf5 static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5\release</td>
|
|
<td>hdf5.lib</td>
|
|
<td>the hdf5 static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\debug</td>
|
|
<td>hdf5ddll.dll</td>
|
|
<td>DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5ddll.lib</td>
|
|
<td>the DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5dll\release</td>
|
|
<td>hdf5dll.dll</td>
|
|
<td>DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5dll.lib</td>
|
|
<td>the DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<p>c:\MyHDFstuff\hdf5\test\libtest\debug</p>
|
|
|
|
<p>c:\MyHDFstuff\hdf5\test\libtest\release</p>
|
|
|
|
</td>
|
|
<td>libtest.lib</td>
|
|
<td>the internal library for test</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\debug</td>
|
|
<td>libtestD.dll</td>
|
|
<td>the internal DLL for test</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtestD.lib</td>
|
|
<td>the internal DLL export library for test</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\test\libtestD\release</td>
|
|
<td>libtestD.dll</td>
|
|
<td>the internal DLL for test</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtestD.lib</td>
|
|
<td>the internal DLL export library for test</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
|
|
<p>c:\MyHDFstuff\hdf5\tools\toolslib\debug
|
|
|
|
<p>c:\MyHDFstuff\hdf5\tools\toolslib\release</p>
|
|
|
|
</td>
|
|
<td>toolslib.lib</td>
|
|
<td>the internal tools library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">
|
|
|
|
<p>c:\MyHDFstuff\hdf5\tools\toolslibD\debug</p>
|
|
|
|
<p>c:\MyHDFstuff\hdf5\tools\toolslibD\release</p>
|
|
|
|
</td>
|
|
<td>toolslibD.dll</td>
|
|
<td>DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>toolslibD.lib</td>
|
|
<td>the internal DLL export library for tools</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\tools\"tools directory"</td>
|
|
<td> </td>
|
|
<td>where tools are located</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<p>The directories listed below will contain the following files ONLY when you choose to build HDF5 C++ libraries:</p>
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"
|
|
>
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\debug</td>
|
|
<td>hdf5_cppd.lib</td>
|
|
<td>the HDF5 C++ API static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_cpp\release</td>
|
|
<td>hdf5_cpp.lib</td>
|
|
<td>the HDF5 C++ API static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\debug</td>
|
|
<td>hdf5_cppddll.dll</td>
|
|
<td>the HDF5 C++ API DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_cppddll.lib</td>
|
|
<td>the C++ API DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_cppdll\release</td>
|
|
<td>hdf5_cppdll.dll</td>
|
|
<td>the HDF5 C++ API DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_cppdll.lib</td>
|
|
<td>the C++ API DLL export library</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<p>The directories listed below will contain the following files ONLY when you choose to build HDF5 Fortran libraries:</p>
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"
|
|
>
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\debug</td>
|
|
<td>hdf5_fortrand.lib</td>
|
|
<td>the HDF5 Fortran API static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_fortran\release</td>
|
|
<td>hdf5_fortran.lib</td>
|
|
<td>the HDF5 Fortran API static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\debug</td>
|
|
<td>hdf5_fortranddll.dll</td>
|
|
<td>the HDF5 Fortran API DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_fortranddll.lib</td>
|
|
<td>the HDF5 Fortran API DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_fortrandll\release</td>
|
|
<td>hdf5_fortrandll.dll</td>
|
|
<td>the HDF5 Fortran API DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_fortrandll.lib</td>
|
|
<td>the HDF5 Fortran API DLL export library </td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_f90sctub\debug</td>
|
|
<td>hdf5_f90cstubd.lib</td>
|
|
<td>the HDF5 C and Fortran stub static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_f90cstub\release</td>
|
|
<td>hdf5_f90cstub.lib</td>
|
|
<td>the HDF5 C and Fortran stub static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\debug</td>
|
|
<td>hdf5_f90cstubddll.dll</td>
|
|
<td>the HDF5 C and Fortran stub DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_f90cstubddll.lib</td>
|
|
<td>the HDF5 C and Fortran stub DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_f90cstubdll\release</td>
|
|
<td>hdf5_f90cstubdll.dll</td>
|
|
<td>the HDF5 C and Fortran stub DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>hdf5_f90cstubdll.lib</td>
|
|
<td>the HDF5 C and Fortran stub DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\debug</td>
|
|
<td>libtest_cstubddll.dll</td>
|
|
<td>the HDF5 Fortran test C and Fortran stub DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtest_cstubddll.lib</td>
|
|
<td>the HDF5 Fortran test C and Fortran stub DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_cstubdll\release</td>
|
|
<td>libtest_cstubdll.dll</td>
|
|
<td>the HDF5 Fortran test C and Fortran stub DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtest_cstubdll.lib</td>
|
|
<td>the HDF5 Fortran test C and Fortran stub DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\debug</td>
|
|
<td>libtest_fortrand.lib</td>
|
|
<td>the HDF5 Fortran test static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td>
|
|
<td>libtest_fortran.lib</td>
|
|
<td>the HDF5 Fortran test static library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortrandll\debug</td>
|
|
<td>libtest_fortranddll.dll</td>
|
|
<td>the HDF5 Fortran test DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtest_fortranddll.lib</td>
|
|
<td>the HDF5 Fortran test DLL export library</td>
|
|
</tr>
|
|
<tr>
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\fortran\test\libtest_fortran\release</td>
|
|
<td>libtest_fortrandll.dll</td>
|
|
<td>the HDF5 Fortran test DLL</td>
|
|
</tr>
|
|
<tr>
|
|
<td>libtest_fortrandll.lib</td>
|
|
<td>the HDF5 Fortran test DLL export library</td>
|
|
</tr>
|
|
</table>
|
|
<div>
|
|
|
|
<p>The directories listed below will contain the following files ONLY when you choose to build HDF5 High Level libraries:</p>
|
|
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"
|
|
>
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Release</td>
|
|
<td>hdf5_hl.lib</td>
|
|
<td>HDF5 High Level Static Library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl\Debug</td>
|
|
<td>hdf5_hld.lib</td>
|
|
<td>HDF5 High Level Static Library</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<p>The directories listed below will contain the following files ONLY when you choose to build HDF5 High Level C++ libraries:</p>
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"
|
|
>
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Release</td>
|
|
<td>hdf5_hl_cpp.lib</td>
|
|
<td>HDF5 High Level Static Library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cpp\Debug</td>
|
|
<td>hdf5_hl_cpp.lib</td>
|
|
<td>HDF5 High Level Static Library</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<p>The directories listed below will contain the following files ONLY when you choose to build HDF5 High Level Fortran libraries:</p>
|
|
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"
|
|
>
|
|
<tr>
|
|
<th>Location</th>
|
|
<th>File Name</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Release</td>
|
|
<td>hdf5_hl_fortran.lib</td>
|
|
<td>HDF5 High Level Fortran Static Library</td>
|
|
</tr>
|
|
<tr>
|
|
<td>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortran\Debug</td>
|
|
<td>hdf5_hl_fortrand.lib</td>
|
|
<td>HDF5 High-Level Fortran Static Library</td>
|
|
</tr>
|
|
</table>
|
|
</div></div></div>
|
|
</li>
|
|
</ul>
|
|
|
|
<h3><a name="step2_section2">STEP 2: Testing HDF5 libraries and tools</a></h3>
|
|
<p>HDF5 libraries and tools should be tested to make sure that they were built correctly.</p>
|
|
<p>We provide 2 options for users to test HDF5 libraries and tools.</p>
|
|
<h4>Option 1: Automatic Testings</h4>
|
|
<p>HDF5 comes with various test suites, all of which can be tested
|
|
with hdf5check.bat batch file in c:\MyHDFstuff\hdf5 directory.
|
|
</p>
|
|
<p>hdf5check batch file can be run with one of the following four
|
|
options:
|
|
</p>
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid">
|
|
<tr>
|
|
<th>Options</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check</p></td>
|
|
<td><p>test HDF5 C library and tools only</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check enablecpp</p></td>
|
|
<td><p>test HDF5 C/C++ libraries and tools.</p>
|
|
<p>To use this option, HDF5 C++ libraries must have been built in <A href="#section1_3.1" target=_blank>step I.</a></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check enablefortran</p></td>
|
|
<td><p>test HDF5 C/FORTRAN libraries and tools</p>
|
|
<p>To use this option, HDF5 Fortran libraries must have been built in <A href="#section1_3.2" target=_blank>step I.</a></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check enableall</p></td>
|
|
<td><p>test HDF5 C/C++/FORTRAN libraries and tools</p>
|
|
<p>To use this option, HDF5 C++ and Fortran libraries must have been built in step I.</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<p>Invoke a command prompt window and run hdf5check with appropriate option.</p>
|
|
<p>Test results are saved in two files:</p>
|
|
<p style="MARGIN-LEFT: 10%">c:\MyHDFstuff\hdf5\check_results.txt</p>
|
|
<p style="MARGIN-LEFT: 10%">c:\MyHDFstuff\hdf5\tests_results.txt.</p>
|
|
<p>In general, you only need to check tests_results.txt. If all the
|
|
tests passed, then you do not have to check check_results.txt.
|
|
If some tests failed, check check_results.txt can help you
|
|
figure out what was wrong.
|
|
</p>
|
|
|
|
<h4>Option 2: Step-by-step HDF5 libraries and tools testings</h4>
|
|
<p>You can also test HDF5 libraries and tools one by one. There are
|
|
possibly four versions of HDF5 libraries and tools testings.
|
|
They are:
|
|
</p>
|
|
<ul class="normal">
|
|
<li><p>release version</p>
|
|
<li><p>release dll version</p>
|
|
<li><p>debug version</p>
|
|
<li><p>debug dll version</p></li>
|
|
</ul>
|
|
<p>We strongly suggest you to redirect your testing results into an
|
|
output file so that you can easily check the testing results. You
|
|
may use either Notepad or WordPad or whatever other windows word
|
|
processor to check the results. For the purpose of printing,
|
|
please choose font less than 14 for better alignment of the text.
|
|
</p>
|
|
<p>DLLs listed below should be placed into the Windows system
|
|
directory. A batch file named install_dll.bat is included in
|
|
c:\MyHDFstuff\hdf5 directory. Run this batch file and the
|
|
following HDF5 DLLs will be copied to the system directory.
|
|
</p>
|
|
<ul class="normal">
|
|
<li>hdf5\proj\hdf5dll\release\hdf5dll.dll
|
|
<li>hdf5\proj\hdf5dll\debug\hdf5ddll.dll
|
|
<li>hdf5\test\libtestD\release\libtestD.dll
|
|
<li>hdf5\test\libtestD\debug\libtestDd.dll</li>
|
|
</ul>
|
|
<ul class="intable">
|
|
<li><h5>1. HDF5 library testing</h5>
|
|
<p>cd into the hdf5\test directory.</p>
|
|
<ul class="intable">
|
|
<li><h5>(1) Basic Tests</h5>
|
|
<p>Go to a, b, c, or d to test your chosen version</p>
|
|
<ul class="intable">
|
|
<li><h5>a. release static version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5test release >"Your output filename" </p>
|
|
<li><h5>b. release dll version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5test release dll > "Your output filename"</p>
|
|
<li><h5>c. debug static version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5test debug >"Your output filename"</p>
|
|
<li><h5>d. debug dll version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5test debug dll >"Your output filename"</p>
|
|
</li>
|
|
</ul>
|
|
<li><h5>(2) Timing tests</h5>
|
|
<p>Go to a, b, c, or d to test your chosen version</p>
|
|
<ul class="intable">
|
|
<li><h5>a. release static version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5timingtest release >"Your output filename" </p>
|
|
<li><h5>b. release dll version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5timingtest release dll >"Your output filename" </p>
|
|
<li><h5>c. debug static version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5timingtest debug >"Your output filename" </p>
|
|
<li><h5>d. debug dll version</h5>
|
|
<p>type:</p>
|
|
<p>hdf5timingtest debug dll >"Your output filename" </p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
<li><h5>2. HDF5 tools testing</h5>
|
|
<p>To test HDF5 tools, cd back into hdf5 directory and then cd into tools directory(c:\MyHDFstuff\hdf5\tools). The HDF5 tools testing
|
|
results are saved into output files in tools directory by the testhdf5tools.bat as described below.
|
|
</p>
|
|
<p>Go to a, b, c, or d to test your chosen version</p>
|
|
<ul class="intable">
|
|
<li><h5>a. release static version</h5>
|
|
<p>type:</p>
|
|
<p>testhdf5tools release</p>
|
|
<p>output file: toolstest_release.txt</p>
|
|
<li><h5>b. release dll version</h5>
|
|
<p>type:</p>
|
|
<p>testhdf5tools release dll</p>
|
|
<p>output file: toolstest_releasedll.txt</p>
|
|
<li><h5>c. debug static version</h5>
|
|
<p>type:</p>
|
|
<p>testhdf5tools debug</p>
|
|
<p>output file: toolstest_debug.txt</p>
|
|
<li><h5>d. debug dll version</h5>
|
|
<p>type:</p>
|
|
<p>testhdf5tools debug dll</p>
|
|
<p>output file: toolstest_debugdll.txt</p>
|
|
</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
<li><h5>3. HDF5 C++ library test</h5>
|
|
<p>Skip this step UNLESS you have built HDF5 C++ libraries and want to test them.</p>
|
|
<p>DLLs listed below should be placed into to the Windows system
|
|
directory. A batch file named install_cppdll.bat is included in
|
|
c:\MyHDFstuff\hdf5 directory. Run this batch file and the
|
|
following HDF5 C++ DLLs will be copied to the system directory.
|
|
</p>
|
|
<ul class="normal">
|
|
<li>hdf5\proj\hdf5_cppdll\release\hdf5_cppdll.dll
|
|
<li>hdf5\proj\hdf5_cppdll\debug\hdf5_cppddll.dll</li>
|
|
</ul>
|
|
<p>Run hdf5cpptest.bat in the hdf5\c++\test directory at the command prompt as below:</p>
|
|
<ul class="normal">
|
|
<li>hdf5cpptest release >"Your output filename"
|
|
<li>hdf5cpptest release dll >"Your output filename"
|
|
<li>hdf5cpptest debug >"Your output filename"
|
|
<li>hdf5cpptest debug dll >"Your output filename"</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>Use Notepad or WordPad to check results. You should
|
|
not find any FAILED marks in your output files.
|
|
</p>
|
|
<li><h5>4. HDF5 Fortran library test</h5>
|
|
<p>Skip this step UNLESS you have built HDF5 Fortran libraries and want to test them.</p>
|
|
<p>DLLs listed below should be placed into to the Windows system
|
|
directory. A batch file named install_f90dll.bat is included in
|
|
c:\MyHDFstuff\hdf5 directory. Run this batch file and the
|
|
following HDF5 Fortran DLLs will be copied to the system
|
|
directory.
|
|
</p>
|
|
<ul class="normal">
|
|
<li>hdf5\proj\hdf5_f90cstubdll\release\hdf5_f90cstubdll.dll
|
|
<li>hdf5\proj\hdf5_f90cstubdll\debug\hdf5_f90cstubddll.dll
|
|
<li>hdf5\proj\hdf5_fortrandll\release\hdf5_fortrandll.dll
|
|
|
|
<li>hdf5\proj\hdf5_fortrandll\debug\hdf5_fortranddll.dll
|
|
<li>hdf5\fortran\test\libtest_cstubdll\release\libtest_cstubdll.dll
|
|
|
|
<li>hdf5\fortran\test\libtest_cstubdll\debug\libtest_cstubddll.dll
|
|
|
|
<li>hdf5\fortran\test\libtest_fortrandll\release\libtest_fortrandll.dll
|
|
|
|
<li>hdf5\fortran\test\libtest_fortrandll\debug\libtest_fortranddll.dll</li>
|
|
</ul>
|
|
<p>Run testhdf5_fortran.bat at the command prompt as below:</p>
|
|
<ul class="normal">
|
|
<li>testhdf5_fortran release > "Your output filename"
|
|
<li>testhdf5_fortran release dll > "Your output
|
|
filename"
|
|
<li>testhdf5_fortran debug > "Your output filename"
|
|
<li>testhdf5_fortran debug dll > "Your output filename"</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
<li><h5>5. HDF5 High-Level library test</h5>
|
|
<p>Skip this step UNLESS you have built HDF5 High-Level libraries and want to test them.</p>
|
|
<p>Run test_hdf5_hl.bat in the hdf5\hl\test directory at the command prompt as below:</p>
|
|
<ul class="normal">
|
|
<li>test_hdf5_hl release >"Your output filename"
|
|
<li>test_hdf5_hl release dll >"Your output filename"
|
|
<li>test_hdf5_hl debug >"Your output filename"
|
|
<li>test_hdf5_hl debug dll >"Your output filename"</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
<li><h5>6. HDF5 High-Level C++ library test</h5>
|
|
<p>Skip this step UNLESS you have built HDF5 High-Level C++ libraries and want to test them.</p>
|
|
<p>Run test_hdf5_hl_cpp.bat in the hdf5\hl\c++\test directory at the command prompt as below:</p>
|
|
<ul class="normal">
|
|
<li>test_hdf5_hl_cpp release >"Your output filename"
|
|
<li>test_hdf5_hl_cpp release dll >"Your output
|
|
filename"
|
|
<li>test_hdf5_hl_cpp debug >"Your output filename"
|
|
<li>test_hdf5_hl_cpp debug dll >"Your output filename"</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
<li><h5>7. HDF5 High-Level Fortran library test</h5>
|
|
<p>Skip this step UNLESS you have built HDF5 High-Level Fortran libraries and want to test them.</p>
|
|
<p>Run test_hdf5_hl_fortran.bat in the hdf5\hl\fortran\test directory at the command prompt as below:</p>
|
|
<ul class="normal">
|
|
<li>test_hdf5_hl_fortran release >"Your output
|
|
filename"
|
|
<li>test_hdf5_hl_fortran release dll >"Your output
|
|
filename"
|
|
<li>test_hdf5_hl_fortran debug >"Your output filename"
|
|
|
|
<li>test_hdf5_hl_fortran debug dll >"Your output filename"</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<p>Use Notepad or WordPad to check results. You should not find any FAILED marks in your output files.</p>
|
|
</li>
|
|
</ul>
|
|
|
|
<h3><a name="step3_section2">STEP 3: Installing HDF5 Libraries</a></h3>
|
|
<p>We provide a batch file for users to relocate all HDF5 libraries in one
|
|
folder (C++ and Fortran libraries will also be copied into this folder
|
|
if they have been built in step I). The file is called
|
|
installhdf5lib.bat under c:\MyHDFstuff\hdf5 directory. Run the batch
|
|
file, you may see a folder called hdf5lib under c:\MyHDFstuff\hdf5.
|
|
</p>
|
|
<p>The <release> layout of <hdf5lib> should be:</p>
|
|
<ul class="normal">
|
|
<li>
|
|
release\include -- HDF5 header files
|
|
|
|
<li>release\bin -- HDF5 static tool executables
|
|
|
|
<li>release\bindll -- HDF5 DLL tool executables
|
|
|
|
<li>release\lib -- HDF5 static libraries
|
|
|
|
<li>release\dll -- HDF5 DLLs</li>
|
|
</ul>
|
|
<p>You may also find the similar layout for the <debug>.
|
|
|
|
<h3>STEP 4: Building HDF5 C/C++/Fortran examples (Optional)</h3>
|
|
<p>Simple examples have been provided for users to test HDF5 C/C++/Fortran library and tools.</p>
|
|
<p class="note">Notes:</p>
|
|
<ul class="intable">
|
|
<li><p>1. To build HDF5 C++ examples, HDF5 C++ library must have been built in step I. </p>
|
|
|
|
<li><p>2. To build HDF5 Fortran examples, HDF5 Fortran library must have been built in step I. </p>
|
|
|
|
<li><p>3. By default, the debug versions of HDF5 C/C++/Fortran examples are linked with the debug versions of HDF5 C/C++/Fortran
|
|
libraries and DLLs. The debug versions of HDF5 C/C++/Fortran examples will fail if they are linked with HDF5 binary
|
|
distribution, which only includes the release versions of HDF5 C/C++/Fortran libraries and DLLs.
|
|
</p></li>
|
|
</ul>
|
|
|
|
<ul class="intable">
|
|
<li><h5>To build and test HDF5 C examples:</h5>
|
|
<ul class="intable">
|
|
<li><p>1. Invoke Microsoft Visual C++, go to "File" and select the "Open Workspace" option.</p>
|
|
<p>Then open the workspace c:\MyHDFstuff\hdf5\windows\examples\allexamples\allexamples.dsw.</p>
|
|
<li><p>2. Select "Build", then Select "Set Active Configuration". </p>
|
|
<ul class="intable">
|
|
<li><h5>To build debug versions of C examples.</h5>
|
|
<p>In "Project configurations", select "allexamples -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build debug version of project "allexamples".
|
|
</p>
|
|
<li><h5>To build release versions of C examples.</h5>
|
|
<p>In "Project configurations", select "allexamples -- Win32 Release",
|
|
select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build release version of project "allexamples".
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>When the debug build or release build is done, there should be the
|
|
following subdirectories in c:\MyHDFstuff\hdf5\examples\</p>
|
|
<ul class="normal">
|
|
<li>attributetest
|
|
<li>attributetestdll
|
|
<li>chunkread
|
|
<li>chunkreaddll
|
|
<li>compoundtest
|
|
<li>compoundtestdll
|
|
<li>extendwritetest
|
|
<li>extendwritetestdll
|
|
<li>grouptest
|
|
<li>grouptestdll
|
|
<li>readtestdll
|
|
<li>selectest
|
|
<li>selectestdll
|
|
<li>writetest
|
|
<li>writetestdll</li>
|
|
</ul>
|
|
<li><p>3. Invoke a command prompt window and run the batch file
|
|
InstallExamples.bat which resides in the top level directory
|
|
(c:\MyHDFstuff\hdf5). This file creates 4 new directories,
|
|
examplesREL, examplesRELDLL, examplesDBG, and examplesDBGDLL,
|
|
in the c:\MyHDFstuff\hdf5\examples directory and places all the
|
|
executables in it. Both the release and debug versions of the
|
|
examples should be built before this step is done.
|
|
</p>
|
|
<li><p>4. We provide a batch file named testExamples.bat and an expected
|
|
examples tests output file named testExamples_exp_output.txt
|
|
in c:\MyHDFstuff\hdf5\examples directory for you to test HDF5
|
|
C examples.</p>
|
|
<p>testExamples.bat batch file has 4 options:</p>
|
|
<ul class="normal">
|
|
<li>testExamples release -- for release version
|
|
|
|
<li>testExamples release dll -- for release DLL
|
|
version
|
|
|
|
<li>testExamples debug -- for debug version
|
|
|
|
<li>testExamples debug dll -- for debug DLL version</li>
|
|
</ul>
|
|
<p>Invoke a command prompt window and run testExamples with
|
|
appropriate options. You should get "All HDF5 C examples tests
|
|
passed." when the C examples are built successfully. Otherwise,
|
|
the difference between the expected outputs and actual outputs
|
|
wil be given.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<li><h5>To build and test HDF5 C++ examples:</h5>
|
|
<ul class="intable">
|
|
<li><p>1. Invoke Microsoft Visual C++, go to "File" and select the "Open Workspace" option.</p>
|
|
<p>Then open the workspace</p>
|
|
<p>c:\myHDFstuff\hdf5\windows\c++\examples\allcppexamples\allcppexamples.dsw.</p>
|
|
<li><p>2. Select "Build", then Select "Set Active Configuration".</p>
|
|
<ul class="intable">
|
|
<li><h5>To build debug versions of C++ examples.</h5>
|
|
<p>In "Project configurations", select "allcppexamples -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build debug version of project "allcppexamples".
|
|
</p>
|
|
<li><h5>To build release versions of C++ examples.</h5>
|
|
<p>In "Project configurations", select "allcppexamples -- Win32 Release",
|
|
select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build release version of project "allcppexamples".
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>When the debug build or release build is done, there should be the
|
|
following subdirectories in c:\MyHDFstuff\hdf5\c++\examples\</p>
|
|
<ul class="normal">
|
|
<li>chunkstest
|
|
<li>chunkstestdll
|
|
<li>compoundtest
|
|
<li>compoundtestdll
|
|
<li>createtest
|
|
<li>createtestdll
|
|
<li>extend_dstest
|
|
<li>extend_dstestdll
|
|
<li>h5grouptest
|
|
<li>h5grouptestdll
|
|
<li>readdatatest
|
|
<li>readdatatestdll
|
|
<li>writedatatest
|
|
<li>writedatatestdll </li>
|
|
</ul>
|
|
<li><p>3. Invoke a command prompt window and run the batch file
|
|
InstallcppExamples.bat which resides in the top level directory
|
|
(c:\MyHDFstuff\hdf5). This file creates 4 new directories,
|
|
cppexamplesREL, cppexamplesRELDLL, cppexamplesDBG,
|
|
and cppexamplesDBGDLL, in the c:\MyHDFstuff\c++\examples
|
|
directory and places all the executables in it. Both the release
|
|
and debug versions of the examples should be built before this
|
|
step is done.
|
|
</p>
|
|
<li><p>4. We provide a batch file named testcppExamples.bat in
|
|
c:\MyHDFstuff\hdf5\c++\examples directory for you to test HDF5
|
|
C++ examples.
|
|
</p>
|
|
<p>testcppExamples.bat batch file has 4 options:</p>
|
|
|
|
<ul class="normal">
|
|
<li>testcppExamples release -- for release version
|
|
|
|
<li>testcppExamples release dll -- for release DLL
|
|
version
|
|
|
|
<li>testcppExamples debug -- for debug version
|
|
|
|
<li>testcppExamples debug dll -- for debug DLL version</li>
|
|
</ul>
|
|
|
|
<p>Invoke a command prompt window and run testcppExamples with
|
|
appropriate options. You should get "All HDF5 C++ examples tests
|
|
passed." when the C++ examples are built successfully. Otherwise,
|
|
the difference between the expected outputs and actual outputs
|
|
will be given.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<li><h5>To build and test HDF5 Fortran example:</h5>
|
|
<ul class="intable">
|
|
<li><p>1. Invoke Compaq Visual Fortran or intel Fortran under Microsoft
|
|
Visual studio development environment, go to "File" and select
|
|
the "Open Workspace" option.
|
|
</p>
|
|
<p>Then open the workspace</p>
|
|
<p>c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw.</p>
|
|
<li><p>2. Select "Build", then Select "Set Active Configuration".</p>
|
|
<ul class="intable">
|
|
<li><h5>To build debug versions of Fortran examples.</h5>
|
|
<p>In "Project configurations", select "allf90examples -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build debug version of project "allf90examples".
|
|
</p>
|
|
<li><h5>To build release versions of Fortran examples.</h5>
|
|
<p>In "Project configurations", select "allf90examples -- Win32 Release",
|
|
select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build release version of project "allf90examples".
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>When the debug build or release build is done, there should be the
|
|
following subdirectories in c:\MyHDFstuff\hdf5\fortran\examples\
|
|
</p>
|
|
<ul class="normal">
|
|
<li>attreexampletest
|
|
<li>attreexampletestdll
|
|
<li>compoundtest
|
|
<li>compoundtestdll
|
|
<li>dsetexampletest
|
|
<li>dsetexampletestdll
|
|
<li>fileexampletest
|
|
<li>fileexampletestdll
|
|
<li>groupexampletest
|
|
<li>groupexampletestdll
|
|
<li>grpdsetexampletest
|
|
<li>grpdsetexampletestdll
|
|
<li>grpittest
|
|
<li>grpittestdll
|
|
<li>grpsexampletest
|
|
<li>grpsexampletestdll
|
|
<li>hyperslabtest
|
|
<li>hyperslabtestdll
|
|
<li>mountexampletest
|
|
<li>mountexampletest
|
|
<li>refobjexampletest
|
|
<li>refobjexampletestdll
|
|
<li>refregexampletest
|
|
<li>refregexampletestdll
|
|
<li>rwdsetexampletest
|
|
<li>rwdsetexampletestdll
|
|
<li>selecteletest
|
|
<li>selecteletestdll</li>
|
|
</ul>
|
|
<li><p>3. Invoke a command prompt window and run the batch file
|
|
Installf90Examples.bat which resides in the top level directory
|
|
(c:\MyHDFstuff\hdf5). This file creates 4 new directories,
|
|
f90examplesREL, f90examplesRELDLL, f90examplesDBG, and
|
|
f90examplesDBGDLL, in the c:\MyHDFstuff\fortran\examples directory
|
|
and places all the executables in it. Both the release and debug
|
|
versions of the examples should be built before this step is done.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
|
|
<h2><a name="section3">Section III: Building an application using the HDF5 library or DLL</a></h2>
|
|
<hr class="second" >
|
|
<p class="note">Warings:</p>
|
|
<p>The instructions below will only describe how to build an
|
|
application using the release version of the HDF5 library or
|
|
DLL. To use the debug version of the HDF5 library or DLL, you
|
|
need to substitute the release version of the HDF5 library or
|
|
DLL with the debug version.
|
|
</p>
|
|
<ul class="intable">
|
|
<li>
|
|
<h3>To use HDF5 static library</h3>
|
|
|
|
<p>To build an application using HDF5 Static Library, the
|
|
following locations will need to be specified for locating header
|
|
files and linking with the HDF static library, for example:
|
|
</p>
|
|
<ul class="normal">
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\include
|
|
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\lib</li>
|
|
</ul>
|
|
<p>If you have installed HDF5 library in <A href="#step3_section2" target=_blank>Section II, step 3</a>, We assume that you will use Zlib and Szip compression with HDF5
|
|
library.
|
|
</p>
|
|
<p>To specify these locations in the settings for your VC++ project, you may choose one of the following two methods.</p>
|
|
<ul class="intable">
|
|
<li>
|
|
<h4>Method One</h4>
|
|
<h4><a name="method1_header">To insert the path that specifies HDF5 and Zlib, Szip header files:</a></h4>
|
|
<ol style="LIST-STYLE-TYPE: lower-roman">
|
|
<li><p>Open your VC++ project in Microsoft Visual C++ and make sure it
|
|
is the active project.
|
|
</p>
|
|
<li><p>Go to the Project menu and chose the "Settings" option.</p>
|
|
<li><p>Choose the build configuration you would like to modify in the drop down menu labeled with "Settings For:"</p>
|
|
|
|
<li><p>Choose the C/C++ tab</p>
|
|
<li><p>Choose "Preprocessor" in the drop down menu labeled with "Category:"</p>
|
|
<li><p>In a text-area labeled with "Additional include directories:", add HDF5, Zlib, and Szip header files directories. For example:</p>
|
|
<ul class="normal">
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\include
|
|
<li>c:\zlib122\include
|
|
<li>c:\szip\include</li>
|
|
</ul>
|
|
<p>Then click OK.</p>
|
|
<li><p> (optional) to use HDF5 Fortran static library,
|
|
the location of Fortran module files should be
|
|
specifiedbyfollowingProject->Settings->Fortran->Preprocessor,
|
|
and in a test-area labeled with "INCLUDE and USE Paths:", add
|
|
HDF5 Fortran module files directories. For example:
|
|
</p>
|
|
<ul class="normal">
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\include</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<h4><a name="link_hdf5">To link the HDF5 library with your application:</a></h4>
|
|
<ol style="LIST-STYLE-TYPE: lower-roman">
|
|
<li><p>Open your VC++ project in Microsoft Visual C++ and make sure it
|
|
is the active project.</p>
|
|
|
|
<li><p>Go to the Project menu and chose the "Add to Project" option and
|
|
then "Files" option.</p>
|
|
|
|
<li><p>Change the "Files of type:" to "Library Files (.lib)"</p>
|
|
|
|
<li><p>Navigate through the directories until you find the location of
|
|
the hdf5.lib. </p>
|
|
|
|
<li><p>Select hdf5.lib and click OK.</p>
|
|
|
|
<li><p>repeat step i-v, to select zdll.lib and szlibdll.lib.</p>
|
|
|
|
<li><p>(optional) repeat step i-v, to select hdf5_cpp.lib to link with HDF5
|
|
C++ static library.</p>
|
|
|
|
<li><p>(optional) repeat step i-v5, to select hdf5_fortran.lib to link with
|
|
HDF5 Fortran static library.</p></li></ol>
|
|
<li>
|
|
<h4>Method Two</h4>
|
|
<ol style="LIST-STYLE-TYPE: lower-roman">
|
|
<li><p>Go toTools->Options->Directories,</p>
|
|
<li><p>Insert the correct HDF5, Zlib, Szip paths for both headers(include)
|
|
and libraries. For example, </p>
|
|
<ul class="normal">
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\include
|
|
<li>c:\MyHDFstuff\hdf5\hdf5lib\release\lib
|
|
<li>c:\zlib122\include
|
|
<li>c:\zlib122\lib
|
|
<li>c:\szip\include
|
|
<li>c:\szip\dll</li>
|
|
</ul>
|
|
<li><p>Go to the Project menu and choose the "Settings" option.</p>
|
|
<li><p>Find the "link" option and "Input" category, insert "zdll.lib, szlibdll.lib, hdf5.lib".</p>
|
|
<li><p>(Optional) repeat step iii-iv, to insert "hdf5_cpp.lib" if you want to use HDF5 C++ static library.</p>
|
|
<li><p>(Optional) repeat step iii-iv, to insert "hdf5_fortran.lib" if you want to use HDF5 Fortran static library.</p></li>
|
|
</ol>
|
|
</li></ul>
|
|
<li>
|
|
<h3>To use HDF5 DLL</h3>
|
|
<ol style="LIST-STYLE-TYPE: lower-roman">
|
|
<li><p>Follow the steps for specifying the location of the header files as shown in <A href="#method1_header" target=_blank>Method One.</a></p>
|
|
<li><p>Follow the steps for linking the HDF5 library as shown in <A href="#link_hdf5" target=_blank>Method One.</a>
|
|
except now link the export library that is created with the DLL.
|
|
The export library is called hdf5dll.lib for HDF5 C libray,
|
|
hdf5_cppdll.lib for HDF5 C++ library, and hdf5_fortrandll.lib
|
|
for HDF5 Fortran library.</p>
|
|
<li><p>Place the DLL in a location that Windows will be able to locate
|
|
it. The searched path and order for DLL's is</p>
|
|
<ol>
|
|
<li><p>The Windows system directory. The GetSystemDirectory function retrieves the path of this directory.</p>
|
|
<li><p>The Windows directory. The GetWindowsDirectory function retrieves the path of this directory.</p>
|
|
<li><p>The directories listed in the PATH environment variable.</p></li>
|
|
</ol>
|
|
<li><p>To modify your own application settings, please DO FOLLOW the<A href="#dll_hints_section4" target=_blank> "DLL Hints" at section IV "HELPFUL POINTERS".</A></p>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section4">Section IV: HELPFUL POINTERS</a></h2>
|
|
<hr class="second" >
|
|
<p>Here are some notes that may be of help if you are not familiar with using the Visual C++ Development Environment.</p>
|
|
<h3>Project name and location issues: </h3>
|
|
<p>If you must install all.dsw and all.dsp in another directory,
|
|
relative to hdf5 directory, you will be asked to locate the
|
|
sub-project files, when you open the project all.dsw.
|
|
</p>
|
|
<p>
|
|
If you want to rename all (the entire project), you will need to
|
|
modify two files all.dsw and all.dsp as text (contrary to the
|
|
explicit warnings in the files).
|
|
</p>
|
|
<p>
|
|
You can also modify all.dsw and all.dsp as text, to allow these two
|
|
files to be installed in another directory.
|
|
</p>
|
|
<h3>Settings... details:</h3>
|
|
<p> If you create your own project, the necessary settings can be read
|
|
from the all.dsp file(as text), or from the Project Settings in the
|
|
Developer Studio project settings dialog.
|
|
</p>
|
|
<p>Project</p>
|
|
<p> Settings</p>
|
|
<p> C/C++</p>
|
|
<p> Category</p>
|
|
<p> Code Generation</p>
|
|
<p> Use run-time Library</p>
|
|
<p>These are all set to use Single-Threaded</p>
|
|
<h3><a name="dll_hints_section4">DLL... hints:</a></h3>
|
|
<p>If you want to use DLL versions of HDF5 library in your application, you should</p>
|
|
<ol>
|
|
<li><p>Put HDF5 DLL into windows system directory</p>
|
|
<li><p>Add HDF5 DLL export library into your project</p>
|
|
<li><p>Follow "Settings... details" into the last line:
|
|
change Single-Threaded into Multithreaded DLL or
|
|
Debug Multithreaded DLL</p>
|
|
<li><p>Follow "Settings.. details" into PreProcessor:<p>
|
|
<p>Project</p>
|
|
<p> Settings</p>
|
|
<p> C/C++</p>
|
|
<p> Category</p>
|
|
<p> PreProcessor</p>
|
|
<p>Find PreProcessor definations and Add _HDF5USEDLL_ at the end of the PreProcessor definitions to use HDF5 C DLL.</p>
|
|
<li><p>(optional) repeat 4), add HDF5CPP_USEDLL at the
|
|
end of the PreProcessor definitions to use HDF5 C++ DLL.</p>
|
|
<li> <p>(optional)Follow
|
|
Project->Settings->Fortran->Category->General->Predefined Preprocess or Symbols, and add
|
|
"HDF5F90_WINDOWS" to use HDF5 Fortran DLL.</p>
|
|
</li>
|
|
</ol>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section5">Section V: How to disable Gzip(Zlib)/Szip compression</a></h2>
|
|
<hr class="second" >
|
|
<p class="note">Warnings:</p>
|
|
<p>When you modify the H5pubconf.h file as described below, DO NOT just change the values of these macros from 1 to 0.
|
|
Please DO remove(or comment out) appropriate lines.
|
|
</p>
|
|
<ul class="intable">
|
|
<li><h3>1. Disable Gzip compression</h3>
|
|
<p>If you would like to remove Gzip compression from the HDF5 library, follow the steps below.</p>
|
|
<ul class="intable">
|
|
<li><p>1.1 Open the H5pubconf.h file from the c:\MyHDFstuff\hdf5\src
|
|
directory and remove(or comment out) the following two lines:
|
|
</p>
|
|
<ul class="normal">
|
|
<li>#define H5_HAVE_ZLIB_H 1
|
|
|
|
<li>#define H5_HAVE_FILTER_DEFLATE 1</li>
|
|
</ul>
|
|
<p>then save the file.</p>
|
|
<li><p>1.2 Delete HDF5_EXT_ZLIB environment variable if you have set it in preconditions.</p>
|
|
<li><p>1.3 Run-compile HDF5 library according to <A href="#section2" target=_blank>Section II.</a></p></li>
|
|
</ul>
|
|
<p>When you disable Gzip, you may get the following message when building HDF5 libraries:</p>
|
|
<ul class="normal">
|
|
<li>The following environment variables were not found $(HDF5_EXT_ZLIB)</li>
|
|
</ul>
|
|
<p>This message can be ignored.</p>
|
|
<li><h3>2. Disable Szip compression (both encoder and decoder)</h3>
|
|
<p>If you would like to remove Szip compression from the HDF5 library, follow the steps below.</p>
|
|
<ul class="intable">
|
|
<li><p>2.1 Open the H5pubconf.h file from the c:\MyHDFstuff\hdf5\src
|
|
directory and remove(or comment out) the following three
|
|
lines: </p>
|
|
<ul class="normal">
|
|
<li>#define H5_HAVE_SZLIB_H 1
|
|
<li>#define H5_HAVE_FILTER_SZIP 1</li>
|
|
</ul>
|
|
<p>then save the file.</p>
|
|
<li><p>2.2 Delete HDF5_EXT_SZIP environment variable if you have set it in preconditions.</p>
|
|
<li><p>2.3 Run-compile HDF5 library according to <A href="#section2" target=_blank>Section II.</a></p>
|
|
|
|
|
|
<p>When you disable Szip, you may get the following message
|
|
when building HDF5 libraries:
|
|
</p>
|
|
<ul class="normal">
|
|
<li>The following environment variables were not found $(HDF5_EXT_SZIP)</li>
|
|
</ul>
|
|
<p>This message can be ignored.</p>
|
|
<p class="note">Notes:</p>
|
|
<p>To disable Gzip and Szip at the same time, just follow 1.1~1.3 and 2.1~2.3 and run-compile HDF5 library according to<A href="#section2" target=_blank> Section II.</a></p></li>
|
|
</ul>
|
|
<li><h3>3. Disable Szip encoder</h3>
|
|
<p>If you would like to just disable Szip encoder from the HDF5
|
|
library while keeping Szip decoder enabled, follow the steps
|
|
below.
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>3.1 Download Szip library without encoder</p>
|
|
<p>Szip library is different if you want to disable Szip encoder.
|
|
Download szip_noencoder binaries from
|
|
<A href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows" target=blank ,>ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.</A>
|
|
The Szip library and header path should also be set up
|
|
accordingly (refer to <A href="#precondition6" target=_blank>Precondition 6.)</a>
|
|
</p>
|
|
<li><p>3.2 Run-compile HDF5 library according to <A href="#section2" target=_blank>Section II.</a></p></li></ul>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
|
|
<h2><a name="section6">Section VI: How to build HDF5 in Microsoft Visual Studio .Net 2003</a> </h2>
|
|
<hr class="second" >
|
|
<p>We just briefly introduce you how to build HDF5 in VS 7.1(.NET)2003;</p>
|
|
<ul class="intable">
|
|
<li><p>1. Open the old workspace file with the "Open solution" option, .NET will automatically convert the data space file to solution file.</p>
|
|
<li><p>2. Then find "Build" and go to "Configuration Manager"; choose "release" or "debug", then choose "build all".</p>
|
|
<li><p>3. If you want to change some project setting, select the project and right click the button to choose Properties; find the similar menu
|
|
there as in Microsoft Visual Studio 6.0.
|
|
</p>
|
|
<li><p> 4. You need to specify the zlib and szip include header files andlibrariesunderTools->Options->Projects->VC++ Directories and choose
|
|
Include and libraries under the category of "show directories for" to
|
|
add the corresponding path if you want to use compression feature inside HDF5.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<ul class="intable">
|
|
<li><p>1. Please read <A href="#section5" target=_blank>Section V </a>if you do not want to use compression feature inside HDF5.</p>
|
|
<li><p>2. Since Microsoft Visual Studio .NET will automatically enable all
|
|
project files in the "Configuration Manager", you have to manually
|
|
disable those project files you don't want to build.
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>2.1 If you don't want to build HDF5 C++ Libraries,
|
|
Go to "Build" and select "Configuration Manager". Choose "Release"
|
|
or "Debug" under "Active Solution Configuration"
|
|
</p>
|
|
<p>Disable the following projects:</p>
|
|
<ul class="normal">
|
|
<li>dsets_cpp
|
|
<li>dsets_cppdll
|
|
<li>hdf5_cpp
|
|
<li>hdf5_cppdll
|
|
<li>testhdf5_cpp
|
|
<li>testhdf5_cppdll
|
|
<li>hdf5_hl_cpp
|
|
<li>hl_test_table_cpp </li>
|
|
</ul>
|
|
<li><p>2.2 If you don't want to build HDF5 Fortran Libraries,
|
|
Go to "Build" and select "Configuration Manager". Choose "Release"
|
|
or "Debug" under "Active Solution Configuration"
|
|
</p>
|
|
<p>Disable the following projects:</p>
|
|
<ul class="normal">
|
|
<li>flush1_fortran
|
|
<li>flush1_fortrandll
|
|
<li>flush2_fortran
|
|
<li>flush2_fortrandll
|
|
<li>hdf5_f90cstub
|
|
<li>hdf5_f90cstubdll
|
|
<li>hdf5_fortran
|
|
<li>hdf5_fortrandll
|
|
<li>libtest_cstubdll
|
|
<li>libtest_fortran
|
|
<li>libtest_fortrandll
|
|
<li>testhdf5_fortran
|
|
<li>testhdf5_fortrandll
|
|
<li>hdf5_hl_fortran
|
|
<li>hl_test_image_fortran
|
|
<li>hl_test_lite_fortran
|
|
<li>hl_test_table_fortran</li>
|
|
</ul>
|
|
<li><p>2.3 If you don't want to build HDF5 High-Level Libraries,
|
|
Go to "Build" and select "Configuration Manager". Choose "Release"
|
|
or "Debug" under "Active Solution Configuration"
|
|
</p>
|
|
<p>Disable the following projects:</p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl
|
|
<li>hl_test_image
|
|
<li>hl_test_lite
|
|
<li>hl_test_table
|
|
<li>hl_test_ds
|
|
<li>hl_test_packet</li>
|
|
</ul>
|
|
<li><p>2.4 If you want to build HDF5 C++ libarty without High-Level
|
|
C++ Libraries, Go to "Build" and select "Configuration Manager".
|
|
Choose "Release" or "Debug" under "Active Solution Configuration"
|
|
</p>
|
|
<p>Disable the following projects:</p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl_cpp
|
|
<li>hl_test_table_cpp</li>
|
|
</ul>
|
|
<li><p>2.5 If you want to build HDF5 Fortran Libraries without High-Level
|
|
Fortran Libraries, Go to "Build" and select "Configuration Manager".
|
|
Choose "Release" or "Debug" under "Active Solution Configuration".
|
|
</p>
|
|
<p>Disable the following projects:</p>
|
|
<ul class="normal">
|
|
<li>hdf5_hl_fortran
|
|
<li>hl_test_image_fortran
|
|
<li>hl_test_lite_fortran
|
|
<li>hl_test_table_fortran </li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section7">Section VII: How to build HDF5 with INTEL Compiler</a></h2>
|
|
<hr class="second" >
|
|
<ul class="intable">
|
|
<li><h3>1. INTEL compiler 7.1</h3>
|
|
<ul class="intable">
|
|
<li><h4>1.1. Intel C Compiler</h4>
|
|
<p>Go toTools-->Select Compiler</p>
|
|
<p>Check Intel box and click OK button.</p>
|
|
<li><h4>1.2. Intel Fortran Compiler</h4>
|
|
<p>Go toTools-->Select Compiler</p>
|
|
<p>Check Intel box and click OK button.</p>
|
|
<p>Go toTools-->Customize-->Add-ins and Macro Files and check Intel Fortran Compiler Build Tool</p>
|
|
</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<p>Szip library is different when using Intel compiler.
|
|
You should build Szip source codes with Intel
|
|
compiler or download binaries for Intel compiler
|
|
from
|
|
<A href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/" target=_blank>ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/.</A>
|
|
The Szip library and header path should also be
|
|
set up accordingly (refer to <A href="#precondition6" target=_blank> Precondition 6.) </a>
|
|
</p>
|
|
<li><h3>2. INTEL compiler 8.1</h3>
|
|
|
|
<h4>Preconditions:</h4>
|
|
<ul class="intable">
|
|
<li><h4>a. Setup Szip Library for Intel Compiler.</h4>
|
|
<p>Intel compilers use different Szip library from other compilers.
|
|
Szip source codes or binaries for Intel compiler can be downloaded
|
|
from the following address:
|
|
</p>
|
|
<p>
|
|
<A href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/" target=_blank> ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows/.</A>
|
|
</p>
|
|
<p>The Szip library and header path should also be set up accordingly (refer to <A href="#precondition6" target=_blank>Precondition 6.)</a></p>
|
|
<li><h4>b. Set up path for external libraries and headers</h4>
|
|
<p>Skip this part if you don't want to use ANY compression features provided by HDF5. Please do read <A href="#section5" target=_blank>Section V.</a></p>
|
|
<p>You have to read this part even if you want to only use Zlib or Szip. You also need to read <A href="#section5" target=_blank>Section V.</a></p>
|
|
<p>Invoke Microsoft Visual C++ and go to "Tools" and select "Options", find "Directories";</p>
|
|
<p>Find the box "Show directories for", choose
|
|
"Include files", if you can not find your Zlib and Szip
|
|
header path
|
|
(for example, c:\zlib122\include, c:\szip\include)
|
|
from the directory list, add the header path
|
|
(c:\zlib122\include, c:\szip\include) to the
|
|
included directories.
|
|
</p>
|
|
<p>Find the box "Show directories for", choose "Library files",
|
|
If you cannot find your Zlib and Szip library path
|
|
(for example, c:\zlib122\lib, c:\szip\dll)
|
|
from the directory list, add the library path
|
|
(c:\zlib122\lib, c:\szip\dll) to the library directories.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<h4><a name="2.1_section7">2.1 Intel C++ Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4>
|
|
<p class="note">Notes:</p>
|
|
<p>1. This step will build ONLY HDF5 Static and DLL C and C++
|
|
Library using Intel C++ Compiler.</p>
|
|
<p>2.If you want to build HDF5 Static and DLL C and C++ Library
|
|
using Intel C++ 8.1 Compiler as well as HDF5 Static Fortran
|
|
Library using Intel Fortran 8.1 Compiler, Please go to <A href="#2.2_section7" target=_blank>2.2 </a>directly!
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>2.1.1 Invoke Microsoft Visual C++ .Net 2003. From the main
|
|
menu, go to "File" and select "Open Solution". In
|
|
the "Open Solution" window, Change "Files of type" to
|
|
"All Project Files". Choose "all.dsw" under the directory
|
|
c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window,
|
|
choose "Yes To All" to convert all project files to Visual
|
|
C++ .Net project format.
|
|
</p>
|
|
<li><p>2.1.2 Right click on the solution name "all.sln" in the
|
|
"Solution Explorer". From the pop-up menu select
|
|
"Convert to use Intel C++ Project System" to convert
|
|
all .Net project files to Intel C++ project files.
|
|
</p>
|
|
<li><p>2.1.3 Go to Tools > Options > Intel C++. In the left pane, Click "General".</p>
|
|
<ul class="intable">
|
|
<li><p>a. In the right pane, under "Compiler
|
|
selection", choose Intel C++ 8.1. </p>
|
|
|
|
<li><p>b. Click on "Intel C++ 8.1" to set the
|
|
directories and default options. In "Include", Add Zlib and Szip header
|
|
path(c:\zlib122\include c:\szip\include). In "Library", Add Zlib and
|
|
Szip Library Path (c:\zlib122\lib, c:\szip\dll).</p>
|
|
<li><p>c. Then click "OK".</p></li>
|
|
</ul>
|
|
<li><p>2.1.4 Select "Build", then Select "Set Active Configuration".</p>
|
|
<p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p>
|
|
<p>Disable all Fortran project files listed below:</p>
|
|
<ul class="normal">
|
|
<li>flush1_fortran
|
|
<li>flush1_fortrandll
|
|
<li>flush2_fortran
|
|
<li>flush2_fortrandll
|
|
<li>hdf5_f90cstub
|
|
<li>hdf5_f90cstubdll
|
|
<li>hdf5_fortran
|
|
<li>hdf5_fortrandll
|
|
<li>libtest_cstubdll
|
|
<li>libtest_fortran
|
|
<li>libtest_fortrandll
|
|
<li>testhdf5_fortran
|
|
<li>testhdf5_fortrandll
|
|
<li>hdf5_hl_fortran
|
|
<li>hl_test_image_fortran
|
|
<li>hl_test_lite_fortran
|
|
<li>hl_test_table_fortran</li>
|
|
</ul>
|
|
<p>Select "ok". Select "Build" -> "Build" or "Rebuild All" to build debug version of project "all".</p>
|
|
<li><p>2.1.5 Go back to <A href="#step2_section2" target=_blank>Section II, continue with STEP 2(Testing HDF5 libraries and tools) to test HDF5 C and C++ Libraries.</a></p>
|
|
</li>
|
|
</ul>
|
|
<h4><a name="2.2_section7">2.2 Intel Fortran Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4>
|
|
<p class="note">Notes:</p>
|
|
<p>1. This step will build HDF5 Static and DLL C and C++ Library
|
|
using Intel C++ 8.1 Compiler as well as HDF5 Static and
|
|
High Level Fortran Library using Intel Fortran 8.1 Compiler.
|
|
</p>
|
|
<p>2. Users who want to build ONLY HDF5 Static and DLL C and C++
|
|
LibraryPlease go to <A href="#2.1_section7" target=_blank>2.1.</a>
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>2.2.1 Invoke Microsoft Visual C++ .Net 2003. From the main
|
|
menu, go to "File" and select "Open Solution". In
|
|
the "Open Solution" window, Change "Files of type" to
|
|
"All Project Files". Choose "all.dsw" under the directory
|
|
c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window,
|
|
choose "Yes To All" to convert all project files to Visual
|
|
C++ .Net project format.
|
|
</p>
|
|
<li><p>2.2.2 Select project "flush1_fortran" in the Solution
|
|
Explorer window. In the Project menu, select
|
|
"Extract Compaq Visual Fortran Project".
|
|
</p>
|
|
|
|
<p>Do the same thing for the following project files:</p>
|
|
<ul class="normal">
|
|
<li>flush2_fortran
|
|
<li>hdf5_fortran
|
|
<li>testhdf5_fortran
|
|
<li>hdf5_hl_fortran
|
|
<li>hl_test_image_fortran
|
|
<li>hl_test_lite_fortran
|
|
<li>hl_test_table_fortran</li>
|
|
</ul>
|
|
<li><p>2.2.3 Select project "libtest_fortran" in the Solution
|
|
Explorer window. In the Project menu, select
|
|
"Extract Compaq Visual Fortran Project". Since Project
|
|
file "libtest_fortran" contain both C and Fortran code,
|
|
you will be asked to specify which project, either
|
|
Fortran or C/C++, will serve as the main project for
|
|
this mixed language projects. Choose
|
|
"The Intel Fortran project" as the the main project and
|
|
click "OK".
|
|
</p>
|
|
<li><p>2.2.4 Change project dependencies of "libtest_fortran"</p>
|
|
<p>Highlight project "libtest_fortran", choose "Project"->
|
|
"Project Dependencies", uncheck "libtest".
|
|
</p>
|
|
<li><p>2.2.5 Right click on the solution name "all.sln" in the
|
|
"Solution Explorer". From the pop-up menu select
|
|
"Convert to use Intel C++ Project System" to convert
|
|
all .Net C++ project files to Intel C++ project formats.
|
|
</p>
|
|
<li><p>2.2.6 Select "Build", then Select "Set Active Configuration".</p>
|
|
<p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p>
|
|
<p>Disable all Fortran DLL project files listed below:</p>
|
|
<ul class="normal">
|
|
<li>flush1_fortrandll
|
|
<li>flush2_fortrandll
|
|
<li>hdf5_fortrandll
|
|
<li>libtest_fortrandll
|
|
<li>testhdf5_fortrandll</li>
|
|
</ul>
|
|
<p>Select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build Debug or Release version of HDF5 C, C++ Static and DLL
|
|
Library using Intel C++ 8.1 Compiler and HDF5 Static and High
|
|
Level Fortran Library using Intel Fortran 8.1 compiler.
|
|
</p>
|
|
<li><p>2.2.7 Test HDF5 Static and High Level Fortran Library</p>
|
|
<ul class="intable">
|
|
<li><p>a. Test HDF5 Static Fortran Library</p>
|
|
<p>Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file
|
|
testhdf5_fortran.bat with the following two options to test
|
|
fortran static library
|
|
</p>
|
|
<ul class="normal">
|
|
<li>testhdf5_fortran release >> "Your output
|
|
file name"
|
|
|
|
<li>testhdf5_fortran debug >> "Your output file name"</li>
|
|
</ul>
|
|
<p>Check your output files, there should be no "failures" at all.</p>
|
|
<li><p>b. Test HDF5 High Level Fortran Library</p>
|
|
<p>Go to directory c:\myHDFstuff\hdf5\hl\fortran\test, Run batch file
|
|
testhdf5_fortran.bat with the following two options to test
|
|
fortran static library
|
|
</p>
|
|
<ul class="normal">
|
|
<li>test_hdf5_hl_fortran release >> "Your
|
|
output file name"
|
|
|
|
<li>test_hdf5_hl_fortran debug >> "Your output file name"</li>
|
|
</ul>
|
|
<p>Check your output files, there should be no "failures" at all.</p>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section8">Section VIII: Building and testing HDF5 snapshot release</a></h2>
|
|
<hr class="second" >
|
|
|
|
<p class="note">Notes:</p>
|
|
<p>This section is only for users who would like to build and test HDF5 snapshot release.</p>
|
|
<ul class="intable">
|
|
<li><h3><a name="step1_section8">Step I: Generate H5Tinit.c using Microsoft Visual C++ 6.0</a></h3>
|
|
<p>For users who would like to build and test HDF5 C and C++ library, it
|
|
is necessary to manually generate H5Tinit.c before going to section II
|
|
step 1(2). Follow the steps below to generate H5Tinit.c manually using
|
|
Microsoft Visual C++ 6.0. We don't guarantee that H5Tinit.c can be
|
|
sucesessfully created by other compilers.
|
|
</p>
|
|
<h4>1. Previous step: <A href="#step1_section1" target=_blank>section II, step 1(1).</a></h4>
|
|
<h4>2. Extra steps:</h4>
|
|
<ul class="intable">
|
|
<li>1) Open
|
|
c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw.
|
|
|
|
<li>2) Build the project file.
|
|
|
|
<li>3) Invoke command prompt and go to
|
|
c:\myHDFstuff\hdf5\src.
|
|
|
|
<li>4) type H5Tinit.exe >H5Tinit.c
|
|
|
|
<li>5) Go back to section II, continue with <A href="#step1_2_section1" target=_blank>step 1(2).</a></li>
|
|
</ul>
|
|
<li><h3>Step II: Generate H5f90i_gen.h and H5fortran_types.f90 using Compaq Fortran 6.6c</h3>
|
|
<p class="note">Notes:</p>
|
|
<p>The users who don't want to build fortran library can skip this step.</p>
|
|
<p>For users who would like to build and test HDF5 with Fortran library.
|
|
It is necessary to manually generate H5f90i_gen.h and
|
|
H5fortran_types.f90 except H5Tinit.c before going to <A href="#section1_3.2" target=_blank>section II,
|
|
step1(3.2)</a>. Follow the steps below to generate these three files.
|
|
Use Microsoft Visual C++ 6.0 to generate H5Tinit.c and Compaq Fortran
|
|
6.6c to generate H5f90i_gen.h and H5fortran_types.f90. We don't guarantee
|
|
that these three files can be created sucessfully by other compilers.
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>1) Previous step: <A href="#step1_section1" target=_blank>section II, step 1(1)</a></p>
|
|
<li><p>2) Follow the steps in <A href="#step1_section8" target=_blank>Step I to generate H5Tinit.c.</a></p>
|
|
<li><p>3) Open H5fortran_detect_gen.dsw under directory
|
|
c:\myHDFstuff\hdf5\windows\misc\H5fortran_detect_gen
|
|
Build the project file.</p>
|
|
<li><p>4) Invoke command prompt and go to c:\myHDFstuff\hdf5\fortran\src.</p>
|
|
<p>type</p>
|
|
<p>H5fortran_detect_gen.exe > H5fortran_detect.f90</p>
|
|
<li><p>5) Open c:\myHDFstuff\hdf5\windows\misc\fortrantypegen\H5fortran_detect.dsw. Build the project file.</p>
|
|
<li><p>6) Invoke command prompt and go to c:\myHDFstuff\hdf5\fortran\src.</p>
|
|
<p>type</p>
|
|
<p>H5fortran_detect.exe > H5fort_type_defines.h</p>
|
|
<li><p>7) Open c:\myHDFstuff\hdf5\windows\misc\matchtypegen\H5match_types.dsw. Build the project file.</p>
|
|
<li><p>8) Invoke command prompt and go to c:\myHDFstuff\hdf5\fortran\src.</p>
|
|
<p>type</p>
|
|
<p>H5fortran_detect_gen.exe</p>
|
|
<p>This step will generate H5f90i_gen.h and H5fortran_types.f90 automatically.</p>
|
|
<li><p>9) Go back to <A href="#section1_3.2" target=_blank>section II,
|
|
step1(3.2)</a></p></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="second" >
|
|
<h2><a name="section9">Section VIIII: Misc.</a></h2>
|
|
<hr class="second" >
|
|
<h3>1) drivers we support</h3>
|
|
<p>The default driver on windows we support is sec2 driver. However, stdio
|
|
driver is also supported. If you want to use stdio driver in your
|
|
application, you may set environment variable HDF5_DRIVER to "stdio".
|
|
</p>
|
|
<p>On windows XP, the following steps should be followed to set the
|
|
environment variable,
|
|
</p>
|
|
<ul class="intable">
|
|
<li><p>a) Go to Control panel and find "system",</p>
|
|
<li><p>b) Click "system" and choose "advanced",</p>
|
|
<li><p>c) Choose Environment Variables</p>
|
|
<li><p>d) Add new variable "HDF5_DRIVER"</p>
|
|
<li><p>e) set the "HDF5_DRIVER" to "stdio"</p></li>
|
|
</ul>
|
|
<p class="note">Reminder:</p>
|
|
<p>If you don't want to use stdio driver, please remember to
|
|
delete the environment variable "HDF5_DRIVER" or change the variable
|
|
value to "sec2".
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p class="right"><A href="#content_table" target=_blank>Go to Table of Contents</A></p>
|
|
<hr class="first" >
|
|
|
|
<h4 style="background-color:green;color:white;">Thank you for using Hierarchical Data Format (HDF). For users who need further assistance, please
|
|
send email to <A href="mailto:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</A></h4>
|
|
<p> </p>
|
|
<p> </p></li></ul>
|
|
</li></ul>
|
|
</body>
|
|
|
|
</html> |