Difference between revisions of "WebProtegeUsersGuide"

From Protege Wiki
Jump to: navigation, search
 
(35 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<p style="padding:0; margin:0; font-size:1.9em; font-weight:bold; word-spacing:-2px;">WebProtege Users's Guide</p>
+
<p style="padding:0; margin:0; font-size:1.9em; font-weight:bold; word-spacing:-2px;">WebProtégé User Guide</p>
  
  
'''WebProtege''' is an open source, lightweight, web-based ontology editor.
+
'''WebProtégé''' is an open source, lightweight, web-based ontology editor.
  
  
 
__TOC__
 
__TOC__
  
 +
'''Looking for the user guide of the old WebProtege (release 1.0)? [[WebProtege1.0UsersGuide|Here it is]].'''
  
'''Go back to [[WebProtege|WebProtege main page]].'''
+
'''Go back to [[WebProtege|WebProtégé main page]].'''
  
== Signing in ==
 
To sign in WebProtege, please click the ''Sign in'' link on the top right corner of the display, and then enter your user name and password.
 
  
<div style="padding-top:5px; padding-bottom:5px;">
+
= Screencasts =
[[Image:Webprotege-login.jpg|none]]
 
</div>
 
  
You may also sign in with your OpenId account (e.g. Google, Yahoo, etc.). The first time you will sign in with your OpenId, you will be asked to associate the OpenId account with a WebProtege account. For future sign ins, you can simply use the OpenId account. To change the preferences for the OpenId accounts, go to the ''Options menu -> Edit profile'' after you signed in. More information on the sign in with OpenId is found [[WebProtegeOpenId|here]].
+
[[File:WP-screencast.png|thumb|70px|left|link=http://www.youtube.com/watch?v=QvURiHVXnQQ]]
  
Note that it is not necessary to log in if you simply wish to view the public ontologies.
+
You can watch a [http://www.youtube.com/watch?v=QvURiHVXnQQ 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 [http://videolectures.net/iswc2013_horridge_webprotege/ 15 minutes presentation] of the simplified user interface of WebProtege and how we came to it that was presented at [http://iswc2013.semanticweb.org/ ISWC 2013].
  
== Introduction to the user interface ==
+
A more comprehensive [https://stanford.webex.com/stanford/lsr.php?AT=pb&SP=MC&rID=62510447&rKey=13018bdbb414ba08 one-hour long screencast] showing also the OBO editing, and the support for linking to BioPortal is available on the [http://www.bioontology.org/ontology-editing-and-publishing-using-webprotege-and-bioportal NCBO Webinar webpage].  
In building the user interface of WebProtege, we were inspired by the Portal metaphor, in which users can customize the content and layout of the UI. The WebProtege user interface is made up of tabs (e.g., Classes Tab, Property Tab, etc.). Each tab contains several ''portlets'' (e.g., the class tree, property values, restriction editor, notes, etc.). The user is able to resize and rearrange the portlets in a tab by drag-n-drop. More information on customizing the WebProtege layout can be found [[WebProtegeLayoutConfig|here]].
 
  
=== My WebProtege tab ===
 
The first time you access WebProtege, you will see the ''My WebProtege'' tab.  This tab lists all of the ontologies that are available for viewing and/or editing.  Simply click on an ontology name in the ''Name'' column to open the ontology. You will only see the ontologies to which your user has access to. If you did not sign in, you will see a list of public ontologies. To test the editing capabilities, you may sign in with the username ''Guest'' and password ''guest'' (case sensitive).
 
  
It is also possible to connect to the WebProtege ontologies through a desktop client. Both the desktop and the web client are linked to the same [[Collaborative Protege]] server. All the edits made in the desktop client will be reflected back right away in the web-client and vice-versa.
+
= Home Screen =
  
<div style="padding-top:5px; padding-bottom:5px;">
+
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.
[[Image:Webprotege-mywebprotege-tab.jpg|none]]
 
</div>
 
  
=== Classes tab ===
+
[[File:wp-home-screen.png|800px]]
After you have opened an ontology, you can view the ontology class hierarchy on the Classes tab. By selecting a class in the Class Tree, you can view the class properties, axioms, notes, etc., in the portlets to the right of the class tree:
 
  
<div style="padding-top:5px; padding-bottom:5px;">
+
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).
[[Image:Webprotege-classes-tab2.jpg|none]]
 
</div>
 
  
If you are logged in, you can also use the Create class and Delete class buttons in the Class Tree to create and delete classes.
+
== Nav Bar ==
  
=== Properties tab ===
+
[[File:Wp-nav-bar.png]]
The Properties tab displays all of the properties in the currently open ontology:
 
  
<div style="padding-top:5px; padding-bottom:5px;">
+
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.
[[Image:Webprotege-properties-tab.jpg|none]]
 
</div>
 
  
=== Individuals tab ===
+
== Creating and Uploading Projects ==
The Individuals tab displays all of the individuals in the currently open ontology.  Select a class in the Class Tree to see a list of individuals in the Individuals portlet:
 
  
<div style="padding-top:5px; padding-bottom:5px;">
+
[[File:wp-project-action-buttons.png]]
[[Image:Webprotege-individuals-tab.jpg|none]]
 
</div>
 
  
 +
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.
  
=== Other tabs and portlets ===
+
[[File:wp-upload-dialog.png]]
  
WebProtege 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 [[WebProtegeLayoutConfig|here]].
+
== Sharing Project with Collaborators ==
  
== References ==
+
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.
  
* Several papers describing the use of WebProtege in real use cases can be found [http://bmir.stanford.edu/people/view.php/tania_tudorache here].
+
[[File:wp-sharing-settings.png]]
  
* A short paper describing WebProtege was presented as a poster at [http://www.webont.org/owled/2008dc/ OWLED 2008].  The paper is available for [http://www.webont.org/owled/2008/papers/owled2008eu_submission_40.pdf download from the OWLED website].
 
  
* WebProtege is a web-client for [[Collaborative Protege]] - a Protege extension that supports the collaborative ontology development process.
+
=  Lightweight editing with auto-completion support =
<br />
 
  
 +
It is now much easier and faster to create content in the new interface of WebProtege that has support for auto-completion.
  
'''Go back to [[WebProtege|WebProtege main page]].'''
+
[[File:WP-classes.png|800px]]
 +
 
 +
 
 +
= 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.
 +
 
 +
[[File:WP-changes.png|800px]]
 +
 
 +
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.
 +
 
 +
[[File:WP-dashboard.png|800px]]
 +
 
 +
= 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.
 +
 
 +
[[File:Add-content-2.png]]
 +
 
 +
 
 +
WebProtégé currently contains the following OWL 2 specific portlets, the '''OWL Entity Description Browser''' and the '''OWL Entity Description Editor'''.
 +
 
 +
== The OWL Entity Description Browser ==
 +
 
 +
'''OWL Entity Description Browser''' - 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 [https://github.com/obophenotype/cephalopod-ontology Cephalapod ontology].
 +
 
 +
[[File: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.
 +
 
 +
[[File: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).
 +
 
 +
[[File:axiom-annotations-example.png]]
 +
 
 +
 
 +
== The OWL Entity Description Editor ==
 +
 
 +
This portlet supports the complete editing of OWL 2 ontologies. It provides a Manchester Syntax text editor, with syntax highlighting, error checking and autocompletion. The '''OWL Entity Description Editor''' portlet and can be added to tabs that permit editing of classes, properties and individuals. For projects that contain multiple ontologies, the editor also makes it possible to tell which ontology axioms reside in. Finally, it is possible to bundle multiple edits for a given entity together and "commit" them with an optional comment.
 +
 
 +
[[File:owl_entity_editor_1.png]]
 +
 
 +
[[File:owl-entity-editor-2.png]]
 +
 
 +
[[File:owl-entity-editor-3.png]]
 +
 
 +
 
 +
= Ontologies with imports =
 +
 
 +
Ontologies with imports can be uploaded to WebProtege. If an import is available at the imported URL, then WebProtege will fetch it from there.
 +
 
 +
However, it is also possible to have local imports that are not resolvable at the import URL, but which are provided as additional files (similar to how Protege desktop handles local imports).
 +
 
 +
To upload to WebProtege an ontology with local imports, create a zip archive, which should contain:
 +
* the top ontology (most importing one), which needs to be renamed to <code>root-ontology.owl</code>, and
 +
* the imported OWL files.
 +
 
 +
The zip archive can be uploaded to WebProtege through the ''Upload Projects'' button, and WebProtege will be able to read the local imports from the archive.
 +
 
 +
 
 +
= Rules support =
 +
 
 +
It is possible to view and edit rules in WebProtege using the [[WebProtegeUsersGuide#The_OWL_Entity_Description_Editor|OWL Entity Description Editor]]. The rules are shown in the ''Rule'' section:
 +
 
 +
[[File:SwrlWP1.png|600px]]
 +
 
 +
 
 +
The editing of rules uses auto-completion for the entities in the ontology and for swrl builtins:
 +
 
 +
[[File:SwrlWP2.png|600px]]
 +
 
 +
 
 +
= 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 [[WebProtegeLayoutConfig|here]].
 +
 
 +
= References =
 +
 
 +
Further documentation and references on WebProtégé can be found [[WebProtege#References|here]].
 +
 
 +
 
 +
'''Go back to [[WebProtege|WebProtégé main page]].'''
  
 
[[Category:WebProtege documentation]]
 
[[Category:WebProtege documentation]]

Latest revision as of 14:46, February 9, 2022

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-2.png


WebProtégé currently contains the following OWL 2 specific portlets, the OWL Entity Description Browser and the OWL Entity Description Editor.

The OWL Entity Description Browser

OWL Entity Description Browser - 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


The OWL Entity Description Editor

This portlet supports the complete editing of OWL 2 ontologies. It provides a Manchester Syntax text editor, with syntax highlighting, error checking and autocompletion. The OWL Entity Description Editor portlet and can be added to tabs that permit editing of classes, properties and individuals. For projects that contain multiple ontologies, the editor also makes it possible to tell which ontology axioms reside in. Finally, it is possible to bundle multiple edits for a given entity together and "commit" them with an optional comment.

Owl entity editor 1.png

Owl-entity-editor-2.png

Owl-entity-editor-3.png


Ontologies with imports

Ontologies with imports can be uploaded to WebProtege. If an import is available at the imported URL, then WebProtege will fetch it from there.

However, it is also possible to have local imports that are not resolvable at the import URL, but which are provided as additional files (similar to how Protege desktop handles local imports).

To upload to WebProtege an ontology with local imports, create a zip archive, which should contain:

  • the top ontology (most importing one), which needs to be renamed to root-ontology.owl, and
  • the imported OWL files.

The zip archive can be uploaded to WebProtege through the Upload Projects button, and WebProtege will be able to read the local imports from the archive.


Rules support

It is possible to view and edit rules in WebProtege using the OWL Entity Description Editor. The rules are shown in the Rule section:

SwrlWP1.png


The editing of rules uses auto-completion for the entities in the ontology and for swrl builtins:

SwrlWP2.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.