mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-30 15:32:37 +08:00
ebda068f2e
Update copyrights.
Description:
Solution:
This should address almost all of the "simple" cases in the repository.
There's still work to do, but it's going to require actually thinking about
the files in question instead of just copying & pasting.
754 lines
34 KiB
HTML
Executable File
754 lines
34 KiB
HTML
Executable File
<HTML>
|
|
|
|
<!--
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* 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://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html. If you do not have *
|
|
* access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. *
|
|
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
-->
|
|
|
|
<HEAD>
|
|
<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><p>(2) Building and testing HDF5 C and C++ Library on command line with
|
|
Microsoft Visual C++ .Net (2003)</p>
|
|
<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><p>(4) Different compiler is using different batch files on command line
|
|
to build HDF5 Libraries.</p>
|
|
<div style="TEXT-ALIGN: center">
|
|
<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid">
|
|
<tr>
|
|
<th>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></TD>
|
|
</tr>
|
|
|
|
</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>Preconditions</h2>
|
|
<hr class="second" >
|
|
<h3>1. Add WinZip command line support (Optional)</h3>
|
|
<p>To use WinZip command line utility, you have to install WinZip 9.0 or higher version.</p>
|
|
<p>If you want to extract zip files on the command line, you should</p>
|
|
<ul class="intable">
|
|
<li><h4>1.1 Install WinZip command line support add-on 1.1</h4>
|
|
<p>Download WinZip command line support add-on 1.1 from <a href="http://www.winzip.com" target="_blank">http://www.winzip.com</a> and install it. </p> <li><h4>1.2 Add WinZip into environment path</h4> <p>Open
|
|
<span class="filename">"System"</span> in Control Panel.
|
|
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 WinZip path (For example <span class="filename">
|
|
C:\Program Files\WinZip) </span>into <span class="filename">"Variable
|
|
Value" </span>and click <span class="filename">"OK". </span> </p>
|
|
<p class="note">Notes:</p>
|
|
<p>You can also extract zip files from interactive WinZip
|
|
interface without the above two steps. </p>
|
|
</li>
|
|
</ul>
|
|
|
|
<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. Extra 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><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">
|
|
<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>
|
|
</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>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">
|
|
<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>
|
|
</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">
|
|
<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>
|
|
</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>
|
|
<li><h4>1.5 Convert project files format from MSVS 6.0 to MSVS .Net</h4>
|
|
<p>Go to directory <span class="filename">c:\MyHDFstuff\hdf5</span> and run
|
|
<span class="filename">convert_to_vcproj.bat</span> in the following format:</p>
|
|
<ul class="normal">
|
|
<li>convert_to_vcproj "Absolute path of directory hdf5" </li>
|
|
</ul>
|
|
<p>For example:</p>
|
|
<ul class="normal">
|
|
<li>convert_to_vcproj c:\MyHDFstuff\hdf5</li>
|
|
</ul>
|
|
<p>The converting results will be saved into file
|
|
<span class="filename">convert.log</span> under the directory
|
|
<span class="filename">c:\MyHDFstuff\hdf5</span>.
|
|
The messages should look like</p>
|
|
<ul class="normal">
|
|
<li>Converting: c:\MyHDFstuff\hdf5\windows\proj\all\all.dsp </li>
|
|
|
|
<li>New Project Name: c:\MyHDFstuff\\hdf5\windows\proj\all\all.vcproj</li>
|
|
</ul>
|
|
<p class="note">Notes:</p>
|
|
<p><span class="filename">all.sln</span> was provided with HDF5-1.8.0 Release. Users don't need
|
|
to convert the workspace from MSVS 6.0 format to MSVS .Net
|
|
Format
|
|
</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">
|
|
<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>
|
|
</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>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">
|
|
<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>
|
|
</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">
|
|
<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>
|
|
</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>
|
|
<li><h4>1.3 Convert project files format from MSVS 6.0 to MSVS .Net Format</h4>
|
|
<p>Go to directory <span class="filename">c:\MyHDFstuff\hdf5</span> and run
|
|
<span class="filename">convert_to_vcproj.bat</span>
|
|
in the following format:</p>
|
|
<ul class="normal">
|
|
<li>convert_to_vcproj "Absolute path of directory hdf5" </li>
|
|
</ul>
|
|
<p>For example:</p>
|
|
<ul class="normal">
|
|
<li>convert_to_vcproj c:\MyHDFstuff\hdf5</li>
|
|
</ul>
|
|
<p>The converting results will be saved into file
|
|
<span class="filename">convert.log </span>under
|
|
the directory<span class="filename"> c:\MyHDFstuff\hdf5</span>. The messages should look like</p>
|
|
<ul class="normal">
|
|
<li>Converting: c:\MyHDFstuff\hdf5\windows\proj\all\all.dsp </li>
|
|
|
|
<li>New Project Name: c:\MyHDFstuff\\hdf5\windows\proj\all\all.vcproj</li>
|
|
</ul>
|
|
</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">
|
|
<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>
|
|
</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><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">
|
|
<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>
|
|
</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> <div style="TEXT-ALIGN: center">
|
|
<table border="1">
|
|
<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>
|
|
</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:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</a> or go to
|
|
<a href="http://hdf.ncsa.uiuc.edu/windows/">http://hdf.ncsa.uiuc.edu/windows/questions</a> to get help on windows</h4>
|
|
<h4 style="background-color:green;color:white;text-align:center;letter-spacing:5;">Thank you for using Hierarchical Data Format (HDF)</h4>
|
|
<p> </p>
|
|
<p> </p>
|
|
</ul>
|
|
</BODY>
|
|
</HTML>
|