WebProtegeUsersGuide

From Protege Wiki
Revision as of 16:08, March 17, 2014 by Matthewhorridge (talk | contribs)

Jump to: navigation, search

WebProtégé User Guide


WebProtégé is an open source, lightweight, web-based ontology editor.


Looking for the user guide of the old WebProtege (release 1.0)? Here it is.

Go back to WebProtégé main page.


Screencasts

WP-screencast.png

You can watch a 15 minutes screencast that introduces the features of the new WebProtege (creating and uploading ontologies, sharing with collaborators, simplified editing with auto-completion, etc.).

You may also watch a 15 minutes presentation of the simplified user interface of WebProtege and how we came to it that was presented at ISWC 2013.

A more comprehensive one-hour long screencast showing also the OBO editing, and the support for linking to BioPortal is available on the NCBO Webinar webpage.


Home Screen

When you open http://webprotege.stanford.edu in a browser you should see the list of public projects and various links to create an account or sign in (top right). You can download the ontologies in any publicly available project by clicking the download icon in the table. To open a project click on its name in the Project Name column.

Wp-home-screen.png

To create and upload your own projects you need to have a user account and be signed in. If you don't have a user account you can create one using the Sign Up for Account button. To sign in click the Sign In link in the top right of the browser window. Enter your user name and password in the dialog that pops up. (You can also sign in with OpenId).

Nav Bar

Wp-nav-bar.png

Once you are signed in you will see a side bar on the left hand side of the screen which offers different categories of projects to view. Clicking on any item in the side bar will filter the list of projects. The home item shows all projects which are owned by you and projects which you have read or write access to. The Owned By Me item filters the list of projects to show projects which you actually own. The Trash item filters the list of projects to show projects which you own that are in the trash. Projects that are in the trash do not get deleted, they just aren't visible to other users.

Creating and Uploading Projects

Wp-project-action-buttons.png

To create a new empty project press the Create Project... button. To upload an existing ontology into a new project (either an OWL ontology or an OBO ontology) press the Upload Project ... button. In both cases a dialog will appear like the one shown below. Enter the name for the project (this need not be unique) and description of the project and press o.k.

Wp-upload-dialog.png

Sharing Project with Collaborators

You can share your project with other people so that they can view, comment or edit it. To do this click the Share link in the top right of the browser window. The sharing settings dialog will appear as shown below.

Wp-sharing-settings.png


Lightweight editing with auto-completion support

It is now much easier and faster to create content in the new interface of WebProtege that has support for auto-completion.

WP-classes.png


Collaboration support

The Changes portlet shows the changes associated to an entity in the ontology. The change tracking provide a full and executable change history.

WP-changes.png

The Project Dashboard provides an overview of the activity in the ontology. The Change Summary portlet shows the changes of the entire ontology, the Watches portlet shows the changes to the watched entities and branches, and the Revisions portlet allows users to download any snapshot in time of the ontology.

WP-dashboard.png

Viewing and Editing OWL 2 Ontologies

By default WebProtégé display a simplified user interface that allows you to edit a subset of OWL 2 syntax. In order to view and edit an OWL 2 ontology you can add some OWL 2 portlets to any tab in your project. You can do this by clicking the Add Content button (shown below) on the top right of each tab.

Add-content.png


WebProtégé currently contains the following OWL 2 specific portlets:

  • Conditions - Offers a Protégé-4 style view of the class description. Axioms can be added, edited and removed in a similar way that they can in the Protégé-4 class description editor view.

Conditions-example.png

  • Entity Description - shows an extended version of the Manchester Syntax rendering for the selected entity (class, object property, data property, annotation, named individual). For example, the figure below shows the class 'glandular epithelium' being viewed in the Cephalapod ontology.

Cephalapod-example.png

Similarly, the figure below shows the description of object property 'negatively regulates'. The axioms that define 'negatively regulates' are defined in the ro ontology, which is imported by the Cephalapod ontology.

Cephalapod-property-example.png

As shown in the Figure below, axiom annotations are shown as indented annotations (a slightly more compact form of the Manchester Syntax).

Axiom-annotations-example.png

Other tabs and portlets

WebProtégé has a configurable user interface, and each user can customize the layout and save it for future sessions. The user may choose from a list of existing tabs and add portlets dynamically from the user interface. It is also possible to create a new empty tab and add the needed portlets through drag-n-drop. More information on the layout configuration can be found here.

References

Further documentation and references on WebProtégé can be found here.


Go back to WebProtégé main page.