Copyright (C) 1993 Peter Kabal

The program dfir and its constituent routines are provided free of charge
without warranty of any kind.  All components are copyrighted.  They may be
distributed free of charge provided that the recipients also acquire the
right to distribute them.  In no case can this software be incorporated into
a work which is distributed for a fee.


DFIR

The main source files are in the top directory.  Two library directories
contain additional source files.  A test directory has a test file to
exercise dfir.

Customization:

The dfir package has been run on Decstations under Ultrix using the DEC
Fortran compiler and on Suns using SunOS Fortran.

An earlier version of this program ran under VMS.  A collection of VMS
replacements for some of the routines from that earlier version is in
the directory vms.

For other machines, the main distribution is a good starting point.
The files d1mach.F and r1mach.f in libnet/core/machine specify machine
constants and need customization.  The values returned by d1mach and r1mach
are used in libnet/cacm-toms/rpoly.f which is invoked by the Nyquist filter
and minimum phase Nquist filter designs.  The modules d1mach and r1mach have
a choice of constants for a wide variety of machines.  On many unix systems,
a file with a .F extension is automatically pre-processed by cpp before
being passed to the fortran compiler.  As supplied d1mach.F includes
conditional code for "sun" and "ultrix" systems.

The other routines which are specific to Unix are:
  halt.f and warn.f - Assume unit 0 is standard error
  halt.f - uses exit
  ttyfun - uses isatty
  rdline - uses getarg and iargc to get command line arguments

Building dfir on Unix:

For Unix systems, use the Makefile to create an executable called dfir.
  % make

Testing:

The test directory has a Unix script for running a number of sample designs.
This can run as
  % ./tdfir > tdfir.log
In this directory are sample outputs for a run on a DECstation and on a Sun.
Run diff on the log files to see if there are any significant changes to the
output compared to the reference outputs.

Documentation:

The header for file dfir.f documents the program.  This header is available
separately as dfir.doc.

$Id: INSTALL,v 1.5 1993/02/05 15:35:11 kabal Exp $
