OWL Test Cases

Status

This document is the work of the author intended for discussion within the Web Ontology working group.

[[Many links and references need to be added.]]

[[get request params and use them to modify the status and content of doc.]]

Table of Contents

1. Introduction

One of the deliverables in the charter of the Web Ontology Working Group is a set of test cases. This document contains those test cases, and also specifies alternative formats. This document also describes the various types of test used; and the process for creation, approval and errata in these tests.

As an appendix, this document includes further proposed tests that are awaiting consideration by the working group.

1.1. Scope

The test cases do not constitute a conformance test suite for OWL.

The test illustrate issue resolutions, and illustrate the use and meaning of the terms in the OWL namespace.

There are [[could be]] other miscellaneous tests motivated individually.

2. Deliverables

The deliverables included as part of the test cases are:

• A recommendation track document, which normatively includes the tests.
• Additional alternative forms of the normative tests. These are also included in informative sections of the recommendation track document.
• A zip file including
  • The RDF/XML files that participate in the tests
  • Manifest files indicating which tests should be apply to which test files.
  • The non-normative alternative forms of the test files.
  This zip file is a non-normative alternative format.
• A web-site which includes the files in the zip file. This also is a non-normative alternative format.

  Note: Other files can be found under the top URL of the web-site which are not part of the deliverable.

[[Do we want index files for the web site that clarify which parts are part of the deliverable and which are not?]]

2.1. Normative Status

Of the deliverables the only normative tests are those included in the recommendation track document. All other deliverables, are informative. Moreover, the recommendation document is informative except for the test data (specified in RDF/XML [RDF/XML]).

2.2. Conflict Resolution

When the normative tests and the other normative OWL recommendations diverge the following process should be followed.

If the OWL working drafts are at or before last call then:

1. The conflict is reported to public-webont-comments@w3.org.
2. The working group makes appropriate modifications to remove the conflict.

If the OWL recommendation has passed last call then:

1. The conflict is reported to public-webont-comments@w3.org.
2. The working group considers the conflict
3. While this happens the other recommendation documents take precedence over the test case.
4. If there is working group consensus to retain the test case as normative and to publish an erratum against the other recommendation document(s) then this is done.
5. Otherwise an erratum is published which deletes the test case.

3. Test Types (Normative)

Each test consists of either one or two RDF/XML documents. Tests of one document indicate some property of that document when viewed as an OWL knowledge base. Tests of two documents indicate a relationship between the two documents when viewed as OWL knowledge bases.

3.1. Tests for Incorrect Use of OWL Namespace

These tests use one document. It is named badNNN.rdf. (The NNN is replaced by the test number). This document includes a use of the OWL namespace with a local name that is not defined by the OWL recommendation.

Note: These tests are intended to help migration from DAML [DAML], since the local names chosen typically are defined in the DAML namespace.

3.2. Entailment Tests

These tests use two documents. One is named premisesNNN.rdf, the other is named conclusionsNNN.rdf. The conclusions are entailed by the premises. Such entailment is defined by the OWL Formal Semantics [OWL-SEMANTICS].

3.3. Non-Entailment Tests

These tests use two documents. One is named premisesNNN.rdf, the other is named nonconclusionsNNN.rdf. The nonconclusions are not entailed by the premises. Such entailment is defined by the OWL Formal Semantics [OWL-SEMANTICS].

3.4. Consistency Tests

These tests use one document. It is named consistentNNN.rdf. The document is consistent as defined by the OWL Formal Semantics [OWL-SEMANTICS].

3.5. Inconsistency Tests

These tests use one document. It is named inconsistentNNN.rdf. The document is inconsistent as defined by the OWL Formal Semantics [OWL-SEMANTICS].

3.6. Miscellaneous Tests (non-Normative)

During development, tests that are not of one of the above types, are classified as miscellaneous while awaiting a new test type to be defined.

4. Manifest Files

[[To be done.]]

5. Test Creation, Approval and Modification

5.1. Creation

Tests are created by members of the working group and placed in the appropriate directory in the test web site. This is done using CVS access to the W3C CVS server. @@@links

When created, tests are given a status of "PROPOSED". The author of the test modifies the Manifest file in the directory of the new test, identifying:

• The test type.
• A description of the test.
• The RDF/XML files used in the test.
• The status as "PROPOSED".
• At least one of:
  • An OWL feature that the test illustrates (by reference to the name of some property or class in the OWL namespace.
  • An issue that the test case is related to (by reference to the issue URI as specified in the OWL issues list [ISSUES].
  • A rationale for the test.
  
  Optionally:
  
• Some part of the recommendation documents which are particularly relevant.

5.2. Approval

At the chair's discretion, individual tests or groups of tests are put to the working group in the weekly telecon or at a face-to-face meeting.

The chair action three members of the working group to review the tests a week before putting the test to the group.

If the Working Group approves a test, then it is included in the test case document.

The Working Group may reject a test, in which case its status is changed to "REJECTED". This does not indicate that the converse of the test has been accepted. There may be stylistic or other grounds for rejecting technically correct tests.

The Working Group has complete discretion to approve or refect tests independent of their conformance with this process or their conformance with the OWL working drafts.

In the light of new information, and at the chairs' discretion, the working group may review any previous decision regarding any test cases. The status of "OBSOLETED" may be used where a test has ceased to be appropriate.

5.3. Modification

Until the test case document reaches last call, the editor(s) of that document may sanction editorial changes to approved tests. This includes:

• Editorial changes to text in the test descriptions.
• Fixing of typos and trivial errors.
• Moving tests to conform with document naming conventions.
• Renaming and renumbering tests and test files.
• Small substantive changes resulting from other working group decisions.
• Larger substantive changes resulting from other working group decisions when actioned by the working group.
• Stylistic changes reflecting changes to the preferences expressed in this document.

6. Stylistic Preferences

There is a preference for the following stylistic rules. None of these rules is obligatory, but test authors should be minded that it will be easier to gain working gain group consensus if they follow these rules.

6.1. Use of RDF/XML

Tests should normally be expressed in RDF/XML.

There are differences of opinion as to whether only a restricted subset of RDF/XML should be used.

6.2. Use of .rdf Suffix

Test and manifest files should use the ".rdf" suffix. URIs should not.

6.3. Use of example Domains

All URLs in the test and manifest files should be retrievable web resources except for those that use domain names with "example" as the penultimate component (e.g. http://www.example.org/ontology#prop").

6.4. Copyright

The following copyright statement should be included as the first XML comment in every test file:

<!--
  Copyright World Wide Web Consortium, (Massachusetts Institute of
  Technology, Institut National de Recherche en Informatique et en
  Automatique, Keio University).
 
  All Rights Reserved.
 
  Please see the full Copyright clause at
  <http://www.w3.org/Consortium/Legal/copyright-software.html>

  $Id: This string is updated by cvs. $
-->

6.5. Description

The description should:

• Link to relevant parts of of the OWL recommendations.
• Clearly distinguish syntactic and semantic concerns.

The description should be included as the second XML comment in each test file, and be included in the Manifest file.

6.6. Directory Structure

Tests that relate principally to some owl property or class, should be put in a directory named using the local name of that property of class.

Otherwise, tests that relate to an issue should be put in a directory named like I3.4 where the issue number is taken from the OWL issue list [ISSUES].

6.7. Test Numbering

Each directory should contain tests numbered consecutively from 001.

No two tests in a single directory should have the same number.

Each file in a test should have the number of the test at the end of its name, before the suffix.

The rest of the file name should follow the conventions for the test type.

Note: the approved tests in a directory will not necessarily be contiguously numbered.

Note: this differs from the RDF Core test case numbering conventions.

7. The OWL Tests (Normative)

[[[The current layout of the tables is not satisfactory.]]

7.1. By Function

7.1.1. owl:FunctionalProperty

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:this="http://www.w3.org/2002/03owlt/FunctionalProperty/premises001#" 
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/premises001" >
    <owl:FunctionalProperty rdf:ID="prop"/>
    <rdf:Description rdf:ID="subject">
      <this:prop rdf:resource="#object1" />
      <this:prop rdf:resource="#object2" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/conclusions001" >
    <rdf:Description rdf:about="premises001#object1">
      <owl:sameIndividualAs rdf:resource="premises001#object2" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:eg ="http://www.example.org/"
  xmlns:this="http://www.w3.org/2002/03owlt/FunctionalProperty/premises002#" 
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/premises002" >
    <owl:FunctionalProperty rdf:ID="prop"/>
    <rdf:Description rdf:ID="subject">
      <this:prop rdf:resource="#object1" eg:prop2="value" />
      <this:prop rdf:resource="#object2" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:eg ="http://www.example.org/"
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/test002" >
    <rdf:Description rdf:about="premises002#object2" eg:prop2="value"/>
</rdf:RDF>

7.1.2. owl:InverseFunctionalProperty

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:this="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises001#" 
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises001" >
    <owl:InverseFunctionalProperty rdf:ID="prop"/>
    <rdf:Description rdf:ID="subject1">
      <this:prop rdf:resource="#object" />
    </rdf:Description>
    <rdf:Description rdf:ID="subject2">
      <this:prop rdf:resource="#object" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/conclusions001" >
    <rdf:Description rdf:about="premises001#subject1">
      <owl:sameIndividualAs rdf:resource="premises001#subject2" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:eg ="http://www.example.org/"
  xmlns:this="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises002#" 
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises002" >
    <owl:InverseFunctionalProperty rdf:ID="prop"/>
    <rdf:Description rdf:ID="subject1" eg:prop2="value" >
      <this:prop rdf:resource="#object" />
    </rdf:Description>
    <rdf:Description rdf:ID="subject2" >
      <this:prop rdf:resource="#object" />
    </rdf:Description>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:eg ="http://www.example.org/"
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/conclusions002" >
    <rdf:Description rdf:about="premises002#subject2" eg:prop2="value"/>
</rdf:RDF>

7.2. By Issue

8. The Tests as Triples (Informative)

This section repeats the tests of the previous section.

This time the test data is shown in simple triples, using N-triple syntax [RDF-TESTS] with qnames. qnames are used in place of URIs in the syntax with no delimiters.

[[[The current layout of the tables is not satisfactory.]]

The following namespace prefixes are used throughout:

rdf

http://www.w3.org/1999/02/22-rdf-syntax-ns#

owl

http://www.w3.org/2002/07/owl#

first

The URL of the first file concatenated with #

second

The URL of the second file concatenated with #

Other namespaces are explicitly listed with the test data.

8.1. By Function

8.1.1. owl:FunctionalProperty

@prefix this: <http://www.w3.org/2002/03owlt/FunctionalProperty/premises001#> .

this:prop rdf:type owl:FunctionalProperty .
this:subject this:prop this:object1 .
this:subject this:prop this:object2 .

this:object1 owl:sameIndividualAs this:object2 .

@prefix this: <http://www.w3.org/2002/03owlt/FunctionalProperty/premises002#> .
@prefix eg: <http://www.example.org/> .

this:prop rdf:type owl:FunctionalProperty .
this:object1 eg:prop2 "value" .
this:subject this:prop this:object1 .
this:subject this:prop this:object2 .

this:object2 eg:prop2 "value" .

8.1.2. owl:InverseFunctionalProperty

@prefix this: <http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises001#> .

this:prop rdf:type owl:InverseFunctionalProperty .
this:subject1 this:prop this:object .
this:subject2 this:prop this:object .

this:subject1 owl:sameIndividualAs this:subject2 .

@prefix this: <http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises002#> .
@prefix eg: <http://www.example.org/> .

this:prop rdf:type owl:InverseFunctionalProperty .
this:subject1 eg:prop2 "value" .
this:subject1 this:prop this:object .
this:subject2 this:prop this:object .

this:subject2 eg:prop2 "value" .

8.2. By Issue

9. Proposed Tests (Informative)

[[[The current layout of the tables is not satisfactory.]]

9.1. By Function

9.1.1. owl:FunctionalProperty

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/premises003" >
    <owl:FunctionalProperty rdf:ID="prop">
      <owl:inverseOf rdf:resource="#inv"/>
    </owl:FunctionalProperty>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/conclusions003" >
    <owl:InverseFunctionalProperty rdf:about="premises003#inv"/>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"  
  xmlns:this="http://www.w3.org/2002/03owlt/FunctionalProperty/premises004#" 
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/premises004" >
    <owl:ObjectProperty rdf:ID="prop">
      <rdfs:range rdf:resource="#Singleton"/>
    </owl:ObjectProperty>
    <rdfs:Class rdf:ID="Singleton">
      <owl:oneOf rdf:parseType="Collection">
          <rdf:Description/>
      </owl:oneOf>
    </rdfs:Class>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/FunctionalProperty/nonconclusions004" >
    <owl:FunctionalProperty rdf:about="premises004#prop"/>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:eg ="http://www.example.org/">
    <owl:FunctionalProperty rdf:about="http://www.example.org/foo#prop" />
    <owl:Thing rdf:about="http://www.example.org/foo#object" />
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xmlns:eg ="http://www.example.org/">
    <owl:Thing rdf:about="http://www.example.org/foo#object">
      <rdf:type>
        <owl:Restriction>
	  <owl:onProperty>
	    <owl:FunctionalProperty rdf:about="http://www.example.org/foo#prop" />
	  </owl:onProperty>
	  <owl:maxCardinality>1</owl:maxCardinality>
        </owl:Restriction>
      </rdf:type>
    </owl:Thing>
</rdf:RDF>

9.1.2. owl:InverseFunctionalProperty

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises003" >
    <owl:InverseFunctionalProperty rdf:ID="prop">
      <owl:inverseOf rdf:resource="#inv"/>
    </owl:InverseFunctionalProperty>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/conclusions003" >
    <owl:FunctionalProperty rdf:about="premises003#inv"/>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"  
  xmlns:this="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises004#" 
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises004" >
    <owl:ObjectProperty rdf:ID="prop">
      <rdfs:domain rdf:resource="#Singleton"/>
    </owl:ObjectProperty>
    <rdfs:Class rdf:ID="Singleton">
      <owl:oneOf rdf:parseType="Collection">
          <rdf:Description/>
      </owl:oneOf>
    </rdfs:Class>
</rdf:RDF>

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#"
  xml:base="http://www.w3.org/2002/03owlt/InverseFunctionalProperty/nonconclusions004" >
    <owl:InverseFunctionalProperty rdf:about="premises004#prop"/>
</rdf:RDF>

9.2. By Issue

9.2.1. [[I4.1-UniqueProp-BadName]]

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  xmlns:owl ="http://www.w3.org/2002/07/owl#" >
    <owl:UniqueProperty rdf:ID="Name"/>
</rdf:RDF>

10. Proposed Tests as Triples (Informative)

This section repeats the tests of the previous section.

[[[The current layout of the tables is not satisfactory.]]

The following namespace prefixes are used throughout:

rdf

http://www.w3.org/1999/02/22-rdf-syntax-ns#

owl

http://www.w3.org/2002/07/owl#

first

The URL of the first file concatenated with #

second

The URL of the second file concatenated with #

Other namespaces are explicitly listed with the test data.

10.1. By Function

10.1.1. owl:FunctionalProperty

first:prop rdf:type owl:FunctionalProperty .
first:prop owl:inverseOf first:inv .

first:inv rdf:type owl:InverseFunctionalProperty .

@prefix this: <http://www.w3.org/2002/03owlt/FunctionalProperty/premises004#> .

this:prop rdf:type owl:ObjectProperty .
this:prop <range> this:Singleton .
this:Singleton rdf:type <Class> .
_:jARP291 rdf:first _:jARP292 .
_:jARP291 rdf:rest rdf:nil .
_:jARP291 rdf:type rdf:List .
this:Singleton owl:oneOf _:jARP291 .

this:prop rdf:type owl:FunctionalProperty .

@prefix eg: <http://www.example.org/> .

eg:foo#prop rdf:type owl:FunctionalProperty .
eg:foo#object rdf:type owl:Thing .

eg:foo#object rdf:type owl:Thing .
_:jARP297 rdf:type owl:Restriction .
eg:foo#prop rdf:type owl:FunctionalProperty .
_:jARP297 owl:onProperty eg:foo#prop .
_:jARP297 owl:maxCardinality "1" .
eg:foo#object rdf:type _:jARP297 .

10.1.2. owl:InverseFunctionalProperty

first:prop rdf:type owl:InverseFunctionalProperty .
first:prop owl:inverseOf first:inv .

first:inv rdf:type owl:FunctionalProperty .

@prefix this: <http://www.w3.org/2002/03owlt/InverseFunctionalProperty/premises004#> .

this:prop rdf:type owl:ObjectProperty .
this:prop <domain> this:Singleton .
this:Singleton rdf:type <Class> .
_:jARP305 rdf:first _:jARP306 .
_:jARP305 rdf:rest rdf:nil .
_:jARP305 rdf:type rdf:List .
this:Singleton owl:oneOf _:jARP305 .

this:prop rdf:type owl:InverseFunctionalProperty .

10.2. By Issue

10.2.1. [[I4.1-UniqueProp-BadName]]

first:Name rdf:type owl:UniqueProperty .

11. Editorial Issues

11.1. Arising from Automated Checking

Some of these issues will be ignored.

Server returned HTTP response code: 403 for URL: http://www.w3.org/2002/03owlt/I3.4/
Server returned HTTP response code: 403 for URL: http://www.w3.org/2002/03owlt/inverseOf/
Server returned HTTP response code: 403 for URL: http://www.w3.org/2002/03owlt/editors-draft/
Jtidy reported 1 warnings in qualified-cardinality-constraints/.
Jtidy reported 1 warnings in umlp/.
Jtidy reported 1 warnings in I4.1/.
Jtidy reported 231 warnings in webont-issues.
Jtidy reported 7 errors in webont-issues.
Jtidy reported 1 warnings in 03owlt.
Jtidy reported 1 warnings in FunctionalProperty/.
Server returned HTTP response code: 403 for URL: http://www.w3.org/2002/03owlt/I3.2/
Server returned HTTP response code: 403 for URL: http://www.w3.org/2002/03owlt/InverseFunctionalProperty/

11.2. Other

Check descriptions of approved tests with respect to clarity of distinction between syntax and semantics.

Check descriptions for appropriate links to other OWL specs.

Add automatic checking of filenames. (4)

Add automatic checking of URIs: (5)

• gettable or example
• without suffix

Smart update, based on what's changed at w3.org. (3)

Page to choose which bits you want. (2)

Submission page to create/edit test cases. (1)

Validate HTML.

Header boilerplate.

References.

Change some bits to Appendixes.