mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-18 15:15:56 +08:00
788 lines
14 KiB
HTML
Executable File
788 lines
14 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>HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003</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>HDF5 Build and Install Instructions for Windows XP with MSVS
|
|
.NET 2003</h1>
|
|
|
|
|
|
<h1>(Short Version)</h1>
|
|
|
|
|
|
<hr class="first">
|
|
<p class="note">Notes:</p>
|
|
|
|
|
|
<p>1. This short instruction is written for users who want to
|
|
quickly build HDF5 library and tools from the HDF5 source code package
|
|
with Microsoft Visual Studio .NET 2003 but do not want to know HDF5
|
|
building and installation details on Windows XP.</p>
|
|
|
|
|
|
<p>2. For detailed HDF5 build and install information, or if you
|
|
have trouble following any steps in the instructions, please refer to
|
|
INSTALL_Windows.html for further information.</p>
|
|
|
|
|
|
<p>3. For users who would like to build and test HDF5 package
|
|
from the command line, please refer to
|
|
INSATLL_Windows_From_Command_Line.txt.</p>
|
|
|
|
|
|
<p>4. For .Net and Intel users, If you are not in
|
|
building HDF5 with Thread-Safe Feature, ttsafedll.dsp should always be turned
|
|
off.</p>
|
|
|
|
|
|
<p class="note">Warnings: Please read CAREFULLY about <a href="http://hdfgroup.org/windows/INSTALL_Windows.html#preconditions" target="_blank">
|
|
HDF5 build and install preconditions and notes</a> before
|
|
starting below procedures.</p>
|
|
|
|
|
|
<hr class="second">
|
|
<h2>Preconditions:</h2>
|
|
|
|
|
|
<hr class="second">
|
|
<h3>a. Setup path Visual Studio .Net 2003 Compiler. </h3>
|
|
|
|
|
|
<p> Open "System" in Control Panel.</p>
|
|
|
|
|
|
<p>On the "Advanced" tab, click "Environment Variables", click
|
|
"Path" in the "System variables" box, then click "Edit" and add your
|
|
Visual C++ .Net path (For example, C:\Program Files\Microsoft Visual
|
|
Studio .NET 2003\Common7\IDE) into "Variable Value" and click "OK". </p>
|
|
|
|
|
|
<h3>b. Set up path for external libraries and headers</h3>
|
|
|
|
|
|
<p>Skip this part if you don't want to use ANY compression
|
|
features provided by HDF5. Read <a href="http://hdfgroup.org/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_WINDOWS.html</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="http://hdfgroup.org/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_WINDOWS.html</a>
|
|
. </p>
|
|
|
|
|
|
<p>Invoke Microsoft Visual C++ .Net and go to "Tools" and select
|
|
"Options". In the left pane of "Option" window poped up, choose and
|
|
extend "Projects", Click on "VC++ Directories". In the right pane, Find
|
|
the box "Show directories for", choose "Include files", if you can not
|
|
find your Zlib and Szip header path (for example, c:\zlib122\include,
|
|
c:\szip\include) from the directory list, add the header path
|
|
(c:\zlib122\include, c:\szip\include) to the included directories. </p>
|
|
|
|
|
|
<p>Find the box "Show directories for", choose "Library files",
|
|
If you cannot find your Zlib and Szip library path (for example,
|
|
c:\zlib122\lib, c:\szip\dll) from the directory list, add the library
|
|
path (c:\zlib122\lib, c:\szip\dll) to the library directories. </p>
|
|
|
|
|
|
<hr class="second">
|
|
<h2>STEP 1: Building HDF5 Libraries and Tools</h2>
|
|
|
|
|
|
<hr class="second">
|
|
<h3>1. Open all.dsw workspace</h3>
|
|
|
|
|
|
<p class="note">Notes:</p>
|
|
|
|
|
|
<p>Notes: all.sln is for command use only. Please open all.dsw
|
|
not all.sln.</p>
|
|
|
|
|
|
<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, chooise "Yes To All" to convert all project files to Visual C++
|
|
.Net project format.</p>
|
|
|
|
|
|
<h3>2. Building HDF5 C and C++ Libraries </h3>
|
|
|
|
|
|
<p>Users can choose the desirable libraries to be built according
|
|
to the following describtion.</p>
|
|
|
|
|
|
<ul class="intable">
|
|
|
|
|
|
<li>
|
|
|
|
<h4>2.1 If you don't want to build HDF5 C++ Libraries</h4>
|
|
|
|
|
|
|
|
<p>Go to "Build" and select "Configuration Manager". Choose
|
|
"Release" or "Debug" under "Active Solution Configuration"</p>
|
|
|
|
|
|
|
|
<p>Disable the following projects:</p>
|
|
|
|
|
|
|
|
<ul class="normal">
|
|
|
|
|
|
<li>dsets_cpp </li>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
<p>Click on "OK", From the main menu, choose "Build"->
|
|
"Build" or "Rebuild ALL" to build both release and debug version of
|
|
HDF5 Libraries. </p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
<h4>2.2 If you don't want to build HDF5 Fortran Libraries</h4>
|
|
|
|
|
|
|
|
<p>Go to "Build" and select "Configuration Manager". Choose
|
|
"Release" or "Debug" under "Active Solution Configuration" </p>
|
|
|
|
|
|
|
|
<p>Disable the following projects:</p>
|
|
|
|
|
|
|
|
<ul class="normal">
|
|
|
|
|
|
<li>flush1_fortran </li>
|
|
|
|
|
|
<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>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>libtest_cstubdll </li>
|
|
|
|
|
|
<li>libtest_fortran </li>
|
|
|
|
|
|
<li>libtest_fortrandll </li>
|
|
|
|
|
|
<li>testhdf5_fortran </li>
|
|
|
|
|
|
<li>testhdf5_fortrandll</li>
|
|
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<p>Click on "OK", From the main menu, choose "Build"->
|
|
"Build" or "Rebuild ALL" to build both release and debug version of
|
|
HDF5 Libraries. </p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
<h4>2.3 If you don't want to build HDF5 High-Level Libraries</h4>
|
|
|
|
|
|
|
|
<p>Go to "Build" and select "Configuration Manager". Choose
|
|
"Release" or "Debug" under "Active Solution Configuration" </p>
|
|
|
|
|
|
|
|
<p>Disable the following projects:</p>
|
|
|
|
|
|
|
|
<ul class="normal">
|
|
|
|
|
|
<li>hdf5_hl </li>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
<p>Click on "OK", From the main menu, choose "Build"->
|
|
"Build" or "Rebuild ALL" to build both release and debug version of
|
|
HDF5 Libraries. </p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
<h4>2.4 If you don't want to build HDF5 C++
|
|
High-Level Libraries</h4>
|
|
|
|
|
|
|
|
<p>Go to "Build" and select "Configuration Manager". Choose
|
|
"Release" or "Debug" under "Active Solution Configuration" </p>
|
|
|
|
|
|
|
|
<p>Disable the following projects:</p>
|
|
|
|
|
|
|
|
<ul class="normal">
|
|
|
|
|
|
<li>hdf5_hl_cpp </li>
|
|
|
|
|
|
<li>hdf5_hl_cppdll</li>
|
|
|
|
|
|
<li>hl_test_table_cpp</li>
|
|
|
|
|
|
<li>hl_test_table_cppdll</li>
|
|
|
|
|
|
<li>ttsafedll</li>
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<p>Click on "OK", From the main menu, choose "Build"->
|
|
"Build" or "Rebuild ALL" to build both release and debug version of
|
|
HDF5 Libraries. </p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
<h4>2.5 If you don't want to build HDF5 Fortran High-Level
|
|
Libraries</h4>
|
|
|
|
|
|
|
|
<p>Go to "Build" and select "Configuration Manager". Choose
|
|
"Release" or "Debug" under "Active Solution Configuration".</p>
|
|
|
|
|
|
|
|
<p>Disable the following projects:</p>
|
|
|
|
|
|
|
|
<ul class="normal">
|
|
|
|
|
|
<li>hdf5_hl_fortran </li>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
<p>Click on "OK", From the main menu, choose "Build"->
|
|
"Build" or "Rebuild ALL" to build both release and debug version of
|
|
HDF5 Libraries. </p>
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
<hr class="second">
|
|
<h2> STEP 2: Testing HDF5 Libraries and Tools </h2>
|
|
|
|
|
|
<hr class="second">
|
|
<p>HDF5 libraries and tools should be tested to make sure that
|
|
they were
|
|
built correctly.</p>
|
|
|
|
|
|
<p>HDF5 libraries and tools can be tested with hdf5check.bat
|
|
batch file in c:\MyHDFstuff\hdf5 directory.</p>
|
|
|
|
|
|
<p>hdf5check.bat has 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>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td>
|
|
|
|
<p>hdf5check enablefortran</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td>
|
|
|
|
<p>test HDF5 C/FORTRAN libraries and tools</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td>
|
|
|
|
<p>hdf5check enableall</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td>
|
|
|
|
<p>test HDF5 C/C++/FORTRAN libraries and tools</p>
|
|
|
|
|
|
</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>Check check_results.txt and there should be no failures at all.</p>
|
|
|
|
|
|
<p>If you want to test HDF5 libraries and tools one by one,
|
|
please refer to <a href="http://hdfgroup.org/windows/INSTALL_Windows.html#step2_section2" target="_blank">Section II, step 2 in INSTALL_Windows.html</a>.</p>
|
|
|
|
|
|
<hr class="second">
|
|
<p>Check check_results.txt and there should be no failures at all.</p>
|
|
|
|
|
|
<p>If you want to test HDF5 libraries and tools one by one,
|
|
please refer to <a href="http://hdfgroup.org/windows/INSTALL_Windows.html#step2_section2" target="_blank">Section II, step 2 in INSTALL_Windows.html</a>.</p>
|
|
|
|
|
|
<hr class="second">
|
|
<h2>STEP 3: Installing HDF5 Libraries</h2>
|
|
|
|
|
|
<hr class="second">
|
|
<p>Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to
|
|
install all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib
|
|
directory.</p>
|
|
|
|
|
|
<hr class="second">
|
|
<h2>STEP 4: Building HDF5 Examples (Optional)</h2>
|
|
|
|
|
|
<hr class="second">
|
|
<p>Please read <a href="http://hdfgroup.org/windows/INSTALL_Windows.html#step4_section2" target="_blank">section II, step 4 in INSTALL_Windows.html.</a></p>
|
|
|
|
|
|
<hr class="first">
|
|
<h4>Need further assistance? email to <a href="mailto:help@hdfgroup.org" style="text-decoration: none;">help@hdfgroup.org</a>
|
|
or go to <a href="http://hdfgroup.org/windows/questions.html" style="text-decoration: none;">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>
|
|
|
|
|
|
<p> </p>
|
|
|
|
|
|
</body>
|
|
</html>
|