mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-30 15:32:37 +08:00
8896b02394
Add html format document for windows users. Description: Solution: Platforms tested: Misc. update:
239 lines
7.2 KiB
HTML
Executable File
239 lines
7.2 KiB
HTML
Executable File
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0">
|
|
<TITLE>HDF5 Build and Install Instructions for Windows XP with MSVS 6.0</TITLE>
|
|
<style type="text/css">
|
|
|
|
h1 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 180%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
}
|
|
h2 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 160%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-align:center;
|
|
text-transform:capitalize;
|
|
|
|
}
|
|
h3 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 140%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
text-transform:capitalize;
|
|
}
|
|
h4 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 120%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
}
|
|
h5 {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
font-style:bold;
|
|
color:#0000FF;
|
|
}
|
|
|
|
p.right{text-align:right;color:#A52A2A;}
|
|
p {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
|
|
}
|
|
p.note{
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
color:#FF0000
|
|
}
|
|
|
|
ul.normal
|
|
{
|
|
margin-left:10%;
|
|
list-style-type:none;
|
|
margin-bottom:15px;
|
|
}
|
|
ul.intable
|
|
{
|
|
text-align: left;
|
|
list-style-type:none;
|
|
}
|
|
td {font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 110%;
|
|
text-align:left;
|
|
padding:10;
|
|
}
|
|
a {text-decoration:none}
|
|
a:link {color:#0000FF;}
|
|
a:visited {color:purple;}
|
|
a:hover {background-color:#FAEBD7;}
|
|
table {
|
|
font-family:font-family:times, arial, 'lucida console', sans-serif;
|
|
font-size: 100%;
|
|
text-align:left;
|
|
border:thin solid blue;
|
|
}
|
|
|
|
body {
|
|
margin-left:5%;
|
|
margin-right:5%
|
|
}
|
|
hr.first {color:#0000FF; height:4px;width:100%;magin-top:10px;margin-bottom:10px;border:thick double blue;}
|
|
hr.second{color:#0000FF;height:2px; width:100%;magin-top:5px;margin-bottom:5px;border:thin dotted;}
|
|
|
|
</style>
|
|
</HEAD>
|
|
<BODY>
|
|
|
|
<h1>HDF5 Build and Install Instructions for Windows XP with MSVS 6.0</h1>
|
|
<p style="TEXT-ALIGN: center">(Short Version)</p>
|
|
<hr class="first" >
|
|
|
|
<p class="note">Notes:</p>
|
|
<p>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 6.0 but do not want to know HDF5
|
|
building and installation details on Windows XP.
|
|
</p>
|
|
<p>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>For users who would like to build and test HDF5 package from the
|
|
command line, please refer to
|
|
INSATLL_Windows_From_Command_Line.html.
|
|
</p>
|
|
<p class="note">Warnings: Please read CAREFULLY about HDF5 build and install preconditions and
|
|
notes in INSTALL_Windows.html before starting below procedures.</p>
|
|
<hr class="second" >
|
|
<h2>STEP 1: Building HDF5 Libraries and Tools</h2>
|
|
<hr class="second" >
|
|
|
|
<ul class="intable">
|
|
<li><h3>1. Run batch file copy_hdf.bat.</h3>
|
|
<p>Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. </p>
|
|
</li>
|
|
<li><h3>2. Open all.dsw workspace</h3>
|
|
<p class="note">Notes:</p>
|
|
<p>all.sln is for command line use ONLY. Please make sure open all.dsw not all.sln.</p>
|
|
<p>Open the c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw workspace. </p>
|
|
</li>
|
|
<li><h3>3. (Optional) Add C++ and/or FORTRAN related projects</h3>
|
|
<ul class="intable">
|
|
<li><h4>3.1 Add the following projects to project "all" dependencies
|
|
ONLY if you want to build HDF5 C++ libraries</h4>
|
|
<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>hl_test_table_cpp</li>
|
|
</ul>
|
|
<li><h4>3.2 Add the follwing projects to project "all" dependencies
|
|
ONLY if you want to build HDF5 FORTRAN libraries</h4>
|
|
<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>hl_test_image_fortran </li>
|
|
<li>hl_test_lite_fortran </li>
|
|
<li>hl_test_table_fortran </li>
|
|
<li>libtest_cstubdll </li>
|
|
<li>libtest_fortran </li>
|
|
<li>libtest_fortrandll </li>
|
|
<li>testhdf5_fortran </li>
|
|
<li>testhdf5_fortrandll</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><h3>4. Select "Build", then Select "Set Active Configuration".</h3>
|
|
<p>In "Project configurations", select the active configuration</p>
|
|
<p>"all -- Win32 Debug" or "all -- Win32 Release"</p>
|
|
<p>Then build project "all".</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 border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid">
|
|
<tr>
|
|
<th>Options</th>
|
|
<th>Illustration</th>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check</p></td>
|
|
<td><p>test HDF5 C library and tools only</p></td>
|
|
</tr>
|
|
<tr>
|
|
<td><p>hdf5check enablecpp</p></td>
|
|
<td><p>test HDF5 C/C++ libraries and tools.</p>
|
|
</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>
|
|
</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://hdf.ncsa.uiuc.edu/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://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step4_section2" target="_blank">section II, step 4 in INSTALL_Windows.html.</a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</BODY>
|
|
</HTML>
|