Difference between revisions of "PrF UG classes class editor"

From Protege Wiki
Jump to: navigation, search
(Automated import of articles)
 
 
(9 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
== The Class Editor ==
 
== The Class Editor ==
  
{{PrF_UG_TOC_classes}}<div id='prf_ug'>
+
<noinclude>{{PrF_UG_TOC_classes}}<div id='prf_ug'></noinclude>
  
 
The Class Editor can be used to define and edit the attributes of a class.
 
The Class Editor can be used to define and edit the attributes of a class.
The Class Editor includes the following areas:
 
 
<ul class='a'>
 
  <li><p>
 
    The
 
    [[#Note_Icons|Note Icons]]
 
    allow you to add and remove notes.
 
    </p>
 
 
  <li><p>
 
    The
 
    [[#The_Class_Name_Field|Class Name field]]
 
    allows you to name your class.
 
    </p>
 
 
  <li><p>
 
    The
 
    [[#The_Class_Role_Menu|Class Role menu]]
 
    allows you to choose whether your class is concrete or abstract.
 
    </p>
 
 
  <li><p>
 
    The
 
    [[#The_Class_Constraints_Pane|Class Constraints pane]]
 
    allows you to create,
 
    edit,
 
    add,
 
    and delete constraints for your class.
 
    </p>
 
 
  <li><p>
 
    The
 
    [[#The_Class_Documentation_Pane|Class Documentation pane]]
 
    allows you to add simple text notes explaining your class.
 
    </p>
 
 
  <li><p>
 
    The
 
    [[PrF_UG_classes_template_slot_pane|Template Slots pane]]
 
    allows you to view the slot information for your class.
 
    </p>
 
</ul>
 
 
 
Click on a link or an area of the picture to jump to a summary.
 
Click on a link or an area of the picture to jump to a summary.
See also
+
See also [[PrF_UG_classes_create_class|Creating a Class]],
[[PrF_UG_classes_create_class|Creating a Class]],
 
 
[[PrF_UG_classes_view_class|Displaying the Class Editor]],
 
[[PrF_UG_classes_view_class|Displaying the Class Editor]],
 
[[PrF_UG_classes_editing_a_class|Editing a Class]],
 
[[PrF_UG_classes_editing_a_class|Editing a Class]],
and
+
and [[PrF_UG_classes_edit_template_slots|Editing Template Slots]].
[[PrF_UG_classes_edit_template_slots|Editing Template Slots]].
 
  
<div>[[Image:PrF_UG_classes_class_editor.png|classes_class_editor]]</div>
+
<imagemap>
 +
Image:PrF_UG_classes_class_editor.png|frame|none|Class Editor
 +
rect 462  61 685 170 [[#The_Class_Constraints_Pane  |The Class Constraints pane]]
 +
rect 237  62 457 174 [[#The_Class_Documentation_Pane |The Class Documentation pane]]
 +
rect  3  59 234 115 [[#The_Class_Name_Field        |The Class Name field]]
 +
rect 600  21 685  48 [[#Note_Icons                  |Note icons]]
 +
rect  5 120 233 172 [[#The_Class_Role_Menu          |The Class Role menu]]
 +
rect 237  62 457 174 [[#The_Class_Documentation_Pane |The Class Documentation pane]]
 +
rect  6 179 691 488 [[#The_Template_Slots_Pane      |The Template Slots pane]]
 +
desc none
 +
</imagemap>
  
 
=== Note Icons ===
 
=== Note Icons ===
  
The
+
The [[PrF_UG_windows_yellow_stickies|note]] icons
[[PrF_UG_windows_yellow_stickies|note]]
 
icons
 
 
([[Image:PrF_UG_windows_class_note.hide.gif|windows_class_note.hide]],
 
([[Image:PrF_UG_windows_class_note.hide.gif|windows_class_note.hide]],
 
[[Image:PrF_UG_windows_class_note.create.gif|windows_class_note.create]],
 
[[Image:PrF_UG_windows_class_note.create.gif|windows_class_note.create]],
 
[[Image:PrF_UG_windows_class_note.delete.gif|windows_class_note.delete]])
 
[[Image:PrF_UG_windows_class_note.delete.gif|windows_class_note.delete]])
 
at the upper right of the Editor allow you to work with class sticky notes.
 
at the upper right of the Editor allow you to work with class sticky notes.
These notes,
+
These notes, which are not part of your ontology,
which are not part of your ontology,
 
 
can be used for todos or communication while you are developing your knowledge base.
 
can be used for todos or communication while you are developing your knowledge base.
 
They can be hidden using the <b>Hide Class Notes</b>
 
They can be hidden using the <b>Hide Class Notes</b>
<div>[[Image:PrF_UG_windows_class_note.hide.gif|windows_class_note.hide]]</div>
+
([[Image:PrF_UG_windows_class_note.hide.gif|windows_class_note.hide]]) button.
button.
+
For information on how to add notes to any frame (class, instance, or slot),
For information on how to add notes to any frame (class,
+
see [[PrF_UG_windows_yellow_stickies|Working with Notes]].
instance,
 
or slot),
 
see
 
[[PrF_UG_windows_yellow_stickies|Working with Notes]].
 
  
 
Notes are not available when working with the Editor as a free-standing window.
 
Notes are not available when working with the Editor as a free-standing window.
Line 84: Line 42:
  
 
The Name field allows you to name your class.
 
The Name field allows you to name your class.
When a class is created,
+
When a class is created, it is given a default name, such as newspaper_Class_1.
it is given a default name,
 
such as newspaper_Class_1.
 
 
You can change the name of a new or existing class by highlighting the name and overwriting it.
 
You can change the name of a new or existing class by highlighting the name and overwriting it.
 
The following rules apply to class names:
 
The following rules apply to class names:
Line 100: Line 56:
 
</ul>
 
</ul>
  
A recommended convention is to make the first character of each word in a class name uppercase and the rest lowercase,
+
A recommended convention is to make the first character
 +
of each word in a class name uppercase and the rest lowercase,
 
and to separate words with underscores.
 
and to separate words with underscores.
  
Line 118: Line 75:
 
</ul>
 
</ul>
  
{{#var:PrF}} sets the role to <b>Concrete</b>,
+
{{#var:PrF}} sets the role to <b>Concrete</b>, by default.
by default. {{#var:PrF}} does not impose any restrictions on the role of your classes.
+
{{#var:PrF}} does not impose any restrictions on the role of your classes.
One common modeling convention is to make all leaf
+
One common modeling convention
(bottom-level)
+
is to make all leaf (bottom-level) classes concrete,
classes concrete,
+
and all interior (higher-level, non-leaf) classes abstract.
and all interior
 
(higher-level,
 
non-leaf)
 
classes abstract.
 
  
 
=== The Class Constraints Pane ===
 
=== The Class Constraints Pane ===
  
 
Class constraints are defined programmatically.
 
Class constraints are defined programmatically.
See
+
See [[PrF_UG_classes_constraints|Constraints]]
[[PrF_UG_classes_constraints|Constraints]]
 
 
for more information.
 
for more information.
  
 
=== The Class Documentation Pane ===
 
=== The Class Documentation Pane ===
  
The Class Documentation pane allows you to enter a text description of the class and other relevant information.
+
The Class Documentation pane allows you
 +
to enter a text description of the class and other relevant information.
 
These notes are part of your ontology.
 
These notes are part of your ontology.
 
Filling in this field is optional,
 
Filling in this field is optional,
Line 145: Line 98:
  
 
The Template Slots pane displays the direct and inherited slots for the selected class.
 
The Template Slots pane displays the direct and inherited slots for the selected class.
Slots,
+
Slots, which represent properties of your class,
which represent properties of your class,
 
 
are a crucial part of your knowledge base.
 
are a crucial part of your knowledge base.
 
In the example,
 
In the example,
 
<b>Editor</b> has several slots which appear in the Template Slots pane.
 
<b>Editor</b> has several slots which appear in the Template Slots pane.
For a full description,
+
For a full description, see the separate
see the separate
+
[[PrF_UG_classes_template_slot_pane|Template Slots pane]] topic.
[[PrF_UG_classes_template_slot_pane|Template Slots Pane]]
+
 
topic.
 
  
</div>
+
<noinclude></div></noinclude>

Latest revision as of 16:22, November 13, 2008

The Class Editor


Protege-Frames User's Guide
Classes
Classes Tab
Class Browser
Class Buttons
Class Hierarchy Window
Class Icons
Class Menu
Class Search Bar
Superclasses Pane
Class Editor
Constraints
Template Slots Pane
Template Slot Buttons
References Window
Creating a New Class
Creating Multiple Subclasses
Deleting a Class
Displaying the Class Editor
Editing a Class
Editing Template Slots
Finding a Class
Hiding a Class
Replacing a Superclass
Adding a Superclass
Jumping to A Superclass
Removing a Superclass
Viewing Class Relations
Classes & Instances Tab
Viewing References
Glossary, Editing Help

The Class Editor can be used to define and edit the attributes of a class. Click on a link or an area of the picture to jump to a summary. See also Creating a Class, Displaying the Class Editor, Editing a Class, and Editing Template Slots.

The Class Constraints paneThe Class Documentation paneThe Class Name fieldNote iconsThe Class Role menuThe Class Documentation paneThe Template Slots pane
Class Editor

Note Icons

The note icons (windows_class_note.hide, windows_class_note.create, windows_class_note.delete) at the upper right of the Editor allow you to work with class sticky notes. These notes, which are not part of your ontology, can be used for todos or communication while you are developing your knowledge base. They can be hidden using the Hide Class Notes (windows_class_note.hide) button. For information on how to add notes to any frame (class, instance, or slot), see Working with Notes.

Notes are not available when working with the Editor as a free-standing window.

The Class Name Field

The Name field allows you to name your class. When a class is created, it is given a default name, such as newspaper_Class_1. You can change the name of a new or existing class by highlighting the name and overwriting it. The following rules apply to class names:

  • The name must be a unique class name in the knowledge base.

  • Class names are case sensitive.

A recommended convention is to make the first character of each word in a class name uppercase and the rest lowercase, and to separate words with underscores.

The Class Role Menu

The Role menu allows you to choose the role of your class: concrete or abstract.

  • Concrete classes may have direct instances.

  • Abstract classes cannot have direct instances.

Protege-Frames sets the role to Concrete, by default. Protege-Frames does not impose any restrictions on the role of your classes. One common modeling convention is to make all leaf (bottom-level) classes concrete, and all interior (higher-level, non-leaf) classes abstract.

The Class Constraints Pane

Class constraints are defined programmatically. See Constraints for more information.

The Class Documentation Pane

The Class Documentation pane allows you to enter a text description of the class and other relevant information. These notes are part of your ontology. Filling in this field is optional, but is recommended to aid in the maintenance of the knowledge base.

The Template Slots Pane

The Template Slots pane displays the direct and inherited slots for the selected class. Slots, which represent properties of your class, are a crucial part of your knowledge base. In the example, Editor has several slots which appear in the Template Slots pane. For a full description, see the separate Template Slots pane topic.