- 
PhysioNet  ·  PhysioBank  ·  PhysioToolkit

WFDB quick start for Mac OS X (Darwin)

To install and use the WFDB Software Package successfully, you must know how to use the Terminal application and the Unix shell. If you are unfamiliar with Unix commands, please find and study a good reference on the subject, such as David Pogue's Mac OS X: The Missing Manual, or Dave Taylor's Learning Unix for Mac OS X (both published by O'Reilly), or get the help of a local expert.

The WFDB Software Package has been successfully compiled and tested on Intel-based Macs under Mac OS X 10.5 (Leopard) and on PPC-based Macs under Mac OS X 10.3 (Panther) and 10.2 (Jaguar). We have not tested other versions of OS X. Note that the XView toolkit needed in order to use WAVE is available for PPC but not (yet) for Intel-based Macs.

Thanks to Isaac Henry for the original port of the WFDB Software Package to Mac OS X; to David T. Linker, MD, of the University of Washington, for providing instructions for compiling WAVE under Mac OS X 10.2 on PPC Macs; and to Prof. Logan Donaldson, of York University (Toronto), for the port of the XView toolkit to Mac OS X 10.0 (PPC) that made David's port of WAVE possible.

  1. Install XCode, including "UNIX Development Support". XCode is a set of software development tools including gcc, make, the libcurl and X11 SDKs, and much more. XCode is included on current Mac OS X CDs and DVDs, and can also be freely downloaded from http://developer.apple.com/tools/xcode/.

  2. Open a Terminal (or xterm) window. Type the commands shown in the remaining steps below into this window.

  3. Install XView (optional).
  4. Download the current version of the WFDB Software Package as sources or binaries. The binary distribution is experimental and may not be up-to-date; we strongly recommend following the procedure described below for compiling the software from the sources instead. If you plan to compile WFDB applications that are not included in the binary packages, please start with the sources.

    If you download the sources (recommended):


    If you download the binaries (not recommended):
  5. If XView is installed, test WAVE.

    Note that WAVE's menus (marked with a nabla) are opened using a right click; if you have a one-button mouse, simulate a right click by pressing and holding the apple key while clicking. Annotation editing requires the use of the middle button, which can be simulated by using the option key while clicking.

    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.
Send feedback about this page to PhysioNet

Your comments and suggestions are welcome. We encourage you to use our feedback form to comment on this page. If you would like to receive a reply, please send your comments by email to webmaster@physionet.org, or post them to:

PhysioNet
MIT Room E25-505A
77 Massachusetts Avenue
Cambridge, MA 02139 USA

Updated Thursday, 07 August 2008 at 15:56 EDT National Institute of Biomedical Imaging and Bioengineering National Institutes of Health National Institute of General Medical Sciences