COGENT Online
CONTENTS
COGENT Help

Inside boxes

This section describes the user interface used to view and edit a model and its subboxes. Recall that a model can be thought of as a single compound box hence the dialog used to access a model is essentially the same as that used to access a compound box.

Opening a model

Figure 1: Editing a model

When a model is opened a set of tabs appears, allowing the user to view and edit the contents of the model. The dialog (see Figure 1) contains five tabs. As we shall see below, a similar dialog is used to give the user access to the boxes within a model.

  1. The Properties tab allows the user to edit and view the properties of the top-level compound box containing the model
  2. .
  3. The Initial Contents tab allows the user to view and edit the model's sub-boxes. Sub-boxes may be added, deleted, or edited as described in the documentation for compound boxes.
  4. The Description tab contains a textual description of the model.
  5. The Messages tab shows a trace of all the data that has been sent or received by the top-level compound box. This tab will in practice be empty but is provided to make the dialog consistent with those other compound boxes in the model
  6. The Full Details tab contains a more complete but uneditable description of the model. The form of the full details tab depends on a various options that may appear in the View menu (these menu items are only enabled while the full details tab is displayed). Specifically the full details tab can display:

Opening a sub-box

A sub-box of a compound box can be opened by double clicking on it. A separate window then appears containing a set of tabs which allows the user to view and edit the sub-box. An example is shown in Figure 2. The dialog contains between five and seven tabs

Figure 2: An open sub-box.

  1. The Properties tab allows the user to edit and view the properties of the box.
  2. The Initial Contents tab allows the user to view and edit the initial contents of the box. The contents of a box depend on its class. Sinks contain actions. Analogue buffers contain graphical objects, expressed as prolog terms. Propositional buffers contain arbitrary prolog terms. Processes contain rules and conditions. Compound boxes contain other boxes.
  3. The Description tab contains a textual description of the box.
  4. The messages tab shows a trace of all the data that has been sent or received by the box.
  5. The full details tab shows a fuller, but uneditable, view of the box and (optionally) its subboxes. The full details tab for a sub-box is similar to that for the model itself (see above) and can be modified using the same options in the View menu. However setting the View->Recurse Through Boxes has no effect unless the currently open box is a compound, in which it causes the subboxes of that compound to be displayed.
  6. The Current Contents tab shows the current contents of a box, and is only available for buffers, sinks, and sources. The current contents are prolog terms.
  7. If the current contents of a box have a graphical representation, as is the case with table sinks and analogue buffers, then an additional tab will be provided to display this graphical representation.

COGENT Online
CONTENTS
COGENT Help