Skip to content

Commit

Permalink
Merge pull request #8 from cKlee/master
Browse files Browse the repository at this point in the history 
defined some new properties from goodRelation, added overview table
  • Loading branch information
@cKlee
cKlee committed Sep 17, 2013
2 parents 016130d + 1cb8987 commit e44dd18
Show file tree
Hide file tree
Showing 2 changed files with 68 additions and 76 deletions.
132 changes: 62 additions & 70 deletions holding.md
View file
Expand Up @@ -41,23 +41,25 @@ The Holding Ontology is defined in RDF/Turtle as following:
rdfs:label "Holding Ontology" ;
vann:preferredNamespacePrefix "holding" .

# Core Relationships
# Overview

| Classes<br>(defined by other ontologies) | Properties<br>(defined by this ontology) | Properties<br>(defined by other ontologies)| Individuals |
|:---:|:---:|:---:|:---:|
| [Item]<br>[Agent]<br>[Document]<br>[DocumentService]<br>[Offering]<br>[Location]<br>[Chronology]| [heldBy]<br>[holds]<br>[inCollection]<br>[exemplar]<br>[exemplarOf]<br>[broaderExemplar]<br>[broaderExemplarOf]<br>[narrowerExemplar]<br>[narrowerExemplarOf]<br>[label] | [availableFor]<br>[unavailableFor]<br>[providedBy]<br>[hasChronology]<br>[hasChronologyGap]<br>[availableAtOrFrom]<br>[hasStockKeepingUnit]<br>[siteOf]<br>[name] | [Loan]<br>[Presentation] |

The holding Ontology does not define classes on its own but makes usage of classes defined in other Ontologies. See [Informative References](#informative) for references to the used onotologies.
# Core Relationships

## frbr:Item
The holding Ontology does not define classes on its own but makes usage of classes defined in other Ontologies. See [Informative References] for references to the used onotologies.

[Item]: #item
## Item

An **Item** is a particular copy of a bibliographic resource that is held by an [Agent]. Items are also referred to as holdings, but a holding can include more information about items, such as inventory and access. The Item class is defined by the [FRBR Ontology] without implying the rest of the FRBR model.

frbr:Item a owl:Class ;
rdfs:label "item"@en ;
rdfs:isDefinedBy <http://purl.org/vocab/frbr/core> .

## foaf:Agent

[Agent]: #agent
## Agent

An **Agent** is a person, organization, group or any other entity that can held items and provide services. The Agent class is defined by the [FOAF Ontology].

Expand All @@ -67,8 +69,6 @@ An **Agent** is a person, organization, group or any other entity that can held

## heldBy

[heldBy]: #heldby

Relates an Item to an Institution that holds the Item.

holding:heldBy a owl:ObjectProperty ;
Expand All @@ -81,21 +81,21 @@ Relates an Item to an Institution that holds the Item.

## holds

[holds]: #holds

Relates an Institution to an Item which the Institution holds.
Relates an [Agent] with an [Item] which the [Agent] holds.

holding:holds a owl:ObjectProperty ;
rdfs:label "holds"@en ;
rdfs:comment "Relates an Institution to an Item which the Institution holds."@en ;
rdfs:domain foaf:Organization ;
rdfs:domain foaf:Agent ;
rdfs:range frbr:Item ;
rdfs:subPropertyOf holding:inCollection ;
owl:inverseOf holding:heldBy .

## bibo:Document
## inCollection

[Document]: #document
TODO

## Document

A **Document** is a bounded physical representation of body of information designed with the capacity (and usually intent) to communicate. A document may manifest symbolic, diagrammatic or sensory-representational information. Documents may include both abstract works, such as "Romeo and Juliet", and more conrete entities, such as a specific edition of a book.

Expand Down Expand Up @@ -133,8 +133,6 @@ To give an example:

## exemplar

[exemplar]: #exemplar

Relates a [Document] to an [Item] that is an exemplar of the [Document]. This property is similar to frbr:exemplar but does not refer to the class frbr:Manifestation.

An exemplar should include all parts of a document but there may be gaps and
Expand All @@ -150,8 +148,6 @@ identfied as other documents, one should better use property [narrowerExemplar].

## exemplarOf

[exemplarOf]: #exemplarof

Relates an Item to the Document that is exemplified by the Item.

holding:exemplarOf a owl:ObjectProperty ;
Expand All @@ -163,8 +159,6 @@ Relates an Item to the Document that is exemplified by the Item.

## broaderExemplar

[broaderExemplar]: #broaderexemplar

Relates a Document to an Item that contains an exemplar of the Document as part.

holding:broaderExemplar a owl:ObjectProperty ;
Expand All @@ -177,8 +171,6 @@ Relates a Document to an Item that contains an exemplar of the Document as part.

## broaderExemplarOf

[broaderExemplarOf]: #broaderexemplarof

Relates an Item to a Document which is partly exemplified by the Item.

holding:broaderExemplarOf a owl:ObjectProperty ;
Expand All @@ -190,8 +182,6 @@ Relates an Item to a Document which is partly exemplified by the Item.

## narrowerExemplar

[narrowerExemplar]: #narrowerexemplar

Relates an Item to a Document which is partly exemplified by the Item.

holding:narrowerExemplar a owl:ObjectProperty ;
Expand All @@ -203,8 +193,6 @@ Relates an Item to a Document which is partly exemplified by the Item.

## narrowerExemplarOf

[narrowerExemplarOf]: #narrowerexemplarof

Relates a Document to an Item that is an exemplar of a part of the Document.

holding:narrowerExemplarOf a owl:ObjectProperty ;
Expand All @@ -218,22 +206,18 @@ Relates a Document to an Item that is an exemplar of a part of the Document.

`item-offering-relation.md`{.include}

## dso:DocumentService

[DocumentService]: #documentservice
## DocumentService

A **DocumentService** is a service that is related to one or more [documents](#document). The service involves a service provider (e.g.
a library) and an optional service consumer (e.g. a library patron). Both service provider and service consumer SHOULD be instances of [foaf:Agent](#Agent). The DocumentService class is defined by the [Document Service Ontology].
a library) and an optional service consumer (e.g. a library patron). Both service provider and service consumer SHOULD be instances of [Agent]. The DocumentService class is defined by the [Document Service Ontology].

dso:DocumentService a owl:Class ;
rdfs:label "DocumentService" ;
rdfs:isDefinedBy <http://purl.org/ontology/dso> .

## gr:Offering

[Offering]: #offering
## Offering

In the scope of holding ontology an **Offering** includes a [DocumentService] for an [Item] and optional a [Location] where the service takes place and a [SKU]. Offering is defined by [GoodRelations].
In the scope of holding ontology an **Offering** includes a [DocumentService] for an [Item] and optional a [Location] where the service takes place. The class Offering is defined by [GoodRelations].

gr:Offering a owl:Class ;
rdfs:label "Offering"@en ;
Expand All @@ -243,9 +227,7 @@ Typical offerings for document services within the scope of holding ontology inv

## Presentation

[Presentation]: #presentation

A **Presentation** is an offering for a document service [dso:Presentation]. Use properties [daia:availableFor] and [daia:unavailableFor] from the [DAIA Ontology] to relate this offer with the [Item].
A **Presentation** is an offering for a document service [dso:Presentation]. Use properties [availableFor] and [unavailableFor] from the [DAIA Ontology] to relate this offer with the [Item].

holding:Presentation a owl:NamedIndividual ;
rdf:type gr:Offering ;
Expand All @@ -257,9 +239,7 @@ A **Presentation** is an offering for a document service [dso:Presentation]. Use

## Loan

[Loan]: #loan

A **Loan** is an offering for a document service [dso:Loan]. Use properties [daia:availableFor] and [daia:unavailableFor] from the [DAIA Ontology] to relate this offer with the [Item].
A **Loan** is an offering for a document service [dso:Loan]. Use properties [availableFor] and [unavailableFor] from the [DAIA Ontology] to relate this offer with the [Item].

holding:Loan a owl:NamedIndividual ;
rdf:type gr:Offering ;
Expand All @@ -269,52 +249,66 @@ A **Loan** is an offering for a document service [dso:Loan]. Use properties [dai
a dso:Loan
] .

## gr:Location
## Location

[Location]: #location

A **Location** is a point or area of interest from which a particular [Item] or [DocumentService] is available. The property [gr:availableAtorFrom](#availableAtorFrom) should be used to indicate the location of an offered [DocumentService] for an [Item]. The Location class is defined as part of [GoodRelations].
A **Location** is a point or area of interest from which a particular [Item] or [DocumentService] is available. The property [availableAtorFrom] should be used to indicate the location of an offered [DocumentService] for an [Item]. The Location class is defined by [GoodRelations].

gr:Location a owl:Class ;
rdfs:label "Location" ;
rdfs:isDefinedBy <http://purl.org/goodrelations/v1> .

## gr:availableAtOrFrom
## name

When a [DocumentService] is offered for an [Item], this property is used to name the location where the [DocumentService] should be provided. The Location class is defined by [GoodRelations].

gr:name a owl:AnnotationProperty ;
skos:scopeNote "When a document service is offered for an item, this property is used to name the location where the document service should be provided."@en ;
rdfs:isDefinedBy <http://purl.org/goodrelations/v1> .

## providedBy

Used to relate an [Offering] with an [Agent] who provides the service offered. This property is defined by the the [DAIA Ontology].

daia:providedBy a owl:AnnotationProperty ;
skos:scopeNote "Used to relate an offering with an agent who provides the service offered."@en ;
rdfs:isDefinedBy <http://purl.org/ontology/daia> .

[availableAtOrFrom]: #availableatorfrom
## availableAtOrFrom

This property is used to relate a Offering of a [DocumentService] for an [Item] with a [Location]. See examples for usage.
This property is used to relate a Offering of a [DocumentService] for an [Item] with a [Location]. See [examples] for usage. This property is defined by [GoodRelations].

gr:availableAtOrFrom a owl:AnnotationProperty ;
skos:scopeNote "Used to relate a document service offered for an item with a location."@en ;
rdfs:isDefinedBy <http://purl.org/goodrelations/v1> .

## org:siteOf
## hasStockKeepingUnit

[siteOf]: #siteof
This property is used as an identifier for the [Item] for which a [DocumentService] is offered. See [examples] for usage. This property is defined by [GoodRelations].

This property is used to relate a [Location] with an [Agent]. See examples for usage.
gr:hasStockKeepingUnit a owl:AnnotationProperty ;
skos:scopeNote "Used to identify the item for which a document service is offered."@en ;
rdfs:isDefinedBy <http://purl.org/goodrelations/v1> .

## siteOf

This property is used to relate a [Location] with an [Agent]. See examples for usage. This property is defined by the [Organization Ontology].

gr:availableAtOrFrom a owl:AnnotationProperty ;
skos:scopeNote "This property is used to relate a location with an agent."@en ;
rdfs:isDefinedBy <http://purl.org/goodrelations/v1> .
rdfs:isDefinedBy <http://www.w3.org/ns/org> .

## ecpo:Chronology

[Chronology]: #chronology
## Chronology

A **Chronology** is the description of enumeration and chronology of a periodical. The Chronology class is defined by the [Enumeration and Chronology of Periodicals Ontology].

ecpo:Chronology a owl:Class ;
rdfs:label "Chronology" ;
rdfs:isDefinedBy <http://purl.org/ontology/ecpo> .

To relate an [Item] to a [Chronology] use [ecpo:hasChronology] or [ecpo:hasChronologyGap]. To be more specific on the nature (current or closed) of a [Chronology] use [ecpo:CurrentChronology] or [ecpo:ClosedChronology]. To simply express the fact that an [Item] has a current chronology or a closed chronology without giving further information one MAY use [ecpo:Current] or [ecpo:Closed].
To relate an [Item] to a Chronology use [hasChronology] or [hasChronologyGap]. To be more specific on the nature (current or closed) of a Chronology use [CurrentChronology] or [ClosedChronology]. To simply express the fact that an [Item] has a current chronology or a closed chronology without giving further information one MAY use [Current] or [Closed].

## label

[label]: #label

A call number, shelf mark or similar label of an item

holding:label a owl:DatatypeProperty ;
Expand Down Expand Up @@ -412,8 +406,6 @@ $alicecopies

## Informative References

[informative]: #informative

* ISO 20775
* [Bibliographic Ontology]
* [DAIA Ontology]
Expand All @@ -434,17 +426,17 @@ $alicecopies
[FRBR Ontology]: http://purl.org/vocab/frbr/core
[GoodRelations]: http://purl.org/goodrelations/v1
[Organization Ontology]: http://www.w3.org/ns/org
[daia:availableFor]: http://purl.org/ontology/daia/availableFor
[daia:availableOf]: http://purl.org/ontology/daia/availableOf
[daia:unavailableFor]: http://purl.org/ontology/daia/unavailableFor
[daia:unavailableOf]: http://purl.org/ontology/daia/unavailableOf
[availableFor]: http://purl.org/ontology/daia/availableFor
[availableOf]: http://purl.org/ontology/daia/availableOf
[unavailableFor]: http://purl.org/ontology/daia/unavailableFor
[unavailableOf]: http://purl.org/ontology/daia/unavailableOf
[dso:Loan]: http://purl.org/ontology/dso#Loan
[dso:Presentation]: http://purl.org/ontology/dso#Presentation
[ecpo:hasChronology]: http://purl.org/ontology/ecpo#hasChronology
[ecpo:hasChronologyGap]: http://purl.org/ontology/ecpo#hasChronologyGap
[ecpo:CurrentChronology]: http://purl.org/ontology/ecpo#CurrentChronology
[ecpo:ClosedChronology]: http://purl.org/ontology/ecpo#ClosedChronology
[ecpo:Current]: http://purl.org/ontology/ecpo#Current
[ecpo:Closed]: http://purl.org/ontology/ecpo#Closed
[hasChronology]: http://purl.org/ontology/ecpo#hasChronology
[hasChronologyGap]: http://purl.org/ontology/ecpo#hasChronologyGap
[CurrentChronology]: http://purl.org/ontology/ecpo#CurrentChronology
[ClosedChronology]: http://purl.org/ontology/ecpo#ClosedChronology
[Current]: http://purl.org/ontology/ecpo#Current
[Closed]: http://purl.org/ontology/ecpo#Closed


12 changes: 6 additions & 6 deletions item-offering-relation.md
View file
@@ -1,12 +1,12 @@
``` {.ditaa}
+-----------------------+ +------------------+
| dso:DocumentService | | gr:Offering |
| +------------------+ | gr:includes | +--------------+ |
| | dso:Presentation |<-----------------------+ Presentation | | +-----------+
| +------------------+ | | +--------------+ | daia:availableFor | |
| dso:DocumentService | | gr:Offering | +------------+
| +------------------+ | gr:includes | +--------------+ +----daia:providedBy---->| foaf:Agent |
| | dso:Presentation |<-----------------------+ Presentation | | +------------+
| +------------------+ | | +--------------+ | daia:availableFor +-----------|
| | | |<-----------------------+ frbr:Item |
| +------------------+ | gr:includes | +--------------+ | daia:unavailableFor | |
| | dso:Loan |<-----------------------+ Loan | | +-----------+
| +------------------+ | gr:includes | +--------------+ | daia:unavailableFor +-----------+
| | dso:Loan |<-----------------------+ Loan | |
| +----------------- + | | +--------------+ |
+-----------------------+ +------------------+
```

0 comments on commit e44dd18

Please sign in to comment.