1039 lines
26 KiB
HTML
Executable File
1039 lines
26 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">
|
|
<title>Instructions for Building and Testing HDF5 from Command
|
|
Line on Windows XP</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: 180%;
|
|
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: 160%;
|
|
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: 140%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-transform:capitalize;
|
|
margin-top:15
|
|
}
|
|
h4 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 120%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
margin-top:12
|
|
}
|
|
h5 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
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;
|
|
}
|
|
p.right{text-align:right;color:#A52A2A;}
|
|
p {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
}
|
|
p.center {text-align:center}
|
|
p.note{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
color:#FF0000
|
|
}
|
|
p.filename
|
|
{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
font-style:italic; color:#008000
|
|
text-align:center;
|
|
}
|
|
span.filename
|
|
{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 95%;
|
|
font-style:italic; color:#800000
|
|
}
|
|
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: 95%;
|
|
text-align:left;
|
|
padding:10;
|
|
}
|
|
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>Instructions for Building and Testing HDF5 on Windows XP </h1>
|
|
|
|
<h1>from Command Line </h1>
|
|
|
|
<hr class="first">
|
|
<p class="note">Notes:</p>
|
|
|
|
<p>1. This instruction is written for users who would like to
|
|
build HDF5 libraries and tools from the HDF5 source code package on
|
|
command line.
|
|
</p>
|
|
|
|
<p>2. Currently, we support:</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<p>(1) Building and testing HDF5 on command line with
|
|
Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(2) Building and testing HDF5 C and C++ Library on command
|
|
line with Microsoft Visual C++ .Net (2003)</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(3) Building and testing HDF5 C and C++ Library on command
|
|
line with Intel C++ Compiler 8.1 integration with Microsoft Visual C++
|
|
.Net 2003.</p>
|
|
|
|
<p>For all other Windows development tools, HDF5 should be
|
|
built in the development environment. Please refer to<span class="filename"> INSTALL_Windows.txt</span> for
|
|
detailed HDF5 building and installation information, or <span class="filename">INSTALL_Windows_short_*.txt</span>
|
|
for quick HDF5 building and installation instructions. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p>(4) Different compiler is using different batch files on
|
|
command line to build HDF5 Libraries.</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table style="border: thin solid blue;" border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Compiler Name</th>
|
|
|
|
<th colspan="2">Batch File 1</th>
|
|
|
|
<th>Batch File 2</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>MSVS 6.0</td>
|
|
|
|
<td colspan="2">hdf5bt.bat</td>
|
|
|
|
<td>hdf5build.bat</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>MSVS .Net</td>
|
|
|
|
<td colspan="2">hdf5bt_net.bat</td>
|
|
|
|
<td>hdf5build_net.bat</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>Intel C++ </td>
|
|
|
|
<td colspan="2">hdf5bt_intelc.bat</td>
|
|
|
|
<td>hdf5build_intelc.bat</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Be careful to choose the corresponding batch file when you
|
|
choose a procedure below to build HDF5 Libraries.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p class="note">3. Please read CAREFULLY about HDF5 build
|
|
and install preconditions and notes in <span class="filename">INSTALL_Windows.txt</span>
|
|
before starting below procedures. </p>
|
|
|
|
<hr class="second">
|
|
<h2>Section I: Building and testing HDF5 with Microsoft Visual
|
|
C++ 6.0 and Compaq Visual Fortran 6.0.</h2>
|
|
|
|
<hr class="second">
|
|
<h3>1. Preconditions: </h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1.1 Set path for Visual C++ 6.0 and Compaq Visual Fortran
|
|
6.0</h4>
|
|
|
|
<p>Open <span class="filename">"System"</span>
|
|
in Control Panel.</p>
|
|
|
|
<p>On the <span class="filename">"Advanced"</span>
|
|
tab, click <span class="filename">"Environment
|
|
Variables", </span> click <span class="filename">"Path"
|
|
</span>in the <span class="filename">"System
|
|
variables" </span>box, then click<span class="filename">
|
|
"Edit"</span> and add your Visual C++ 6.0 path (For example, <span class="filename">C:\Program Files\Microsoft Visual
|
|
Studio\Common\MSDev98\Bin\</span>) and Compaq Visual Fortran 6.0
|
|
path (For example, <span class="filename">C:\Program
|
|
Files\Microsoft Visual Studio\Common\MSDev98\Bin\) </span>into<span class="filename"> "Variable Value" </span>and click<span class="filename"> "OK".</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.2 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> </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>2. Building and testing HDF5 libraries and tools</h3>
|
|
|
|
<p>We provide 2 options for users to build test HDF5 libraries
|
|
and tools.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>2.1 Options A: Build and test in one step</h4>
|
|
|
|
<p>A batch file named <span class="filename">hdf5bt.bat
|
|
</span>in<span class="filename">
|
|
c:\MyHDFstuff\hdf5</span> directory is provided for users to
|
|
build and test HDF5 library and tools together from command line. </p>
|
|
|
|
<p><span class="filename">hdf5bt.bat</span>
|
|
has four options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt</td>
|
|
|
|
<td>build and test C library and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt enablecpp</td>
|
|
|
|
<td>build and test C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt enablefortran</td>
|
|
|
|
<td>build and test C/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt enableall</td>
|
|
|
|
<td>build and test C/C++/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run hdf5bt with
|
|
appropriate options.</p>
|
|
|
|
<p>Test results are saved in two files:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\hdf5_results.txt </li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\tests_results.txt.</li>
|
|
|
|
</ul>
|
|
|
|
<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">hdf5_results.txt</span>.
|
|
If some tests failed, check <span class="filename">hdf5_results.tx</span>t
|
|
can help you figure out what was wrong.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2 Options B: Build and test in two steps</h4>
|
|
|
|
<p>We also provide users with the option to build and test
|
|
HDF5 libraries and tools separately.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>Step 1) Build HDF5 Libraries and Tools</h4>
|
|
|
|
<p>A batch file named <span class="filename">hdf5build.bat
|
|
</span>in<span class="filename">
|
|
c:\MyHDFstuff\hdf5</span> directory is provided for users to
|
|
build HDF5 library and tools from command line.</p>
|
|
|
|
<p><span class="filename">hdf5build.bat</span>
|
|
has four options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build</td>
|
|
|
|
<td>build C library and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build enablecpp</td>
|
|
|
|
<td>build C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build enablefortran</td>
|
|
|
|
<td>build C/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build enableall</td>
|
|
|
|
<td>build C/C++/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run hdf5build with
|
|
appropriate options. Compiling outputs are saved in <span class="filename">c:\MyHDFstuff\hdf5\build_results.txt</span>.
|
|
You can check the file to find out whether there are any compilation
|
|
errors.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>Step 2) Test HDF5 Libraries and Tools</h4>
|
|
|
|
<p>A batch file named hdf5check.bat in <span class="filename">c:\MyHDFstuff\hdf5</span> directory
|
|
is provided for users to test HDF5 library and tools from command line.</p>
|
|
|
|
<p><span class="filename">hdf5check.bat</span>
|
|
has four options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check</td>
|
|
|
|
<td>test C library and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check enablecpp</td>
|
|
|
|
<td>test C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check enablefortran</td>
|
|
|
|
<td>test C/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check enableall</td>
|
|
|
|
<td>test C/C++/Fortran libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run hdf5check with
|
|
appropriate options.</p>
|
|
|
|
<p>Test results are saved into file:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\check_results.txt.</li>
|
|
|
|
</ul>
|
|
|
|
<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>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>3. Installing HDF5 Libraries</h3>
|
|
|
|
<p>Run the batch file <span class="filename">c:\MyHDFstuff\hdf5\installhdf5lib.bat</span>
|
|
to install all HDF5 libraries and tools into <span class="filename">c:\MyHDFstuff\hdf5\hdf5lib</span>
|
|
directory.</p>
|
|
|
|
<p>For further information, please refer to <span class="filename">INSTALL_WINDOWS.txt</span>.</p>
|
|
|
|
<hr class="second">
|
|
<h2>SECTION II: Building and testing HDF5 C and C++ Library
|
|
with Microsoft Visual C++ .Net 2003</h2>
|
|
|
|
<hr class="second">
|
|
<h3>1. Extra Preconditions:</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1.1 Microsoft Visual C++ .Net 2003 Installed</h4>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.2 Command-based script host (CScript.exe) installed</h4>
|
|
|
|
<p><span class="filename">Cscript.exe</span>
|
|
is a command-line version of the Windows Script Host. Users can check
|
|
windows system directory to make sure <span class="filename">Cscript.exe</span>
|
|
installed. <span class="filename">Cscript.exe </span>will
|
|
be used during converting project files from MSVS 6.0 Format to Visual
|
|
C++ .Net 2003 format from command line.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.3 Set path for Microsoft Visual C++ .Net</h4>
|
|
|
|
<p>Open "System" in Control Panel.</p>
|
|
|
|
<p>On the <span class="filename">"Advanced"</span>
|
|
tab, click <span class="filename">"Environment Variables"</span>,
|
|
click <span class="filename">"Path"</span> in the <span class="filename">"System variables"</span> box, then
|
|
click<span class="filename"> "Edit"</span> and add
|
|
your Visual C++ .Net path (For example, <span class="filename">C:\Program
|
|
Files\Microsoft Visual Studio .NET 2003\Common7\IDE) </span>into<span class="filename"> "Variable Value" </span>and click<span class="filename"> "OK".</span></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.4 Run batch file <span class="filename">copy_hdf.bat.</span></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 and text files
|
|
saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
directory to the directories where they will be used.</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>2. Building HDF5 C and C++ Libraries :</h3>
|
|
|
|
<p>We provide 2 options for users to build HDF5 libraries and
|
|
tools.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>2.1 Options A: Build and test in one step</h4>
|
|
|
|
<p>A batch file named <span class="filename">hdf5bt_net.bat</span>
|
|
in <span class="filename">c:\MyHDFstuff\hdf5</span>
|
|
directory is provided for users to build and test HDF5 library and
|
|
tools together from command line. </p>
|
|
|
|
<p><span class="filename">hdf5bt_net.bat</span>
|
|
has two options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt_net </td>
|
|
|
|
<td>build and test C libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt_net enablecpp</td>
|
|
|
|
<td>build and test C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run hdf5bt_net with
|
|
one of the options.</p>
|
|
|
|
<p>Test results are saved in two files:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>c:\MyHDFstuff\hdf5\hdf5_results_net.txt </li>
|
|
|
|
<li>c:\MyHDFstuff\hdf5\tests_results.txt.</li>
|
|
|
|
</ul>
|
|
|
|
<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">hdf5_results_net.txt</span>.
|
|
If some tests failed, check <span class="filename">hdf5_results_net.txt</span>
|
|
can help you figure out what was wrong.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2 Options B: Build and test in two steps</h4>
|
|
|
|
<p>We also provide users with the option to build and
|
|
test HDF5 libraries and tools separately.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>Step 1) Build HDF5 Libraries and Tools</h4>
|
|
|
|
<p>A batch file named hdf5build_net.bat in <span class="filename">c:\MyHDFstuff\hdf5</span> directory
|
|
is provided for users to build HDF5 library and tools from command line.</p>
|
|
|
|
<p> <span class="filename">hdf5build_net.bat</span>
|
|
has two options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build_net</td>
|
|
|
|
<td>build C libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build_net enablecpp</td>
|
|
|
|
<td>build C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run<span class="filename"> hdf5build_net </span>with one of
|
|
the options. building results will be saved in <span class="filename">c:\MyHDFstuff\hdf5\build_results_net.txt</span>.
|
|
You can check the file to find out whether there are any compilation
|
|
errors.</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>Step 2) Build HDF5 Libraries and Tools</h4>
|
|
|
|
<p>Go to directory, run batch file <span class="filename">hdf5check.bat</span> with the
|
|
following options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check</td>
|
|
|
|
<td>test HDF5 C library and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check enablecpp</td>
|
|
|
|
<td>test HDF5 C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p> <span class="filename">hdf5check.bat</span>
|
|
has ONLY TWO options listed above in this case.</p>
|
|
|
|
<p>Testing results will be saved in <span class="filename">c:\MyHDFstuff\hdf5\check_results.txt</span>.
|
|
There should be no failures at all. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>3. Installing HDF5 Libraries</h3>
|
|
|
|
<p>Run the batch file <span class="filename">c:\MyHDFstuff\hdf5\installhdf5lib.bat</span>
|
|
to install all HDF5 libraries and tools into<span class="filename">
|
|
c:\MyHDFstuff\hdf5\hdf5lib </span>directory.</p>
|
|
|
|
<hr class="second">
|
|
<h2>SECTION III: Building and testing HDF5 C and C++ Library
|
|
with Intel C++ Compiler 8.1 integration with Microsoft Visual C++ .Net
|
|
2003</h2>
|
|
|
|
<hr class="second">
|
|
<h3>1. Extra Preconditions:</h3>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>1.1 Set path for Microsoft Visual C++ .Net and Intel
|
|
C++ 8.1</h4>
|
|
|
|
<p>Open <span class="filename">"System"</span>
|
|
in Control Panel.</p>
|
|
|
|
<p>On the <span class="filename">"Advanced"</span>
|
|
tab, click <span class="filename">"Environment Variables"</span>,
|
|
click <span class="filename">"Path"</span> in the <span class="filename">"System variables"</span> box, then
|
|
click<span class="filename"> "Edit"</span>
|
|
and add your Visual C++ .Net path (For example, <span class="filename">C:\Program Files\Microsoft Visual Studio
|
|
.NET 2003\Common7\IDE</span>) and Intel C++ 8.1 path (For
|
|
example, <span class="filename">C:\Program
|
|
Files\Intel\CPP\Compiler80\Ia32\Bin</span>) into <span class="filename">"Variable Value" and click "OK"</span>.
|
|
</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>1.2 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 and text files saved under <span class="filename">c:\MyHDFstuff\hdf5\windows</span>
|
|
directory to the directories where they will be used. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>2. Building HDF5 C and C++ Libraries :</h3>
|
|
|
|
<p>We provide 2 options for users to build HDF5 libraries and
|
|
tools.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>2.1 Options A: Build and test in one step</h4>
|
|
|
|
<p>A batch file named <span class="filename">hdf5bt_intelc.bat
|
|
</span>in<span class="filename">
|
|
c:\MyHDFstuff\hdf5</span> directory is provided for users to
|
|
build and test HDF5 library and tools together from command line. </p>
|
|
|
|
<p><span class="filename">hdf5bt_intelc.bat</span>
|
|
has two options:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt_intelc</td>
|
|
|
|
<td>build and test C libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5bt_intelc enablecpp</td>
|
|
|
|
<td>build and test C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run hdf5bt_intelc
|
|
with one of the options.</p>
|
|
|
|
<p>Test results will be saved in two files:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\hdf5_results_intelc.txt
|
|
</span> </li>
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\tests_results.txt.</span></li>
|
|
|
|
</ul>
|
|
|
|
<p>Project conversion results from MSVS .Net format to
|
|
Intel C++ fomat will be saved in </p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li><span class="filename">c:\MyHDFstuff\hdf5\convert_intel.txt</span></li>
|
|
|
|
</ul>
|
|
|
|
<p>Check <span class="filename">convert_intel.txt</span>
|
|
to see if all of the project files have been converted successfully.
|
|
Conversion messages should look like:</p>
|
|
|
|
<ul class="normal">
|
|
|
|
<li>"projname.vcproj": has been converted from
|
|
Microsoft VC++ project system to the Intel C++ 8.x project system.</li>
|
|
|
|
</ul>
|
|
|
|
<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">hdf5_results_intelc.txt</span>.
|
|
If some tests failed, check <span class="filename">hdf5_results_intelc.txt</span>
|
|
can help you figure out what was wrong. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>2.2 Options B: Build and test in two steps </h4>
|
|
|
|
<p>We also provide users with the option to build and
|
|
test HDF5 libraries and tools separately.</p>
|
|
|
|
<ul class="intable">
|
|
|
|
<li>
|
|
<h4>Step 1) Build HDF5 Libraries and Tools</h4>
|
|
|
|
<p>A batch file named <span class="filename">hdf5build_intelc.bat
|
|
</span>in<span class="filename">
|
|
c:\MyHDFstuff\hdf5</span> directory is provided for users to
|
|
build HDF5 library and tools from command line. </p>
|
|
|
|
<p> <span class="filename">hdf5build_intelc.bat</span>
|
|
has only one option:</p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build_intelc</td>
|
|
|
|
<td>build C libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5build_intelc enablecpp</td>
|
|
|
|
<td>build C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p>Invoke a command prompt window and run <span class="filename">hdf5build_intelc</span> with this
|
|
option. Compiling outputs are saved in <span class="filename">c:\MyHDFstuff\hdf5\build_results_intelc.txt.</span>
|
|
You can check the file to find out whether there are any compiling
|
|
errors. </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<h4>Step 2) Testing HDF5 Libraries and Tools</h4>
|
|
|
|
<p>Go to directory, run batch file <span class="filename">hdf5check</span> with the following
|
|
options: </p>
|
|
|
|
<p> </p>
|
|
|
|
<div style="text-align: center;">
|
|
<table border="1">
|
|
|
|
<tbody>
|
|
|
|
<tr>
|
|
|
|
<th>Options</th>
|
|
|
|
<th>Illustration</th>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check</td>
|
|
|
|
<td>test HDF5 C library and tools</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td>hdf5check enablecpp</td>
|
|
|
|
<td>test HDF5 C/C++ libraries and tools</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
</div>
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
<p><span class="filename">hdf5check.bat</span>
|
|
has ONLY TWO options listed above in this case.</p>
|
|
|
|
<p>Testing results will be saved in c<span class="filename">:\MyHDFstuff\hdf5\check_results.txt</span>.
|
|
There should be no failures at all. </p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h3>3. Installing HDF5 Libraries</h3>
|
|
|
|
<p>Run the batch file <span class="filename">c:\MyHDFstuff\hdf5\installhdf5lib.bat</span>
|
|
to install all HDF5 libraries and tools into <span class="filename">c:\MyHDFstuff\hdf5\hdf5lib</span>
|
|
directory. </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/questions.html">http://hdfgroup.org/windows/questions.html</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>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</body>
|
|
</html>
|