The AtomSpace Viewer is a tool for visualizing the contents of the AtomSpace of a running CogServer instance in real time. Atoms are displayed graphically, as well as in various other views.
See the README.md file for development notes, current list of issues, and proposed enhancements.
In order to use the AtomSpace Viewer, you must first carry out the following steps:
The default CogServer address (http://localhost:5000/) should work if you run the CogServer locally with all default settings. However, if you run your server on a different port, or if you wish to connect to a remote CogServer, enter the desired URL and port number here. For instructions on accessing remote servers via the REST API, refer to: http://wiki.opencog.org/w/Web_interface#Default_Endpoint.
After setting the CogServer address, hit the "Connect/Refresh" button to connect to the server and retrieve the atoms. By default, this will retrieve all atoms in the AtomSpace. If the number is very large, you will want to first set filter options, as described in the next section.
The "Auto Update" toggle button allows you to turn on automatic refreshes, so AtomSpace changes can be viewed in real time as they take place.
This allows you to filter the atoms by STI (short-term importance) range, or to view only those atoms in the attentional focus. Filters should be used whenever you have a large AtomSpace to reduce the atoms retrieved to a manageable number.
Note that once configured, filter options remain active until cleared, so any subsequent updates will automatically apply the filters.
You may search for specific atoms by name, handle, or type. Enter the value (case sensitive) and click the search icon button. Unlike filters, searches are one-time operations and do not affect subsequent updates. Therefore, you should be sure to turn off the "Auto Update" feature when searching, to avoid losing search results.
This view shows a force directed style graph of the atoms. Node type atoms are drawn with a circle, while Link atoms are drawn with a triangle.
You may interact with the graph in the following ways:
Not yet implemented. Atoms will be displayed in a tabular style, similar to an object diagram.
Not yet implemented. Atoms will be represented in Scheme, equivalent to the "list -a" CogServer console command.
In this view, the Atoms are listed in JSON (JavaScript Object Notation) format. This is the same format as returned by the REST API, and can be copied/pasted to other applications that understand JSON.
Not yet implemented. This feature will provide useful statistical analysis of the AtomSpace.