Viewing the Simulation Results

To view the results of a simulation with Kinetiscope, you must first construct a reaction scheme, where you enter the reaction mechanism, conditions and species data. You then run a simulation, first specifying simulation settings and then starting Kinetiscope's simulator.

After Kinetiscope has finished a simulation, you view the results by creating a results window. Simulation results are saved to the reaction scheme file immediately upon completion, so the results also can be viewed at a later time by reloading the file.

About Results Windows

A results window displays simulation results, initially in a default graphical format. You can then modify the window to show an expanded or restricted data set, to change plot characteristics, and so on. The plotted data can be viewed as tables of text. You can create multiple results windows for a reaction scheme to simultaneously view the simulation results in different formats.

Results Windows Styles

Kinetiscope can draw a number of different plot styles. Most are applicable only to three-dimensional reaction schemes. For single reactor reaction schemes and compartmental reaction schemes, results windows are always in the style of x/y line plots.

The following styles are available (click on each image for more detail):
Line Plot
This is a conventional x/y plot of two parameters, typically concentration or amount versus elapsed time. The window may be modified to display multiple graphs. (More on this style...)
Contour Plot
This style displays one parameter, typically concentration or amount, as a color map or set of contours, plotted as a function of elapsed time on one axis and the compartments' ordinal positions on the other. (More on this style...)
Waterfall Plot
This style displays one parameter, typically concentration or amount, on the vertical axis, plotted as a function of elapsed time and the compartments' ordinal positions on the other two axes. (More on this style...)
Surface Plot
This style displays one parameter, typically concentration or amount, on the vertical axis, and the compartments' ordinal position on the other two axes. The plot is animated to show how the plotted parameter changes with time. (More on this style...)
Volume Plot
This style displays one parameter as a color map, typically concentration or amount, plotted as a function of the compartments' ordinal positions on the other three axes. The plot is animated to show how the plotted parameter changes with time. (More on this style...)
Text Listing
For all of these plots, a text listing of all the data is available for viewing and export. (More on this...)

Creating a Results Window

To create a results window for a single-reactor reaction scheme:

  1. On the single reactor scheme window, activate the Scheme Page by selecting its tab.
  2. Click on the (Create results window) push button on the tool bar.

    A new results window will appear within the main window.

To create a results window for a compartmental reaction scheme:

There are two equivalent methods:

  1. On the compartmental scheme window, activate the Scheme Page by selecting its tab.
  2. Select a compartment by clicking with the left mouse button.

    The selected compartment will appear cross-hatched.

  3. Click on the (Create results window) push button on the tool bar

    A new results window will appear within the main window.

or
  1. On the compartmental scheme window, activate the Scheme Page by selecting its tab.
  2. Click the right mouse button on a compartment.

    The selected compartment will appear cross-hatched, and a context menu will appear:

  3. Select the Show Contents vs Time menu item from the context menu
  4. A new results window will appear within the main window.

Creating Results Windows for Three-Dimensional Reaction Schemes

With three-dimensional reaction schemes, you indicate the plot type you want to create by how you select compartments within the scheme diagram on the Scheme Page:
If you select a single compartment, the results window initially displays the contents of that compartment as a Line Plot.
If you select a column or row of compartments (that is, a contiguous 1 x 1 x m array, where m is greater than 1), the results window will display data from the array of compartments as either a Waterfall Plot or a Contour Plot.
If you select a plane of compartments (a contiguous 1 x m x n array, where m and n are greater than 1), the results window will display data from the array of compartments as a Surface Plot.
If you select all compartments in a three dimensional scheme (to give an m x n x p array where m, n and p all are greater than 1) then the results window will display data from all compartments as a Volume Plot.
If no compartments are selected, then Kinetiscope selects the plot type based on the dimensionality of the compartment array and creates the appropriate results window.


Note: When creating the plot you must select a complete row,column or plane in the reaction scheme diagram. If you wish to view only a portion of those arrays you may adjust plot limits after the plot has been created.


To create a results window for a three-dimensional reaction scheme:

  1. On the three-dimensional scheme window, activate the Scheme Page by clicking its tab.
  2. Click the right mouse button over a compartment.

    The selected compartment will appear cross-hatched, and the compartment's context menu will appear.

  3. From the context menu, choose the Select... menu item. The following submenu appears:

  4. From this submenu, choose one of the listed actions to select the compartments to be included in the plot.

    The selected compartments will be highlighted by cross-hatching.

  5. Click on the (Create results window) push button on the tool bar.
  6. If you have selected a single compartment, a new results window will immediately appear within the main window.
  7. If you have selected multiple compartments, a Plot Setup Dialog specific to the plot style will appear.

    When you close that Plot Setup Dialog by clicking its OK push button, a new results window will be added to Kinetiscope's main window.