file: UNIX.TXT G. Moody 1 February 1995 Last revised: 25 May 1997 Notes on installing and using the DB Software Package and WAVE under UNIX The DB Software Package is a set of applications that can be used to manipulate digitized recordings such as those in ../database, and those available from ecg.mit.edu. WAVE is an X Window System application designed for viewing and analyzing such recordings interactively. All of these applications are built using the DB library, a package of functions (subroutines) for reading and writing data files in the formats used for these recordings (among others); the DB library may be incorporated freely into your own applications written in C or C++ (among other languages). For general information on the DB Software Package and WAVE, see the file `software/README.TXT'. Installing the DB Software Package and WAVE =========================================== Precompiled binaries of the DB Software Package, version 9.7, and of WAVE, version 6.1, are available for use with several versions of UNIX: If you have: then use: CPU: 386/486/Pentium OS: Linux (ELF) linux.tar, common.tar, install.unx Linux (a.out) linuxold.tar, common.tar, install.unx CPU: SPARC OS: Solaris 2.x solaris.tar, common.tar, install.unx SunOS 4.1.x sunos.tar, common.tar, install.unx If your CPU and OS are not listed above, you can still compile the DB Software Package from the C sources using any K&R or ANSI/ISO C compiler. Sources for the DB library and some or all of the applications are included in db.tar.gz (available from our FTP server) or within the `db' directory. (Our `Samples of Physiologic Databases' CD-ROM contains the same subset of sources available from our FTP server; several of our other CD-ROMs, including this one, contain the entire DB Software Package in source form. To obtain one of these CD-ROMs, see ../ORDER.4M.) At present, WAVE is available only for the operating systems listed above. If your CPU and operating system are listed above, and you wish to install the precompiled binaries into /usr/local, log in with root permissions. Type sh install.unx (from within this directory). Follow the instructions that will be presented on-screen to set your environment variables before using the DB applications. Also be sure to read the remainder of this file for information specific to your version of UNIX. (Copy install.unx and edit the copy if you need to make changes; for example, change the reference to /usr/local within install.unx if you wish to install the DB Software Package into a different directory.) (If you wish to remove the files installed by `install.unx', log in with root permissions and type: sh uninst.unx from within this directory.) If your CPU and operating system are not listed above, you can compile all or selected portions of the DB Software Package, version 9.7, from the sources provided in `db', using any K&R or ANSI/ISO C compiler to do so. See the files named `Makefile' in `db' and its subdirectories, as well as the files `UNIX', `LINUX', and `SUN' within the `db' directory, for details on compiling the source files. If you can supply or can test a `tar' archive of the DB Software Package in precompiled form for a CPU or UNIX version not listed above, for inclusion in a future edition of this disk, please write to me (george@hstbme.mit.edu). Using the DB Software Package ============================= Refer to the ECG Database Programmer's Guide (../html/dbpg/dbpg.htm) and the ECG Database Applications Guide (../html/dbag/dbag.htm), for details on using the applications provided and on writing your own applications to read and write compatible files. For general information about using WAVE, refer to the WAVE User's Guide (../html/wug/wug.htm). Type `wave' with no command-line arguments to get a brief summary of options and instructions for printing a concise reference manual. WAVE and all of the applications in the DB Software Package use the shared version of the DB library. This allows great flexibility as well as modest savings in disk space and execution time. Since the shared library can be replaced without the need to recompile the applications that use it, you can modify the library, for example to add support for additional file formats. For details on this and related subjects, see the ECG Database Programmer's Guide.