HDF5 Build and Install Instructions for Windows XP with INTEL Compiler

(Short Version)

Notes:

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.

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.

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.

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 ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.

5. Set up path for external libraries and headers

• Skip this part if you don't want to use ANY compression features provided by HDF5. Please do read Section V in INSTALL_Windows.html.

• You have to read this part even if you want to use only Zlib or Szip. You also need to read Section V in INSTALL_Windows.html

• For users using Intel compiler 7.1 integration with MSVS 6.0, please refer to "Preconditions 6" on INSTALL_Windows.html to set up path for external libraries and headers.

• 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.

6. Part II, 2.1 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 Part II, 2.2 directly!

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 INSTALL_Windows.html, Section II, STEP 2 Testing HDF5 libraries and tools.

8. If  you are not building HDF5 with Thread-Safe Feature, ttsafedll.dsp should be turned off always.

Warnings:

Please read CAREFULLY about HDF5 build and install preconditions and notes in INSTALL_Windows.txt before starting below procedures.

Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0

• 1.1. Intel C Compiler

  Go to Tools-->Select Compiler

  Check Intel box and click OK button.

• 1.2. Intel Fortran Compiler

  Go to Tools-->Select Compiler

  Check Intel box and click OK button.

  Go to Tools-->Customize-->Add-ins and Macro Files and check Intel Fortran Compiler Build Tool

Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment

• 2.1 Building HDF5 C and C++ Library with Intel C++ Compiler

  • 2.1.1 Open all.dsw

    Notes:

    all.sln is for command line use only. please open all.dsw not all.sln.

    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.

  • 2.1.2 Convert to Use Intel C++ Project System

    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.

  • 2.1.3 Set up path for external libraries and headers

    Go to Tools > Options > Intel C++. In the left pane, Click "General".

    • a. In the right pane, under "Compiler selection", choose Intel C++ 8.1.

    • 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).

    • c. Then click "OK".

  • 2.1.4 Building C and C++ Static and DLL Libraries and Tools

    Select "Build", then Select "Set Active Configuration".

    Select "all -- Win32 Debug" or "all -- Win32 Release"

    Disable all Fortran project files listed below and ttsafedll project file:

    • flush1_fortran
    • flush1_fortrandll
    • flush2_fortran
    • flush2_fortrandll
    • hdf5_f90cstub
    • hdf5_f90cstubdll
    • hdf5_fortran
    • hdf5_fortrandll
    • hdf5_hl_fortran
    • hdf5_hl_fortrandll
    • hdf5_hl_f90cstubdll
    • hl_test_image_fortran
    • hl_test_image_fortrandll
    • hl_test_lite_fortran
    • hl_test_lite_fortrandll
    • hl_test_table_fortran
    • hl_test_table_fortrandll
    • libtest_cstubdll
    • libtest_fortran
    • libtest_fortrandll
    • testhdf5_fortran
    • testhdf5_fortrandll
    • ttsafedll

    Select "ok". Select "Build" -> "Build" or "Rebuild All" to build debug version of project "all".

  • 2.1.5 Testing HDF5 C and C++ Libraries and Tools

    Under directory "hdf5", a batch file hdf5check.bat was provided to test HDF5 libraries and tools.

    Invoke command prompt, go to directory "hdf5", type in the following command to test HDF5 C and C++ Libraries.

    • hdf5check enablecpp

    Test results will be save into file check_results.txt under directory "hdf5". Check check_results.txt, there should be no "failures" at all.

• 2.2 Building HDF5 C and C++ Library and Static Fortran Library with Intel Compiler 8.1

  Notes:

  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.

  Users who want to build ONLY HDF5 Static and DLL C and C++ Library please go to Part II, 2.1.

  • 2.2.1 Open all.dsw

    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.

  • 2.2.2 Extract Compaq Visual Fortran Projects

    • a. Select project "flush1_fortran" in the Solution Explorer window. In the Project menu, select "Extract Compaq Visual Fortran Project".

      Do the same thing for the following project files:

      • flush2_fortran
      • hdf5_fortran
      • testhdf5_fortran
      • hl_test_image_fortran
      • hl_test_lite_fortran
      • hl_test_table_fortran

    • 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 . Do the same thing for "hdf5_hl_fortran"

  • 2.2.3 Change project dependencies of "libtest_fortran" and "hdf5_hl_fortran"

    Highlight project "libtest_fortran", choose "Project"-> "Project Dependencies", uncheck "libtest".

    Highlight project "hdf5_hl_fortran", choose "Project"-> "Project Dependencies", uncheck "hdf5_fortran" and "hdf5_hl".

  • 2.2.4 Convert all.sln to Use Intel C++ Project System

    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.

  • 2.2.5 Building C and C++ Static and DLL Libraries and Static Fortran Libraries and Tools

    Select "Build", then Select "Set Active Configuration".

    Select "all -- Win32 Debug" or "all -- Win32 Release"

    Disable all Fortran DLL project files listed below and ttsafedll project file:

    • flush1_fortrandll
    • flush2_fortrandll
    • hdf5_fortrandll
    • hdf5_hl_fortrandll
    • hdf5_hl_f90cstubdll
    • hl_test_image_fortrandll
    • hl_test_lite_fortrandll
    • hl_test_table_fortrandll
    • libtest_fortrandll
    • testhdf5_fortrandll
    • ttsafedll

    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.

Part III Build HDF5 C and C++ Library with Intel C++ Compiler

• 3.1 Test HDF5 C and C++ Libraries

  Invoke command prompt, go to directory "hdf5", type in the following command to test HDF5 C and C++ Libraries.

  hdf5check enablecpp

  Test results will be save into file check_results.txt under directory "hdf5". Check check_results.txt, there should be no "failures" at all.

• 3.2 Test HDF5 Static and High Level Fortran Library

  Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file testhdf5_fortran.bat with the following two options to test fortran static library

  • testhdf5_fortran release >> "Your output file name"
  • testhdf5_fortran debug >> "Your output file name"

  Check your output files, there should be no "failures" at all.

• 3.3 Test HDF5 High Level Fortran Library

  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

  • test_hdf5_hl_fortran release >> "Your output file name"
  • test_hdf5_hl_fortran debug >> "Your output file name"

  Check your output files, there should be no "failures" at all.

Part IV: 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.

Part V: Building HDF5 Examples (Optional)

Please read section II, step 4 in INSTALL_Windows.html.

Need further assistance? email to hdfhelp@ncsa.uiuc.edu or go to http://hdf.ncsa.uiuc.edu/windows/questions to get help on windows

Thank  you  for  using  Hierarchical  Data  Format  (HDF)