Menu
▾
▴
Tree [adc5f8] default tip / History
martijnj
martijnj@flotilla
Read Me
================================================================================
:: h5labview ::
http://h5labview.sf.net
================================================================================
*** Requires HDF v1.8.11 *** (Released 16 May 2013)
Permalink: http://www.hdfgroup.org/ftp/HDF5/releases/hdf5-1.8.11/bin/
-----
HDF5 is an extremely flexible, open-source format for storing hierarchical data.
It supports heterogenerous data types and organises data and meta-data into
groups for easy access. It greatly simplifies data storage and is cross-platform
with bindings to most scientific languages.
Installation is handled by the VI Package Manager (VIPM) available from
http://jkisoft.com/vipm/ (the free community version works fine).
Simply open the most recent VIP file in the package manager and click "install".
Further platform-specific instructions are below.
***** WINDOWS INSTALLATION *****
h5labview requires a working installation of the HDF5 binary distribution
compiled with Visual Studio 2010.
The installed version MUST match the expected version (listed at the top of
this document) due to a library requirement, so visit the permalink listed
above, select "windows" and download the zip marked "vs10-shared.zip" with
either "win32" or "win64" depending on your LabVIEW architecture.
Unzip and install. Ensure choose to "Add HDF5 to the system PATH" is selected,
since
Run the example "simple-write.vi" then "simple-read.vi" to check it is working
correctly.
If you get an error about missing DLLs, copy the files
hdf5.dll, szip.dll and zlib.dll
from the "bin" folder in the HDF5 installation directory to LabVIEW's resource
folder, located somewhere like
C:\Program Files\National Instruments\LabVIEW 20XX\resource
***** LINUX INSTALLATION *****
The h5labview binary distributed with this package was generated with
Arch kernel 3.8.11-1, gcc 4.8.0-4, glibc 2.17-5, HDF5 1.8.10-1, LabVIEW 2010
If your Linux system is similar, you MAY be able to use it out of the box.
The binary is primarily included to prevent the installer getting confused.
You will likely need to rebuild the helper library for your own system.
Navigate to the "lib" directory of h5labview, somewhere like
/usr/local/natinst/LabVIEW-20XX/vi.lib/addons/h5labview/lib
Open the "makefile" and update line 1 to contain the location of your LabVIEW
"cintools" directory.
It is extremely important that the library is linked against "liblvrt" and NOT
"liblv". The library files should be in /usr/local/lib/LabVIEW-20XX, consider
making a symlink in /usr/local/lib, or add a -L flag to the makefile.
Execute make, there should be no errors or warnings.
Open the "repack-h5.vi" example program and attempt to run it. If it fails,
check the troubleshooting section below.
Otherwise try "simple-write.vi" then "simple-read.vi" and check they work.
You will likely have to "Rebuild" the XNodes as mentioned in the
troubleshooting section.
If encountering any problems, run labview from a shell, as debug information
gets printed to stderr and can be very helpful.
********** TROUBLESHOOTING **********
The below list contains problems you may potentially encounter after installing
h5labview.
- The version of HDF5 installed MUST match version expected by h5labview,
or LabVIEW itself will CRASH HARD upon the first library call.
This is a "feature" of HDF5 that doesn't make much sense in GUI applications
but exists all the same.
The only workaround (besides installing the expected version) is to set the
environment variable
HDF5_DISABLE_VERSION_CHECK = 1
Instructions to do this for your particular OS can be easily found online
- LabVIEW can't find h5labview32.dll but I'm on 64-bit Windows/Linux!
Some of the library calls must have escaped being updated.
Run "change_dll.vi" in the "lib" directory of h5labview and it will process
the VIs.
- Error message "XNodes are not executable" on 64-bit Windows/Linux.
This is a bug from the install process,
but can be fixed by right-clicking each XNode and selecting "Rebuild".
- LabVIEW can't find hdf5.dll
Copy the files hdf5.dll, szip.dll and zlib.dll from the HDF5 install
directory ("bin" folder) to the LabVIEW "resource" folder (see also Windows
install instructions above)
If you encounter a problem not listed here, please report it by either
launching a support ticket or posting on the forums at the project website,
http://h5labview.sf.net