Profile Editor Dialog

Kinetiscope supports several types of programmed reaction conditions, where a system parameter (temperature, voltage or an external stimulus) is constrained to follow a user-defined time profile during the simulation. Yuo specify such a profile as a series of time/parameter value pairs, which is saved as part of the reaction scheme file. Multiple profiles may be defined and stored simultaneously in a reaction scheme file, but only one of the stored profiles will be active at a given time.

This dialog is used to create, modify, select, import and export such profiles. The dialog is invoked from the Reaction Conditions Page and looks like this:


profile editor

Creating a New Profile

To create a new profile:

  1. click the (Add a new Profile) push button on the tool bar.

    A message box appears where you are asked for a unique name for the new profile.

  2. Type a name into the data entry field on the message box.
  3. Click the OK push button on the message box.

    A default profile with two data pairs is created.

You may now edit the default data.

Editing a Profile

Data points may be editing using the table of profile data.

To change a value:
  1. Double-click on the cell you want to edit.
  2. Type in the new value.
  3. Press the Enter key, or move the text cursor to another cell with the mouse.

Values in the Time column have two restrictions:

  • the first Time value must be equal to zero
  • the Time values must increase in order; that is, each Time value must be greater than the value preceding it in the table.

To delete a data pair:
  1. Click the right mouse button over the row you want to delete.

    A context menu appears.

  2. Select Remove this row from the context menu.

    The row is deleted.

To add a data pair:
  1. Click the right mouse button over the row immediately above the place where the new row should be inserted.

    A context menu appears.

  2. Select Insert a new row from the context menu. A new row is added to the table.

  3. Type valid numeric values into the two new cells.

Selecting a Profile

To select an existing profile:

  1. Click on the Stored Profiles drop-down list box at the top of the dialog.

    A list of all profiles stored in the reaction scheme appears.

  2. Select a name from that list to make the profile active for editing.

The active profile is the one used by Kinetiscope when carrying out a simulation.

Deleting a Profile

To delete a profile:

  1. If necessary, use the Stored Profiles drop-down list box at the top of the dialog to make active the profile to be deleted.
  2. Click the (Remove the current profile) push button to delete that profile from the reaction scheme.

Importing a Profile From a Text File

You may import a profile from a regular text file.

To import a profile:
  1. Click the (Import a profile) button.

    A File Open Dialog appears.

  2. Use the File Open Dialog to select the file to be imported.
  3. Click Open on the File Open Dialog to import the profile.

When importing the text file:

  • Kinetiscope expects the text file to be a series of pairs of numeric values, one pair per line.
  • The first entry in each pair is taken to be the time value, in the same time units in use in the reaction scheme. The second entry in each pair is the value of the programmed parameter.
  • The series of entries must follow the rules for profile data: the first time value must equal zero, and time values must be in increasing order.
  • Kinetiscope converts each line to numeric values as the file is read. If a line does not contain two valid numeric values as the first two words, then that line is not added to the profile. Therefore you may include non-numeric text such as column heading in the text file.

Here is an example of the contents of a valid text file: 

time temperature
0.0  298.0
1.0  298.0
2.0  350.0
3.0  375.0
4.0  385.0

The column labels are optional.

Exporting a Profile to a Text File

You may export a profile to a regular text file.

To export a profile:
  1. Click the (Export a profile) push button.

    A File Save Dialog appears.

  2. Use the File Save Dialog to choose the file name and location of the exported profile.
  3. Click Save on the File Save Dialog to create the profile file.