WFDB quick start for Solaris

The new PhysioNet website is available at: We welcome your feedback.
  1. Install gcc (requires root permissions) if it is not installed already (try the command 'gcc --version' to check).

  2. Install an HTTP client library (optional, requires root permissions) if one is not installed already (try the commands 'curl-config --version' and 'libwww-config --version' to check). If either command works, skip to step 3.

    If neither libcurl nor libwww has been installed already, install one of them now.

    • You will be able to use the WFDB software to read files on local disk drives and CD-ROMs whether or not you install one of these libraries.
    • Direct access from WFDB applications to data files on remote web and FTP servers (NETFILES) is possible only if you install libcurl or libwww.
    • Direct access from WFDB applications to password-protected data files on remote web and FTP servers requires libcurl 7.12.0 or later.
    • If you skip this step now, you may install libcurl or libwww and recompile the WFDB library later to enable NETFILES access for all of your WFDB applications. It will not be necessary to recompile the applications themselves.
  3. Install the X11 developer's toolkit and XView (optional, requires root permissions) if they are not already installed. (Check for the presence of Xlib.h, which is usually found in /usr/include/X11, to see if the X11 developer's toolkit has been installed. Check for the presence of textedit, which is usually found in /usr/openwin/bin, to see if XView has been installed.)

    • You will not be able to compile or use WAVE unless you have installed the X11 developer's toolkit and XView, but none of the other WFDB applications require XView. Other components of PhysioToolkit, such as plt and SEMIA, require X11 and XView.
    • Add /usr/openwin/bin (or the directory containing textedit, if you have a non-standard installation of XView) to your PATH before attempting to compile WAVE.
  4. Download and compile the current version of the WFDB Software Package.

    • Unpack the archive of sources:

      tar xfvz wfdb.tar.gz

      If you don't have GNU tar, you may need to uncompress the archive before unpacking it, like this:

      gzip -d wfdb.tar.gz
      tar xfv wfdb.tar

      Unpacking the archive creates a directory with a name of the form wfdb-10.m.n within your working directory.

    • Enter this directory, configure, and install the package:

      cd wfdb-10.m.n
      make install

      The make command requires root permissions, and installs the package in subdirectories of /usr/local. If you do not have root permissions, you may install the package in any writable directory by adding an appropriate option to the make command above:

      make install WFDBROOT=/path/to/another/directory

      Note that in this case you will need to add WFDBROOT/bin to your PATH.

    • (Optional) Check that the WFDB library and applications have been correctly compiled and installed:

      make check

      This step compiles a short program that exercises the WFDB library and applications, and prints a summary of test results. The tests are very short (typically less than a second each), except that the last one (xform using NETFILES) may take up to a minute if you have a slow or inoperative Internet connection. If any application test fails, its output (program.out) can be found in the checkpkg subdirectory of the WFDB source tree; compare this output with the file of the same name that can be found in the checkpkg/expected subdirectory.

  5. If XView is installed, test WAVE with the command:

    wave -r mitdb/200 -a atr

    If you have not used WAVE before, you may want to follow through the tutorial material in the beginning of the WAVE User's Guide.

  6. Read the manuals. Really! :-) If you want to write your own software to work with PhysioBank data, begin with the WFDB Programmer's Guide. To learn about the wide variety of existing software that can be used to study PhysioBank data, read the WFDB Applications Guide and the WAVE User's Guide.

Questions and Comments

If you would like help understanding, using, or downloading content, please see our Frequently Asked Questions.

If you have any comments, feedback, or particular questions regarding this page, please send them to the webmaster.

Comments and issues can also be raised on PhysioNet's GitHub page.

Updated Friday, 01-Dec-2017 22:32:35 CET

PhysioNet is supported by the National Institute of General Medical Sciences (NIGMS) and the National Institute of Biomedical Imaging and Bioengineering (NIBIB) under NIH grant number 2R01GM104987-09.