Contents - Index



$OverlayPlot Name='my Plot' Table='myTable'  X=Xvar  Y=Yvar  Rows=1..10  LineStyle=1  Symbol=4  SymbolSize=10 Color=Blue  Legend='legend text'   Scale=Right   ErrorBars   PointLabels   ConnectLasttoFirst   AutoUpdate



This directive will overlay a plot in the existing plot window having the plot window tab name provided after the Name= keyword. The plot tab name may be either a string constant within single quotes or a predefined EES string variable.   (EES will also accept a numerical value indicating the position of the plot tab.  By default, data are plotted on the left Y axis.   



The name on the tab of the table from which data will be plotted follows the Table= keyword.  Note that the table could also have been identified by entering PARN, LOOKN, or ARRN where N is the tab number of the Parametric or Lookup tables.  You can use ARR for the first Arrays table or INT for Integral table. 


X=Xvar     Y=Yvar

Plot variable Xvar on the X-axis and Yvar on the Y-axis. Xvar and Yvar must appear in the specified table.  When plotting variables from the Arrays table (ARR or ARRN) specify the array name as XXX[i], where XXX is the parent name of the array variable.  In addition, the X-axis variable can be:

     X=Index causes the index number of an Array to be used as the X-values.  

     X=Run_Number causes the run number of a Parametric Table to be used as the X-values.

     X=Row_Number causes the row number of a Lookup table to be used as the X-values



The following keywords are optional.


Rows=1..10  {indicate the rows that are to be plotted. All rows are plotted by default.}


Symbol, SymbolSize, Color and LineStyle indicators may be an integer or an EES variable.  (See $NEWPLOT for a list of these parameters.)


Legend causes a legend item to be created.  The legend text following the = sign can be a string constant of string variable that has been previously defined.  If a string constant is used and it has embedded spaces, it it necessary to surround the text with single quote marks.  If an equal sign is provided after the Legend keyword, it will be assumed that the legend text is the same as the name of the Y-axis variable.  


Scale=Right keyword indicates that the data will be plotted on the right Y-scale.  


ErrorBars will cause error bars to be drawn if the data that are plotted contain uncertainty information. 


PointLabels keyword places a label next to each plotted point.  By default, the label is an integer corresponding to the array position (when plotting from the Arrays window) or row (when plotting from the Parametric or Lookup tables).  The point labels keyword can be optionally followed with a /ColName, where ColName is the name of a column in the table that is being plotted.  In this case, the point labels will be set to the value (or string) in the specified column of the table rather than to the row or array position.  The column number can be provided as an alternative to providing the column name.   An example is provided in the description of the NewPlot macro command


ConnectLasttoFirst keyword will cause a line to be drawn from the last plotted point to the first point.  This option is useful when plotting thermodynamic cycles. 


AutoUpdate will cause the plot to be updated whenever the data in the table change.



NOTE:  The $NewPlot provides an alternative to using the OverlayPlot macro commandMacro commands provide additional plotting options. This directive can only be used with a Professional license.



See also: $NewPlot