#----------------------------------------------------------------------------- # filename: # Install_HDFEOS5_NT_98.README # # description: # Installation instruction for HDFEOS5 on Windows NT and # Windows 95/98 # # author: # Phuong Nguyen/ L3 Communication, GSI. # # history: # 2-Aug-1999 Second version # 11-OCT-1999 Third version( with Fortran support) # 06-Jul-2005 Version 5.1.9 #----------------------------------------------------------------------------- The instructions which follow assume that you will be using the 'zip' files that we provide: hdfeos5.1.9b.zip (binary file for Windows 98/NT) and hdfeos5.1.9.zip (source code file). Building from Binary Code Release (hdfeos5.1.9b.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 BOTH WINNT AND WIN98 1. Go to the website edhs1.gsfc.nasa.gov, under directory hdfeos5/window you can download: hdfeos5.1.9b.zip. 2. On you window, create a directory structure to unpack the source file. For example: c:\ (any drive) MyHDFEOS5\ (any folder name) 3. Copy the hdfeos5.1.9b.zip to that directory and unpack it by running WinZip on it. This should create the following directories: hdfeos5, jpeg, Zlib-1.1.3, and szip1.2 The libraries and include files for hdfeos5.1.9 are inside: c:\MyHDFEOS5\hdfeos5\lib\NT_98 ( Release versions of hdfeos and gctp libraries (hdfeos5.lib, gctp.lib)) c:\MyHDFEOS5\hdfeos5\include ( HDFEOS5 include files ) Inside the directories Zlib-1.1.3, jpeg and szip1.2 You can find their include files and libraries (zlib.lib, libjpeg.lib and szlib.lib). 4. If you are building an application that uses the HDFEOS5 library, you must already have installed NSCA hdf5 (curren version that we're using is 5-1.6.3) on your machine. Assumed you have installed hdf5-1.6.3 on C:\MyHDF5\ To specify the header files and linking in the HDFEOS libraries: Select Tools->Options->Directories->"Show directories for"-> "Include files", add the following directories: F:\Program Files\ArrayVisualizer\INCLUDE F:\Program Files\Microsoft Visual Studio\VC98\MFC\Include F:\Program Files\Microsoft Visual Studio\VC98\INCLUDE C:\MyHDFEOS5\jpeg C:\MyHDFEOS5\Zlib-1.1.3\include C:\MyHDFEOS5\szip1.2\include C:\myHDF5\hdf5\hdf5lib\release\include C:\MyHDFEOS5\hdfeos5\include Select Tools->Options->Directories->"Show directories for"-> "Libraries files", add the following directories: F:\Program Files\ArrayVisualizer\LIB F:\Program Files\Microsoft Visual Studio\VC98\LIB F:\Program Files\Microsoft Visual Studio\VC98\MFC\Lib C:\MyHDFEOS5\jpeg C:\MyHDFEOS5\Zlib-1.1.3\lib C:\MyHDFEOS5\szip1.2\lib C:\myHDF5\hdf5\hdf5lib\release\lib C:\MyHDFEOS5\hdfeos5\lib\NT_98 NOTE: Please see Compile_NT_98.readme.txt inside hdfeos5/doc for more details. Building from Source Code Release (hdfeos5.1.9.zip) =============================================== STEP I: Preconditions To build the HDFEOS5, it is assumed that you have done the following: 1. Installed MicroSoft Developer Studio and Visual C++ 5.0. 2. Installed jpeg, szip and zlib (see install_jpeg_zlib_szip.txt) 3. Installed NSCA hdf5 (current we're using is 1.6.3). 4. Set up a directory structure to unpack the library. For example: c:\ (any drive) MyHDFEOS5\ (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.9.zip (the entire source tree). This should create a directory called 'hdfeos5_dev' which contains several files and directories for Win95/98 and NT, a directory called 'hdfeos5' which contains the hdfeos5 package. STEP II: Build HDFEOS5 library INSTRUCTIONS FOR INSTALLATION 1. Open c:\myHDFEOS5\hdfeos5_dev\hdfeos5.dsw to begin building the Developer Studio project. When you the pop up box "Browse for project hdfeos5", please select the right location for hdfeos5.dsp. For example, you install hdfeos5 under C:\MyHDFEOS5, so you can select the location for hdfeos5.dsp as c:\MyHDFEOS5\hdfeos5_dev\hdfeos5\hdfeos5.dsp 2. Select Tools->Options->Directories->"Show directories for"-> "Include files", add the following directories: F:\Program Files\ArrayVisualizer\INCLUDE F:\Program Files\Microsoft Visual Studio\VC98\MFC\Include F:\Program Files\Microsoft Visual Studio\VC98\INCLUDE C:\jpeg C:\include C:\include C:\include C:\include 3. Select Tools->Options->Directories->"Show directories for"-> "Libraries files", add the following directories: C:\Program Files\ArrayVisualizer\LIB C:\Program Files\Microsoft Visual Studio\VC98\LIB C:\Program Files\Microsoft Visual Studio\VC98\MFC\LIB C:\jpeg C:\lib C:\lib C:\lib where may be C:\myHDF5\hdf5 where may be C:\myHDFEOS5\hdfeos5\ 4. Select Project->Settings, select forder, C/C++ Add the following to "Preprocessor definitions": VISUAL_CPLUSPLUS, INTEL86 5. Select "Build", then Select "Set Active Configuration". Select "hdfeos5 - Win32Debug" as active configuration. Select "Build" and "Build hdfeos5d.lib" to build the Debug version of the hdfeos5 tree. 6. Select "Build", then Select "Set Active Configuration". Select "hdfeos5 - Win32Release" as active configuration. Select "Build" and "Build hdfeos5.lib" to build the Release version of the hdfeos5 tree. 7. gctp libraries for debug and release versions was already in hdfeos5/lib/nt_98: gctpd.lib, gctp.lib. Or if you want to build them, you can use hdfeos2 stuff. 8. In command prompt window run the installation batch commands win32ins.bat in directory C:\myHDFEOS5\hdfeos5_dev. These commands will copy *.lib files to C:\MyHDFEOS5\hdfeos5\lib\NT_98 and remove some temporary files. 9. If you are building an application that uses the HDFEOS5 library, Please refer to the \hdfeos5_dev\compile_NT_98.txt file for more information on compiling an application with the HDFEOS5 libraries on Windows 95/98 and Window NT. MORE HELPFUL POINTERS ===================== Here are some notes that may be of help is you are not familiar with using the Visual C++ Development Environment. Project name and location issues: The files in hdfeos5.dsw must end up in the hdfeos5_dev\ directory If you must install hdfeos5.dsw in another directory, relative to hdfeos5_dev\ , you will be asked to locate the hdfeos and gctp project files, when you open the project hdfeos.dsw. 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.