File: Install_HDFEOS5_WIN.readme.txt

package info (click to toggle)
hdf-eos5 5.1.13.dfsg.1-3
  • links: PTS
  • area: main
  • in suites: wheezy
  • size: 23,304 kB
  • sloc: ansic: 77,198; fortran: 32,428; sh: 9,521; makefile: 609; csh: 4
file content (250 lines) | stat: -rwxr-xr-x 9,379 bytes parent folder | download
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
#-----------------------------------------------------------------------------
# filename:
#       Install_HDFEOS5_WIN.README
#
# description:
#       Installation instruction for HDFEOS5.1.13 on Windows xp
#       
# author:
#       Phuong Nguyen/ L3 Communication, GSI.
#       Abe Taaheri/ Raytheon SSI
#
# history:
#       02-Aug-1999 Second version
#       11-OCT-1999 Third version( with Fortran support)
#	06-Jul-2005 Version 5.1.9
#	19-Feb-2006 Version 5.1.10
#	27-Feb-2008 Version 5.1.11
#	15-jun-2009 Version 5.1.12
#	19-Aug-2010 Version 5.1.13
#-----------------------------------------------------------------------------
              
The instructions which follow assume that you will be using
the 'zip' files that we provide: hdfeos5_1_13b.zip (binary file 
for Windows xp) and hdfeos5_1_13.zip (source code file along with binaries). 
Also we have been using "Microsoft Visual Studio 2008" for our windows 
developement. 


Building from Binary Code Release (hdfeos5_1_13b.zip)
===============================================
To install the HDFEOS with the prebuilt libraries, it is assumed that 
you have done the following:      

      NOTE: THE FOLLOWING INTSTRUTIONS SHOULD BE FINE FOR WIN xp

      1. Go to the  ftp site 
      ftp://edhs1.gsfc.nasa.gov/edhs/hdfeos5/latest_release/windows/, 
         and download hdfeos5_1_13b.zip.

      2. On your window, create a directory structure to unpack the 
	source file. For example: 
	F:\					(any drive)
   	MyHDFEOS\				(any folder name)
        

      3. Copy the hdfeos5_1_13b.zip to that directory and unpack it by running 
	WinZip on it. This should create the following directories: hdfeos5, 
	hdf5-1.8.5-win32, jpeg6b-vs2008, zlib125-dll, and szip21-vs2008-noenc 
	(no- encoder) and szip21-vs2008-enc (with encoder)

	The libraries and include files for hdfeos5.1.13 are inside:
	F:\MyHDFEOS\hdfeos5\lib		(Release versions of hdfeos and gctp
					libraries (hdfeos.lib, gctp.lib))
					(Debug versions of hdfeos and gctp
					libraries (hdfeosd.lib, gctpd.lib))
	
	F:\MyHDFEOS\hdfeos5\include		( HDFEOS5 include files )

	Inside the directories hdf5-1.8.5-win32, jpeg6b-vs2008, zlib125-dll, 
	and szip21-vs2008-noenc ( or szip21-vs2008-enc) You can find their 
	include files and libraries (hdf5.lib, hdf5_hl.lib, zdll.lib, 
	hdf5_fortran.lib, hdf5_hl_fortran.lib, libjpeg.lib and szlib.lib).

      4. Run your "Microsoft Visual Studio 2008" application.
	If you are building an application that uses the HDFEOS5 library,
	you must already have installed hdf5-1.8.5 (or use HDF5 binary provided
	for your machine. 
         
	Assumed you have installed HDF5-1.8.5 on 
            
	F:\MyHDF\hdf5-1.8.5-win32\

	To specify the header files and linking in the HDFEOS5 libraries:
	Select Tools->Options->Projects and Solutions->VC++Directories->
	"Show directories for"->"Include files", add the following directories:

	$(VCInstallDir)include
        $(VCInstallDir)atlmfc\include
        $(WindowsSdkDir)\include
        $(FrameworkSDKDir)include
	F:\MyHDFEOS\jpeg6b-vs2008\include
	F:\MyHDFEOS\zlib125-dll\include
	F:\MyHDFEOS\szip21-vs2008-enc\include
	F:\MyHDF\hdf5-1.8.5-win32\include
	F:\MyHDFEOS\hdfeos5\include

	Select Tools->Options->Projects and Solutions->VC++Directories->
	"Show directories for"->"Library files", add the following directories:

	F:\Program Files\Microsoft Visual Studio 9.0\VC\redist\x86\Microsoft.VC90.CRT
	$(VCInstallDir)lib
	$(VCInstallDir)atlmfc\lib
	$(VCInstallDir)atlmfc\lib\i386
	$(WindowsSdkDir)\lib
	$(FrameworkSDKDir)lib
	$(VSInstallDir)
	$(VSInstallDir)lib
	F:\Program Files\Microsoft Visual Studio 9.0\VC\redist\x86\Microsoft.VC90.CRT
	F:\MyHDFEOS\jpeg6b-vs2008\lib
	F:\MyHDFEOS\zlib125-dll\lib
	F:\MyHDFEOS\szip21-vs2008-enc\lib
	F:\MyHDF\hdf5-1.8.5-win32\lib
	F:\MyHDFEOS\hdfeos5\lib\WIN

	NOTE: you may need H5_USE_16_API in C/C++->Preprocesssor(if you are 
	using HDF5-1.8.X this may be required to map a few depricated hdf5 
	functions to their new formats). Please note that you may need some 
	other include and lib directories, depending on your application. 
	Please see Compile_WIN.readme.txt inside for more details.


Building from Source Code Release (hdfeos5_1_13.zip)
===============================================

STEP I:  Preconditions

To build the HDFEOS5, it is assumed that you have done the following:
      
      1. Installed MicroSoft Developer Studio 2008 (or higher)
    
      2. Installed jpeg, szip and zlib (see install_jpeg_zlib_szip.txt)
         
      3. Installed HDF5 version 1.8.5.

      4. Set up a directory structure to unpack the library. For 
      	example: 

	    	F:\				(any drive)
           	MyHDFEOS\			(any folder name)

      5. Copy the source distribution archive to that directory and unpack 
      it using the appropriate archiver options to create a directory 
      hierarchy.
         
      Run WinZip on hdfeos5_1_13.zip. Exract 'hdfeos5' and
      'hdfeos5_dev' directories into F:\MyHDFEOS5. The directory 'hdfeos5_dev' 
      contains several files and directories for Windows, and the 'hdfeos5' 
      directory hdfeos5 source code package.

STEP II: Build HDFEOS5 library

INSTRUCTIONS FOR INSTALLATION           

      1. Open  F:\myHDFEOS5\hdfeos5_dev\hdfeos5.sln to begin building the 
	Developer Studio project.
         
      2. Select Tools->Options->Projects and Solutions->VC++Directories->
      "Show directories for"->"Include files", add the following directories:
         
	$(VCInstallDir)include
        $(VCInstallDir)atlmfc\include
        $(WindowsSdkDir)\include
        $(FrameworkSDKDir)include
	F:<path to jpeg>\include  
	F:<path to zlib>\include
	F:<path to szlib>\include      
	F:<path to HDF5>\include 
	F:<path to HDFEOS5>\include 
	F:<path to HDFEOS5>\gctp\include

	where for example <path to HDF5> is F:\MyHDF\hdf5-1.8.5-win32      
	and <path to HDFEOS5> can be F:\myHDFEOS5\hdfeos5

      3. Select Tools->Options->Projects and Solutions->VC++Directories->
      "Show directories for"->"Library files", add the following directories:

	F:\Program Files\Microsoft Visual Studio 9.0\VC\redist\x86\Microsoft.VC90.CRT
	$(VCInstallDir)lib
	$(VCInstallDir)atlmfc\lib
	$(VCInstallDir)atlmfc\lib\i386
	$(WindowsSdkDir)\lib
	$(FrameworkSDKDir)lib
	$(VSInstallDir)
	$(VSInstallDir)lib
	F:<path to jpeg lib>\jpeg  
	F:<path to zlib>\lib
	F:<path to szlib>\lib
	F:<path to HDF5>\lib
	F:<path to HDFEOS5>\lib\WIN

      4. Select hffeos5 in the "Solution Explorer" window the select 
      Project->Properties, 

	Select "General" under "Configuration Properties". In the selection 
	window for "Configuration Type" select "Static Library(.lib)" option 
	to create output as library.

	Select folder C/C++->Preprocesssor.
	Add the following to "Preprocessor definitions" if they are not there 
	alraedy: 
	WIN32;NDEBUG;_LIB;INTEL86;VISUAL_CPLUSPLUS;_CRT_SECURE_NO_WARNINGS;
	H5_USE_16_API	 

      5. Now Select "Solution 'hdfeos5'" in the "Solution Explorer" windoW. 
      Select "Build", then Select "Configuration Mangger".
      Select "Debug" in "Active Solution Configuration" window, check mark 
      hdfeos5 and gctp build boxes and change Configuration to Debug for both
      projects.
      Select "Build" and "Build Solutions" to build the Debug version of the 
      hdfeos5 and gctp tree.

      6. Select "Build", then Select "Configuration Mangger".
      Select "Release" in "Active Solution Configuration" window, check mark 
      hdfeos5 and gctp build boxes and change Configuration to Release for both
      projects.
      Select "Build" and "Build Solutions" to build the Release version of 
      the hdfeos5 and gctp tree.

      Please note that you have a choice of building gctp and hdfeos5 
      separately.

      7. Please check "Release" and "Debug" directories under 
      F:\myHDFEOS5\hdfeos5_dev\hdfeos5 and F:\myHDFEOS5\hdfeos5_dev\gctp to 
      make sure that libraries have been created sucessfully.

      8. In command prompt window run the installation batch commands 
      win32ins.bat in the directory F:\myHDFEOS5\hdfeos5_dev, Or double click 
      on "F:\myHDFEOS5\hdfeos5_dev\win32ins.bat" file. This will copy *.lib 
      files to F:\MyHDFEOS5\hdfeos5\lib directory and will remove some 
      temporary files, debug and release directories, and all other lib 
      directories under "F:\MyHDFEOS5\hdfeos5\lib" directory.

      9. If you are building an application that uses the HDFEOS5 library,
      Please refer to the 
      <HDFEOS5 directory>\hdfeos5_dev\compile_WIN_readme.txt 
      file for more information on compiling an application with the 
      HDFEOS5 libraries on Windows.

MORE HELPFUL POINTERS
=====================

Settings... details:
  If you create your own project, the necessary settings can be
  read from the hdfeos5.dsw file(as text), or from the
  Project Settings in the Developer Studio project settings 
  dialog.

    Project
	  Settings
	      C/C++
		  Category
		     PreProcessor
			 Code Generation
			    Use run-time Library
				   These are all set to use Single-Threaded.
				   or Single-Threaded debug.