# Installation instructions

- If you are using Matlab R2014b or later, you may select "Download Toolbox" from the file exchange and all the installation details will be taken care of for you when you install the toolbox. (All the files and folders listed below will be installed.) If you have an older version of Matlab select "Download Zip" from the file exchange and then follow the instructions below.
- Create a new folder called plt (or pltSig if you prefer) in any convenient place on your disk.
- Extract the downloaded archive file (pltSig.zip) into this new folder. Your unzipper must preserve the directory structure. (Unzippers do this properly by default.) After the unzip operation the new folder will contain the files and folders shown below.
- Add the following folders to your Matlab path:
  1. plt
  2. plt\util
  3. plt\demo
  4. plt\sig
  5. plt\math
- You may delete the downloaded pltSig.zip if you prefer.

  plt.m pltinit.m cur.m | Matlab code for the plt plotting package
  plt.htm doc\*.* | Top-level html help file for the pltSig toolbox A folder containing all lower-level html files and images.
  plt.chm | full plt help documentation (compiled from above plt.htm and doc\)
  util\Pebar.m util\Pquiv.m util\Pvbar.m util\pltwater.m util\pltt.m util\pltpub.m | For displaying error bar plots For displaying vector fields (arrows) For displaying functions as vertical bars For displaying 3D waterfall plots For adding traces to an existing plt figure Calls plt with defaults oriented towards publication quality plotting
  util\arrange.m util\b64decode.m util\dealv.m util\funcstart.m util\inifile.m util\matplt.m util\uic.m | Automatically generates object positions. Useful for initializing a GUI. Used to decode base64 encoded text files (such as MPP\MPP.b64 and sig\iir\iir.b64) Similar to the Matlab deal function, except for vector inputs Starts a function running and returns to the caller immediately Used by many of the applications and demos to create or read files in the plt\ini folder Creates a figure for plotting variables contained in a .mat file Like the Matlab uicontrol function but can create multiple controls
  util\figpos.m util\screencfg.m util\workingArea.m | For positioning figure windows (called by plt) Called from figpos to determine screen layout (size, taskbar, etc). Called from screencfg to determine the screen working area. Used by screencfg.m if the automatic method fails
  util\prin.m util\Pftoa.m util\pp.m util\prin.pdf | A powerful alternative to sprintf & fprintf. (Called by plt and its demo programs.) Called by prin. (Implements the additional floating point conversion formats.) Pretty printer for vectors and matrices A complete description of the prin, pp, and Pftoa functions.
  ini\pltColor1.mat ini\erip.txt ini\airspeed.txt ini\glider.jpg | Color specification file: Rename this file to pltColor.mat to use Matlab's default colors. Saved filter specifications. (used by sig\erip.m) Aircraft configuration file. (used by math\airspeed.m) Used by demo\picplot.m if no picture input file is specified.
  ini\afilt.mat ini\demoplt.mat ini\editz.mat ini\erip.mat ini\gpsLog.csv ini\screencfg.txt ini\winplt.mat ini\workingArea.txt | These files are not included with the toolbox, however, they are automatically created when you call plt or some of the included applications and demos.
  demo\demoplt.m demo\pltsig.m | Automatically cycles through the 37 programs in the demo, sig, & math folders (in the order listed below). Like demoplt.m with a more minimal interface. Used to create pltSig.exe, the compiled version of demoplt.
  demo\plt5.m demo\plt50.m demo\pltn.m demo\vbar.m demo\wrkspace.m demo\movbar.m demo\trigplt.m demo\subplt.m demo\subplt8.m demo\subplt16.m demo\subplt20.m demo\picplot.m demo\pltmap.m demo\gui1.m demo\wfalltst.m demo\wfall.m demo\pub0.m demo\pub1.m demo\pub2.m demo\pub3.m demo\xChart.m | Programs demonstrating the use of the plt plotting command and its various features. For descriptions, click here.
  sig\afilt.m sig\editz.m sig\erip.m sig\fseries.m sig\psdZoom.m sig\weight.m sig\winplt.m | Signal processing applications.
  math\airspeed.m math\carlo.m math\circles12.m math\curves.m math\gauss.m math\gpsLog.m math\hermite.m math\julia.m math\motion.m | Applications related to various mathematics and engineering topics
  sig\afiltALT.m sig\afiltS.m sig\parks.m sig\iir\iir.b64 | Alternative version of sig\afilt.m (not run by demoplt) Simplified version of sig\afilt.m (not run by demoplt) Helper function used by sig\erip.m (Parks-McClellan design algorithm) Automatically decoded by erip to create the helper function sig\iir.exe
  ---------------------------- | If you plan on making changes to plt.m or pltinit.m, you will need all the files listed below. Otherwise you may delete them since plt and the applications will run without them. (You also don't need these files to make changes to any of the other .m files.)
  MPP\MPP.CPP MPP\*.mi MPP\*.m | The c source code for MPP, the Matlab Preprocessor (explained here) Example MPP input files Example MPP output files
  MPP\MPP.b64 | MPP Executable for Windows/DOS. This text file is in base64 format because binary files are not allowed on the file exchange. To convert this file to the binary file MPP.exe type the following commands: >> cd(fileparts(which('plt'))) >> cd MPP >> b64decode MPP.b64 .exe Or if you prefer you could use an online converter such as base64decode.org. The file size of the created exe file will be 65536 bytes if it has been decoded properly.
  source\plt.mi source\pltinit.mi source\cur.mi source\abrev.m source\pltcase.m source\pltdef.m license.txt | True source code. Used to create plt.m by the preprocessor (see MPP.exe above) True source code. Used to create pltinit.m by the preprocessor True source code. Used to create cur.m by the preprocessor An include file referenced by plt.mi and pltinit.mi (GUI abbreviations) An include file referenced by plt.mi and pltinit.mi (switch case strings) An include file referenced by plt.mi and pltinit.mi (index definitions) Open source license

### Notes for PC based systems:

If you type plt help or if you click on the Help tag in the menu box included in all the applications, then plt.chm is opened with the Windows help system hh.exe. (which usually resides in the C:\Windows folder) If hh.exe is missing or if you prefer not to use the chm compiled help file, just delete the chm file and plt will instead open plt.htm using your browser.

### Notes for Unix based systems:

If you type plt help or if you click on the Help tag in the menu box included in all the applications, then plt.htm is opened in your browser. This file points to many other html files and images inside the doc folder. If your browser supports chm help files and you prefer to use it, you can do that by deleting or renaming the plt.htm file.