HDF指导书.docx

win7 64工程修改合入* hdf5 build and install instructions for windows xp/vista * (full version) *the following instructions assume that the hdf5 source code package fromhdf website () is used.warnings:please read carefully about the following preconditions and notes first.contents: section : preconditions and notes section i : what do we build and install section ii : how to build and test hdf5 libraries and tools section iii : how to build examples (optional) section iv : how to build an application using the hdf5 library or dll section v : how to disable gzip(zlib)/szip compression section vi : how to build hdf5 with fortran support section vii : how to build multi-threaded version of hdf5 library section viii : how to build hdf5 with thread-safe feature section ix : how to build hdf5 for 64-bit windows section x : how to build hdf5 on windows vista section xi : how to build hdf5 using visual studio 2008 section xii : backwards compatibility with hdf5 1.6 section xiii : misc.= preconditions and notes=preconditions: 1. installed microsoft visual studio. this document is written for visual studio 2008. we no longer support building hdf5 using microsoft visual studio .net 2003 or 2005. 2. (optional) installed intel compiler 10.1 or 11.1 if you want to build hdf5 fortran libraries. we no longer support intel fortran compiler 9.1. 3. install winzip or 7-zip for extracting source tarball. note: 1. 7zip is an open-source alternative to winzip. some of the advanced functionality is disabled in winzip unless you buy the software. with 7zip, most of this functionality is included for free. 2. by default, winzip will convert the unix end of line format when extracting .tar file. this conversion will cause false failure in some hdf5 tools testings. please uncheck the tar file smart cr/lf conversion option in your winzip to prevent the conversion when extracting .tar file. to uncheck the tar file smart cr/lf conversion option: invoke winzip, go to options, select configuration. click the miscellaneous tab and uncheck tar file smart cr/lf conversion option, then click ok. 4. cmake is available for this release on a experimental basis. cmake 2.8.1 can be downloaded from the kitware website at . note: we have attempted to mirror our autoconf configuration files for maintainence reasons. we are still working out the problems with some issues like fortran shared libraries and tools testing. we will maintain the current vs2008 project files for the 1.8 product. 5. set up a directory structure to unpack the library. for example: c: (any drive) myhdfstuff (any folder name) 6. download the hdf5-1.8.x source code package and use 7zip or winzip to extract the hdf5 package into c:myhdfstuff. this creates a directory called hdf5-1.8.x under myhdfstuff which contains several files and directories. rename hdf5-1.8.x to hdf5. 7. hdf5 provide options to do in-memory compression within hdf5 library. currently, two external compression libraries zlib and szip can be used with hdf5. 7.1 hdf5 uses zlib version 1.2.5 for compression and zlib is not distributed with hdf5 library in 1.8.x release. to use zlib library, you have to install your own zlib dll library or go to / to download the zlib library. 7.2 hdf5 uses szip version 2.1 for compression and szip compression software is provided with hdf5 products in 1.8.x release. to use szip 2.1 library, you can download szip source codes and binaries from /lib-external/szip/2.1/bin/windows please note that szip is not a totally open-source free software. for licensing issue of szip, please check licensing terms at /doc_resource/szip/index.html. szip compression feature inside hdf5 is optional. 8. define the following environment variables: hdf5_ext_zlib hdf5_ext_szip in this section, zlib and szip compression packages are assumed to be used. please read section v as well as this section if you do not want to use compression feature inside hdf5. to define these environment variables: click start, click control panel, and then double-click system. on the advanced tab, click environment variables. if you are logged on as administrator to the local computer and want to let all other users use these two environment variables, click new under system variables box; otherwise, click new under user variables box. in the new variable window, set variable name as hdf5_ext_zlib and variable value as zlib1.lib, then click ok. similarly, you can set: hdf5_ext_szip environment variable as szip.lib notes: a. you will have to close and reopen running programs for the new environment variable settings to take effect. b. c:zlibzlib1.dll and c:szipdllszip.dll should be copied into a location that the application can find. 9. set up path for external libraries and headers skip this part if you dont want to use any compression features provided by hdf5. please do read section v. you have to read this part even if you want to only use zlib or szip. you also need to read section v. invoke microsoft visual studio and go to tools and select options, find projects, and then vc+ directories. 9.1 if you are building on 64-bit windows, find the platform dropdown and select x64. 9.2 find the box show directories for, choose include files, if you can not find your zlib and szip header path (for example, c:zlibinclude, c:szipinclude) from the directory list, add the header path (c:zlibinclude, c:szipinclude) to the included directories. 9.3 find the box show directories for, choose library files. if you cannot find your zlib and szip library path (for example, c:zlibdll, c:szipdll) from the directory list, add the library path (c:zlibdll, c:szipdll) to the library directories. 9.4 if building fortran libraries, you will also need to setup the path for the intel fortran compiler. please see section vi.notes: 1. as of 1.8.0, all.zip is deprecated. users should go to hdf5/windows directory, run copy_hdf.bat first and then open all.sln under hdf5/windows/proj/all to start building process. 2. visual studio 6.0 is no longer supported in hdf5 1.8 or later releases. visual studio .net is no longer support in hdf5 1.8.4 or later releases. visual studio 2005 is no longer support in hdf5 1.8.5 or later releases. intel fortran 9.1 is no longer support in hdf5 1.8.5 or later releases. 3. for users who want to quickly build hdf5 library or do not want to know hdf5 building and installation details, please read the install_windows_short_2008.txt relating to your compiler. 4. for users who would like to build and test hdf5 package from the command line, please read install_windows_from_command_line.txt. 5. for users who would like to build and test hdf5 package using cmake, please read cmake.txt. 6. hdf4-related tools are not built and released with hdf5 library packages any more. to obtain hdf4 related tools, please check /h4toh5/ and /hdf5/h4toh5 7. for fortran users, intel fortran compiler 10.1 is currently supported - please see section vi. intel compiler verion 7.x, 8.x and 9.x are no longer supported. intel compiler 11.1 can be used but the project files must be upgraded within the visual studio ide. 8. visual studio now only builds muti-threaded versions of hdf5 library, please read section vii. = section i: what do we build and install?= 1. build and install hdf5 static library: debug and release version hdf5 dynamic link library(dll): debug and release version as well as export libraries for dll hdf5 high-level library (optional): hdf5 c+ library hdf5 hl-fortran library hdf5 tools: hdf5 tools 2. build only (not included in the binary distribution) hdf5 tool library: debug and release version hdf5 tool export library for dll: debug and release version hdf5 library testing programs: hdf5 library comprehensive tests hdf5 related tools testing programs: hdf5 tools comprehensive tests 3. examples (not included in the binary distribution) hdf5 examples: simple hdf5 c/c+/fortran and high level c/fortran examples= section ii: how to build and test hdf5 libraries and tools=note: to build and test hdf5 with fortran support, please read over section vi. step 1: building hdf5 libraries and tools 1. run batch file copy_hdf.bat go to c:myhdfstuffhdf5windows and run copy_hdf.bat. this process will copy all the necessary batch files, windows-specific source code and text files saved under c:myhdfstuffhdf5windows directory to the corresponding directories under hdf5. 2. open the hdf5 library project in visual studio invoke microsoft visual studio. from the main menu, go to file and select the open solution option. then open the c:myhdfstuffhdf5windowsprojallall.sln solution. you should find windows project files listed as all, big, etc. on the left. 3. (optional) disable hdf5 c+ and high level c+ in hdf5 1.8, c+ and hl c+ libraries are built by default. to opt-out, you must explicitly disable them. 3.1 skip this step if you do want to build hdf5 high-level c+ libraries go to project and select project dependencies. select all, and disable all of the following projects: hdf5_hl_cpp hdf5_hl_cppdll hl_test_table_cpp hl_test_table_cppdll 3.2 skip this step if you do want to build hdf5 high-level libraries go to project and select project dependencies. select all, and disable all of the project files listed in the previous step, as well as the following projects: hdf5_hl hdf5_hldll hl_test_image hl_test_imagedll hl_test_lite hl_test_litedll hl_test_table hl_test_tabledll hl_test_ds hl_test_dsdll hl_test_packet hl_test_packetdll note: disabling some projects will likely produce false errors in the testing script. check the output carefully to ensure that the errors are related to the disabled projects, and then safely ignore them. 4. select build, then select configuration manager. 4.1 to build debug static libraries, debug multithreaded dlls, and tests: in active solution configuration, select debug. select close. select build - build solution or rebuild solution to build debug version of project all. 4.2 to build release static libraries, multithreaded dlls and tests: in active solution configuration, select release. select close. select build - build solution or rebuild solution to build release version of project all. release version must be built for testing, debug version is optional. warning messages can be ignored. when the debug or release build is done the directories listed below will contain the following files: c:myhdfstuffhdf5projhdf5debug - hdf5d.lib- the hdf5 static library c:myhdfstuffhdf5projhdf5release - hdf5.lib- the hdf5 static library c:myhdfstuffhdf5projhdf5dlldebug - hdf5ddll.dll- dll hdf5ddll.lib- the dll export library c:myhdfstuffhdf5projhdf5dllrelease - hdf5dll.dll- dll hdf5dll.lib- the dll export library c:myhdfstuffhdf5testlibtestdebug - and c:myhdfstuffhdf5testlibtestrelease - libtest.lib - the internal library for test c:myhdfstuffhdf5testlibtestdlldebug - libtestddll.dll - the internal dll for test libtestddll.lib - the internal dll export library for test c:myhdfstuffhdf5testlibtestdllrelease - libtestdll.dll - the internal dll for test libtestdll.lib - the internal dll export library for test c:myhdfstuffhdf5toolstoolslibdebug - and c:myhdfstuffhdf5toolstoolslibrelease - toolslib.lib- the internal tools library c:myhdfstuffhdf5toolstoolslibddebug - and c:myhdfstuffhdf5toolstoolslibdrelease - toolslibd.dll- dll toolslibd.lib- the internal dll export library for tools c:myhdfstuffhdf5toolstools directory- where tools are located the directories listed below will contain the following files only when you choose to build hdf5 c+ libraries: c:myhdfstuffhdf5projhdf5_cppdebug - hdf5_cppd.lib- the hdf5 c+ api static library and c:myhdfstuffhdf5projhdf5_cpprelease - hdf5_cpp.lib- the hdf5 c+ api static library c:myhdfstuffhdf5projhdf5_cppdlldebug - hdf5_cppddll.dll- the hdf5 c+ api dll hdf5_cppddll.lib - the c+ api export library and c:myhdfstuffhdf5projhdf5_cppdllrelease - hdf5_cppdll.dll- the hdf5 c+ api dll hdf5_cppdll.lib- the c+ api dll export library the directories listed below will contain the following files only when you choose to build hdf5 high level libraries: c:myhdfstuffhdf5projhdf5_hlrelease - hdf5_hl.lib - hdf5 high level static library and c:myhdfstuffhdf5projhdf5_hldebug - hdf5_hld.lib - hdf5 high level static library c:myhdfstuffhdf5projhdf5_hldllrelease - hdf5_hldll.dll - hdf5 high level dll hdf5_hldll.lib - hdf5 high level export library and c:myhdfstuffhdf5projhdf5_hldlldebug - hdf5_hlddll.dll - hdf5 high level dll hdf5_hlddll.lib - hdf5 high level export library the directories listed below will contain the following files only when you choose to build hdf5 high level c+ libraries: c:myhdfstuffhdf5projhdf5_hl_cpprelease - hdf5_hl_cpp.lib - hdf5 high level c+ static library and c:myhdfstuffhdf5projhdf5_hl_cppdebug - hdf5_hl_cppd.lib - hdf5 high level c+ static library c:myhdfstuffhdf5projhdf5_hl_cppdllrelease - and c:myhdfstuffhdf5projhdf5_hl_cppdlldebug - hdf5_hl_cppddll.dll - hdf5 high level c+ dll hdf5_hl_cppddll.lib - hdf5 high level c+ export librarystep 2: testing hdf5 libraries and toolshdf5 libraries and tools should be tested to make sure that they were built correctly.note: the complete testing suite can take a long time to run on even fast machines. some of the longer tests can be automatically shortened by defining an environment variable hdf5testexpress. set hdf5testexpress to 3 for fastest, or 0 for slowest. for example: set hdf5testexpress=3 if the variable is unset, it takes on the value 1. note that when hdf5testexpress is set to 2 or 3, some features may not be thoroughly tested. for most users, we reco