mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +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.
457 lines
18 KiB
HTML
Executable File
457 lines
18 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>HDF5 Build and Install Instructions for Windows XP with
|
|
INTEL Compiler </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 INTEL Compiler</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 Intel Compiler but do
|
|
not want to know HDF5 building and installation details on Windows XP. For
|
|
detailed HDF5 build and install information, or if you have trouble following
|
|
any steps in the instructions, please refer to INSTALL_Windows.txt for further
|
|
information. 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>2. 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>
|
|
|
|
<p>3. HDF5 Fortran DLL Libraries is not supported with Intel Fortran
|
|
8.1 integration with Visual C++ .Net 2003 Environment. But
|
|
Release version of HDF5 Fortran DLL Libraries works with Intel
|
|
Fortran whilt Debug version doesn't.</p>
|
|
|
|
<p>4. 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.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows" target="_blank">
|
|
ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.</a> </p>
|
|
|
|
<p>5. Set up path for external libraries and headers
|
|
<ul class="intable">
|
|
|
|
|
|
<li><p>Skip this part if you don't want to use ANY compression
|
|
features provided by HDF5. Please do read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_Windows.html.</a></p></li>
|
|
|
|
<li><p>You have to read this part even if you want to use only Zlib
|
|
or Szip. You also need to read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_Windows.html</a></p></li>
|
|
|
|
<li><p>For users using Intel compiler 7.1 integration with MSVS 6.0,
|
|
please refer to<a href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#precondition6" target="_blank">
|
|
"Preconditions 6" on INSTALL_Windows.html </a>to
|
|
set up path for external libraries and headers.</p></li>
|
|
|
|
<li><p>For users using Intel compiler 8.1 integration with Visual C++
|
|
.Net 2003, detailed information about setting up external
|
|
libraries and header will be given in Part II, 2.1.3 in this
|
|
document.</p></li>
|
|
</ul>
|
|
</p>
|
|
|
|
<p>6. <a href="#part2_2.1" target="_blank">Part II, 2.1 </a>in this document will build ONLY HDF5 Static and DLL C and C++
|
|
Library using Intel C++ Compiler. If you want to build HDF5
|
|
Static and DLL C and C++ Library as well as HDF5 Static Fortran
|
|
Library, Please go to <a href="#part2_2.2" target="_blank">Part II, 2.2 </a>directly!</p>
|
|
|
|
<p>7. Only short information was given on test HDF5 Libraries. Users
|
|
want to know detailed information about testing HDF5 Libraries
|
|
and tools, please refer to document
|
|
<A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank>
|
|
INSTALL_Windows.html, Section II, STEP 2 Testing HDF5 libraries and tools.</a></p>
|
|
|
|
<p class="note">Warnings:</p>
|
|
<p class="note">Please read CAREFULLY about <a href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#preconditions" target="_blank">
|
|
HDF5 build and install preconditions and notes</a> in
|
|
INSTALL_Windows.txt before starting below procedures. </p>
|
|
<hr class="second" />
|
|
<h2>Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0</h2>
|
|
<hr class="second" />
|
|
|
|
<ul class="intable">
|
|
<li><h3>1.1. Intel C Compiler</h3>
|
|
<p>Go to Tools-->Select Compiler</p>
|
|
<p>Check Intel box and click OK button.</p>
|
|
</li>
|
|
<li><h3>1.2. Intel Fortran Compiler</h3>
|
|
<p>Go to Tools-->Select Compiler</p>
|
|
<p>Check Intel box and click OK button.</p>
|
|
<p>Go to Tools-->Customize-->Add-ins and Macro Files and check Intel Fortran Compiler Build Tool</p>
|
|
</li>
|
|
</ul>
|
|
|
|
<hr class="second" />
|
|
<h2>Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment</h2>
|
|
<hr class="second" />
|
|
|
|
<ul class="intable">
|
|
<li><h3><a name="part2_2.1">2.1 Building HDF5 C and C++ Library with Intel C++ Compiler</a></h3>
|
|
<ul class="intable">
|
|
<li><h4>2.1.1 Open all.dsw</h4>
|
|
<p class="note">Notes:</p>
|
|
<p>all.sln is for command line 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,
|
|
choose "Yes To All" to convert all project files to Visual
|
|
C++ .Net project format.</p>
|
|
</li>
|
|
<li><h4>2.1.2 Convert to Use Intel C++ Project System</h4>
|
|
|
|
<p>Right click on the solution name "all.sln" in the
|
|
"Solution Explorer". From the pop-up menu select
|
|
"Convert to use Intel C++ Project System" to convert
|
|
all .Net project files to Intel C++ project files. </p>
|
|
</li>
|
|
<li><h4>2.1.3 Set up path for external libraries and headers</h4>
|
|
<p> Go to Tools > Options > Intel C++. In the left pane, Click "General".</p>
|
|
<ul class="intable">
|
|
<li><p>a. In the right pane, under "Compiler selection",
|
|
choose Intel C++ 8.1.</p></li>
|
|
<li><p>b. Click on "Intel C++ 8.1" to set the directories
|
|
and default options. In "Include", Add Zlib and Szip
|
|
header path(c:\zlib122\include c:\szip\include).
|
|
In "Library", Add Zlib and Szip Library Path
|
|
(c:\zlib122\lib, c:\szip\dll).</p></li>
|
|
<li><p>c. Then click "OK".</p></li>
|
|
</ul>
|
|
</li>
|
|
<li><h4>2.1.4 Building C and C++ Static and DLL Libraries and Tools</h4>
|
|
<p>Select "Build", then Select "Set Active Configuration".</p>
|
|
<p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p>
|
|
<p>Disable all Fortran project files listed below:</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>
|
|
</ul>
|
|
<p>Select "ok". Select "Build" -> "Build" or "Rebuild All" to
|
|
build debug version of project "all".</p>
|
|
</li>
|
|
<li><h4>2.1.5 Testing HDF5 C and C++ Libraries and Tools</h4>
|
|
<p>Under directory "hdf5", a batch file hdf5check.bat was provided to
|
|
test HDF5 libraries and tools.
|
|
</p>
|
|
<p>Invoke command prompt, go to directory "hdf5", type in the following command to test HDF5 C and C++ Libraries.</p>
|
|
<ul class="normal">
|
|
<li>hdf5check enablecpp</li>
|
|
</ul>
|
|
<p>Test results will be save into file check_results.txt under
|
|
directory "hdf5". Check check_results.txt, there should be no
|
|
"failures" at all.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><h3><a name="part2_2.2">2.2 Building HDF5 C and C++ Library and Static Fortran Library with Intel Compiler 8.1</a></h3>
|
|
<p class="note">Notes:</p>
|
|
<p>This step will 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.
|
|
</p>
|
|
<p>Users who want to build ONLY HDF5 Static and DLL C and C++
|
|
Library please go to <a href="#part2_2.1" target="_blank">Part II, 2.1.</a>
|
|
<ul class="intable">
|
|
<li><h4>2.2.1 Open all.dsw</h4>
|
|
<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><h4> 2.2.2 Extract Compaq Visual Fortran Projects</h4>
|
|
<ul class="intable">
|
|
<li><p> a. Select project "flush1_fortran" in the Solution
|
|
Explorer window. In the Project menu, select
|
|
"Extract Compaq Visual Fortran Project". </p>
|
|
<p>Do the same thing for the following project files:</p>
|
|
<ul class="normal">
|
|
<li>flush2_fortran </li>
|
|
<li>hdf5_fortran </li>
|
|
<li>testhdf5_fortran </li>
|
|
<li>hdf5_hl_fortran </li>
|
|
<li>hl_test_image_fortran </li>
|
|
<li>hl_test_lite_fortran </li>
|
|
<li>hl_test_table_fortran</li>
|
|
</ul>
|
|
</li>
|
|
<li><p>b. Select project "libtest_fortran" in the Solution
|
|
Explorer window. In the Project menu, select
|
|
"Extract Compaq Visual Fortran Project". Choose
|
|
"The Intel Fortran project" as the the main project .</p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><h4>2.2.3 Change project dependencies of "libtest_fortran"</h4>
|
|
<p>Highlight project "libtest_fortran", choose "Project"->
|
|
"Project Dependencies", uncheck "libtest".
|
|
</p>
|
|
</li>
|
|
<li><h4>2.2.4 Convert all.sln to Use Intel C++ Project System</h4>
|
|
<p>Right click on the solution name "all.sln" in the
|
|
"Solution Explorer". From the pop-up menu select
|
|
"Convert to use Intel C++ Project System" to convert
|
|
all .Net C++ project files to Intel C++ project formats.
|
|
</p>
|
|
</li>
|
|
<li><h4>2.2.5 Building C and C++ Static and DLL Libraries and Static
|
|
Fortran Libraries and Tools</h4>
|
|
<p>Select "Build", then Select "Set Active Configuration".</p>
|
|
<p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p>
|
|
<p>Disable all Fortran DLL project files listed below:</p>
|
|
<ul class="normal">
|
|
<li>flush1_fortrandll </li>
|
|
<li>flush2_fortrandll </li>
|
|
<li>hdf5_fortrandll </li>
|
|
<li>hdf5_hl_fortrandll</li>
|
|
<li>hdf5_hl_f90cstubdll</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>
|
|
</ul>
|
|
<p>Select "ok". Select "Build" -> "Build" or "Rebuild All" 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.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<hr class="second" />
|
|
<h2>Part III Build HDF5 C and C++ Library with Intel C++ Compiler</h2>
|
|
<hr class="second" />
|
|
<ul class="intable">
|
|
<li><h3>3.1 Test HDF5 C and C++ Libraries</h3>
|
|
<p>Invoke command prompt, go to directory "hdf5", type in the
|
|
following command to test HDF5 C and C++ Libraries.</p>
|
|
<p>hdf5check enablecpp</p>
|
|
<p>Test results will be save into file check_results.txt under
|
|
directory "hdf5". Check check_results.txt, there should be no
|
|
"failures" at all.
|
|
</p>
|
|
</li>
|
|
|
|
<li><h3>3.2 Test HDF5 Static and High Level Fortran Library</h3>
|
|
<p>Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file
|
|
testhdf5_fortran.bat with the following two options to test
|
|
fortran static library
|
|
</p>
|
|
<ul class="normal">
|
|
<li>testhdf5_fortran release >> "Your output file name" </li>
|
|
<li>testhdf5_fortran debug >> "Your output file name"</li>
|
|
</ul>
|
|
<p>Check your output files, there should be no "failures" at all.</p>
|
|
</li>
|
|
<li><h3>3.3 Test HDF5 High Level Fortran Library</h3>
|
|
<p>Go to directory c:\myHDFstuff\hdf5\hl\fortran\test, Run batch file
|
|
testhdf5_fortran.bat with the following two options to test
|
|
fortran static library
|
|
</p>
|
|
<ul class="normal">
|
|
<li>test_hdf5_hl_fortran release >> "Your output file name" </li>
|
|
|
|
<li>test_hdf5_hl_fortran debug >> "Your output file name"</li>
|
|
</ul>
|
|
<p>Check your output files, there should be no "failures" at all.</p>
|
|
</li>
|
|
</ul>
|
|
|
|
<hr class="second" >
|
|
<h2>Part IV: 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>Part V: 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></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>
|
|
<p> </p>
|
|
<p> </p>
|
|
|
|
</BODY>
|
|
</HTML>
|