glam/schemas/20251121/linkml/modules/classes/PersonObservation.yaml
kempersc fcd1c21c63 Add aliases and enhance slot definitions across various modules
- Added new aliases for existing slots to improve clarity and usability, including:
  - has_deadline: has_embargo_end_date
  - has_extent: has_extent_text
  - has_fonds: has_fond
  - has_laboratory: conservation_lab
  - has_language: has_iso_code639_1, has_iso_code639_3
  - has_legal_basis: legal_basis
  - has_light_exposure: max_light_lux
  - has_measurement_unit: has_unit
  - has_note: has_custodian_observation
  - has_occupation: occupation
  - has_operating_hours: has_operating_hours
  - has_position: position
  - has_quantity: has_artwork_count, link_count
  - has_roadmap: review_date
  - has_skill: skill
  - has_speaker: speaker_label
  - has_specification: specification_url
  - has_statement: rights_statement_url, rights_statement
  - has_type: custodian_only
  - has_user_category: serves_visitors_only
  - hold_record_set: record_count
  - identified_by: has_index_number
  - in_period: has_period
  - in_place: has_place
  - in_series: has_series
  - measure: has_measurement
  - measured_on: measurement_date
  - organized_by: has_organizer
  - originate_from: has_origin
  - part_of: suborganization_of
  - published_on: has_publication_date
  - receive_investment: has_investment
  - related_to: connection_heritage_type
  - require: preservation_requirement
  - safeguarded_by: current_keeper, record_holder_note
  - state: states_or_stated
  - take_comission: takes_or_took_comission
  - take_place_at: takes_or_took_place_at
  - transmit_through: transmits_or_transmitted_through
  - warrant: warrants_or_warranted

- Introduced a new slot definition for evaluated_through to capture evaluation methodologies and review statuses.
2026-02-14 14:41:49 +01:00

147 lines
9 KiB
YAML

id: https://nde.nl/ontology/hc/class/PersonObservation
name: PersonObservation
title: Person Observation (Staff Role Context)
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
pico: https://personsincontext.org/model#
pnv: https://w3id.org/pnv#
crm: http://www.cidoc-crm.org/cidoc-crm/
foaf: http://xmlns.com/foaf/0.1/
prov: http://www.w3.org/ns/prov#
dcterms: http://purl.org/dc/terms/
sdo: https://schema.org/
imports:
- linkml:types
- ../slots/begin_of_the_begin
- ../slots/has_age
- ../slots/expertise_in
- ../slots/has_label
- ../slots/has_provenance
- ../slots/has_score
- ../slots/identified_as
- ../slots/deceased
- ../slots/affected_by
- ../slots/affiliated_with
- ../slots/has_provenance_path
- ../slots/has_profile
- ../slots/updated_at
- ../slots/has_source
- ../slots/has_occupation
- ../slots/has_name
- ../slots/refer_to
- ../slots/has_religion
- ../slots/final_of_the_final
- ../slots/has_title
- ../slots/has_staff
classes:
PersonObservation:
class_uri: pico:PersonObservation
description: "An observation of a person serving in a staff role at a heritage custodian institution,\nas documented in a specific source at a specific point in time.\n\n**PiCo Pattern Adaptation**:\nThe PiCo (Persons in Context) ontology distinguishes between:\n- **PersonObservation**: Data about a person as found in a source (evidence-based)\n- **PersonReconstruction**: Aggregated identity from multiple observations (inferred)\n\nFor heritage custodian staff tracking, we adapt this pattern:\n- **PersonObservation**: Staff role as documented in institutional sources\n (annual reports, org charts, staff directories, archival records)\n- Focus on ROLES and AFFILIATIONS rather than biographical details\n- Temporal validity tracks employment period in specific position\n\n**Key Distinction from General Person Data**:\nThis class models INSTITUTIONAL ROLES, not complete biographical data:\n- Emphasis: Role, title, unit affiliation, employment dates\n- NOT: Full biographical reconstruction\
\ (birth, death, family, etc.)\n- Sources: Institutional records (not vital records, census, etc.)\n- PiCo: `pico:PersonObservation` (primary - person data from sources)\n- Schema.org: `schema:Person` (for person identity)\n- Schema.org: `schema:Role` (for organizational role)\n- CIDOC-CRM: `crm:E21_Person` (person as cultural heritage actor)\n- PROV-O: `prov:Agent` (person as responsible agent)\n- FOAF: `foaf:Person` (person in social network)\n\n**Hub Architecture Integration**:\n- PersonObservation refers to Person hub via `refers_to_person` (PICO pattern)\n- PersonObservation refers to OrganizationUnit via `affiliated_with`\n- OrganizationalStructure refers back via `staff_members` (bidirectional)\n- PersonObservation affected by OrganizationalChangeEvent via `affected_by_event`\n- Person hub links to Event via `participated_in_events`\n- Temporal alignment: employment dates vs. organizational unit validity\n\n**Use Cases**:\n1. **Staff directories**: Document current\
\ and historical staff roles\n2. **Organizational provenance**: Track who managed departments/collections\n3. **Workforce history**: Analyze staffing patterns over time\n4. **Expertise tracking**: Find conservators, curators by specialization\n5. **Reorganization impact**: Track staff transitions during structural changes\n\n**Example - Conservation Staff**:\n\n```yaml\nPersonObservation:\n person_name: \"Dr. Jane Smith\"\n staff_role: CONSERVATOR\n role_title: \"Senior Paintings Conservator\"\n affiliated_with: \".../org-unit/rm-conservation-division\"\n role_start_date: \"2013-03-01\"\n role_end_date: null # Still employed\n observation_source:\n source_type: \"Staff directory\"\n source_uri: \"https://rijksmuseum.nl/staff/jane-smith\"\n observation_date: \"2024-11-22\"\n```\n\n**Example - Staff Through Organizational Change**:\n\n```yaml\n# Before merger (2013-02-28)\nPersonObservation:\n person_name: \"Dr. Jane Smith\"\n staff_role: CONSERVATOR\n role_title:\
\ \"Head, Paintings Conservation Department\"\n affiliated_with: \".../org-unit/rm-paintings-conservation\"\n role_start_date: \"2010-01-01\"\n role_end_date: \"2013-02-28\"\n\n# After merger (2013-03-01)\nPersonObservation:\n person_name: \"Dr. Jane Smith\"\n staff_role: CONSERVATOR\n role_title: \"Deputy Director, Conservation Division\"\n affiliated_with: \".../org-unit/rm-conservation-division\"\n role_start_date: \"2013-03-01\"\n role_end_date: null\n affected_by_event: \".../event/rm-conservation-merger-2013\"\n```\n"
exact_mappings:
- pico:PersonObservation
close_mappings:
- schema:Person
- schema:Role
- crm:E21_Person
- foaf:Person
- prov:Agent
slots:
- affected_by
- has_age
slot_usage:
has_age:
# range: string
required: false
occupation:
# range: string
multivalued: true
required: false
has_religion:
# range: string
required: false
identified_as:
# range: string # uriorcurie
# range: Gender
inlined: false # Fixed invalid inline for primitive type
required: false
examples:
- value:
has_label: Female
- value:
has_label: Male
has_staff:
# range: string # uriorcurie
# range: StaffRole
required: true
has_title:
# range: string
required: false
affiliated_with:
# range: string
required: false
begin_of_the_begin:
range: date
required: false
final_of_the_final:
range: date
required: false
has_source:
# range: string
required: false
has_provenance_path:
# range: string
inlined: false # Fixed invalid inline for primitive type
required: false
affected_by:
# range: string # uriorcurie
# range: OrganizationalChangeEvent
required: false
has_expertise_in:
# range: string # uriorcurie
# range: ExpertiseArea
multivalued: true
inlined: false # Fixed invalid inline for primitive type
required: false
has_provenance_path:
# range: string
required: false
has_profile:
range: uri
required: false
begin_of_the_begin:
range: datetime
updated_at:
range: datetime
comments:
- PiCo PersonObservation pattern adapted for institutional staff role tracking
- Focus on ROLES and AFFILIATIONS within heritage organizations
- NOT general biographical reconstruction (PiCo PersonReconstruction is separate concept)
- refers_to_person links observation to Person hub (core PICO pattern)
- Multiple observations from different sources can refer to same Person hub
- Temporal validity enables tracking staff through organizational changes
- "Bidirectional links: staff \u2192 unit (affiliated_with), unit \u2192 staff (staff_members)"
- "Person hub \u2192 Event via participated_in_events enables career event tracking"
- 'Rule 26 compliance: web_claims slot enables verifiable provenance for person data'
- LinkedIn data stored separately in person/entity/ files (Rule 12, Rule 20)
examples:
- value: 'id: https://nde.nl/ontology/hc/person-obs/nl-nh-ams-m-rm/jane-smith/conservator-2013
person_name: Dr. Jane Smith
refers_to_person: https://nde.nl/ontology/hc/person/jane-smith
staff_role: CONSERVATOR
role_title: Deputy Director, Conservation Division
affiliated_with: https://nde.nl/ontology/hc/org-unit/rm-conservation-division
role_start_date: ''2013-03-01''
role_end_date: null
affected_by_event: https://nde.nl/ontology/hc/event/rm-conservation-merger-2013
'
- value: "id: https://nde.nl/ontology/hc/person-obs/nl-nh-ams-m-rm/taco-dibbits/director-2016\nperson_name: Taco Dibbits\nrefers_to_person: https://nde.nl/ontology/hc/person/taco-dibbits\nstaff_role: DIRECTOR\nrole_title: General Director\nrole_start_date: '2016-09-01'\nrole_end_date: null\nlinkedin_profile_url: https://www.linkedin.com/in/taco-dibbits\nlinkedin_profile_path: data/custodian/person/entity/taco-dibbits_20250115T103000Z.json\nhas_web_claim:\n- person_claim_type: full_name\n person_claim_value: Taco Dibbits\n source_url: https://www.rijksmuseum.nl/en/about-us/organisation\n person_xpath: /html/body/main/section[2]/div[1]/h2\n retrieved_on: '2025-01-15T10:30:00Z'\n retrieval_agent: firecrawl\n person_xpath_match_score: 1.0\n- person_claim_type: role_title\n person_claim_value: General Director\n source_url: https://www.rijksmuseum.nl/en/about-us/organisation\n person_xpath: /html/body/main/section[2]/div[1]/p[1]\n retrieved_on: '2025-01-15T10:30:00Z'\n retrieval_agent:\
\ firecrawl\n person_xpath_match_score: 1.0\n"
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"