DrawFilt -- DRAWing FILTers and systems in MATLAB
Version 2.8
Copyright 1999-2005 Miroslav D. Lutovac and Dejan V. Tosic

Authors: Prof. Dr Miroslav D. Lutovac, Prof. Dr Dejan V. Tosic
lutovac@kondor.etf.bg.ac.yu    http://kondor.etf.bg.ac.yu/~lutovac/
tosic@galeb.etf.bg.ac.yu       http://www.rcub.bg.ac.yu/~tosicde/
   
DrawFilt is a MATLAB toolbox for creating schematics of filters and systems.
By mouse point-and-click you draw schematics in MATLAB figure windows. 
The filter schematic is saved as an M-file, and can be called 
as a stand alone function. You can use this function in your 
MATLAB scripts to illustrate or document the filter realization 
that you work on. DrawFilt produces publication quality 
filter schematics; the diagrams can be imported 
into your word processor as EPS, WMF or BMP figures. 
DrawFilt is easy to use, intuitive, and it is based on standard 
built-in MATLAB commands. Albums of example schematics 
accompany DrawFilt -- afalbum.m, scalbum.m, dfsalbum.m and dfalbum.m scripts.
Run demodraw.m script for a quick tour about DrawFilt features.
 
INSTALLATION: DrawFilt is distributed in compressed form as the file
DF28.zip. Decompress DF28.zip with path names. You obtain

DrawFilt
DrawFilt\album
...

DrawFilt directory has to be appended to the MATLAB path.
For example, add DrawFilt to the MATLAB path with
path(path,'C:\afd\DrawFilt')

RUNNING: Run MATLAB and execute the following main scripts:

drawfilt.m  --  Draw digital and analog schematics

DRAWING: After invoking drawfilt.m the DrawFilt main window appears,
and you can draw a digital or analog schematics.
A schematic is a system of interconnected components:
delays, multipliers, adders, etc. (for digital filters), and
resistors, capacitors, amplifiers, etc. (for analog filters).
Click the Mult button to draw the multiplier (gain),
click the R button to draw the resistor, and so on.

Enter the position of element nodes by mouse click, 
(nodes are automatically snapped to the grid).
The element is centered between the selected nodes.

For example, if you want to draw a delay, 
click the Delay button, 
point and click where the first node should appear, and 
point and click where the second node should appear.
You can draw only horizontal or vertical elements.

LINE, _|, and |_ buttons draw line segments which connect nodes.
IN and OUT buttons draw small circles that
identify filter input and output, respectively.
NODE button puts a dot that designates a node.
TEXT button adds a text label to the schematic.

NEW button clears the schematic so you can start a new drawing.
OPEN/SAVE button opens/saves schematic from/to a file.

Parameters can be edited by the EDIT button.
DELETE button erases selected schematic objects,
UNDO undoes the last deletion.

MA button creates a Mathematica package for drawing
the current schematic in a Mathematica notebook.
The name of the schematic package is *.mma and 
it is saved in the directory where MATLAB schematic *.m resides.
Run Mathematica and open *.ma notebook to draw the schematic.

A group of buttons operates on the current file *.m
(which is initially named untitled.m),
and you can use them for quick save or open. In addition
the EPS button converts *.m to eps format.
The view button previews *.m without the grid and buttons.
Issue the help command to see how to call *.m as a
MATLAB function, i.e. type "help untitled" in the command window.

The example buttons show various filter schematics.

DrawFilt saves a filter schematic as a MATLAB function 
which can be called from within your MATLAB scripts. 
Feel free to COMBINE the schematic with your scripts and plots.
Start dfalbum and click the button "draw +" to get an idea 
how you can use a DrawFilt drawings in a MATLAB subplot.

To get updates of DrawFilt join our AFD e-mail list; contact us at
lutovac@kondor.etf.bg.ac.yu   or   tosic@galeb.etf.bg.ac.yu

================================
THE COPYING PERMISSION STATEMENT
================================
Copyright 1999-2005 Miroslav D. Lutovac and Dejan V. Tosic
This file is part of DrawFilt.

DrawFilt is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
any later version.

DrawFilt is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with DrawFilt; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

DrawFilt is distributed with the GNU General Public License.
This licence is contained in the file LICENCE.TXT.

----------------- end-of-README.TXT ------------------------
