Volume Plot Window

A volume plot window displays an graph of simulation results for a three-dimensional array of compartments.

To create a volume plot window:

  1. Select all (or none of the) compartments in the scheme diagram of a three-dimensional scheme window.
  2. Click the (Create new results window) push button on the main window's tool bar.

    A Volume Plot Style Dialog is then displayed.

  3. Using the Volume Plot Style Dialog, select the parameter and species you wish to plot.
  4. Click the OK push button on the Volume Plot Style Dialog.

    The dialog is dismissed and a new results window is added to Kinetiscope's main window according to your specifications:

On this window all three axes mark the compartments' locations in sequential order. The values of the parameter you selected (e.g. concentration or amount) for each compartment are displayed as a color map; the legend for the color map is positioned to the right of the graph.

When first created, the window is scaled so that all data points are visible and the parameter values at zero elapsed time are displayed. The current value of the elapsed time is displayed in the title text above the graph.

Animation of the Graph

To view the parameter values at other points in elapsed time, use the set of animation tools positioned below the graph:

Elapsed Time Slider

Use the slider control to change the elapsed time currently displayed.

To change the elapsed time:

  1. Move the mouse cursor over the slider handle.
  2. Press and hold the left mouse button.
  3. Move the slider handle to the right or left to move the elapsed time point forward or backward, respectively.
  4. Release the mouse button when you are viewing the time point of interest.

You also may move the elapsed time forward or backward in steps by clicking on the slider to the right or left, respectively, of the slider handle.

Step Size Control

By default, an animation displays the parameter values at every elapsed time point recorded during a simulation. Use this control to increase the size of the steps taken during the animation, so that only every nth elapsed time point is displayed. Use the up or down arrows to increase or decrease the step size. The step size changes by factors of two.

Frame Rate Dial

This dial control sets how long the animation pauses at each elapsed time point. Press the left mouse button while the mouse cursor is over the marker on the dial, and rotate the dial clockwise to increase the frame rate and counterclockwise to decrease the frame rate.

Animation Push Buttons

These allow you to control a timed animation (a "movie") of the plot to view how the parameter changes with time.

The push button functions are:

Move to start.
Clicking this push button sets the elapsed time slider to zero time. The plot displays the parameter values at zero elapsed time.
Play in reverse direction.
Clicking this push button starts an animation from the current elapsed time point, in the direction of decreasing time.
Play in forward direction.
Clicking this push button starts an animation from the current elapsed time point, in the direction of increasing time.
Pause.
Clicking this pauses the animation at the current elapsed time point. When paused, you may continue the animation by clicking on one of the Play push buttons.

This push button is only visible if an animation is actively playing.

Move to end.
Clicking this push button sets the elapsed time slider to the last time point. The plot displays the parameter values at that elapsed time.
Reset.
Clicking this push button stops any animation, moves the elapsed time slider to zero elapsed time, sets the step size control and the frame rate dial to their initial default values.
Record to file.
This push button prepares Kinetiscope to record the next animation and save to a video file.

To record a video of the animation:
  1. set the elapsed time slider, step size control and frame rate dials to the values you wish to use.
  2. click the Record to file push button.

    a File Save Dialog appears. Use this to select a location and name for the video file and then click the dialog's Save push button.

  3. Start the animation by clicking one of the Play push buttons.
  4. the recording will stop when the elapsed time slider reaches its endpoint, or when you click the Pause, Reset, Move or Record push buttons.
  5. Kinetiscope then processes the recorded data to create a video file.

    A message box notifies you when processing is complete. The video file is saved in MPEG format with the .mpg file extension.

Mouse Actions

You may scale, move and rotate the graph using the mouse.

To rotate the plot:
  1. Press and hold the left mouse button while over the plot.
  2. Move the mouse cursor while still holding down the button.

    The plot changes orientation around a horizontal axis and a vertical axis in coordination with the mouse movement.

  3. Press the Shift key and move the mouse cursor, while still holding down the left button, to rotate the plot around the axis perpendicular to the screen.
  4. When the plot is oriented as you want, release the mouse button.
To zoom the plot:
  • Rotate the mouse wheel forward or backward to change the zoom..
To move the plot:
  1. Double-click and hold the left mouse button while over the plot.
  2. Move the mouse cursor while still holding down the button.

    The plot changes location in coordination with the mouse movement.

  3. When the plot is located as you want, release the mouse button.

You also can rotate, zoom and change plot proportions from the Attributes Page of the Three-Dimensional Plot Settings Dialog.

Changing the Plot Scales

You may change the minimum and maximum limits of all three scales by typing in precise numeric values.

To rescale the plot:

  1. Double-click the left mouse button anywhere on the plot.
  2. A Three-Dimensional Plot Settings Dialog opens on its Limits page. Type or select minimum and maximum values for the ranges of the three axes.
  3. Click OK. The dialog closes and the graph is rescaled to your specification.

Text View

You may display all the numeric data that comprises the current graphical view as a text-based table. You use the graphical view's context menu (see below) to switch to this display. The table may be exported to a text file.

Context Menus

Context menus for both the graphical and text views of this window are accessed using a single click of the right mouse button.

The context menu of the graphical view provides the following actions:

Modify...
This action opens a Three-Dimensional Plot Settings Dialog on its Attributes page. There you may change the color map and the plot's orientation and scaling.
Copy
When this menu item is selected, a bitmap image of the plot is placed on the system's clipboard. This image may be pasted into other applications.
Export to Image File...
When this menu item is selected, a File Save Dialog appears that allows you to save an image of the plot to a disk file. The image is saved in Portable Network Graphics (.png) format.
Export Data...
this menu item displays a submenu enabling you to export the data you currently are viewing graphically as a file in a number of non-graphical formats.
Show in Text Format

The context menu of the text view provides the following actions:

Export to Text File...
When this menu item is selected, a File Save Dialog appears that allows you to save the tabular text to a disk file.
Show in Graphical Format
Selection of this menu item switches the window from text format to graphical format.
Select All
This action selects all text for a pending Copy operation. You may select a portion of the table to copy by holding down the left mouse button while moving the mouse cursor over the text.
Copy
When this menu item is selected, a copy of any selected text is placed on the system's clipboard. This text may be pasted into other applications.
Zoom In
Selection of this menu item increases the font size of the text table.
Zoom Out
Selection of this menu item decreases the font size of the text table.