home
download
class models
standard gui
custom gui
models
user guide
problems
 

Standard user interface components

SimpleValue


about the class

[SimpleValue_thumbnail] The basic components for setting model parameters. You can change the value by sliding the knob, or with the arrow buttons, set the range by dragging the endpoints, or just type in a number from the keyboard.

 

SimpleGraph


about the class

[SimpleGraph_thumbnail] Most Catacomb graphs and diagrams allow zooming, panning and selecting regions with the mouse. A left click zooms in keeping the clicked point fixed. Clicks with the right button zoom out. Long clicks with the left button and clicks with the CTRL key held down also zoom out. Clicking to the left of or below the axes scale only that axis. Press-drag-release moves the data with the mouse. Pressing "f" with the mouse over the diagram recenters the data in the window.

 

AppletConfig


about the class

[AppletConfig_thumbnail] The appletizer lets you package up a group of windows in a single panel which can then be saved and reloaded as an applet from a Web site. There is a short cut to the applet tool under the misc menu. The process works by defining one or more AppletConfig objects which contain a specification ofthe desired applet: what panels to include, how to arrange them, and any documentation to go with them.

 

BinaryControl


about the class

[BinaryControl_thumbnail] On-off control of multiple channels. Channels can be added as required and switching between their two possible states can be defined by toggling points on a grid or dragging regions of activity for fine control of timing.

 

CalcResults


about the class

[CalcResults_thumbnail] The results of most calculations come in the form of CalcResults objects. The data may be graphed or displayed as a table. In the first case all the usual mouse operations apply as described under the SimpleGraphEditor. Menus change according to the results provided by the calculation and control how the data is displayed.

 

CalcResults3


about the class

[CalcResults3_thumbnail] For models which produce 3-D stratified data, such as the concentrations of a set of species on a 2-D grid. Selected variables are shown as images. You can take slices along either axis and export them to simpler displays.

 

Catacomb


about the class

[Catacomb_thumbnail] This is usually the window you will first see on starting Catacomb. It contains menus for loading and saving files, accessing the models the current version has pre-loaded, making new instances of top level objects and a few other functions. The display shows the current object hierarchy. Clicking on a box brings up a window to examine that part of the model, and possibly other windows to display the results of any calculations it defines.

 

CcmbNet


about the class

[CcmbNet_thumbnail] Many Catacomb objects take the form of a set of nodes with various links between them (e.g. IaFNetwork, KSChannel, ReactionScheme). These share most of their editing properties, and are all subclasses of CcmbNet.

 

ColorTable


about the class

[ColorTable_thumbnail] Color tables define mappings between values and colors for the display of results. The number of colors, the range of values they correspond to and the treatment of values outside this range can be set.

 

ColorTarget


about the class

[ColorTarget_thumbnail] Every object in Catacomb has its own color and name that distinguish it from other objects of the same type. Colors are also used in color tables for displaying image data. The color target editor is used for setting a single color for an object, a line in a graph, or as part of a color table.

 

DataClipboard


about the class

[DataClipboard_thumbnail] On importing data to Catacomb, either as an ascii file or certain types of raw binary data (so far, just ABF files) it appears on the data clipboard. From here you can pick it up and drop it on any graph display to appear in the background for comparison, or on particular components such as a DiffMeasure. Data saved from the results of calculations also appears on the DataClipboard.

 

DiffMeasure


about the class

[DiffMeasure_thumbnail] Root mean square difference measure between the results of a calculation and data either from an earlier calculation or read from a file. There is a running display of the current difference measure continually updated as any parameter in the model is changed.

 

ErrorLog


about the class

[ErrorLog_thumbnail] A log of what has gone wrong. Occasionally it contains useful information, about why what you expect may not be happening. More often it contains obscure details for debugging purposes. All being well, the amount of the former is growing and the latter decreasing.

 

FieldConfig


about the class

[FieldConfig_thumbnail] By default, Catacomb shows you everything there is to know about a model - that is, everything that would be saved in a file. Sometimes however, it is convenient to cut out some of the complexity and only look at a few parameters. A FieldConfig object contains information on what should and should not be seen at any particular viewing level.

 

HelpTarget


about the class

[HelpTarget_thumbnail] An on-line help browser. Most Catacomb documentation is available within the application itself or in model description files. In either case, it can be viewed through the browser. The html documentation contains all the same material but also some more general information which is not related to any particular component.

 

HistogramSet


about the class

[HistogramSet_thumbnail] Where the results of a calculation are a set of independent points, such as measurements performed on a set of randim instances of some process, then the data are often presented as a HistogramSet. The mean and variance of each measurement are displayed on the right, and selected histograms are shown in detail on the left with the specified bin width.

 

InfoMessage


about the class

[InfoMessage_thumbnail] They may occasionally pop up, and are probably worth a read. But, they are not insistent: they do not block other activity until you click OK.

 

LabelledDrawing


about the class

[LabelledDrawing_thumbnail] Just that - a drawing with labels. Not much use on its own. The only subclass so far is the MeshedDrawingEditor which also constructs a triangular mesh on the regions defined in the drawing ready for use in ReactionDiffusion calculations.

 

LineSet


about the class

[LineSet_thumbnail] Most catacomb calculations yield a series of lines showing different quantities as a function of one variable. These can be edited, exported, sparsified and generally manipulated with the LineSetEditor. It is mainly handy for cleaning up big data files when they contain more lines than you want or a smaller sampling interval. All LineSet instances appear on the DataClipboard.

 

MeshedDrawing


about the class

[MeshedDrawing_thumbnail] For constructing 2-D systems of regions, points and lines, and making triangular meshes on them ready for solving 2-D or rotationally symmetric 3-D field problems. You can drag elementary components onto the drawing area and extend them as required.

 

MultiDiffMeasure


about the class

[MultiDiffMeasure_thumbnail] A MultiDiffMeasure evaluates a DiffMeasure repeatedly while gradually changing one parameter in the model. The results are plotted as they arrive. Unlike most parts of catacomb, the quantities required by a MultiDiffMeasure can legitimately come from almost anywhere in the model so it uses the CatacombEditor drag and drop facility.

 

ObjectInfo


about the class

[ObjectInfo_thumbnail] Any Catacomb object that is part of a model can include its own documentation. This is particularly important for top level objects and AppletConfig objects for which it gets built into the Web pages when they are catalogued. But any time you use the on-line browser it will fish around for object documentation and present this in the instances in current model line at the bottom of the page.

 

PhaseDiffMeasure


about the class

[PhaseDiffMeasure_thumbnail] Phase difference measures take the results of a calculation in phase space, and convert them to an image. The error between two models or a model and external data is then calculated as some function of the difference in pixel intensities.

 

Profile


about the class

[Profile_thumbnail] Set up voltage, current or other command Profiles. Points can be added singly or in predefined groups and sections of a Profile can be cut out to define new groups. Points can be positioned relative to any other point in the Profile so a range of different scaling behaviors can be achieved.