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 Type	Class	Declaration Snippet (TTL)
Attribute assignment	crm:E13_Attribute_Assignment	`<attribute_assignment> a crm:E13_Attribute_Assignment ; rdfs:label "<attribute_assignment>" .`
Annotation	crm:E33_Linguistic_Object, oa:Annotation	`<annotation> a crm:E33_Linguistic_Object, oa:Annotation ; rdfs:label "<annotation>" .`
Annotation source	E73_Information_Object, oa:SpecificResource	`<annotation_source> a E73_Information_Object, oa:SpecificResource ; rdfs:label "<annotation_source>" .`
Annotation source quote	E33_Linguistic_Object, oa:TextQuoteSelector	`<annotation_source_quote> a E33_Linguistic_Object, oa:TextQuoteSelector ; rdfs:label "<annotation_source_quote>" .`
Metadata method	crm:E29_Design_or_Procedure	`<metadata_method> a crm:E29_Design_or_Procedure ; rdfs:label "<metadata_method>" .`
Type	crm: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.

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:

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

Connection between the Entity and the Assertion

Pattern/Structure Values	Definition	This pattern declares that an attribute that is made about an entity is the subject of an annotation.
Pattern/Structure Values	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 Values	Type of Value	Uniform Resource Identifier (URI)
	Expected Value	URI from project dataset, existing linked data authority, or minted by LINCS
	Format/Requirements for the Value	URI (preferably dereferenceable)
Case Examples	Typical 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`
Case Examples	Edge Case Example & Abstraction	N/A
Resource Links		N/A
Discussion Elements Pertaining to This Pattern		N/A
Projects Following This Pattern		Orlando

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

Pattern/Structure Values	Definition	This pattern declares that an annotation is made from a source.
Pattern/Structure Values	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 Values	Type of Value	Uniform Resource Identifier (URI)
	Expected Value	URI from project dataset, existing linked data authority, or minted by LINCS
	Format/Requirements for the Value	URI (preferably dereferenceable)
Case Examples	Typical 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`
Case Examples	Edge Case Example & Abstraction	N/A
Resource Links		N/A
Discussion Elements Pertaining to This Pattern		N/A
Projects Following This Pattern		Orlando

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 Values	Definition	This pattern declares that an annotation source includes a specific quote of text.
Pattern/Structure Values	Abstraction	`crm:E73_Information_Object, oa:XPathSelector → oa:refinedBy → crm:E33_Linguistic_Object, oa:TextQuoteSelector → oa:exact → rdfs:literal`
Content Values	Type of Value	Uniform 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 Value	URI (preferably dereferenceable); rdfs:literal
Case Examples	Typical 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.”`
Case Examples	Edge Case Example & Abstraction	N/A
Resource Links		N/A
Discussion Elements Pertaining to This Pattern		N/A
Projects Following This Pattern		Orlando

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

Pattern/Structure Values	Definition	This pattern declares that a data object has metadata.
Pattern/Structure Values	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 Values	Type of Value	Uniform 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 Value	URI (preferably dereferenceable); rdfs:literal
Case Examples	Typical 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>`
Case Examples	Edge Case Example & Abstraction	N/A
Resource Links		N/A
Discussion Elements Pertaining to This Pattern		N/A
Projects Following This Pattern		Orlando

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>" .

Purpose​

Acronyms​

Main Classes​

Overview Diagram​

Nodes​

Annotations​

Connection between the Entity and the Assertion​

Describing the Source of the Assertion​

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

Metadata​

Purpose

Acronyms

Main Classes

Overview Diagram

Nodes

Annotations

Connection between the Entity and the Assertion

Describing the Source of the Assertion

Identifying the Specific Resource and Text Quote used for the Assertion

Metadata