A knowledge-based electronic information and documentation system

ABSTRACT

We describe the capabilities of a knowledge-based system to automatically generate a collection of electronic notebooks containing various forms of online documentation and reports. This system is a subsystem of a larger knowledge-based system called SciNapse. SciNapse's raison d'etre is to transform high-level simulation problem specifications into executable numerical programs. The electronic notebooks are generated from the same domain knowledge bases that the system uses to perform its primary tasks. These online notebooks are of two different kinds: reference materials and reports. Reference materials are generated from the latest version of the knowledge base, which includes the classes that drive the system, and a network of objects representing meta-information about the system. The reference materials document the system's capabilities and help users understand what the system can do. Reports are generated from the instances created by a run of the system. They document the transformations the input specification underwent in becoming code, and are intended to help a user understand what the system has done. We have found that our approach to producing documents has both advantages and disadvantages when compared with more traditional approaches to documentation. The advantages are that we can minimize the manual effort that is involved in writing documentation about the system, while at the same time maximizing the accuracy of the documentation that is produced. The main disadvantage has been the lack of truly appropriate authoring tools built to work in our environment. When we began, we expected the task of creating such authoring tools to be much easier than it has turned out to be. Later in this paper, we explore some of the factors that have caused this to be the case.

REFERENCES

• 1: Richard Fikes , Tom Kehler, The role of frame-based representation in reasoning, Communications of the ACM, v.28 n.9, p.904-920, Sept. 1985 [doi>10.1145/4284.4285]
• 2: Robert L. Akers , Elaine Kant , Curtis J. Randall , Stanly Steinberg , Robert L. Young, SciNapse: A Problem-Solving Environment for Partial Differential Equations, IEEE Computational Science & Engineering, v.4 n.3, p.32-42, July 1997 [doi>10.1109/99.615429 ]
• 3: James Gatheral , Yonathan Epelbaum , Jining Han , Kishor Laud , Olga Lubovitsky , Elaine Kant , Curt Randall, Implementing Option-Pricing Models Using Software Synthesis, Computing in Science and Engineering, v.1 n.6, p.54-64, November 1999 [doi>10.1109/5992.805136 ]
• 4: Stephen Wolfram, Mathematics (3rd ed.), Cambridge University Press, 1996.
• 5: Extendable Markup Language: XML. See http://www.xml.org

INDEX TERMS

Primary Classification:
  I. Computing Methodologies
  I.2 ARTIFICIAL INTELLIGENCE

Additional Classification:
  I. Computing Methodologies
  I.2 ARTIFICIAL INTELLIGENCE

General Terms:
Design, Experimentation, Theory

Keywords:
intelligent interfaces, knowledg-based systems