mpt_plotPWA

MPT_PLOTPWA Plots a PWA function defined over a given polyhedral partition

 handle=mpt_plotPWA(Pn,L,C,Options)

 ---------------------------------------------------------------------------
 DESCRIPTION
 ---------------------------------------------------------------------------
 Plots a PWA function (L*x + C) defined over a given polyhedral partition.

 This function could be used either to plot value of control moves (Fi,Gi) or
 to plot the piece-wise linear cost over polyhedral partition (Ai,Bi)

 USAGE:
   mpt_plotPWA(Pn,Fi,Gi)   to plot value of control moves
   mpt_plotPWA(Pn,Bi,Ci)   to plot linear cost index

 ---------------------------------------------------------------------------
 INPUT
 ---------------------------------------------------------------------------
 Pn                      - Polyhedral partition of the state-space
 L,C                     - cell arrays containing a PWA function
 Options.shade           - Level of transparency (0 = fully transparent, 
                           1 = solid). Default: 1.
 Options.drawnow         - Whether or not to use the drawnow command to refresh
                           the current plot (default is true)
 Options.edgecolor       - specifies the color of edges. Default: 'k'.
 Options.edgewidth       - specifies the width of edges. Default: 0.5.
 Options.extreme_solver  - Which method to use for vertex enumeration 
                           (see help extreme)
 Options.lpsolver        - LP solver to be used
 Options.abs_tol         - absolute tolerance
 Options.newfigure       - If set to 1, opens a new figure window
 Options.showPn          - If set to 1, plots on polyhedral sets Pn,
                           (default: 1)
 Options.samecolors      - If set to 1, pieces of PWA function will be plotted
                           in the same colors as the partition below
                           (default: 0)

 Note: If Options is missing or some of the fields are not defined, the default
       values from mptOptions will be used

 ---------------------------------------------------------------------------
 OUTPUT                                                                                                    
 ---------------------------------------------------------------------------
 handle  - handle of the plot object

 see also MPT_PLOTPWQ, MPT_PLOTU