Adding graph node¶

This diagram displays how the GraphWidget responds to user input and adds new nodes to the Ontology. Note that all operations that might change the Ontology pass through the SyntaxController and all operations that read from the loaded Ontologies pass through the IndexAbstractor.

Searching in the index¶

This diagram displays a simple abstraction of how the DocumentationWidget responds to a user search request. Note that it does not include any IndexAbstractor internal operations such as building and maintaining the Index.

Graph widget input loop¶

This diagram displays the activity diagram used by the GraphWidget when a user adds a node to the graph. Of special note is that the parsing of the new graph is done in the background so that the user can still interact with the GraphWidget while it is updating the Ontology.

Text editor input loop¶

This diagram displays the activity diagram used by the TextWidget while the user is typing. Once the user pauses typing, the text editor checks whether the parenthetical syntax is correct, and if it passes a simple syntax check, the text is passed to the parser. The parser then checks syntax and semantics and returns accordingly. If errors occur during parsing, they are displayed in the editor.

Common workflow¶

This diagram displays an abstract view of a common User-interaction with the program. The user starts the program adds a .kif-File, searches in WordNet and finally adds a relation through the GraphWidget. PySUMO automatically converts the relation to kif and appends it to the ontology source.

Exit process¶

This diagram displays an abstract view of the activity diagram when a user wants to exit the program. This is done when the user clicks on the close icon in the title bar of the main window of pySUMO or on ‘Exit’ in the menu ‘File’. The program makes sure that there are no unsaved changes in open ontologies and if there are changes, prompts if they should be saved. If the user doesn’t save them, the modifications will be lost. Note that the program also saves session layouting preferences of the GUI so they can be restored in the next pySUMO session. These preferences include, for example, the position of widgets in the main window.

Module contents¶

The pySUMO library package. This package contains the core functionality of pySUMO. It not only provides the GUI with a feature-rich API, but also validates input and keeps the Ontologies in a consistent state.

Subpackages¶

Submodules¶

pysumo.indexabstractor module¶

pysumo.wordnet module¶

pysumo.parser module¶

pysumo.syntaxcontroller module¶

pysumo.updater module¶

Module contents¶

The pySUMO Qt-GUI package. This package contains all classes and widgets needed to display the pySUMO editor. There are also classes created by Qt Designer which are inherited from in the ‘coded’ classes.

Subpackages¶

Submodules¶

pySUMOQt.MainWindow module¶

pySUMOQt.Settings module¶

IndexAbstractor¶

• Delete DotGraph.
• Make root and depth keyword arguments defaulting to None
• Turn index into a simple dict. Makes index access easier and faster.
• Add init_wordnet() to initialize the WordNet mapping
• Add update_index() to build the index
• wordnet_locate() returns a list of strings
• IA now also stores the root AST node and a list of ontologies
• Change get_graph arguments to allow for more complex matching.
• Add normalize method for normalizing string arguments.
• Add function to return list of possible completions.

WordNet¶

• change argument of wparse() from a mapping file to a directory containing the mapping files and the rest of the wordnet database - avoid merging mapping files
• completely get rid of all dependencies on NLToolkit - extending upon it is a nightmare
• locate_term() returns a tuple of String, SSType, String

SyntaxController¶

• Add an optional argument newversion to add_ontology()
• Remove parse_graph(), the user now has to edit the file self
• Remove parse_add(), we can use add_ontology() now
• Moved Ontology to syntaxcontroller module

Logger¶

TextEditor¶

• remove show autocomplete – Qt does this on its own

• Added

  • setTextChanged()
  • _initNumberBar()
  • _updateOntologySelector()
  • _hideLines(lines)
  • _showLines(lines)
  • _zoomOut_()
  • _zoomIn_()
  • showOtherOntology(ontologyname)
  • expandIfBracketRemoved()
  • increaseSize()
  • decreaseSize()
  • expandAll()
  • hideAll()
  • getLayoutWidget()
  • numberbarPaint(number_bar, event)
  • initAutocomplete()
  • searchCompletion()
  • toggleVisibility(line)
  • hideFrom(line)
  • insertCompletion(completion)
  • commit()

Introduce SyntaxHighlightSetting to handle user defined Syntax Highlight Rules

class SyntaxHighlightSetting() __init__( expression, font_weight, font_color, expression_end=’‘) createFormat() get_format() getValues() serialize() deserialize( string)

Introduce class SyntaxHighlighter class SyntaxHighlighter __init__( document) highlightBlock( text)

Introduce Numberbar because Qt does not do this on his own class NumberBar(QWidget) __init__( edit) paintEvent( event) adjustWidth( count) updateContents( rect, scroll) mouseDoubleClickEvent( event)

GraphWidget¶

Komplette Änderung der API, um an pygraphviz anzupassen

MainWindow¶

• Added

  • _showOptionDialog_()
  • _addWidget_(widgetType, widgetMenu)
  • createPySumoWidget(widgetType, widgetMenu)
  • addDeleteWidgetAction(widget)
  • addOrRestoreWidget(widget, menu, directAdd=False)
  • closeEvent(event)
  • createStatusBar()
  • setupStatusConnection()
  • displayLog(socket)
  • _updateStatusbar_(wrappedWidget=None)
  • _deleteWidget_(widget)
  • connectWidget(widget)
  • disconnectWidget(widget, callback=None)
  • getDefaultOutputPath()
  • _newOntology_()
  • _openLocalOntology_()
  • _openRemoteOntology_()
  • addOntology(ontology, newversion=None)
  • notifyOntologyAdded(ontology)
  • _ClearRecentOntologiesHistory_()
  • _deleteOntology_(ontology)
  • _updateOntology_(ontology)
  • _revertOntology_(ontology)
  • _showOntologyProperties_(ontology)
  • _closeOntology(ontology)

• Added quit_handler(signum, frame) to capture SIGINT signal.

• Introduced class PySUMOWidget which wrappes the application widgets.

• Removed class Statusbar, it became useless towards createStatusBar in MainWindow.

• Removed class Menubar, because the menu bar is already created by the designer.

• Removed class Toolbar, because the tool bar is already created by the designer.

• Moved class HelpDialog to module Dialog

Settings¶

• Introduced class LayoutManager.
• Introduced class PySumoSettings.
• Removed class PluginManager.
• Removed class WSettings.
• Moved class OptionDialog to module Dialog.

OptionDialog¶

• Remove createView() and load(path) methods.
• Added other methods to the OptionDialog.

ActionLog¶

• Queue the addition of an ontology to the A0ctionLog * Initialize an ActionLog with an ontology * Modify an ontology and store the changes * Assert that undoing the last action returns the previous state * Assert that undo/redo is invariant * Make sure the queue auto-flushes when exceeding size * Check that addition queue is overwritten when new changes are added and the old changes have not been OK’d. * Assert the invariance of excessive undoes * Assert the invariance of excessive redoes
• Check that ActionLog copes with high workloads

IndexAbstractor¶

• Assert than normalize() normalizes terms correctly.
• Assert that the index is built correctly.
• Test search on various terms
• Test WordNet search and self-initialization.
• Build several AbstractGraphs and check their contents
• Test that get_ontology_file returns the correct kif
• Test that adding multiple ontologies works
• Test that get_completions returns a correct list of terms

Parser¶

SyntaxController¶

• Assert that add_ontology() adds an AST equivalent to the one produced by kifparse()
• Assert the invariance of redundant adds
• Assert that adding and then deleting an ontology is invariant
• Check that adding two ontologies works correctly
• Assert that get_ontologies() lists the correct ontologies
• Assert that modifying the ontology works correctly
• Assert that parsing diffs works correctly
• Assert that undo/redo work correctl

WordNet¶

• Check functionality of locate_term
• Check functionality of find_synonym

Text Editor¶

Texteditor after doing test.

1. Open pySUMO
2. Open TextEditor
3. Open Merge.kif
4. Choose Merge.kif
5. Collapse Line 288
6. Collapse Line 136
7. Collapse Line 134
8. Uncollapse Line 134
9. Uncollapse Line 288
10. Collapse all
11. Expand all

Graphical Settings¶

1. Open pySUMO
2. Open TextEditor
3. Open Merge.kif
4. Choose Merge.kif
5. Open GraphWidget
6. Open DocumentationWidget
7. Open Hierarchy Widget
8. Open TextEdiorWidget

Hierarchy Widget¶

Hierarchywidget after doing test.

Graph Widget¶

Graphwidget after step 6.

Graphwidget after step 11.

1. Open pySUMO
2. Open GraphWidget
3. Open Merge.kif
4. Select instance on Variant selector
5. Select a root node
6. Select a depth (1)
7. Open a new ontology to write temporary content to.
8. Add a node “bla” in Graph Widget
9. Add a node “bla2”
10. Add a node “bla” (error)
11. Add a relation instance between “bla” and “bla2” (error)
12. Change scale
13. Choose a valid selector (there was a messagebox)
14. Add a relation instance between “bla” and “bla2”
15. Undo
16. Redo

Documentation Widget¶

Documentation widget after step 6.

Docwidget after doing test.

1. Open pySUMO
2. Open Merge.kif
3. Open DocumentationWidget
4. Switch to the Ontology tab in the DocumentationWidget
5. Type subrelation into the search field
6. Press Enter
7. Open TextEditor
8. Select Merge.kif in TextEditor
9. Press one of the links listed under “Merge”
10. Switch to the WordNet tab in the DocumentationWidget
11. Search for ‘Object’
12. Search for ‘Table’

MainWindow¶

Widgets ordering.

1. Open pySUMO
2. Open a new Ontology named “Mondial”
3. Open a remote ontology named “Mondial” at location: http://sigmakee.cvs.sourceforge.net/viewvc/sigmakee/KBs/mondial.kif
4. Close the ontology named “Mondial” with save and reopen it as local file.
5. Add Text Editor Widget
6. Add Documentation Widget
7. Add Graph Widget
8. Add Hierarchy Widget
9. Reorder Widgets
10. Make a print preview of the ontology “Mondial” from the Text Editor Widget
11. Delete the Text Editor Widget
12. Make a print preview of the ontology “Mondial” from the Graph Widget
13. Add a node and a relation in Graph widget
14. Delete the Graph Widget
15. Try to update the ontology “Mondial”
16. Open ontology properties dialog for “Mondial” and then close it.
17. Open Option Dialog and then close it
18. Revert the ontology “Mondial”
19. Quit pySUMO