Current Kepler Configuration System

This page documents all of the ways in which Kepler can be configured. The intent is to act as a reference for developers, but more importantly to gain an understanding of configuration as a whole so it can be simplified and rationalized.

Relevant Configuration Files

lib/config.xml

The Kepler splash screen image.
The Jar library directory.
Whether to auto-refresh data sources (registry entries).
Whether to output standard output and error to a log file.
Create cache folders in .kepler and supply SQL commands to create necessary tables.
A list of style sheets and associated parameters used to transform EML (Ecological Metadata Language) XML documents.
The URL for the GEON server, including associated documentation.
A specification of a data type dictionary, which consists of a list of data types and associated information.
A specification of a particular database to be used for the cache, in particular HSQL.
A specification for ecogrid services.

configs/ptolemy/configs/kepler/configuration.xml

The class to manage configuration. ( ptolemy.actor.gui.Configuration ).
The HTML file to display in the about screen.
A list classes that should be removed by MoMLFilter.
The HTML file to display copyright information for the application as a whole.
The HTML file to display copyright information for the ImageJ actor.
The HTML file containing a list of demos.
The image file with the Kepler icon.
The class containing an alternative getMoml() method. ( org.kepler.moml.GetMomlFromLSID ).
The default directory to open when File->Open is selected.
The custom menu bar for Kepler. ( org.kepler.gui.KeplerMenuHandler ).
The "icon handler" for Kepler. ( org.kepler.gui.KeplerXMLIcon ).
The name of the application. (i.e. "Kepler")
Whether to use a blank Graph Editor at startup.
The HTML file to display help contents.
An unspecified directory that contains open models.
The class that initializes the application. ( org.kepler.gui.KeplerInitializer ).
The class that specializes the documentation system. ( org.kepler.gui.KeplerDocApplicationSpecializer )
The remote URL that contains generated Javadoc. (#"
Whether multiple documentation windows are allowed at the same time.
A list of XML files which are known as "effigy factories."
A list of XML files which are known as "tableau factories."
The names of the classes which specify the visual arrangement of the library pane, known as "library tableau factories."
The names of the classes that generate the tabes in the library pane.
The names of the classes that generate tabs in the window which appears after Tools->Preferences is selected.
The names of the classes that enable scrollbars on the Vergil canvas.
The names of the classes that manage searching through the library.
The names of the classes that create the GUI pane for searching through the library.
The names of the classes that control the context menus for actors, directors, etc.
The names of the classes that control the context menus for the workflow canvas.
A specification for ecogrid search.
Settings for configuring a custom library builder. This is where you specify the classes that read kar files.
Properties excluded from the docviewer.

configs/ptolemy/configs/kepler/ConfigGUIAndCache.xml -- ptolemy.actor.gui.Configuration for running a workflow from the command line with GUI actors and Kepler cache.

configs/ptolemy/configs/kepler/ConfigGUINoCache.xml -- ptolemy.actor.gui.Configuration used when running a workflow from the command line with GUI actors and no Kepler cache.

configs/ptolemy/configs/kepler/uiMenuMappings_en_US.properties

Mappings of menu item names to either a Ptolemy equivalent menu item or to a fully qualified Kepler class that manages the menu functionality.

configs/ptolemy/configs/kepler/uiContextMenuMappings_en_US.properties