Difference between revisions of "PrF UG classes references window"
Line 8: | Line 8: | ||
between classes, instances, and slots. | between classes, instances, and slots. | ||
A <i>reference</i> for a frame is any other frame that has a direct relationship to it. | A <i>reference</i> for a frame is any other frame that has a direct relationship to it. | ||
− | The References window can be viewed by selecting an item and clicking on the <b>References</b> | + | The References window can be viewed by selecting an item |
− | ([[Image:PrF_UG_classes_class.view_references.gif|classes_class.view_references]] or | + | and clicking on the <b>References</b> |
− | [[Image:PrF_UG_inst_instance.view_references.gif|instances_instance.view_references]]) button. | + | ([[Image:PrF_UG_classes_class.view_references.gif|classes_class.view_references]] |
+ | or [[Image:PrF_UG_inst_instance.view_references.gif|instances_instance.view_references]]) button. | ||
See [[PrF_UG_classes_view_references|Viewing References]] for more information. | See [[PrF_UG_classes_view_references|Viewing References]] for more information. | ||
Line 36: | Line 37: | ||
<li><p> | <li><p> | ||
− | any <i>direct</i> slots (inherited slots are <i>not</i> considered to be references) | + | any <i>direct</i> slots |
+ | (inherited slots are <i>not</i> considered to be references) | ||
</p> | </p> | ||
Line 48: | Line 50: | ||
</ul> | </ul> | ||
− | For a slot, | + | For a slot, references include: |
− | references include: | ||
<ul class='a'> | <ul class='a'> | ||
Line 74: | Line 75: | ||
[[Image:PrF_UG_all_object.view.gif|all_object.view]] | [[Image:PrF_UG_all_object.view.gif|all_object.view]] | ||
| | | | ||
− | <b>View Reference:</b> Opens the editor for the highlighted frame and allows you to view the frame's properties. | + | <b>View Reference:</b> |
+ | Opens the editor for the highlighted frame and allows you to view the frame's properties. | ||
Depending on the frame, | Depending on the frame, | ||
− | this could be the | + | this could be the [[PrF_UG_classes_class_editor|Class Editor]], |
− | [[PrF_UG_classes_class_editor|Class Editor]], | + | the [[PrF_UG_slots_slot_editor|Slot Editor]], |
− | the | + | or the [[PrF_UG_inst_instance_editor|Instance Editor]]. |
− | [[PrF_UG_slots_slot_editor|Slot Editor]], | ||
− | or the | ||
− | [[PrF_UG_inst_instance_editor|Instance Editor]]. | ||
|- | |- | ||
| | | | ||
Line 91: | Line 90: | ||
This column shows the name of each frame that references the highlighted item. | This column shows the name of each frame that references the highlighted item. | ||
− | The type of frame is indicated by a | + | The type of frame is indicated |
− | [[PrF_UG_classes_class_icons|class icon]], | + | by a [[PrF_UG_classes_class_icons|class icon]], |
− | [[PrF_UG_slots_slot_icons|slot icon]], | + | [[PrF_UG_slots_slot_icons|slot icon]], or instance icon |
− | or instance icon | ||
[[Image:PrF_UG_inst_instance.gif|instances_instance]]. | [[Image:PrF_UG_inst_instance.gif|instances_instance]]. | ||
Line 100: | Line 98: | ||
This column specifies the slot that actually references the selected item. | This column specifies the slot that actually references the selected item. | ||
− | Note that {{#var:PrF}} provides standard slots which indicate the relationship between the selected item and the referencing frame. | + | Note that {{#var:PrF}} provides standard slots |
+ | which indicate the relationship between the selected item and the referencing frame. | ||
For example: | For example: | ||
Line 116: | Line 115: | ||
| | | | ||
The frame is a slot and the selected item appears as one of its values. | The frame is a slot and the selected item appears as one of its values. | ||
− | If the selected item is an instance, | + | If the selected item is an instance, it may be a value. |
− | it may be a value. | ||
If the selected item is a class, | If the selected item is a class, | ||
it may be an <b>Allowed Superclass</b> (for a | it may be an <b>Allowed Superclass</b> (for a | ||
[[PrF_UG_slots_value_type_class|slot of type <b>Class</b>]]) | [[PrF_UG_slots_value_type_class|slot of type <b>Class</b>]]) | ||
− | or an <b>Allowed Class</b> (for a | + | or an <b>Allowed Class</b> |
− | [[PrF_UG_slots_value_type_instance|slot of type <b>Instance</b>]]). | + | (for a [[PrF_UG_slots_value_type_instance|slot of type <b>Instance</b>]]). |
|} | |} | ||
Line 129: | Line 127: | ||
=== The Facet Column === | === The Facet Column === | ||
− | This column gives information about the facet value for certain types of references and gives information about the slot relationships between classes. | + | This column gives information about the facet value for certain types of references |
− | For example, | + | and gives information about the slot relationships between classes. |
− | an item may appear as a value for a slot which is called by that frame. | + | For example, an item may appear as a value for a slot which is called by that frame. |
In the illustration above, | In the illustration above, | ||
the class <b>Author</b> appears as an <b>Allowed Class</b> for the slot <i>author</i>, | the class <b>Author</b> appears as an <b>Allowed Class</b> for the slot <i>author</i>, | ||
as shown in the second row. | as shown in the second row. | ||
− | In addition, | + | In addition, the slot <i>author</i> appears as a slot for the class <b>Article</b>. |
− | the slot <i>author</i> appears as a slot for the class <b>Article</b>. | + | Therefore, <b>Article</b> references <b>Author</b>. |
− | Therefore, | ||
− | <b>Article</b> references <b>Author</b>. | ||
This reference appears in the fifth row in the example. | This reference appears in the fifth row in the example. | ||
For an embedded reference of this type, | For an embedded reference of this type, | ||
− | the facet value column specifies whether the selected item appears as an <b>Allowed Class</b> or an <b>Allowed Superclass</b>. | + | the facet value column specifies whether the selected item appears |
+ | as an <b>Allowed Class</b> or an <b>Allowed Superclass</b>. | ||
</div> | </div> |
Revision as of 11:46, October 15, 2008
The References Window
In a complex project, it is possible to have many different relationships between classes, instances, and slots. A reference for a frame is any other frame that has a direct relationship to it. The References window can be viewed by selecting an item and clicking on the References ( or ) button. See Viewing References for more information.
It is also possible to view those classes that are related through a particular slot, using the Relations Menu.
Examples
For example, references for a class include:
any superclasses of the class
any direct subclasses of the class
any instances of the class
any direct slots (inherited slots are not considered to be references)
any notes at the class
the metaclass of the class
For a slot, references include:
any superslots or subslots
:STANDARD-SLOT or other slot metaclass
any classes that have the slot attached as a direct slot
The References window allows you to view a list of all the references of a selected frame.
The View Buttons
View Reference: Opens the editor for the highlighted frame and allows you to view the frame's properties. Depending on the frame, this could be the Class Editor, the Slot Editor, or the Instance Editor. | |
View References to Value: Shows the references for the highlighted frame. |
The Frame Column
This column shows the name of each frame that references the highlighted item. The type of frame is indicated by a class icon, slot icon, or instance icon .
The Slot Column
This column specifies the slot that actually references the selected item. Note that Protege-Frames provides standard slots which indicate the relationship between the selected item and the referencing frame. For example:
DIRECT-INSTANCES | The selected item is a direct instance of the frame. |
DIRECT-SUPERCLASSES | The selected item is a direct superclass of the frame. |
DIRECT-SUBCLASSES | The selected item is a direct subclass of the frame. |
SLOT-VALUE-TYPE |
The frame is a slot and the selected item appears as one of its values. If the selected item is an instance, it may be a value. If the selected item is a class, it may be an Allowed Superclass (for a slot of type Class) or an Allowed Class (for a slot of type Instance). |
The name of any other slot in the project may also appear in this column.
The Facet Column
This column gives information about the facet value for certain types of references and gives information about the slot relationships between classes. For example, an item may appear as a value for a slot which is called by that frame.
In the illustration above, the class Author appears as an Allowed Class for the slot author, as shown in the second row. In addition, the slot author appears as a slot for the class Article. Therefore, Article references Author. This reference appears in the fifth row in the example.
For an embedded reference of this type, the facet value column specifies whether the selected item appears as an Allowed Class or an Allowed Superclass.