f9f3cc8e74
Schema Improvements: - Fix YAML import indentation across 800+ class files (sed: '^- ../' → ' - ../') - Add descriptions to 26 inline slots missing them (lint warnings) - Fix malformed imports in BirthPlace.yaml and CustodianObservation.yaml Validation Results: - linkml-lint: 4 warnings (intentional SCREAMING_CASE tier names) - gen-owl: SUCCESS (164,069 lines generated) - gen-json-schema: SUCCESS (9.4MB generated) Files affected: 1,034 files, +23,908 -15,200 lines
196 lines
6.8 KiB
YAML
196 lines
6.8 KiB
YAML
id: https://nde.nl/ontology/hc/class/Asserter
|
|
name: Asserter
|
|
title: Asserter Class
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
prov: http://www.w3.org/ns/prov#
|
|
foaf: http://xmlns.com/foaf/0.1/
|
|
schema: http://schema.org/
|
|
dcterms: http://purl.org/dc/terms/
|
|
imports:
|
|
- linkml:types
|
|
- ../enums/AsserterTypeEnum
|
|
- ../slots/has_or_had_identifier
|
|
- ../slots/has_or_had_label
|
|
- ../slots/has_or_had_description
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
- ../slots/asserter_contact
|
|
- ../slots/asserter_type
|
|
- ../slots/asserter_version
|
|
- ../slots/has_or_had_description
|
|
- ../slots/has_or_had_identifier
|
|
- ../slots/has_or_had_label
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ../slots/asserter_contact
|
|
- ../slots/asserter_type
|
|
- ../slots/asserter_version
|
|
- ../slots/has_or_had_description
|
|
- ../slots/has_or_had_identifier
|
|
- ../slots/has_or_had_label
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
default_prefix: hc
|
|
classes:
|
|
Asserter:
|
|
class_uri: prov:Agent
|
|
description: >-
|
|
An agent (person, organization, or system) responsible for making
|
|
an assertion about a heritage entity.
|
|
|
|
**PROV-O ALIGNMENT**:
|
|
|
|
Maps to `prov:Agent` - "An agent is something that bears some form
|
|
of responsibility for an activity taking place, for the existence
|
|
of an entity, or for another agent's activity."
|
|
|
|
**TYPES OF ASSERTERS**:
|
|
|
|
| Type | Description | Example |
|
|
|------|-------------|---------|
|
|
| HUMAN_ANALYST | Expert making judgment | "jane.doe@nde.nl" |
|
|
| AUTOMATED_SYSTEM | Software system | "primary-presence-classifier/1.0" |
|
|
| AI_AGENT | AI/ML model | "claude-opus-4", "opencode-claude-sonnet-4" |
|
|
| ORGANIZATION | Institution | "Noord-Hollands Archief" |
|
|
|
|
**USE CASES**:
|
|
|
|
1. **Attribution Tracking**: Who made this assertion about primary presence?
|
|
2. **Provenance Chain**: Trace assertions back to their source agent.
|
|
3. **Quality Assessment**: Different asserters may have different reliability.
|
|
4. **Accountability**: Identify responsible party for each assertion.
|
|
|
|
**EXAMPLE**:
|
|
|
|
```yaml
|
|
Asserter:
|
|
asserter_id: https://nde.nl/ontology/hc/asserter/claude-opus-4
|
|
asserter_name: Claude Opus 4
|
|
asserter_type: AI_AGENT
|
|
asserter_description: Anthropic Claude AI model used for assertion generation
|
|
asserter_version: "claude-opus-4-20250514"
|
|
```
|
|
exact_mappings:
|
|
- prov:Agent
|
|
close_mappings:
|
|
- foaf:Agent
|
|
- dcterms:Agent
|
|
related_mappings:
|
|
- schema:Person
|
|
- schema:Organization
|
|
slots:
|
|
- has_or_had_identifier
|
|
- has_or_had_label
|
|
- has_or_had_description
|
|
- asserter_type
|
|
- asserter_version
|
|
- asserter_contact
|
|
- specificity_annotation
|
|
- template_specificity
|
|
slot_usage:
|
|
has_or_had_identifier:
|
|
range: uriorcurie
|
|
required: true
|
|
identifier: true
|
|
description: >-
|
|
Unique identifier for this asserter.
|
|
examples:
|
|
- value: https://nde.nl/ontology/hc/asserter/claude-opus-4
|
|
description: AI agent asserter
|
|
- value: https://nde.nl/ontology/hc/asserter/jane-doe-nde
|
|
description: Human analyst asserter
|
|
has_or_had_label:
|
|
range: string
|
|
required: true
|
|
description: >-
|
|
Name of the asserter.
|
|
examples:
|
|
- value: Claude Opus 4
|
|
description: AI model name
|
|
- value: Dr. Jane Doe
|
|
description: Human analyst name
|
|
- value: primary-presence-classifier
|
|
description: Automated system name
|
|
has_or_had_description:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Description of the asserter and their role in the assertion process.
|
|
examples:
|
|
- value: Anthropic Claude AI model used for heritage data assertions
|
|
- value: Senior digital heritage analyst at NDE
|
|
asserter_type:
|
|
range: AsserterTypeEnum
|
|
required: true
|
|
description: >-
|
|
The type of agent making the assertion.
|
|
examples:
|
|
- value: AI_AGENT
|
|
- value: HUMAN_ANALYST
|
|
- value: AUTOMATED_SYSTEM
|
|
asserter_version:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Version identifier for software agents.
|
|
examples:
|
|
- value: "claude-opus-4-20250514"
|
|
- value: "1.2.3"
|
|
asserter_contact:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Contact information for human or organizational asserters.
|
|
examples:
|
|
- value: jane.doe@nde.nl
|
|
- value: heritage-team@museum.nl
|
|
comments:
|
|
- Asserter models the agent responsible for making assertions
|
|
- Supports tracking of human, automated, and AI-based assertions
|
|
- Uses PROV-O Agent as primary ontology mapping
|
|
- Version tracking particularly important for AI/ML agents
|
|
see_also:
|
|
- https://www.w3.org/TR/prov-o/#Agent
|
|
- https://xmlns.com/foaf/spec/#term_Agent
|
|
examples:
|
|
- value:
|
|
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/claude-opus-4
|
|
has_or_had_label: Claude Opus 4
|
|
asserter_type: AI_AGENT
|
|
has_or_had_description: Anthropic Claude AI model used for heritage data assertions
|
|
asserter_version: "claude-opus-4-20250514"
|
|
description: AI agent asserter
|
|
- value:
|
|
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/jane-doe-nde
|
|
has_or_had_label: Dr. Jane Doe
|
|
asserter_type: HUMAN_ANALYST
|
|
has_or_had_description: Senior digital heritage analyst at NDE
|
|
asserter_contact: jane.doe@nde.nl
|
|
description: Human analyst asserter
|
|
- value:
|
|
has_or_had_identifier: https://nde.nl/ontology/hc/asserter/primary-presence-classifier
|
|
has_or_had_label: primary-presence-classifier
|
|
asserter_type: AUTOMATED_SYSTEM
|
|
has_or_had_description: Automated system for classifying primary digital presence
|
|
asserter_version: "1.0.0"
|
|
description: Automated system asserter
|
|
slots:
|
|
asserter_type:
|
|
description: >-
|
|
The type of agent making the assertion (human, automated, AI, organization).
|
|
range: AsserterTypeEnum
|
|
slot_uri: hc:asserterType
|
|
asserter_version:
|
|
description: >-
|
|
Version identifier for software agents (automated systems or AI).
|
|
range: string
|
|
slot_uri: hc:asserterVersion
|
|
asserter_contact:
|
|
description: >-
|
|
Contact information for human or organizational asserters.
|
|
range: string
|
|
slot_uri: hc:asserterContact
|