1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
************************************************************************
* Instructions for Building and Testing HDF5 on Windows XP *
* (From Command Line) *
************************************************************************
Note: This instruction is written for users who would like to build HDF5
libraries and tools from the HDF5 source code package on command
line.
Currently, we support
1. Building and testing HDF5 C/C++/Fortran libraries on command line with
Microsoft Visual Studio 2005 for 32- or 64-bit Windows.
For all other Windows development tools, HDF5 should be built in
the development environment. Please refer to INSTALL_Windows.txt
for detailed HDF5 building and installation information, or
INSTALL_Windows_Short.txt for quick HDF5 building and installation
instructions.
WARNINGS:
Please read CAREFULLY about HDF5 build and install preconditions and
notes in INSTALL_Windows.txt before starting below procedures.
========================================================================
Section I: Building and testing HDF5 on command line with Microsoft
Visual Studio 2005
========================================================================
1. Preconditions:
1.1 Verify environment for Visual Studio 2005
Building from the command line requires environment variables for Visual
Studio. These are generally setup when Visual Studio is installed, but you
can verify by running the command:
echo %vs80comntools%
This should output a path similar to:
C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\
1.2 Run batch file copy_hdf.bat.
Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat.
1.3 Setup evironment for external libraries
Similarly to building from within Visual Studio, HDF5 requires environment
variables for szip and zlib library names. To define these environment
variables:
From the command prompt that you will be building HDF5 from, issue the
following command:
set HDF5_EXT_ZLIB=zdll.lib
replacing "zdll.lib" with the name of the zlib library on your system.
Similarly, set HDF5_EXT_SZIP to the name of the szip library on your system.
(Optional) If you will be building using the /useenv switch, you must also
define variables INCLUDE and LIB with a semi-colon deliminated list of
paths for szip and zlib include files and libraries, respectively. Set
these variables in the same way you set HDF5_EXT_ZLIB and HDF5_EXT_SZIP.
2. Building and testing HDF5 libraries and tools
We provide 2 options for users to build and test HDF5 libraries
and tools.
2.1 Options A: Build and test in one step
A batch file named hdf5bt.bat in c:\MyHDFstuff\hdf5 directory is
provided for users to build and test HDF5 library and tools together
from command line.
hdf5bt file takes the following options:
/fort Build and test HDF5 with Fortran libraries
/useenv Build HDF5 using compiler settings defined
in the environment, rather than the IDE.
/? Help information
If you specify the "/useenv" option, then include and library
directories for szip and zlib must have been set in the
Preconditions above.
Invoke a command prompt window and run hdf5bt. Users are
encouraged to pipe the test output into a file. You should find no
compilation errors or "*FAILED*" marks.
2.2 Options B: Build and test in two steps
We also provide users with the option to build and test HDF5 libraries
and tools seperately.
Step 1) Build HDF5 Libraries and Tools
A batch file named hdf5build.bat in c:\MyHDFstuff\hdf5
directory is provided for users to build HDF5 library and
tools from command line.
hdf55build takes the following options:
/fort Build HDF5 with Fortran libraries
/useenv Build HDF5 using compiler settings defined
in the environment, rather than the IDE.
/? Help information
If you specify the "/useenv" option, then include and library
directories for szip and zlib must have been set in the
Preconditions above.
Invoke a command prompt window and run hdf5build. Users are
encouraged to pipe the test output into a file. You can check
the file to find out whether there are any compilation errors.
Step 2) Test HDF5 Libraries and Tools
HDF5 comes with various test suites, all of which can be tested with
hdf5check.bat batch file in c:\MyHDFstuff\hdf5 directory.
hdf5check batch file can be run with one of the following four options:
hdf5check Test HDF5 C library and tools only.
hdf5check enablecpp Test HDF5 C/C++ libraries and tools.
hdf5check enablefortran Test HDF5 C/Fortran libraries and
tools. To use this option, HDF5
Fortran libraries must have been built.
hdf5check enableall Test HDF5 C/Fortran libraries and
tools. To use this option, HDF5
Fortran libraries must have been built.
Invoke a command prompt window and run hdf5check with appropriate
option. Users are encouraged to pipe the test output into a file.
You should find no "*FAILED*" marks.
3. Installing HDF5 Libraries
Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install all
HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.
For further information, please refer to INSTALL_WINDOWS.txt.
***********************************************************************
For further information, please refer to INSTALL_WINDOWS.txt.
Please send email to help@hdfgroup.org for further assistance.
|
