mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-03-07 16:37:56 +08:00
5467 lines
136 KiB
HTML
Executable File
5467 lines
136 KiB
HTML
Executable File
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
|
|
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright by The HDF Group. * * Copyright by the Board of Trustees of the University of Illinois. * * All rights reserved. * * * * This file is part of HDF5. The full HDF5 copyright notice, including * * terms governing use, modification, and redistribution, is contained in * * the files COPYING and Copyright.html. COPYING can be found at the root * * of the source code distribution tree; Copyright.html can be found at the * * root level of an installed copy of the electronic HDF5 document set and * * is linked from the top-level documents page. It can also be found at * * http://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have * * access to either file, you may request a copy from help@hdfgroup.org. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
|
|
<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">
|
|
a {text-decoration:none}
|
|
a:link {color:#0000FF;}
|
|
a:visited {color:purple;}
|
|
a:hover {background-color:#FAEBD7;}
|
|
body {
|
|
margin-left:5%;
|
|
margin-right:5%
|
|
}
|
|
h1 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 160%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
margin-top:30
|
|
}
|
|
h2 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 140%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
margin-top:20
|
|
}
|
|
h3 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 120%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-transform:capitalize;
|
|
}
|
|
h4 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
margin-top:12
|
|
}
|
|
h5 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
margin-top:10
|
|
}
|
|
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;}
|
|
li{ margin-top:12;
|
|
font-size: 98%;
|
|
text-align:left;
|
|
}
|
|
p.right {
|
|
text-align:right;
|
|
color:#A52A2A;
|
|
font-size: 90%;}
|
|
p {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
}
|
|
p.center {text-align:center}
|
|
p.note{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 80%;
|
|
text-align:left;
|
|
color:#FF0000
|
|
}
|
|
p.insmes{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 80%;
|
|
text-align:left;
|
|
}
|
|
p.filename
|
|
{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
font-style:italic; text-align:center;
|
|
}
|
|
span.filename
|
|
{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 95%;
|
|
font-style:italic; }
|
|
table {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
text-align:left;
|
|
border:thin solid blue;
|
|
}
|
|
td {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 85%;
|
|
text-align:left;
|
|
}
|
|
ul.normal
|
|
{
|
|
margin-left:10%;
|
|
list-style-type:none;
|
|
margin-bottom:15px;
|
|
}
|
|
ul.intable
|
|
{
|
|
text-align: left;
|
|
list-style-type:none;
|
|
}
|
|
</style>
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
<h1>HDF5 Build and Install Instructions for Windows XP (Full
|
|
Version)</h1>
|
|
|
|
<hr class="first">
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">The following instructions assume that the
|
|
HDF5 source code package from<a href="http://hdfgroup.org" target="_blank"> HDF website (http://hdfgroup.org)</a>
|
|
is used. </p>
|
|
|
|
<h3 style="color: rgb(165, 42, 42);"><a name="content_table">Table of Contents:</a></h3>
|
|
|
|
<table style="border-width: 0pt; border-collapse: collapse;">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<td colspan="2">
|
|
<h3><a href="#preconditions">Preconditions</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section1">Section
|
|
I </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section1"> What do we
|
|
build and install</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section2">Section
|
|
II </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section2"> How to
|
|
build and test HDF5 libraries and tools</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section3_examples">Section
|
|
III </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section3_examples">
|
|
How to Build Examples (Optional)</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section4">Section IV </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section4"> How to
|
|
build an application using the HDF5 library or DLL</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section5">Section
|
|
V </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section5"> How to
|
|
disable Gzip(Zlib)/Szip compression </a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section6">Section VI </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section6"> How to
|
|
build HDF5 in .NET 2003</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section7">Section VII </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section7"> How to
|
|
build HDF5 with INTEL Compiler</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section8">Section VIII</a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section8"> How to
|
|
build Multi-threaded version of HDF5 library</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section9">Section IX </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section9"> How to
|
|
build and test HDF5 snapshot release</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section10">Section
|
|
X </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section10"> How to
|
|
build
|
|
HDF5 with Thread-Safe Feature</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section11">Section
|
|
XI </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section11"> How to
|
|
build HDF5 in Visual Studio 2005</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<h3><a href="#section12">Section
|
|
XII </a></h3>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<h3><a href="#section12"> Misc.</a></h3>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<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><u>1. Installed Microsoft Visual C++ 6.0 or Intel C
|
|
compiler and WinZip.</u></h4>
|
|
|
|
<blockquote>
|
|
<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 class="note">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>
|
|
|
|
</blockquote>
|
|
|
|
<h4><u>2. Set up a directory structure to unpack the
|
|
library.</u></h4>
|
|
|
|
<p>For example:</p>
|
|
|
|
<table style="border-width: 0pt; border-collapse: collapse;" bordercolor="#111111" cellpadding="0" cellspacing="0">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<p class="filename" style="text-align: left;">c:\
|
|
(any drive)</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>
|
|
<p class="filename" style="text-align: left;">MyHDFstuff\
|
|
(any folder name)</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<h4> </h4>
|
|
|
|
<h4><u>3. Download the hdf5-1.8.x source code package </u>
|
|
</h4>
|
|
|
|
<p>Use WinZip to extract the HDF5 package into <span class="filename">c:\MyHDFstuff</span>. This creates a
|
|
directory called 'hdf5-1.8.x' under <span class="filename">MyHDFstuff</span>
|
|
which contains several files and directories. Rename <span class="filename">"hdf5-1.8.x"</span> to<span class="filename"> "hdf5"</span>. </p>
|
|
|
|
<h4><u>4. HDF5 provide options to do in-memory compress
|
|
within HDF5 library.</u></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://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/
|
|
</a>to download the Zlib library.</p>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">1. Zlib 1.2.2 DLL library can also be
|
|
downloaded from <a href="ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin" target="_blank">ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin
|
|
</a></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">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 <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">
|
|
ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/ </a></p>
|
|
|
|
<p class="note">3. 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://hdfgroup.org/doc_resource/SZIP/index.html" target="_blank">
|
|
http://hdfgroup.org/doc_resource/SZIP/index.html.</a> </p>
|
|
|
|
<p class="note">Szip compression feature inside HDF5
|
|
is optional.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h4><u>5. Define the following environment variables: </u>
|
|
</h4>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>HDF5_EXT_ZLIB </li>
|
|
|
|
<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">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 <span class="filename">"Start"</span>
|
|
-> <span class="filename">"Control Panel"</span>
|
|
-> <span class="filename">"System"</span>
|
|
-> <span class="filename">"Advanced"</span>
|
|
-> <span class="filename">"Environment Variables"</span>.
|
|
If you are logged on as administrator to the local computer AND want to
|
|
let all other users use these two environment variables, click
|
|
<span class="filename">"New"</span> under <span class="filename">"System Variables"</span> box;
|
|
otherwise, click <span class="filename">"New"</span>
|
|
under
|
|
<span class="filename">"User Variables"</span> box.
|
|
In the New Variable window, set </p>
|
|
|
|
<p> <span class="filename">"Variable name"</span>
|
|
as <span class="filename">HDF5_EXT_ZLIB</span> </p>
|
|
|
|
<p> <span class="filename">"Variable value"</span>
|
|
as <span class="filename">zdll.lib</span>, then
|
|
click OK. </p>
|
|
|
|
<p>Similarly, you can set:</p>
|
|
|
|
<p><span class="filename">HDF5_EXT_SZIP</span>
|
|
environment variable as
|
|
<span class="filename">szlibdll.lib</span></p>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">a. You might have to close and reopen
|
|
running programs for the new environment variable settings to take
|
|
effect. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">b. <span class="filename">c:\zlib122\zlib1.dll
|
|
</span>and <span class="filename">c:\szip\dll\szlibdll.dll</span>
|
|
should be copied into the location that the application can find, one
|
|
suggestion is to use the <span class="filename">c:\WINDOWS\system</span>.
|
|
</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h4><a name="precondition6"><u>6. Set up path
|
|
for external libraries and headers</u></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">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">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 <span class="filename">"Show
|
|
directories for"</span>, choose <span class="filename">"Include
|
|
files"</span>, if you can not find your Zlib and Szip header path
|
|
(for example, <span class="filename">c:\zlib122\include,
|
|
c:\szip\include</span>) from the directory list, add the header
|
|
path (<span class="filename">c:\zlib122\include,
|
|
c:\szip\include</span>) to the included directories. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Find the box <span class="filename">"Show
|
|
directories for"</span>, choose <span class="filename">"Library
|
|
files"</span>, If you cannot find your Zlib and Szip library path
|
|
(for example, <span class="filename">c:\zlib122\lib,
|
|
c:\szip\dll</span>) from the directory list, add the library path
|
|
(<span class="filename">c:\zlib122\lib, c:\szip\dll</span>)
|
|
to the library directories. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">1. In release 1.8.0, <span class="filename">all.zip</span> is deprecated. Users
|
|
should go to <span class="filename">hdf5/windows</span>
|
|
directory, run <span class="filename">copy_hdf.bat</span>
|
|
first and then open <span class="filename">all.dsw</span>
|
|
under <span class="filename">hdf5/windows/proj/all</span>
|
|
to start building process. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">2. In release 1.8.0, all.sln was
|
|
provided for command line use ONLY. all.sln should never be opened to
|
|
start building HDF5 using IDE.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">3. To build HDF5 C++ and FORTRAN
|
|
libraries, please read through this document. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">4. For users who want to quickly build
|
|
HDF5 library or do not want to know HDF5 building and installation
|
|
details, please read <span class="filename">INSATLL_Windows_Short.txt.
|
|
</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">5. For users who would like to build
|
|
and test HDF5 package from the command line, please read <span class="filename">INSATLL_Windows_From_Command_Line.txt. </span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">6. HDF4-related tools are not built
|
|
and released with HDF5 library packages any more . To obtain
|
|
HDF4-releated tools, please check</p>
|
|
|
|
<p class="note"><a href="http://hdfgroup.org/h4toh5/" target="blank" ,="">http://hdfgroup.org/h4toh5/</a></p>
|
|
|
|
<p class="note"><a href="ftp://ftp.hdfgroup.org/HDF5/h4toh5" target="blank" ,="">ftp://ftp.hdfgroup.org/HDF5/h4toh5</a> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">7. For DLL users, please do read and
|
|
follow <a href="#dll_hints_section4">"DLL Hints" Section
|
|
IV.</a> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">8. For .NET users, please read <a href="#section6">Section VI.</a> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">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>
|
|
|
|
<li>
|
|
<p class="note">10. For users who would like to build
|
|
Muti-threaded version of HDF5 library, please read <a href="section8">Section VIII</a>.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">11. For users who would like to build,
|
|
test and use HDF5 snapshot release, please read <a href="#section9">Section
|
|
IX.</a> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">12. For .Net and Intel users, if you
|
|
are not building HDF5 with Thread-Safe Feature (see <a href="#section10">Section X</a>), ttsafedll.dsp should
|
|
always be turned off.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#preconditions">Go
|
|
to TOP Preconditions</a></p>
|
|
|
|
<p class="right"><a href="#content_table">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>
|
|
|
|
<li>
|
|
<p>HDF5 Dynamic Link Library(DLL): debug and release
|
|
version as well as export libraries for DLL</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>HDF5 High-Level Library (Optional):HDF5 C++ Library
|
|
and HDF5 HL-Fortran Library</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>HDF5 Tools: HDF5 tools </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<p>HDF5 tool export library for DLL: debug and release
|
|
version</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>HDF5 library testing programs: HDF5 library
|
|
comprehensive tests</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>HDF5 related tools testing programs: HDF5 tools
|
|
comprehensive tests</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>3. Examples (Not included in the binary distribution)</h4>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>
|
|
<p>HDF5 examples: simple HDF5 C/C++/Fortran and high
|
|
level C examples</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#content_table">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>This section includes:</h3>
|
|
|
|
<p><a href="##step1_section2">STEP 1: Building HDF5
|
|
libraries and tools</a></p>
|
|
|
|
<p><a href="#step2_section2">STEP 2: Testing HDF5
|
|
libraries and tools</a></p>
|
|
|
|
<p><a href="#step3_section2">STEP 3: Installing HDF5
|
|
Libraries</a></p>
|
|
|
|
<p> </p>
|
|
|
|
<h3><a name="#step1_section2"><u>STEP 1:
|
|
Building HDF5 libraries and tools</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1. Run batch file copy_hdf.bat.</h4>
|
|
|
|
<p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
and run <span class="filename">copy_hdf.bat</span>.
|
|
This process will copy all the necessary batch files, windows specific
|
|
source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
directory to the corresponding directories under <span class="filename">hdf5</span>. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><a name="step1_2_section2">2. Invoke
|
|
Microsoft Visual C++ compiler</a></h4>
|
|
|
|
<p>Invoke Microsoft Visual C++. From the main menu, go to <span class="filename">"File" </span>and select the <span class="filename">"Open Workspace" </span>option. Then
|
|
open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span>
|
|
workspace. </p>
|
|
|
|
<p>You should find windows project files listed as "all
|
|
files, big files etc." on the left. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>3. (Optional)HDF5 C++, Fortran libraries, High level C++,
|
|
High level 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 <span class="filename">"Project"</span>
|
|
and select <span class="filename">"dependencies"</span>;
|
|
Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span>
|
|
box, then enable the desired projects: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>dsets_cpp </li>
|
|
|
|
<li>dsets_cppdll </li>
|
|
|
|
<li>hdf5_cpp </li>
|
|
|
|
<li>hdf5_cppdll </li>
|
|
|
|
<li>testhdf5_cpp </li>
|
|
|
|
<li>testhdf5_cppdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<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 <span class="filename">"Project"</span>
|
|
and select <span class="filename">"dependencies"</span>;
|
|
Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span>
|
|
box, then enable the desired projects: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>flush1_fortran </li>
|
|
|
|
<li>flush1_fortrandll </li>
|
|
|
|
<li>flush2_fortran </li>
|
|
|
|
<li>flush2_fortrandll </li>
|
|
|
|
<li>hdf5_f90cstub </li>
|
|
|
|
<li>hdf5_f90cstubdll </li>
|
|
|
|
<li>hdf5_fortran </li>
|
|
|
|
<li>hdf5_fortrandll </li>
|
|
|
|
<li>libtest_cstubdll </li>
|
|
|
|
<li>libtest_fortran </li>
|
|
|
|
<li>libtest_fortrandll </li>
|
|
|
|
<li>testhdf5_fortran </li>
|
|
|
|
<li>testhdf5_fortrandll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>3.3 Skip this step if you do not want to build HDF5
|
|
High-Level libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Project"</span>
|
|
and select <span class="filename">"dependencies"</span>;
|
|
Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span>
|
|
box, then enable the desired projects: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl </li>
|
|
|
|
<li>hdf5_hldll </li>
|
|
|
|
<li>hl_test_image </li>
|
|
|
|
<li>hl_test_imagedll </li>
|
|
|
|
<li>hl_test_lite </li>
|
|
|
|
<li>hl_test_litedll </li>
|
|
|
|
<li>hl_test_table </li>
|
|
|
|
<li>hl_test_tabledll </li>
|
|
|
|
<li>hl_test_ds </li>
|
|
|
|
<li>hl_test_dsdll </li>
|
|
|
|
<li>hl_test_packet</li>
|
|
|
|
<li>hl_test_packetdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>3.4 Skip this step if you do not want to build HDF5
|
|
High-Level C++ libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Project"</span>
|
|
and select <span class="filename">"dependencies"</span>;
|
|
Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span>
|
|
box, then enable all of the project files listed in <a href="#section1_3.1">Section II, Step 1(3.1)</a> and
|
|
the following desired projects: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl_cpp </li>
|
|
|
|
<li>hdf5_hl_cppdll </li>
|
|
|
|
<li>hl_test_table_cpp</li>
|
|
|
|
<li>hl_test_table_cppdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>3.5 Skip this step if you do not want to build HDF5
|
|
High-Level Fortran libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Project"</span>
|
|
and select <span class="filename">"dependencies"</span>;
|
|
Select <span class="filename"> "all"</span> in the <span class="filename">"Select project to modify:"</span>
|
|
box, then enable all of the project files listed in <a href="#section1_3.2">Section II, Step 1(3.2)</a> and
|
|
the following desired projects: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl_f90cstubdll </li>
|
|
|
|
<li>hdf5_hl_fortran </li>
|
|
|
|
<li>hdf5_hl_fortrandll </li>
|
|
|
|
<li>hl_test_image_fortran </li>
|
|
|
|
<li>hl_test_image_fortrandll </li>
|
|
|
|
<li>hl_test_lite_fortran </li>
|
|
|
|
<li>hl_test_lite_fortrandll </li>
|
|
|
|
<li>hl_test_table_fortran </li>
|
|
|
|
<li>hl_test_table_fortrandll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>3.6 If you are using Intel compilers, please read <a href="#section7">Section VII.</a></h5>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><a name="step1_4_section2">4. Select
|
|
"Build", then Select "Set Active Configuration".</a></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 <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"all
|
|
-- Win32 Debug"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build debug version of project <span class="filename">"all"</span>. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>4.2 To build release versions of single-threaded
|
|
static libraries, multithreaded DLLs and tests</h5>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"all
|
|
-- Win32 Release"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build release version of project <span class="filename">"all"</span>. </p>
|
|
|
|
<ol>
|
|
|
|
</ol>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">1. Both debug and release versions
|
|
must be built.</p>
|
|
|
|
<p class="note">2. Warning messages can be
|
|
ignored. </p>
|
|
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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> c:\MyHDFstuff\hdf5\test\libtest\debug
|
|
c:\MyHDFstuff\hdf5\test\libtest\release </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> c:\MyHDFstuff\hdf5\tools\toolslib\debug
|
|
c:\MyHDFstuff\hdf5\tools\toolslib\release </td>
|
|
|
|
<td>toolslib.lib</td>
|
|
|
|
<td>the internal tools library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\tools\toolslibD\debug
|
|
c:\MyHDFstuff\hdf5\tools\toolslibD\release </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>
|
|
|
|
</tbody>
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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>
|
|
|
|
</tbody>
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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>
|
|
|
|
</tbody>
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release</td>
|
|
|
|
<td>hdf5_hldll.lib</td>
|
|
|
|
<td>HDF5 High Level export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hldll.dll</td>
|
|
|
|
<td>HDF5 High Level DLL</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug</td>
|
|
|
|
<td>hdf5_hldlld.lib</td>
|
|
|
|
<td>HDF5 High Level export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hldlld.dll</td>
|
|
|
|
<td>HDF5 High Level DLL</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release</td>
|
|
|
|
<td>hdf5_hl_cppdll.lib</td>
|
|
|
|
<td>HDF5 High Level C++ export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_cppdll.dll</td>
|
|
|
|
<td>HDF5 High Level C++ DLL</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug</td>
|
|
|
|
<td>hdf5_hl_cppdlld.lib</td>
|
|
|
|
<td>HDF5 High Level C++ export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_cppdlld.dll</td>
|
|
|
|
<td>HDF5 High Level C++ DLL</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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_fortranr.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>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release</td>
|
|
|
|
<td>hdf5_hl_fortrandll.lib</td>
|
|
|
|
<td>HDF5 High Level Fortran export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_fortrandll.dll</td>
|
|
|
|
<td>HDF5 High Level Fortran DLL</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug</td>
|
|
|
|
<td>hdf5_hl_fortrandlld.lib</td>
|
|
|
|
<td>HDF5 High Level Fortran export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_fortrandlld.dll</td>
|
|
|
|
<td>HDF5 High Level Fortran DLL</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release</td>
|
|
|
|
<td>hdf5_hl_f90cstubdll.lib</td>
|
|
|
|
<td>HDF5 High Level Fortran C stub export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_f90cstubdll.dll</td>
|
|
|
|
<td>HDF5 High Level Fortran C stub DLL</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td rowspan="2">c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug</td>
|
|
|
|
<td>hdf5_hl_f90cstubdlld.lib</td>
|
|
|
|
<td>HDF5 High Level Fortran C stub export Library</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5_hl_f90cstubdlld.dll</td>
|
|
|
|
<td>HDF5 High Level Fortran C stub DLL</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3><a name="step2_section2"><u>STEP 2:
|
|
Testing HDF5 libraries and tools</u></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 style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<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">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">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>
|
|
|
|
</tbody>
|
|
</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 class="filename">c:\MyHDFstuff\hdf5\check_results.txt</p>
|
|
|
|
<p class="filename">c:\MyHDFstuff\hdf5\tests_results.txt.</p>
|
|
|
|
<p>In general, you only need to check<span class="filename">
|
|
tests_results.txt</span>. If all the tests passed, then you do
|
|
not have to check <span class="filename">check_results.txt</span>.
|
|
If some tests failed, check <span class="filename">check_results.txt</span>
|
|
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 four versions of HDF5 libraries and tools testing. They are: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>
|
|
<p>release version</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>release dll version</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>debug version</p>
|
|
|
|
</li>
|
|
|
|
<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 <span class="filename">install_dll.bat</span>
|
|
is included in
|
|
<span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
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>
|
|
|
|
<li>hdf5\proj\hdf5dll\debug\hdf5ddll.dll </li>
|
|
|
|
<li>hdf5\test\libtestD\release\libtestD.dll </li>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<h5>b. release dll version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>hdf5test release dll > "Your output
|
|
filename"</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>c. debug static version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>hdf5test debug >"Your output filename"</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>d. debug dll version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>hdf5test debug dll >"Your output filename"</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<h5>b. release dll version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>hdf5timingtest release dll >"Your output
|
|
filename" </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>c. debug static version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>hdf5timingtest debug >"Your output
|
|
filename" </p>
|
|
|
|
</li>
|
|
|
|
<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 class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2. HDF5 tools testing</h5>
|
|
|
|
<p>To test HDF5 tools, go to directory <span class="filename">c:\MyHDFstuff\hdf5\tools</span>. The
|
|
HDF5 tools testing results are saved into output files in tools
|
|
directory by the <span class="filename">testhdf5tools.bat</span>
|
|
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: <span class="filename">toolstest_release.txt</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>b. release dll version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>testhdf5tools release dll</p>
|
|
|
|
<p>output file: <span class="filename">toolstest_releasedll.txt</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>c. debug static version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>testhdf5tools debug</p>
|
|
|
|
<p>output file: <span class="filename">toolstest_debug.txt</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>d. debug dll version</h5>
|
|
|
|
<p>type:</p>
|
|
|
|
<p>testhdf5tools debug dll</p>
|
|
|
|
<p>output file: <span class="filename">toolstest_debugdll.txt</span></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
</li>
|
|
|
|
<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 <span class="filename">install_cppdll.bat</span>
|
|
is included in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
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>
|
|
|
|
<li>hdf5\proj\hdf5_cppdll\debug\hdf5_cppddll.dll</li>
|
|
|
|
</ul>
|
|
|
|
<p>Run <span class="filename">hdf5cpptest.bat</span>
|
|
in the <span class="filename">hdf5\c++\test </span>directory
|
|
at the command prompt as below:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>hdf5cpptest release >"Your output filename" </li>
|
|
|
|
<li>hdf5cpptest release dll >"Your output filename" </li>
|
|
|
|
<li>hdf5cpptest debug >"Your output filename" </li>
|
|
|
|
<li>hdf5cpptest debug dll >"Your output filename"</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files. </p>
|
|
|
|
</li>
|
|
|
|
<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 <span class="filename">install_f90dll.bat</span>
|
|
is included in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
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>
|
|
|
|
<li>hdf5\proj\hdf5_f90cstubdll\debug\hdf5_f90cstubddll.dll </li>
|
|
|
|
<li>hdf5\proj\hdf5_fortrandll\release\hdf5_fortrandll.dll </li>
|
|
|
|
<li>hdf5\proj\hdf5_fortrandll\debug\hdf5_fortranddll.dll </li>
|
|
|
|
<li>hdf5\fortran\test\libtest_cstubdll\release\libtest_cstubdll.dll
|
|
</li>
|
|
|
|
<li>hdf5\fortran\test\libtest_cstubdll\debug\libtest_cstubddll.dll
|
|
</li>
|
|
|
|
<li>hdf5\fortran\test\libtest_fortrandll\release\libtest_fortrandll.dll
|
|
</li>
|
|
|
|
<li>hdf5\fortran\test\libtest_fortrandll\debug\libtest_fortranddll.dll</li>
|
|
|
|
</ul>
|
|
|
|
<p>Run <span class="filename">testhdf5_fortran.bat</span>
|
|
at the command prompt as below:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>testhdf5_fortran release > "Your output
|
|
filename" </li>
|
|
|
|
<li>testhdf5_fortran release dll > "Your output
|
|
filename" </li>
|
|
|
|
<li>testhdf5_fortran debug > "Your output filename" </li>
|
|
|
|
<li>testhdf5_fortran debug dll > "Your output
|
|
filename"</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>5. HDF5 High-Level C library test</h5>
|
|
|
|
<p>Skip this step UNLESS you have built HDF5 High-Level
|
|
libraries and want to test them.</p>
|
|
|
|
<p>DLLs listed below should be placed into the Windows system
|
|
directory. A batch file named <span class="filename">install_hldll.bat</span>
|
|
is included in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
directory. Run this batch file and the following HDF5 high level DLLs
|
|
will be copied to the system directory.</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Release\hdf5_hldll.dll</li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hldll\Debug\hdf5_hldlld.dll</li>
|
|
|
|
</ul>
|
|
|
|
<p>Run <span class="filename">test_hdf5_hl.bat</span>
|
|
in the <span class="filename">hdf5\hl\test</span>
|
|
directory at the command prompt as below:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>test_hdf5_hl release >"Your output filename" </li>
|
|
|
|
<li>test_hdf5_hl release dll >"Your output filename"
|
|
</li>
|
|
|
|
<li>test_hdf5_hl debug >"Your output filename" </li>
|
|
|
|
<li>test_hdf5_hl debug dll >"Your output filename"</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
</li>
|
|
|
|
<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>DLLs listed below should be placed into the Windows system
|
|
directory. A batch file named <span class="filename">install_hlcppdll.bat</span>
|
|
is included in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
directory. Run this batch file and the following HDF5 high level DLLs
|
|
will be copied to the system directory.</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Release\hdf5_hl_cppdll.dll</li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_cppdll\Debug\hdf5_hl_cppdlld.dll</li>
|
|
|
|
</ul>
|
|
|
|
<p>Run <span class="filename">test_hdf5_hl_cpp.bat</span>
|
|
in the <span class="filename">hdf5\hl\c++\test</span>
|
|
directory at the command prompt as below:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>test_hdf5_hl_cpp release >"Your output filename"
|
|
</li>
|
|
|
|
<li>test_hdf5_hl_cpp release dll >"Your output
|
|
filename" </li>
|
|
|
|
<li>test_hdf5_hl_cpp debug >"Your output filename" </li>
|
|
|
|
<li>test_hdf5_hl_cpp debug dll >"Your output
|
|
filename"</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Use Notepad or WordPad to check
|
|
results. You should not find any FAILED marks in your output files.</p>
|
|
|
|
</li>
|
|
|
|
<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>DLLs listed below should be placed into the Windows system
|
|
directory. A batch file named <span class="filename">install_hlf90dll.bat</span>
|
|
is included in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
directory. Run this batch file and the following HDF5 high level DLLs
|
|
will be copied to the system directory.</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release\hdf5_hl_f90cstubdll.dll</li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug\hdf5_hl_f90cstubdlld.dll</li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Release\hdf5_hl_fortrandll.dll</li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\proj\hdf5_hl_fortrandll\Debug\hdf5_hl_fortrandlld.dll</li>
|
|
|
|
</ul>
|
|
|
|
<p>Run <span class="filename">test_hdf5_hl_fortran.bat</span>
|
|
in the <span class="filename">hdf5\hl\fortran\test</span>
|
|
directory at the command prompt as below:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>test_hdf5_hl_fortran release >"Your output
|
|
filename" </li>
|
|
|
|
<li>test_hdf5_hl_fortran release dll >"Your output
|
|
filename" </li>
|
|
|
|
<li>test_hdf5_hl_fortran debug >"Your output
|
|
filename" </li>
|
|
|
|
<li>test_hdf5_hl_fortran debug dll >"Your output
|
|
filename"</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">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"><u>STEP 3:
|
|
Installing HDF5 Libraries</u></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
|
|
<span class="filename">installhdf5lib.bat</span>
|
|
under <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
directory. Run the batch file, you may see a folder called hdf5lib
|
|
under <span class="filename">c:\MyHDFstuff\hdf5</span>.
|
|
</p>
|
|
|
|
<p>The <release> layout of <hdf5lib>
|
|
should be:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>release\include -- HDF5 header files </li>
|
|
|
|
<li>release\bin -- HDF5 static tool executables </li>
|
|
|
|
<li>release\bindll -- HDF5 DLL tool executables </li>
|
|
|
|
<li>release\lib -- HDF5 static libraries </li>
|
|
|
|
<li>release\dll -- HDF5 DLLs</li>
|
|
|
|
</ul>
|
|
|
|
<p>You may also find the similar layout for the
|
|
<debug>. </p>
|
|
|
|
<p class="right"><a href="#section2">Go to
|
|
TOP Section II</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section3_examples">Section III: How to
|
|
build Examples (Optional)</a></h2>
|
|
|
|
<hr class="second">
|
|
<p>This section include:</p>
|
|
|
|
<p><a href="#cexamples">How to build and test C
|
|
examples</a></p>
|
|
|
|
<p><a href="#cppexamples">How to build and test C++
|
|
examples</a></p>
|
|
|
|
<p><a href="#f90examples">How to build and test
|
|
Fortran examples</a></p>
|
|
|
|
<p><a href="#hlcexamples">How to build and test High
|
|
Level C examples</a></p>
|
|
|
|
<p><a href="#hlf90examples">How to build and test
|
|
High Level Fortran examples</a></p>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">1. To build HDF5 C++ examples, HDF5
|
|
C++ library must have been built in Section III, step I. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">2. To build HDF5 Fortran examples,
|
|
HDF5 Fortran library must have been built in Section III, step I. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">3. To build HDF5 High Level C
|
|
examples, HDF5 High Level C library must have been built in Section
|
|
III, step I.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">4. By default, the debug versions of
|
|
HDF5 C/C++/Fortran/HL examples are linked with the debug versions of
|
|
HDF5 C/C++/Fortran/HL libraries and DLLs. The debug versions of <span style="font-size: 100%;">HDF5</span> C/C++/Fortran/HL
|
|
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>
|
|
|
|
<p> </p>
|
|
|
|
<hr>
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h3><a name="cexamples"><u>How to build
|
|
and test C examples:</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. Open C Examples Workspace</p>
|
|
|
|
<p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option.</p>
|
|
|
|
<p>Then open the workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\examples\allexamples\allexamples.dsw.</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Compile/Build C Examples</p>
|
|
|
|
<p>Select <span class="filename">"Build"</span>,
|
|
then Select <span class="filename">"Set Active
|
|
Configuration"</span>. </p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>To build debug versions of C examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allexamples
|
|
-- Win32 Debug"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build debug version of project <span class="filename">"allexamples"</span>. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To build release versions of C examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allexamples
|
|
-- Win32 Release"</span>, select <span class="filename">"ok".</span>
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build release version of project <span class="filename">"allexamples"</span>. </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>
|
|
|
|
<li>attributetestdll </li>
|
|
|
|
<li>chunkread </li>
|
|
|
|
<li>chunkreaddll </li>
|
|
|
|
<li>compoundtest </li>
|
|
|
|
<li>compoundtestdll </li>
|
|
|
|
<li>extendwritetest </li>
|
|
|
|
<li>extendwritetestdll </li>
|
|
|
|
<li>grouptest </li>
|
|
|
|
<li>grouptestdll </li>
|
|
|
|
<li>readtestdll </li>
|
|
|
|
<li>selectest </li>
|
|
|
|
<li>selectestdll </li>
|
|
|
|
<li>writetest </li>
|
|
|
|
<li>writetestdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. Install C Examples</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Invoke a command prompt window and run the batch file <span class="filename">InstallExamples.bat</span> which
|
|
resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>).
|
|
This file creates 4 new directories, <span class="filename">examplesREL,
|
|
examplesRELDLL, examplesDBG, and examplesDBGDLL</span>, in the <span class="filename">c:\MyHDFstuff\hdf5\examples</span>
|
|
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>
|
|
|
|
<li>
|
|
<p>4.Test C examples</p>
|
|
|
|
<p>We provide a batch file named <span class="filename">testExamples.bat</span> and an
|
|
expected examples tests output file named <span class="filename">testExamples_exp_output.txt</span>
|
|
in <span class="filename">c:\MyHDFstuff\hdf5\examples</span>
|
|
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>
|
|
|
|
<li>testExamples release dll -- for release DLL version
|
|
</li>
|
|
|
|
<li>testExamples debug -- for debug version </li>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<h3><a name="cppexamples"><u>How to build
|
|
and test C++ examples</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. Open C++ Examples Workspace</p>
|
|
|
|
<p>Invoke Microsoft Visual C++, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option.</p>
|
|
|
|
<p>Then open the workspace</p>
|
|
|
|
<p class="filename">c:\myHDFstuff\hdf5\windows\c++\examples\allcppexamples\allcppexamples.dsw.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Compile/Build C++ Examples</p>
|
|
|
|
<p>Select <span class="filename">"Build"</span>,
|
|
then Select <span class="filename">"Set Active
|
|
Configuration"</span>.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>To build debug versions of C++ examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allcppexamples
|
|
-- Win32 Debug"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build debug version of project <span class="filename">"allcppexamples".</span> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To build release versions of C++ examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allcppexamples
|
|
-- Win32 Release"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build release version of project <span class="filename">"allcppexamples".</span> </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>When the debug build or release build is done, there
|
|
should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples\</span></p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>chunkstest </li>
|
|
|
|
<li>chunkstestdll </li>
|
|
|
|
<li>compoundtest </li>
|
|
|
|
<li>compoundtestdll </li>
|
|
|
|
<li>createtest </li>
|
|
|
|
<li>createtestdll </li>
|
|
|
|
<li>extend_dstest </li>
|
|
|
|
<li>extend_dstestdll </li>
|
|
|
|
<li>h5grouptest </li>
|
|
|
|
<li>h5grouptestdll </li>
|
|
|
|
<li>readdatatest </li>
|
|
|
|
<li>readdatatestdll </li>
|
|
|
|
<li>writedatatest </li>
|
|
|
|
<li>writedatatestdll </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. Install C++ Examples</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Invoke a command prompt window and run the batch file <span class="filename">InstallcppExamples.bat</span> which
|
|
resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>).
|
|
This file creates 4 new directories, <span class="filename">cppexamplesREL,
|
|
cppexamplesRELDLL, cppexamplesDBG, and cppexamplesDBGDLL</span>,
|
|
in the <span class="filename"> c:\MyHDFstuff\c++\examples</span>
|
|
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>
|
|
|
|
<li>
|
|
<p>4. Test C++ Examples</p>
|
|
|
|
<p>We provide a batch file named <span class="filename">testcppExamples.bat</span> in <span class="filename">c:\MyHDFstuff\hdf5\c++\examples</span>
|
|
directory for you to test HDF5 C++ examples. </p>
|
|
|
|
<p><span class="filename">testcppExamples.bat</span>
|
|
batch file has 4 options:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>testcppExamples release -- for release version </li>
|
|
|
|
<li>testcppExamples release dll -- for release DLL
|
|
version </li>
|
|
|
|
<li>testcppExamples debug -- for debug version </li>
|
|
|
|
<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 <span class="filename">"All
|
|
HDF5 C++ examples tests passed."</span> when the C++ examples are
|
|
built successfully. Otherwise, the difference between the expected
|
|
outputs and actual outputs will be given. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3><a name="f90examples"><u>How to Build
|
|
and test HDF5 Fortran examples:</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. Open Fortran Examples Workspace</p>
|
|
|
|
<p>Invoke Compaq Visual Fortran or intel Fortran under
|
|
Microsoft Visual studio development environment, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace" </span>option. </p>
|
|
|
|
<p>Then open the workspace</p>
|
|
|
|
<p class="filename">c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Compile/Build Fortran Examples</p>
|
|
|
|
<p>Select "Build", then Select "Set Active Configuration".</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>To build debug versions of Fortran examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allf90examples
|
|
-- Win32 Debug"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build debug version of project <span class="filename">"allf90examples".</span> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To build release versions of Fortran examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"allf90examples
|
|
-- Win32 Release"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build release version of project <span class="filename">"allf90examples".</span> </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>When the debug build or release build is done, there
|
|
should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\fortran\examples\
|
|
</span></p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>attreexampletest </li>
|
|
|
|
<li>attreexampletestdll </li>
|
|
|
|
<li>compoundtest </li>
|
|
|
|
<li>compoundtestdll </li>
|
|
|
|
<li>dsetexampletest </li>
|
|
|
|
<li>dsetexampletestdll </li>
|
|
|
|
<li>fileexampletest </li>
|
|
|
|
<li>fileexampletestdll </li>
|
|
|
|
<li>groupexampletest </li>
|
|
|
|
<li>groupexampletestdll </li>
|
|
|
|
<li>grpdsetexampletest </li>
|
|
|
|
<li>grpdsetexampletestdll </li>
|
|
|
|
<li>grpittest </li>
|
|
|
|
<li>grpittestdll </li>
|
|
|
|
<li>grpsexampletest </li>
|
|
|
|
<li>grpsexampletestdll </li>
|
|
|
|
<li>hyperslabtest </li>
|
|
|
|
<li>hyperslabtestdll </li>
|
|
|
|
<li>mountexampletest </li>
|
|
|
|
<li>mountexampletest </li>
|
|
|
|
<li>refobjexampletest </li>
|
|
|
|
<li>refobjexampletestdll </li>
|
|
|
|
<li>refregexampletest </li>
|
|
|
|
<li>refregexampletestdll </li>
|
|
|
|
<li>rwdsetexampletest </li>
|
|
|
|
<li>rwdsetexampletestdll </li>
|
|
|
|
<li>selecteletest </li>
|
|
|
|
<li>selecteletestdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. Install Fortran Examples</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Invoke a command prompt window and run the batch file <span class="filename">Installf90Examples.bat</span> which
|
|
resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>).
|
|
This file creates 4 new directories, <span class="filename">f90examplesREL,
|
|
f90examplesRELDLL, f90examplesDBG, and f90examplesDBGDLL</span>,
|
|
in the <span class="filename">
|
|
c:\MyHDFstuff\fortran\examples</span> 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>
|
|
|
|
<li>
|
|
<p>4. Test Fortran Examples</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>The batch file is not available for the time being.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3><a name="hlcexamples"><u>How to build
|
|
and test HDF5 High Level C examples</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. Open HL C Examples Workspace.</p>
|
|
|
|
<p>Invoke Microsoft Visual C++ 6.0, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace" </span>option.</p>
|
|
|
|
<p>Then open the workspace</p>
|
|
|
|
<p class="filename">c:\MyHDFstuff\hdf5\windows\hl\hl_c_examples\hl_c_examples.dsw.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Compile/Build HL C Examples</p>
|
|
|
|
<p>Select <span class="filename">"Build"</span>,
|
|
then Select <span class="filename">"Set Active
|
|
Configuration".</span></p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>To build debug versions of High Level C examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"hl_c_examples
|
|
-- Win32 Debug"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build debug version of project <span class="filename">"hl_c_examples"</span>. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To build release versions of High Level C examples,</p>
|
|
|
|
<p>In <span class="filename">"Project
|
|
configurations"</span>, select <span class="filename">"hl_c_examples
|
|
-- Win32 Release"</span>, select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build" -> "Build"
|
|
or "Rebuild All"</span> to build release version of project <span class="filename">"hl_c_examples"</span>. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>When the debug build or release build is done, there
|
|
should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples.
|
|
</span></p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>ex_images </li>
|
|
|
|
<li>ex_imagesdll </li>
|
|
|
|
<li>ex_lite </li>
|
|
|
|
<li>ex_litedll </li>
|
|
|
|
<li>ex_table </li>
|
|
|
|
<li>ex_tabledll</li>
|
|
|
|
<li>ex_ds</li>
|
|
|
|
<li>ex_dsdll</li>
|
|
|
|
<li>ex_packet</li>
|
|
|
|
<li>ex_packetdll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. Install HL C examples</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Invoke a command prompt window and run the batch file <span class="filename">Install_hlcexamples.bat</span> which
|
|
resides in the top level directory (<span class="filename">c:\MyHDFstuff\hdf5</span>).
|
|
This file creates 4 new directories, <span class="filename">HLCexamplesRELEASE,
|
|
HLCexamplesRELEASEDLL, HLCexamplesDEBUG, and HLCexamplesDEBUGDLL</span>
|
|
in the <span class="filename">c:\MyHDFstuff\hl\hl_c_examples</span>
|
|
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>
|
|
|
|
<li>
|
|
<p>4. Test HL C examples</p>
|
|
|
|
<p>We provide a batch file named <span class="filename">test_hl_cexamples.bat</span> in <span class="filename">c:\MyHDFstuff\hdf5\hl\hl_c_examples\</span>
|
|
directory for you to test HDF5 High Level C examples. </p>
|
|
|
|
<p><span class="filename">test_hl_cexamples.bat</span>
|
|
batch file has 4 options:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>test_hl_cexamples release -- for release version </li>
|
|
|
|
<li>ttest_hl_cexamples release dll -- for release DLL
|
|
version </li>
|
|
|
|
<li>test_hl_cexamples debug -- for debug version </li>
|
|
|
|
<li>test_hl_cexamples debug dll -- for debug DLL version</li>
|
|
|
|
</ul>
|
|
|
|
<p>Invoke a command prompt window and run <span class="filename">test_hl_cexamples.bat</span> with
|
|
appropriate options. When you run <span class="filename">"test_hl_cexamples
|
|
release"</span>, When you run "test_hl_cexamples.bat" with each
|
|
option, if you see the following messages at the end: </p>
|
|
|
|
<p class="insmes"> All of the HL C Examples Passed!</p>
|
|
|
|
<p>You have built HL C examples successfully. Otherwise,
|
|
HL C examples Failed to build.</p>
|
|
|
|
<h3><a name="hlf90examples"><u>How
|
|
to build and test HDF5 High Level Fortran examples:</u></a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. Open HL Fortran Examples Workspace</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Invoke Compaq Visual Fortran 6.6c, open the
|
|
workspace <span class="filename">c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\allhlf90examples\allhlf90examples.dsw</span>
|
|
</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Compile/Build HL Fortran Examples</p>
|
|
|
|
<p>Select "Build", then Select "Set Active
|
|
Configuration"</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>To build debug versions of High Level Fortran
|
|
examples,</p>
|
|
|
|
<p>In "Project configurations", select
|
|
"allhlf90examples -- Win32 Debug", select "ok". Select "Build"
|
|
-> "Build" or "Rebuild All" to build debug version of project
|
|
"allhlf90examples". </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To build release versions of Fortran examples.</p>
|
|
|
|
<p>In "Project configurations", select
|
|
"allhlf90examples -- Win32 Release", select "ok". Select "Build"
|
|
-> "Build" or "Rebuild All" to build release version of project
|
|
"allhlf90examples". </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p> When the debug build or release build is done,
|
|
there should be the following subdirectories in <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples</span></p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>ex_lite</li>
|
|
|
|
<li>ex_litedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. Install HL Fortran Examples</p>
|
|
|
|
<p>Invoke a command prompt window and run the batch
|
|
file<span class="filename">Install_hlf90examples.bat</span>
|
|
which resides in the top level directory <span class="filename">(c:\MyHDFstuff\hdf5)</span>.
|
|
This file creates 4 new directories, <span class="filename">HLf90examplesRELEASE,
|
|
HLf90examplesRELEASEDLL, HLf90examplesDEBUG,and HLf90examplesDEBUGDLL,</span>
|
|
in the directory <span class="filename">c:\MyHDFstuff\hdf5\hl\fortran\examples
|
|
</span> 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>
|
|
|
|
<li>
|
|
<p>4. Test HL Fortran Examples</p>
|
|
|
|
<p>We provide a batch file named <span class="filename">test_hl_f90examples.bat</span> in
|
|
directory <span class="filename">
|
|
c:\MyHDFstuff\hdf5\hl\fortran\examples </span>for you to test
|
|
HDF5 high level fortran examples.</p>
|
|
|
|
<p><span class="filename">test_hl_f90examples.bat</span>
|
|
batch file has 4 options:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>test_hl_f90examples release -- for release
|
|
version</li>
|
|
|
|
<li>test_hl_f90examples release dll -- for release
|
|
DLL version</li>
|
|
|
|
<li>test_hl_f90examples debug -- for debug version</li>
|
|
|
|
<li>test_hl_f90examples debug dll -- for debug DLL
|
|
version</li>
|
|
|
|
</ul>
|
|
|
|
<p>Invoke a command prompt window and run <span class="filename">test_hl_f90examples.bat</span> with
|
|
appropriate options.</p>
|
|
|
|
<p>When you run "test_hl_f90examples release", the
|
|
output will look like:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>release version of High Level Fortran examples
|
|
PASSED</li>
|
|
|
|
</ul>
|
|
|
|
<p>Similar messages should be generated with another
|
|
three options If the high level Fortran examples are built successfully.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section3_examples">Go
|
|
to TOP Section III</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section4">Section IV: Building an
|
|
application using the HDF5 library or DLL</a></h2>
|
|
|
|
<hr class="second">
|
|
<p class="note">Warnings:</p>
|
|
|
|
<p class="note">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>1. To use HDF5 static library</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<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><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li>
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib</span></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>If you have installed HDF5 library in <a href="#step3_section2">Section II, step 3</a>, We
|
|
assume that you will use Zlib and Szip compression with HDF5 library. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<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><u>Method One</u></h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<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>
|
|
|
|
<li>
|
|
<p>Go to the <span class="filename">Project</span>
|
|
menu and chose the <span class="filename">"Settings"</span>
|
|
option.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Choose the build configuration you
|
|
would like to modify in the drop down menu labeled with <span class="filename">"Settings For:"</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Choose the <span class="filename">C/C++</span>
|
|
tab</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Choose <span class="filename">"Preprocessor</span>"
|
|
in the drop down menu labeled with <span class="filename">"Category:"</span></p>
|
|
|
|
</li>
|
|
|
|
<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><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\zlib122\include
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\szip\include</span></li>
|
|
|
|
</ul>
|
|
|
|
<p>Then click OK.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(optional) to use HDF5 Fortran static
|
|
library, the location of Fortran module files should be specified by
|
|
following<span class="filename">
|
|
Project->Settings->Fortran->Preprocessor</span>,
|
|
and in a test-area labeled with <span class="filename">"INCLUDE
|
|
and USE Paths:"</span>, add HDF5 Fortran module files
|
|
directories. For example: </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include</span></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<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>
|
|
|
|
<li>
|
|
<p>Go to the <span class="filename">Project</span>
|
|
menu and chose the <span class="filename">"Add to Project"</span>
|
|
option and then <span class="filename">"Files"</span>
|
|
option.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Change the <span class="filename">"Files
|
|
of type:"</span> to <span class="filename">"Library
|
|
Files (.lib)".</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Navigate through the directories until
|
|
you find the location of the <span class="filename">hdf5.lib</span>.
|
|
</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Select <span class="filename">hdf5.lib</span>
|
|
and click <span class="filename">OK</span>.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>repeat step i-v, to select<span class="filename"> zdll.lib and szlibdll.lib</span>.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(optional) repeat step i-v, to select <span class="filename">hdf5_cpp.lib</span> to link with HDF5
|
|
C++ static library.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(optional) repeat step i-v5, to select
|
|
<span class="filename">hdf5_fortran.lib</span>
|
|
to link with HDF5 Fortran static library.</p>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><u>Method Two</u></h4>
|
|
|
|
<blockquote>
|
|
<ol style="list-style-type: lower-roman;">
|
|
|
|
<li>
|
|
<p>Go to <span class="filename">Tools->Options->Directorie</span>s,</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Insert the correct HDF5, Zlib, Szip
|
|
paths for both headers (include) and libraries. For example, </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\include
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\hdf5lib\release\lib
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\zlib122\include
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\zlib122\lib
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\szip\include
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\szip\dl</span>l</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Go to the <span class="filename">Project</span>
|
|
menu and choose the <span class="filename">"Settings"</span>
|
|
option.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Find the <span class="filename">"link"</span>
|
|
option and <span class="filename">"Input"</span>
|
|
category, insert <span class="filename">"zdll.lib,
|
|
szlibdll.lib, hdf5.lib"</span>.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(Optional) repeat step iii-iv, to insert
|
|
<span class="filename">"hdf5_cpp.lib"</span>
|
|
if you want to use HDF5 C++ static library.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(Optional) repeat step iii-iv, to insert
|
|
<span class="filename">"hdf5_fortran.lib"</span>
|
|
if you want to use HDF5 Fortran static library.</p>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</blockquote>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3>2. To use HDF5 Dynamic Link Library</h3>
|
|
|
|
<blockquote>
|
|
<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">Method
|
|
One.</a></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Follow the steps for linking the HDF5 library as
|
|
shown in <a href="#link_hdf5">Method One.</a>
|
|
except now link the export library that is created with the DLL. The
|
|
export library is called <span class="filename">hdf5dll.lib</span>
|
|
for HDF5 C libray, <span class="filename">hdf5_cppdll.lib</span>
|
|
for HDF5 C++ library, and <span class="filename">hdf5_fortrandll.lib</span>
|
|
for HDF5 Fortran library.</p>
|
|
|
|
</li>
|
|
|
|
<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>
|
|
|
|
<li>
|
|
<p>The Windows directory. The
|
|
GetWindowsDirectory function retrieves the path of this directory.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>The directories listed in the PATH
|
|
environment variable.</p>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>To modify your own application settings, please
|
|
DO FOLLOW the<a href="#section11_pointers"> "DLL Hints" at
|
|
Section XI "HELPFUL POINTERS".</a></p>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</blockquote>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section4">Go
|
|
to TOP Section IV</a></p>
|
|
|
|
<p class="right"><a href="#content_table">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 class="note">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>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>If you would like to remove Gzip compression from
|
|
the HDF5 library, follow the steps below.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<p></p>
|
|
|
|
<li>1.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span>
|
|
directory and remove (or comment out) the following two lines:
|
|
<ul class="normal">
|
|
|
|
<li>
|
|
<p class="insmes">#define
|
|
H5_HAVE_ZLIB_H 1 </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#define
|
|
H5_HAVE_FILTER_DEFLATE 1</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
then save the file. </li>
|
|
|
|
<li>1.2 Delete HDF5_EXT_ZLIB environment variable
|
|
if you have set it in preconditions.</li>
|
|
|
|
<li>1.3 Run-compile HDF5 library according to <a href="#section2">Section II.</a></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<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>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>This message can be ignored.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3>2. Disable Szip compression (both encoder and decoder)</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>If you would like to remove Szip compression from
|
|
the HDF5 library, follow the steps below.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>2.1 Open the H5pubconf.h file from the <span class="filename">c:\MyHDFstuff\hdf5\src</span>
|
|
directory and remove (or comment out) the following two lines:
|
|
<ul class="normal">
|
|
|
|
<li>
|
|
<p class="insmes">#define
|
|
H5_HAVE_SZLIB_H 1 </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#define
|
|
H5_HAVE_FILTER_SZIP 1</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>then save the file.</li>
|
|
|
|
<li>2.2 Delete <span class="filename">HDF5_EXT_SZIP</span>
|
|
environment variable if you have set it in preconditions.</li>
|
|
|
|
<li>2.3 Run-compile HDF5 library according to <a href="#section2">Section II.</a> </li>
|
|
|
|
</ul>
|
|
|
|
<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 class="note">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"> Section II.</a></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<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>
|
|
|
|
<blockquote>
|
|
<ul class="intable">
|
|
|
|
<li>3.1 Download Szip library without encoder</li>
|
|
|
|
<li>Szip library is different if you want to disable
|
|
Szip encoder. Download <span class="filename">szip_noencoder</span>
|
|
binaries from <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="blank" ,="">
|
|
ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a>
|
|
The Szip
|
|
library and header path should also be set up accordingly (refer to <a href="#precondition6">Precondition 6.)</a>
|
|
<p></p>
|
|
|
|
</li>
|
|
|
|
<li>3.2 Run-compile HDF5 library according to <a href="#section2">Section II.</a></li>
|
|
|
|
</ul>
|
|
|
|
</blockquote>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section5">Go
|
|
to TOP Section V</a></p>
|
|
|
|
<p class="right"><a href="#content_table">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">
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h3>1. Open the workspace </h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>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>
|
|
|
|
<li>
|
|
<p class="note">Notes: If you are
|
|
not in <a href="#section10"> Section X How to build HDF5
|
|
with Thread-Safe Feature</a>, ttsafedll.dsp should be turned off
|
|
always.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3>2. Building HDF5 C/C++ Libraries</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>Users can choose the desirable libraries to be
|
|
built according to the following description.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.1 If you don't want to build HDF5 C++ Libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Build"</span>
|
|
and select<span class="filename"> "Configuration Manager"</span>.
|
|
Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span>
|
|
</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Disable the following projects:
|
|
<ul class="normal">
|
|
|
|
<li>dsets_cpp </li>
|
|
|
|
<li>dsets_cppdll </li>
|
|
|
|
<li>hdf5_cpp </li>
|
|
|
|
<li>hdf5_cppdll </li>
|
|
|
|
<li>testhdf5_cpp </li>
|
|
|
|
<li>testhdf5_cppdll </li>
|
|
|
|
<li>hdf5_hl_cpp</li>
|
|
|
|
<li>hdf5_hl_cppdll </li>
|
|
|
|
<li>hl_test_table_cpp</li>
|
|
|
|
<li>hl_test_table_cppdll </li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.2 If you don't want to build HDF5 Fortran
|
|
Libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Build"</span>
|
|
and select <span class="filename">"Configuration Manager"</span>.
|
|
Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span>
|
|
</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Disable the following projects:
|
|
<ul class="normal">
|
|
|
|
<li>flush1_fortran </li>
|
|
|
|
<li>flush1_fortrandll </li>
|
|
|
|
<li>flush2_fortran </li>
|
|
|
|
<li>flush2_fortrandll </li>
|
|
|
|
<li>hdf5_f90cstub </li>
|
|
|
|
<li>hdf5_f90cstubdll </li>
|
|
|
|
<li>hdf5_fortran </li>
|
|
|
|
<li>hdf5_fortrandll </li>
|
|
|
|
<li>libtest_cstubdll </li>
|
|
|
|
<li>libtest_fortran </li>
|
|
|
|
<li>libtest_fortrandll </li>
|
|
|
|
<li>testhdf5_fortran </li>
|
|
|
|
<li>testhdf5_fortrandll </li>
|
|
|
|
<li>hdf5_hl_fortran</li>
|
|
|
|
<li>hdf5_hl_fortrandll</li>
|
|
|
|
<li>hdf5_hl_f90cstubdll </li>
|
|
|
|
<li>hl_test_image_fortran</li>
|
|
|
|
<li>hl_test_image_fortrandll </li>
|
|
|
|
<li>hl_test_lite_fortran</li>
|
|
|
|
<li>hl_test_lite_fortrandll </li>
|
|
|
|
<li>hl_test_table_fortran</li>
|
|
|
|
<li>hl_test_table_fortrandll</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.3 If you don't want to build HDF5 High-Level
|
|
Libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Build"</span>
|
|
and select <span class="filename">"Configuration Manager"</span>.
|
|
Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span>
|
|
</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Disable the following projects:
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl </li>
|
|
|
|
<li>hdf5_hldll</li>
|
|
|
|
<li>hl_test_image</li>
|
|
|
|
<li>hl_test_imagedll </li>
|
|
|
|
<li>hl_test_lite </li>
|
|
|
|
<li>hl_test_litedll</li>
|
|
|
|
<li>hl_test_table </li>
|
|
|
|
<li>hl_test_tabledll</li>
|
|
|
|
<li>hl_test_ds </li>
|
|
|
|
<li>hl_test_dsdll</li>
|
|
|
|
<li>hl_test_packet</li>
|
|
|
|
<li>hl_test_packetdll</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.4 If you want to build HDF5 C++ libarty without
|
|
High-Level C++ Libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Build"</span>
|
|
and select <span class="filename">"Configuration Manager"</span>.
|
|
Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span>
|
|
</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Disable the following projects:
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl_cpp </li>
|
|
|
|
<li>hdf5_hl_cppdll</li>
|
|
|
|
<li>hl_test_table_cpp</li>
|
|
|
|
<li>hl_test_table_cppdll</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.5 If you want to build HDF5 Fortran Libraries
|
|
without High-Level Fortran Libraries</h5>
|
|
|
|
<p>Go to <span class="filename">"Build"</span>
|
|
and select <span class="filename">"Configuration Manager"</span>.
|
|
Choose <span class="filename">"Release"</span> or <span class="filename">"Debug"</span> under <span class="filename">"Active Solution Configuration" </span>
|
|
</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Disable the following projects:
|
|
<ul class="normal">
|
|
|
|
<li>hdf5_hl_fortran </li>
|
|
|
|
<li>hdf5_hl_fortrandll</li>
|
|
|
|
<li>hdf5_hl_f90cstubdll</li>
|
|
|
|
<li>hl_test_image_fortran </li>
|
|
|
|
<li>hl_test_image_fortrandll</li>
|
|
|
|
<li>hl_test_lite_fortran </li>
|
|
|
|
<li>hl_test_lite_fortrandll</li>
|
|
|
|
<li>hl_test_table_fortran </li>
|
|
|
|
<li>hl_test_table_fortrandll</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p> </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Find <span class="filename">"Build"</span>
|
|
and go to <span class="filename">"Configuration Manager"</span>;
|
|
choose <span class="filename">"release"</span> or <span class="filename">"debug"</span>, then choose <span class="filename">"build all"</span> to build HDF5 with
|
|
desired options.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">1. You need to specify
|
|
the <span class="filename">zlib</span> and <span class="filename">szip</span> include header files and
|
|
libraries under<span class="filename"> Tools
|
|
->Options->Projects->VC++</span> Directories
|
|
and choose Include and libraries under the category of <span class="filename">"show directories for"</span> to add
|
|
the corresponding path if you want to use compression feature inside
|
|
HDF5. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">2. Please read <a href="#section5">Section V </a>if you do not want to
|
|
use compression feature inside HDF5.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">3. Since Microsoft Visual Studio
|
|
.NET will automatically enable all project files in the <span class="filename">"Configuration Manager"</span>, you
|
|
have to manually disable those project files you don't want to build. </p>
|
|
|
|
<p class="note">4. 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>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section6">Go
|
|
to TOP Section VI</a></p>
|
|
|
|
<p class="right"><a href="#content_table">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>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Go to Tools-->Select Compiler</li>
|
|
|
|
<li>Check Intel box and click OK button.</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.2. Intel Fortran Compiler</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Go to Tools-->Select Compiler</li>
|
|
|
|
<li>Check Intel box and click OK button.</li>
|
|
|
|
<li>Go to Tools-->Customize-->Add-ins
|
|
and Macro Files and check Intel Fortran Compiler Build Tool</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">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.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">
|
|
ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a>
|
|
The Szip
|
|
library and header path should also be set up accordingly (refer to <a href="#precondition6">Precondition 6.) </a></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3>2. INTEL compiler 8.1</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>Preconditions:</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>a. Setup Szip Library for Intel Compiler.</h4>
|
|
|
|
</li>
|
|
|
|
<li>Intel compilers use different Szip library from
|
|
other compilers. Szip source codes or binaries for Intel compiler can
|
|
be downloaded from the following address: </li>
|
|
|
|
<li><a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/" target="_blank">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/.</a>
|
|
</li>
|
|
|
|
<li>The Szip library and header path should also be
|
|
set up accordingly (refer to <a href="#precondition6">Precondition
|
|
6.)</a></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>b. Set up path for external libraries and headers</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Skip this part if you don't want to use ANY
|
|
compression features provided by HDF5. Please do read <a href="#section5">Section V.</a></li>
|
|
|
|
<li>You have to read this part even if you want to
|
|
only use Zlib or Szip. You also need to read <a href="#section5">Section
|
|
V.</a></li>
|
|
|
|
<li>Invoke Microsoft Visual C++ and go to <span class="filename">"Tools"</span> and select <span class="filename">"Options"</span>, find <span class="filename">"Directories"</span>;</li>
|
|
|
|
<li>Find the box <span class="filename">"Show
|
|
directories for"</span>, choose <span class="filename">"Include
|
|
files"</span>, if you can not find your Zlib and Szip header path
|
|
(for example, <span class="filename">c:\zlib122\include,
|
|
c:\szip\include</span>) from the directory list, add the header
|
|
path (<span class="filename">c:\zlib122\include,
|
|
c:\szip\include</span>) to the included directories. </li>
|
|
|
|
<li>Find the box <span class="filename">"Show
|
|
directories for"</span>, choose <span class="filename">"Library
|
|
files"</span>, If you cannot find your Zlib and Szip library path
|
|
(for example, <span class="filename">c:\zlib122\lib,
|
|
c:\szip\dll</span>) from the directory list, add the library path
|
|
(<span class="filename">c:\zlib122\lib, c:\szip\dll</span>)
|
|
to the library directories. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><a name="2.1_section7">2.1 Intel C++
|
|
Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">Notes:</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">1. This step will build ONLY
|
|
HDF5 Static and DLL C and C++ Library using Intel C++ Compiler.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">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">2.2 </a>directly!
|
|
</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.1.1 Invoke Microsoft Visual C++ .Net 2003. </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>From the main menu, go to<span class="filename">
|
|
"File"</span> and select <span class="filename">"Open
|
|
Solution"</span>. In the "Open <span class="filename">Solution" </span>window, Change <span class="filename">"Files of type" </span>to<span class="filename"> "All Project Files". </span>Choose<span class="filename"> "all.dsw" </span>under the
|
|
directory <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span>
|
|
In the pop up window, choose <span class="filename">"Yes
|
|
To All"</span> to convert all project files to Visual C++ .Net
|
|
project format. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.1.2 Right click on the solution name <span class="filename">"all.sln"</span> in the <span class="filename">"Solution Explorer"</span>. </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>From the pop-up menu select <span class="filename">"Convert to use Intel C++ Project System"</span>
|
|
to convert all .Net project files to Intel C++ project files. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.1.3 Go to <span class="filename">Tools
|
|
> Options > Intel C++</span>,</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>In the left pane, Click <span class="filename">"General"</span>.
|
|
</li>
|
|
|
|
<li>In the right pane, under "Compiler selection",
|
|
choose Intel C++ 8.1. </li>
|
|
|
|
<li>Click on <span class="filename">"Intel
|
|
C++ 8.1"</span> to set the directories and default options. In <span class="filename">"Include"</span>, Add Zlib and Szip
|
|
header path (<span class="filename">c:\zlib122\include
|
|
c:\szip\include</span>). In <span class="filename">"Library"</span>,
|
|
Add Zlib and Szip Library Path (<span class="filename">c:\zlib122\lib,
|
|
c:\szip\dll</span>).</li>
|
|
|
|
<li>Click <span class="filename">"OK"</span>.</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.1.4 Select "Build", then Select "Set Active
|
|
Configuration".</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Select <span class="filename">"all --
|
|
Win32 Debug" </span>or<span class="filename"> "all
|
|
-- Win32 Release"</span></li>
|
|
|
|
<li>Disable all Fortran project files listed below and <span class="filename"> ttsafedll</span> project file:</li>
|
|
|
|
<li>flush1_fortran </li>
|
|
|
|
<li>flush1_fortrandll </li>
|
|
|
|
<li>flush2_fortran </li>
|
|
|
|
<li>flush2_fortrandll </li>
|
|
|
|
<li>hdf5_f90cstub </li>
|
|
|
|
<li>hdf5_f90cstubdll </li>
|
|
|
|
<li>hdf5_fortran </li>
|
|
|
|
<li>hdf5_fortrandll </li>
|
|
|
|
<li>libtest_cstubdll </li>
|
|
|
|
<li>libtest_fortran </li>
|
|
|
|
<li>libtest_fortrandll </li>
|
|
|
|
<li>testhdf5_fortran </li>
|
|
|
|
<li>testhdf5_fortrandll </li>
|
|
|
|
<li>hdf5_hl_fortran </li>
|
|
|
|
<li>hl_test_image_fortran </li>
|
|
|
|
<li>hl_test_lite_fortran </li>
|
|
|
|
<li>hl_test_table_fortran</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
<li>Select <span class="filename">"ok". </span>Select<span class="filename"> "Build" -> "Build" or "Rebuild All"
|
|
</span>to build debug version of project<span class="filename"> "all".</span></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.1.5 Go back to <a href="#step2_section2">Section
|
|
II, continue with STEP 2(Testing HDF5 libraries and tools) to test HDF5
|
|
C and C++ Libraries.</a></h4>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><a name="2.2_section7">2.2 Intel Fortran
|
|
Compiler 8.1 under MSVS C++ .Net 2003 Environment</a></h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p class="note">Notes:</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">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>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">2. Users who want to build
|
|
ONLY HDF5 Static and DLL C and C++ LibraryPlease go to <a href="#2.1_section7">2.1.</a> </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.1 Invoke Microsoft Visual C++ .Net 2003. </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>From the main menu, go to <span class="filename">"File"</span>
|
|
and select <span class="filename">"Open Solution"</span>.
|
|
In the <span class="filename">"Open Solution"</span>
|
|
window, Change <span class="filename">"Files of type"</span>
|
|
to <span class="filename">"All Project Files"</span>.
|
|
Choose <span class="filename">"all.dsw"</span>
|
|
under the directory <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all.</span>
|
|
In the pop up window, choose <span class="filename">"Yes
|
|
To All</span>" to convert all project files to Visual C++ .Net
|
|
project format. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.2 Select project "flush1_fortran" in the Solution
|
|
Explorer window. In the Project menu, select "Extract Compaq Visual
|
|
Fortran Project". </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Do the same thing for the following project files:</li>
|
|
|
|
<li>flush2_fortran </li>
|
|
|
|
<li>hdf5_fortran </li>
|
|
|
|
<li>testhdf5_fortran </li>
|
|
|
|
<li>hl_test_image_fortran </li>
|
|
|
|
<li>hl_test_lite_fortran </li>
|
|
|
|
<li>hl_test_table_fortran</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.3 Select project "libtest_fortran" in the
|
|
Solution Explorer window. </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>In the Project menu, select <span class="filename">"Extract Compaq Visual Fortran Project"</span>.
|
|
Since Project file <span class="filename">"libtest_fortran</span>"
|
|
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 <span class="filename">"The
|
|
Intel Fortran project"</span> as the the main project and click <span class="filename">"OK"</span>. Do the same
|
|
thing for "hdf5_hl_fortran".</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.4 Change project dependencies of
|
|
"libtest_fortran" and "hdf5_hl_fortran"</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Highlight project <span class="filename">"libtest_fortran"</span>,
|
|
choose <span class="filename">"Project"</span>->
|
|
<span class="filename">"Project Dependencies",
|
|
</span>uncheck<span class="filename">
|
|
"libtest".</span> </li>
|
|
|
|
<li>Highlight project <span class="filename">"hdf5_hl_fortran"</span>,
|
|
choose <span class="filename">"Project"</span>->
|
|
<span class="filename">"Project Dependencies",
|
|
</span>uncheck<span class="filename">
|
|
"hdf5_hl" and "hdf5_fortran".</span> </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.5 Right click on the solution name "all.sln" in
|
|
the "Solution Explorer". </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>From the pop-up menu select <span class="filename">"Convert to use Intel C++ Project System"</span>
|
|
to convert all .Net C++ project files to Intel C++ project formats. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.6 Select "Build", then Select "Set Active
|
|
Configuration".</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Select<span class="filename"> "all --
|
|
Win32 Debug" </span>or<span class="filename"> "all
|
|
-- Win32 Release"</span></li>
|
|
|
|
<li>Disable all Fortran DLL project files listed below
|
|
and <span class="filename">ttsafedll</span> project
|
|
file:</li>
|
|
|
|
<li>flush1_fortrandll </li>
|
|
|
|
<li>flush2_fortrandll </li>
|
|
|
|
<li>hdf5_fortrandll </li>
|
|
|
|
<li>hdf5_hl_fortrandll</li>
|
|
|
|
<li>hl_test_image_fortrandll</li>
|
|
|
|
<li>hl_test_lite_fortrandll</li>
|
|
|
|
<li>hl_test_table_fortrandll</li>
|
|
|
|
<li>libtest_fortrandll </li>
|
|
|
|
<li>testhdf5_fortrandll</li>
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
<li>Select <span class="filename">"ok"</span>.
|
|
Select <span class="filename">"Build"</span>
|
|
-> <span class="filename">"Build" or "Rebuild All"</span>
|
|
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. </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2.7 Test HDF5 Static and High Level Fortran Library</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4><u>Test HDF5 Static Fortran Library</u></h4>
|
|
|
|
<p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\fortran\test</span>,
|
|
Run batch file <span class="filename">testhdf5_fortran.bat</span>
|
|
with the following two options to test fortran static library </p>
|
|
|
|
</li>
|
|
|
|
<li>testhdf5_fortran release >> "Your
|
|
output file name" </li>
|
|
|
|
<li>testhdf5_fortran debug >> "Your
|
|
output file name"</li>
|
|
|
|
<li>
|
|
<p>Check your output files, there should be no
|
|
"failures" at all.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4><u>Test HDF5 High Level Fortran Library</u></h4>
|
|
|
|
<p>Go to directory <span class="filename">c:\myHDFstuff\hdf5\hl\fortran\test</span>,
|
|
Run batch file testhdf5_fortran.bat with the following two options to
|
|
test fortran static library </p>
|
|
|
|
</li>
|
|
|
|
<li>test_hdf5_hl_fortran release >> "Your
|
|
output file name" </li>
|
|
|
|
<li>test_hdf5_hl_fortran debug >> "Your
|
|
output file name"</li>
|
|
|
|
<li>
|
|
<p>Check your output files, there should be no
|
|
"failures" at all.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section7">Go
|
|
to TOP Section VII</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section8">Section VIII: Building
|
|
and testing Multi-threaded version of HDF5 Library </a></h2>
|
|
|
|
<hr class="second">
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">Preconditions and Section I also apply
|
|
to this section. Users who want to build Multi-threaded version of HDF5
|
|
library, please read those two sections carefully before go to the
|
|
following part. </p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1. Run batch file copy_hdf.bat.</h4>
|
|
|
|
<p>Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
and run <span class="filename">copy_hdf.bat</span>.
|
|
This process will copy all the necessary batch files, windows specific
|
|
source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
directory to the corresponding directories under <span class="filename">hdf5</span>. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2. Invoke Microsoft Visual C++ compiler Invoke
|
|
Microsoft</h4>
|
|
|
|
<p>Visual C++. From the main menu, go to <span class="filename">"File"</span> and select the <span class="filename">"Open Workspace"</span> option. Then
|
|
open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span>
|
|
workspace. You should find windows project files listed as <span class="filename">"all files, big files etc."</span> on
|
|
the left. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>3. Please refer to Section II, Step 3(3) to set the
|
|
dependencies of project "all.dsp". </h4>
|
|
|
|
<p></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>4. Change Project settings </h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Choose <span class="filename">"Project"->"Settings",</span>
|
|
<ul class="intable">
|
|
|
|
<li>In the left pane of the window <span class="filename">"Project Settings"</span>, from the
|
|
drop down box to the right of <span class="filename">"Setting
|
|
For:"</span>,
|
|
<ul class="intable">
|
|
|
|
<li><u>Choose <span class="filename">"Win32
|
|
Release"</span>:</u></li>
|
|
|
|
<li>Highlight all of the static project file in
|
|
the left lower pane by pressing <span class="filename">"ctrl"</span>
|
|
key while clicking the project file name.</li>
|
|
|
|
<li>In the right pane of the <span class="filename">"Project Settings"</span> window,
|
|
choose <span class="filename">"C/C++"</span>. From
|
|
the drop down box to the right of <span class="filename">"Category"</span>,
|
|
choose <span class="filename">"Code Generation", </span>under<span class="filename"> "Use run-time library:"</span>,<span class="filename"> "Single-Threaded" </span>should
|
|
appear. If it is blank inside this box, check if you highlight some dll
|
|
project files (see notes below). Change <span class="filename">"Single-Threaded"
|
|
</span> to <span class="filename">"Multithreaded"</span>.</li>
|
|
|
|
<li><u>Choose <span class="filename">"Win32
|
|
Debug"</span>; </u></li>
|
|
|
|
<li>Highlight all of the static project file in
|
|
the left lower pane by pressing <span class="filename">"ctrl"</span>
|
|
key while clicking the project file name.</li>
|
|
|
|
<li>In the right pane of the <span class="filename">"Project Settings"</span> window,
|
|
choose <span class="filename">"C/C++".</span> From
|
|
the drop down box to the right of <span class="filename">"Category"</span>,
|
|
choose <span class="filename">"Code Generation", </span>under<span class="filename"> "Use run-time library:"</span>,<span class="filename"> "Debug Single-Threaded"</span>
|
|
should appear. If it is blank inside this box, check if you highlight
|
|
some dll project files. Change <span class="filename">"Debug
|
|
Single-Threaded" </span>to<span class="filename">
|
|
"Debug Multithreaded" .</span></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">1. All of the dll project files
|
|
have "dll" at the end of their file names. </p>
|
|
|
|
<p class="note">2. Static project files don't have
|
|
"dll" at the end of their file names. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>5. Go back to <a href="#step1_4_section2">Section
|
|
II, Step 1 (4)</a>, continue to build and test HDF5 library. </h4>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section8">Go
|
|
to TOP Section VIII</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section9">Section IX: Building and
|
|
testing HDF5 snapshot release</a></h2>
|
|
|
|
<hr class="second">
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">This section is only for users who
|
|
would like to build and test HDF5 snapshot release.</p>
|
|
|
|
<h3><a name="step1_section9">Step I: Generate
|
|
H5Tinit.c using Microsoft Visual C++ 6.0</a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<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 successfully created by other compilers. </p>
|
|
|
|
<h4>1. <a href="##step1_section2" name="prevstep_section9">Previous step: section II, step 1(1)</a><a href="#step1_section2">.</a></h4>
|
|
|
|
<h4>2. Extra steps:</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>1) Open
|
|
c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. </li>
|
|
|
|
<li>2) Build the project file. </li>
|
|
|
|
<li>3) Invoke command prompt and go to
|
|
c:\myHDFstuff\hdf5\src. </li>
|
|
|
|
<li>4) type H5Tinit.exe >H5Tinit.c </li>
|
|
|
|
<li>5) Go back to section II, continue with <a href="#step1_2_section2">step 1(2).</a></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3><a name="step2_section9">Step II: Generate
|
|
H5f90i_gen.h and H5fortran_types.f90 using Compaq Fortran 6.6c</a></h3>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">The users who don't want to build
|
|
fortran library can skip this step.</p>
|
|
|
|
<p class="note">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"> 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 successfully by other compilers. </p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1. Previous step: <a href="#step1_section1">section
|
|
II, step 1(1)</a></h4>
|
|
|
|
<h4>2. Extra Steps:</h4>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>1)Follow the steps in <a href="#step1_section9">Step
|
|
I to generate H5Tinit.c.</a></li>
|
|
|
|
<li>2) Open <span class="filename">H5fortran_detect_gen.dsw</span>
|
|
under directory <span class="filename">c:\myHDFstuff\hdf5\windows\misc\H5fortran_detect_gen</span>
|
|
Build the project file.</li>
|
|
|
|
<li>3) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src</span>.</li>
|
|
|
|
<li>type</li>
|
|
|
|
<li><span class="filename">H5fortran_detect_gen.exe
|
|
> H5fortran_detect.f90</span></li>
|
|
|
|
<li>4) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\fortrantypegen\fortrantypegen.dsw.</span>
|
|
Build the project file.</li>
|
|
|
|
<li>5) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src.</span></li>
|
|
|
|
<li>type</li>
|
|
|
|
<li><span class="filename">H5fortran_detect.exe
|
|
> H5fort_type_defines.h</span></li>
|
|
|
|
<li>6) Open <span class="filename">c:\myHDFstuff\hdf5\windows\misc\matchtypegen\matchtypegen.dsw</span>.
|
|
Build the project file.</li>
|
|
|
|
<li>7) Invoke command prompt and go to <span class="filename">c:\myHDFstuff\hdf5\fortran\src.</span></li>
|
|
|
|
<li>type</li>
|
|
|
|
<li><span class="filename">H5match_types.exe</span></li>
|
|
|
|
<li>This step will generate <span class="filename">H5f90i_gen.h
|
|
</span> and<span class="filename">
|
|
H5fortran_types.f90</span> automatically.</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3> Step III: Go back to <a href="#section1_3.2">section
|
|
II, step1(3.2)</a></h3>
|
|
|
|
<p class="right"><a href="#section9">Go
|
|
to TOP Section IX</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<p class="right"> </p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section10">Section X: How to build
|
|
HDF5 with Thread-Safe Feature</a></h2>
|
|
|
|
<hr class="second">
|
|
<h3>Preconditions:</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h5>1. All of the Preconditions in <a href="#preconditions">Preconditions</a>.</h5>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2. Pthread-Win32 Installed</h5>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="notes">Posix Threads for Windows is a
|
|
open source free software. Users can download it from <a href="http://sources.redhat.com/pthreads-win32/">http://sources.redhat.com/pthreads-win32/</a>.</p>
|
|
|
|
</li>
|
|
|
|
<li>HDF5 release 1.8.0 supports Pthread-Win32 2.7.0
|
|
(2005-06-04) or later. Since pthreadVC2.dll used by HDF5 1.8.0 is the
|
|
release version dll of pthread-win32, ONLY HDF5 1.8.0 release dll are
|
|
supported and tested on Windows XP. </li>
|
|
|
|
<li>
|
|
<h5>3. Set Path for Pthread-Win32 header and library</h5>
|
|
|
|
</li>
|
|
|
|
<li>Invoke Microsoft Visual C++ 6.0, go to <span class="filename">Tools->Options->Directories</span>.
|
|
</li>
|
|
|
|
<li>From the drop-down box under <span class="filename">"Show
|
|
directories for:"</span>
|
|
<ul class="normal">
|
|
|
|
<li>Choose <span class="filename">"Include
|
|
files"</span>, add in the path to Pthread-Win32 header file(For
|
|
example: <span class="filename"> C:\PTHREADS_WIN32\INCLUDE</span>).
|
|
</li>
|
|
|
|
<li>Choose <span class="filename">"Library
|
|
files"</span>, add in the path to Pthread-Winew library (For
|
|
example: <span class="filename">C:\PTHREADS_WIN32\LIB</span>).
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li> </li>
|
|
|
|
<li>
|
|
<h5>4. Enable HDF5 Thread-safe Feature on Windows</h5>
|
|
|
|
</li>
|
|
|
|
<li>Go to directory <span class="filename">c:\MYHDFstuff\hdf5\windows\src</span>,
|
|
open <span class="filename"> H5pubconf.h</span> and
|
|
find the following messages and remove those comment signs referred to
|
|
by those two arrows and save <span class="filename">H5pubconf.h.</span></li>
|
|
|
|
<li>
|
|
<p class="insmes">/*Users want to build and test
|
|
hdf5 library with thread safe enabled,<br>
|
|
|
|
Make the following block active<br>
|
|
|
|
*/</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">/* <---- </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#if defined _DLL</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#define H5_HAVE_THREADSAFE 1</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#define
|
|
H5_HAVE_SYSTEM_SCOPE_THREADS 1</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#if defined TTSAFE_H</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#define sleep Sleep</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#endif</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">#endif </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">*/ <----</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h5>5. Define Environment Variable(HDF5_EXT_PTHREAD) for
|
|
PthreadVC2.lib </h5>
|
|
|
|
</li>
|
|
|
|
<li>To define this environment variable: <span class="filename">Click "Start" -> "Control Panel"
|
|
-> "System" -> "Advanced" -> "Environment
|
|
Variables"</span>.</li>
|
|
|
|
<li> If you are logged on as administrator to the
|
|
local computer AND want to let all other users use these two
|
|
environment variables, click <span class="filename"> "New"</span>
|
|
under <span class="filename">"System Variables" </span>box;
|
|
otherwise, click <span class="filename">"New"</span>
|
|
under <span class="filename"> "User Variables"</span>
|
|
box. In the New Variable window, set </li>
|
|
|
|
<li> <span class="filename">"Variable name"</span>
|
|
as <span class="filename"> HDF5_EXT_PTHREAD</span> </li>
|
|
|
|
<li> <span class="filename">"Variable
|
|
value"</span> as <span class="filename">
|
|
pthreadVC2.lib</span></li>
|
|
|
|
<li>click OK. </li>
|
|
|
|
<li>
|
|
<h5>6. Copy pthreadVC2.dll to System Directory</h5>
|
|
|
|
</li>
|
|
|
|
<li> <span class="filename">pthreadVC2.dll</span>
|
|
should be copied into the location that applications can find. One
|
|
suggestion is to use the <span class="filename">c:\WINDOWS\system</span>.
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p></p>
|
|
|
|
<h3>1. Build HDF5 Release DLL with Thread-safe Feature</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h5>1.1 Run batch file copy_hdf.bat</h5>
|
|
|
|
</li>
|
|
|
|
<li> Go to <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
and run <span class="filename">copy_hdf.bat</span>.
|
|
This process will copy all the necessary batch files,windows specific
|
|
source codes and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
directory to the corresponding directories under <span class="filename">hdf5</span>. </li>
|
|
|
|
<li>
|
|
<h5>1.2 Open workspace all.dsw</h5>
|
|
|
|
</li>
|
|
|
|
<li>Invoke Microsoft Visual C++ compiler Invoke Microsoft
|
|
Visual C++. </li>
|
|
|
|
<li>From the main menu, go to <span class="filename">"File"
|
|
-> "Open Workspace", </span> browse and open the <span class="filename">c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw</span>
|
|
workspace. </li>
|
|
|
|
<li>
|
|
<h5>1.3 Add in Thread-safe Source Code for HDF5 Library.</h5>
|
|
|
|
</li>
|
|
|
|
<li>Expand project<span class="filename">
|
|
"hdf5dll"</span>, right click on <span class="filename">"source"
|
|
-> "Add Files to Folder..."</span>, browse to add in file <span class="filename">"c:\MYHDFSTUFF\hdf5\src\H5TS.c" </span>
|
|
</li>
|
|
|
|
<li>
|
|
<h5>1.4 Add Link to pthreadVC2.lib </h5>
|
|
|
|
</li>
|
|
|
|
<li>Right click on project <span class="filename">"hdf5dll"</span>,
|
|
choose "<span class="filename">Set as Active Project</span>".
|
|
</li>
|
|
|
|
<li>Go to <span class="filename">"Project"
|
|
-> "Setting</span>",</li>
|
|
|
|
<li>On the left pane, choose <span class="filename">"Win32
|
|
Release"</span> to the right of <span class="filename">"Settings
|
|
For:" </span> </li>
|
|
|
|
<li>On the right pane, choose <span class="filename">"Link"</span>,
|
|
choose <span class="filename"> "Input" </span>from
|
|
the drop-down box to the right of <span class="filename">
|
|
"Category:"</span> Under <span class="filename">"Object/library
|
|
modules:"</span>, add in "<span class="filename">$(HDF5_EXT_PTHREAD)</span>"
|
|
(No quotation marks). </li>
|
|
|
|
<li>Click on <span class="filename">"OK"</span>.
|
|
</li>
|
|
|
|
<li>
|
|
<h5>1.5 Set Project Active Configurations</h5>
|
|
|
|
</li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Set Active Configuration"</span>, choose <span class="filename">"hdf5dll-Win32 Release"</span> under <span class="filename">"Project configurations:"</span>,
|
|
Click <span class="filename">"OK".</span> </li>
|
|
|
|
<li>
|
|
<h5>1.6 Build HDF5 Release DLL with Thread-safe Feature</h5>
|
|
|
|
</li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Build hdf5dll.dll"</span> to build HDF5 Release DLL
|
|
with thread-safe feature. Warning messages can be ignored. But there
|
|
should be no failures at all. </li>
|
|
|
|
</ul>
|
|
|
|
<h3>2. Test Thread-safe Feature of HDF5 Release DLL</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h5>2.1 Build Release Version of Project libtestD</h5>
|
|
|
|
</li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Set Active Configuration"</span>, choose <span class="filename">"libtestD-Win32 Release"</span> under
|
|
<span class="filename">"Project configurations:"</span>,
|
|
Click <span class="filename">"OK"</span>. </li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Build libtestD.dll"</span> to build release
|
|
version of Project <span class="filename">libtestD</span>.
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.2 Build Release Version of Project ttsafedll</h5>
|
|
|
|
</li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Set Active Configuration"</span>,, choose <span class="filename">"ttsafedll-Win32 Release"</span>
|
|
under <span class="filename">"Project configurations:"</span>,
|
|
Click <span class="filename">"OK"</span>. </li>
|
|
|
|
<li>Go to <span class="filename">"Build"
|
|
-> "Build ttsafedll.exe"</span> to build release version
|
|
of Project <span class="filename">ttsafedll.exe</span>.
|
|
</li>
|
|
|
|
<li>
|
|
<h5>2.3 Install hdf5dll.dll</h5>
|
|
|
|
</li>
|
|
|
|
<li>Invoke a comand prompt, change directory to <span class="filename">c:\MYHDFSTUFF\hdf5</span>, run batch
|
|
file <span class="filename">install_dll.bat </span>to
|
|
copy <span class="filename">c:\MYHDFSTUFF\hdf5\proj\hdf5dll\release\hdf5dll.dll</span>
|
|
into system directory. </li>
|
|
|
|
<li>
|
|
<h5>2.4 Test Thread-safe Feature of HDF5 Release DLL</h5>
|
|
|
|
</li>
|
|
|
|
<li>Set project file <span class="filename">ttsafedll.dsp</span>
|
|
as the active project file if it is not. Go to <span class="filename">"Build" -> "Execute ttsafedll.exe"</span>,
|
|
the following is the test messages users should get: </li>
|
|
|
|
<li>
|
|
<p class="insmes">For help use: ttsafedll.exe -help</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Linked with hdf5 version 1.7
|
|
release 51 </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Testing -- multi-dataset
|
|
creation (dcreate) </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Testing -- per-thread error
|
|
stacks (error) </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Testing -- thread cancellation
|
|
safety test (cancel) </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Testing -- multi-attribute
|
|
creation (acreate) </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">All tests were successful. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="insmes">Cleaning Up temp files... </p>
|
|
|
|
</li>
|
|
|
|
<li>Users who got the similar messages as above have
|
|
successfully built the release version of hdf5dll.dll. </li>
|
|
|
|
</ul>
|
|
|
|
<h3>3. Build, Test and Install HDF5 Library and Tools</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>Go back to <a href="#step1_2_section2">Section
|
|
II, Step I(2)</a> to Build, test and install HDF5 libary and
|
|
tools.
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section10">Go
|
|
to TOP Section X</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<p class="right"> </p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section11">Section XI: How to build
|
|
HDF5 in Visual studio 2005 on windows 32-bit and 64-bit platform</a></h2>
|
|
|
|
<hr class="second">
|
|
<p class="note">Notes:</p>
|
|
|
|
<p class="note">The building procedure is almost the
|
|
same as
|
|
building HDF5 on .Net 2003. </p>
|
|
|
|
<p class="note">For 64-bit, currently we only support
|
|
HDF5 as an 32-bit application and
|
|
you may need to pay attention to the following reminders: </p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>1. To use zlib or szlib compression packages:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>Use zlib 1.2.2 DLL provided at <a href="ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz">ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz</a></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Use szlib 2.0 DLL provided at <a href="ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/xp-net">ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/xp-net</a></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>2. Make sure that WIN32 macro is set at visual studio
|
|
2005. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>3. You may use _CRT_SECURE_NO_DEPRECATE to disable the
|
|
warnings. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h4>
|
|
<p>Please refer to <a href="#section6">Section
|
|
VI: How to build HDF5 in Visual
|
|
Studio .Net 2003</a>.</p>
|
|
|
|
<p>Please also note that the example workspace may not work
|
|
properly. You
|
|
may need to reset hdf5 library path.</p>
|
|
|
|
</h4>
|
|
|
|
<p class="right"><a href="#section11">Go
|
|
to TOP Section XI</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<p class="right"> </p>
|
|
|
|
<hr class="second">
|
|
<h2><a name="section12">Section XII: Misc.</a></h2>
|
|
|
|
<hr class="second">
|
|
<h3>1. Drivers We Support</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<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 <span class="filename">HDF5_DRIVER</span> to <span class="filename">"stdio"</span>.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>On windows XP, the following steps should be followed
|
|
to set the environment variable.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>a) Go to Control panel and find <span class="filename">"system"</span>, </li>
|
|
|
|
<li>b) Click <span class="filename">"system"</span>
|
|
and choose <span class="filename">"advanced"</span>,
|
|
</li>
|
|
|
|
<li>c) Choose <span class="filename">Environment
|
|
Variables</span></li>
|
|
|
|
<li>d) Add new variable <span class="filename">"HDF5_DRIVER"</span></li>
|
|
|
|
<li>e) set the <span class="filename">"HDF5_DRIVER"</span>
|
|
to <span class="filename">"stdio"</span></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">Reminder:</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p class="note">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>
|
|
|
|
<h3>2. <a name="section11_pointers"> Helpful
|
|
Pointers</a></h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>Here are some notes that may be of help if you are not
|
|
familiar with using the Visual C++ Development Environment.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h3>2.1 Project name and location issues: </h3>
|
|
|
|
</li>
|
|
|
|
<li>If you must install <span class="filename">all.dsw</span>
|
|
and <span class="filename">all.dsp</span> in
|
|
another directory, relative to <span class="filename">hdf5</span>
|
|
directory, you will be asked to locate the sub-project files, when you
|
|
open the project <span class="filename">all.dsw.</span>
|
|
</li>
|
|
|
|
<li>If you want to rename all (the entire project), you
|
|
will need to modify two files <span class="filename">all.dsw</span>
|
|
and <span class="filename">all.dsp</span> as text
|
|
(contrary to
|
|
the explicit warnings in the files). </li>
|
|
|
|
<li>You can also modify <span class="filename">all.dsw</span>
|
|
and <span class="filename">all.dsp</span> as
|
|
text, to allow these two files to be installed in another directory. </li>
|
|
|
|
<li>
|
|
<h3>2.2 Settings... details:</h3>
|
|
|
|
</li>
|
|
|
|
<li>If you create your own project, the necessary settings
|
|
can be read from the <span class="filename">all.dsp</span>
|
|
file(as text), or from the Project Settings in the Developer Studio
|
|
project settings dialog. </li>
|
|
|
|
<li>Project</li>
|
|
|
|
<li> Settings</li>
|
|
|
|
<li>
|
|
C/C++</li>
|
|
|
|
<li>
|
|
Category</li>
|
|
|
|
<li>
|
|
Code Generation</li>
|
|
|
|
<li>
|
|
Use run-time Library</li>
|
|
|
|
<li>These are all set to use Single-Threaded</li>
|
|
|
|
<li>
|
|
<h3>2.3 <a name="dll_hints_section4">DLL...
|
|
hints:</a></h3>
|
|
|
|
</li>
|
|
|
|
<li>If you want to use DLL versions of HDF5 library in your
|
|
application, you should
|
|
<ol>
|
|
|
|
<li>
|
|
<p>Put HDF5 DLL into windows system directory</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Add HDF5 DLL export library into your project</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Follow <span class="filename">"Settings...
|
|
details"</span> into the last line: change <span class="filename">Single-Threaded </span>into <span class="filename">Multithreaded DLL</span> or <span class="filename">Debug Multithreaded DLL</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Follow <span class="filename">"Settings..
|
|
details</span>" into PreProcessor:</p>
|
|
|
|
<p></p>
|
|
|
|
<p>Project</p>
|
|
|
|
<p> Settings</p>
|
|
|
|
<p>
|
|
C/C++</p>
|
|
|
|
<p>
|
|
Category</p>
|
|
|
|
<p>
|
|
PreProcessor</p>
|
|
|
|
<p>Find <span class="filename">PreProcessor
|
|
definations</span> and <span class="filename">Add
|
|
_HDF5USEDLL_</span> at the end of the PreProcessor definitions to
|
|
use HDF5 C DLL.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(optional) Repeat 4), add <span class="filename">HDF5CPP_USEDLL</span> at the end of
|
|
the PreProcessor definitions to use HDF5 C++ DLL.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(optional) Follow
|
|
Project->Settings->Fortran->Category->General->Predefined
|
|
Preprocess or Symbols, and add <span class="filename">"HDF5F90_WINDOWS"</span>
|
|
to use HDF5 Fortran DLL.</p>
|
|
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>3. Backward compatibility with 1.6</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>If you are going to use 1.6 APIs with 1.8 branch, you may
|
|
do the following two things:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>3.1 Uncomment out /*#define H5_WANT_H5_V1_6_COMPAT
|
|
1*/
|
|
inside h5pubconf.h under windows\src.</h4>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>3.2 Set up an environment variable
|
|
H5_WANT_H5_V1_6_COMPAT to 1, this will be used to test compatibility
|
|
of error APIs.</h4>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>Remember to undo 1 and 2 after you test if you are not
|
|
going to use 1.6 backward compatibility option.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="right"><a href="#section12">Go to
|
|
TOP Section XII</a></p>
|
|
|
|
<p class="right"><a href="#content_table">Go
|
|
to Table of Contents</a></p>
|
|
|
|
<hr class="first">
|
|
<h4>Need further assistance? email to <a href="mailto:help@hdfgroup.org">help@hdfgroup.org</a>
|
|
or go to <a href="http://hdfgroup.org/windows/">http://hdfgroup.org/windows/questions</a>
|
|
to get help on Windows</h4>
|
|
|
|
<h4 style="background-color: green; color: white; text-align: center; letter-spacing: 5px;">Thank
|
|
you for using Hierarchical
|
|
Data Format (HDF)</h4>
|
|
|
|
<p> </p>
|
|
|
|
<p> </p>
|
|
|
|
<h3></h3>
|
|
|
|
<h4></h4>
|
|
|
|
<h4></h4>
|
|
|
|
</body>
|
|
</html>
|