Skip to main content

Sources & Metadata Application Profile

Purpose​

To document how various facets of LINCS data are modelled, along with reference authorities for the populating vocabularies. This will provide a basis for instruction for how to model data in a LINCS-compatible manner, as well as aid in navigation and discovery.

β€œSources and Metadata” describes patterns that are unique or specific to representing information about dataset or data object metadata, as well as the use of the Web Annotation Data Model (WADM) to connect to sources.

This document introduces the concepts as used by LINCS, and are not complete definitions of the CIDOC CRM ontology class or property concepts. Consult CIDOC CRM v. 7.1.1 documentation for full class descriptions and property descriptions.

Acronyms​

Ontology Acronyms:

Vocabulary and Authority Acronyms:

  • LINCS - LINCS minted entities

Main Classes​

Entity TypeClassDeclaration Snippet (TTL)
Attribute assignmentcrm:E13_Attribute_Assignment
<attribute_assignment> a crm:E13_Attribute_Assignment ;
rdfs:label "<attribute_assignment>" .
Annotationcrm:E33_Linguistic_Object, oa:Annotation
<annotation> a crm:E33_Linguistic_Object, oa:Annotation ;
rdfs:label "<annotation>" .
Annotation sourceE73_Information_Object, oa:SpecificResource
<annotation_source> a E73_Information_Object, oa:SpecificResource ;
rdfs:label "<annotation_source>" .
Annotation source quoteE33_Linguistic_Object, oa:TextQuoteSelector
<annotation_source_quote> a E33_Linguistic_Object, oa:TextQuoteSelector ;
rdfs:label "<annotation_source_quote>" .
Metadata methodcrm:E29_Design_or_Procedure
<metadata_method> a crm:E29_Design_or_Procedure ;
rdfs:label "<metadata_method>" .
Typecrm:E55_Type
<type> a crm:E55_Type ;
rdfs:label "<type>" .

Overview Diagram​

Below is an image of the application profile overview diagram. Follow this link for a zoomable, more readable version. The segments below align with the document sections.

Application profile overview diagram.

Nodes​

Annotations​

LINCS uses WADM to support the representation of sources of assertions. This involves aligning WADM with CIDOC CRM; this has been done through an object-centric alignment which declares that an Annotation is the text object that is produced by the act of annotating, and thus can also be classed as a crm:E33_Linguistic_Object. For more on this, see the LINCS Web Annotation Model Use document.

This pattern area can be broken down into three parts:

  1. The connection between the entity and the assertion
  2. Describing the source of the assertion
  3. Identifying the specific resource and text quote used for the assertion

Application profile annotation

Connection between the Entity and the Assertion​

Application profile connection

Pattern/Structure ValuesDefinition

This pattern declares that an attribute that is made about an entity is the subject of an annotation.

Abstraction

crm:E1_CRM_Entity β†’ crm:P140i_was_attributed_by β†’ E13_Attribute_Assignment
β†’ crm:P129i_is_subject_of β†’ E33_Linguistic_Object, oa:Annotation
β†’ crm:P67_refers_to β†’ crm:E1_CRM_Entity
β†’ oa:hasBody β†’ crm:E1_CRM_Entity

Content ValuesType of ValueUniform Resource Identifier (URI)
Expected Value

URI from project dataset, existing linked data authority, or minted by LINCS

Format/Requirements for the ValueURI (preferably dereferenceable)
Case ExamplesTypical Example & Abstraction

The Orlando dataset states that Rosamund Marriort Watson was identified in an annotation of a text which attributed her with having a gender of woman.

orlando:9e381429-5019-48dd-88fd-79e8b3f4825f β†’ crm:P140i_was_attributed_by β†’ crm:E13_Attribute_Assignment
β†’ crm:P129i_is_subject_of β†’ lincs:cCCGa6IkVuU
β†’ crm:P67_refers_to β†’ orlando:9e381429-5019-48dd-88fd-79e8b3f4825f
β†’ oa:hasBody β†’ orlando:9e381429-5019-48dd-88fd-79e8b3f4825f

Edge Case Example & AbstractionN/A
Resource LinksN/A
Discussion Elements Pertaining to This PatternN/A
Projects Following This PatternOrlando

Pattern in TTL:

<entity> a crm:E1_CRM_Entity ; 
rdfs:label "<entity>" ;
crm:P140i_was_attributed_by <attribute_assignment> .

<attribute_assignment> a crm:E13_Attribute_Assignment ;
rdfs:label "<attribute_assignment>" ;
crm:P129i_is_subject_of <annotation> .

<annotation> a crm:E33_Linguistic_Object, oa:Annotation ;
rdfs:label "<annotation>" ;
crm:P67_refers_to <entity> ;
oa:hasBody <entity> .

Describing the Source of the Assertion​

Application profile assertion

Pattern/Structure ValuesDefinitionThis pattern declares that an annotation is made from a source.
Abstraction

crm:E33_Linguistic_Object, oa:Annotation β†’ oa:hasTarget β†’ crm:E73_Information_Object, oa:Specific Resource
β†’ oa:hasSource β†’ crmdig:D1_Digital_Object
β†’ oa:hasSelector β†’ crm:E73_Information_Object, oa:XPathSelector

Content ValuesType of ValueUniform Resource Identifier (URI)
Expected Value

URI from project dataset, existing linked data authority, or minted by LINCS

Format/Requirements for the ValueURI (preferably dereferenceable)
Case ExamplesTypical Example & Abstraction

The Orlando dataset states that the annotation connected to Rosamund Marriort Watson being attributed with having a gender of woman was made from a source.

lincs:cCCGa6IkVuU β†’ oa:hasTarget β†’ lincs:7wNnMYeWw3l
β†’ oa:hasSource β†’ <https://orlando.cambridge.org/profiles/alcolo#alcolo-chapter-birthandbackground>
β†’ oa:hasSelector β†’ lincs:ufFzkYoOJNM

Edge Case Example & AbstractionN/A
Resource LinksN/A
Discussion Elements Pertaining to This PatternN/A
Projects Following This PatternOrlando

Pattern in TTL:

<annotation> a crm:E33_Linguistic_Object, oa:Annotation ; 
rdfs:label "<annotation>" ;
oa:hasTarget <source> .

<source> a crm:E73_Information_Object, oa:SpecificResource ;
rdfs:label "<source>" ;
oa:hasTarget <digital> ;
oa:hasSelector <source_detail> .

<digital> a crmdig:D1_Digital_Object ;
rdfs:label "<digital>" .

<source_detail> a crm:E73_Information_Object, oa:XPathSelector ;
rdfs:label "<source_detail>" .

Identifying the Specific Resource and Text Quote used for the Assertion​

Application profile specific resource

Pattern/Structure ValuesDefinition

This pattern declares that an annotation source includes a specific quote of text.

Abstraction

crm:E73_Information_Object, oa:XPathSelector β†’ oa:refinedBy β†’ crm:E33_Linguistic_Object, oa:TextQuoteSelector
β†’ oa:exact β†’ rdfs:literal

Content ValuesType of ValueUniform Resource Identifier (URI); literal value (text)
Expected Value

URI from project dataset, existing linked data authority, or minted by LINCS; literal value from project dataset

Format/Requirements for the ValueURI (preferably dereferenceable); rdfs:literal
Case ExamplesTypical Example & Abstraction

The Orlando dataset states that the source of the annotation connected to Rosamund Marriort Watson being attributed with having a gender of woman includes a specific quote of text.

lincs:ufFzkYoOJNM β†’ oa:refinedBy β†’ lincs:mgAMtF4hV10
β†’ oa:exact β†’ β€œLMA was raised in a household of middle-class, presumably white, AmericanTranscendentalist thinkers whose philosophies often precluded financial solvency for the Alcott family. Her childhood poverty fuelled her adult writing and earning. The Trancendentalists stand accused by a recent commentator of smug sexism and narrow mindededness.”

Edge Case Example & AbstractionN/A
Resource LinksN/A
Discussion Elements Pertaining to This PatternN/A
Projects Following This PatternOrlando

Pattern in TTL:

<source_detail> a crm:E73_Information_Object, oa:XPathSelector ;
rdfs:label "<source_detail>" ;
oa:refinedBy <source_quote> .

<source_quote> a crm:E33_Linguistic_Object, oa:TextQuoteSelector ;
rdfs:label "<source_quote>" ;
oa:exact "<quote_text>" .

Metadata​

Application profile metadata

Pattern/Structure ValuesDefinitionThis pattern declares that a data object has metadata.
Abstraction

crm:E1_CRM_Entity β†’ crm:P140i_was_attributed_by β†’ crm:E13_Attribute_Assignment
β†’ crm:P33_used_specific_technique β†’ crm:E29_Design_or_Procedure
β†’ rdfs:comment β†’ rdfs:literal
β†’ crm:P2_has_type β†’ crm:E55_Type

Content ValuesType of ValueUniform Resource Identifier (URI); literal value (text)
Expected Value

URI from project dataset, existing linked data authority, or minted by LINCS; literal value from project dataset

Format/Requirements for the ValueURI (preferably dereferenceable); rdfs:literal
Case ExamplesTypical Example & Abstraction

The Orlando dataset states that the administrative metadata of the creation of the MODS record for Hopes and Fears was made using the generation process of the MODS Record of Orlando bibliographic records.

<lincs:MXtpaxIkxG7> β†’ crm:P140i_was_attributed_by β†’ crm:E13_Attribute_Assignment
β†’ crm:P33_used_specific_technique β†’ <lincs:z7kKbF0M7cw>
β†’ rdfs:comment β†’ β€œRecord has been transformed into MODS from an XML Orlando record using an XSLT stylesheet. Metadata originally created in Orlando Document Archive’s bibliographic database formerly available at nifflheim.arts.ualberta.ca/wwp.”
β†’ crm:P2_has_type β†’ <GenerationProcess>

Edge Case Example & AbstractionN/A
Resource LinksN/A
Discussion Elements Pertaining to This PatternN/A
Projects Following This PatternOrlando

Pattern in TTL:

<entity> a crm:E1_CRM_Entity ; 
rdfs:label <entity> ;
crm:P140i_was_attributed_by <admin_metadata_ref> .

<admin_metadata_ref> a crm:E13_Attribute_Assignment ;
rdfs:label "<admin_metadata_ref>" ;
crm:P33_used_specific_technique <process> .

<process> a crm:E29_Design_or_Procedure ;
rdfs:label "<process>" ;
crm:P2_has_type <process_type> ;
rdfs:comment β€œ<process_description>” .

<process_type> a crm:E55_Type ;
rdfs:label "<prcoess_type>" .