id: https://nde.nl/ontology/hc/class/ExhibitedObject
name: ExhibitedObject
title: Exhibited Object Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  crm: http://www.cidoc-crm.org/cidoc-crm/
  dcterms: http://purl.org/dc/terms/
  skos: http://www.w3.org/2004/02/skos/core#
  foaf: http://xmlns.com/foaf/0.1/
  rdfs: http://www.w3.org/2000/01/rdf-schema#
  rico: https://www.ica.org/standards/RiC/ontology#
  aat: http://vocab.getty.edu/aat/
imports:
  - linkml:types
  - ../metadata
  - ./HeritageObject  # Parent class (added 2026-01-15)
  - ./TimeSpan
  - ./CustodianPlace
  - ./Loan
  - ./ConservationRecord
  - ./ProvenanceEvent
  - ../enums/ExhibitedObjectTypeEnum
  # REMOVED 2026-01-15: ../slots/wikidata_id - migrated to has_or_had_identifier + WikiDataIdentifier (Rule 53)
  - ../slots/has_or_had_identifier
  - ./WikiDataIdentifier
  - ../slots/creator
  - ../slots/has_accession_number
  - ../slots/has_acquisition_method
  - ../slots/has_acquisition_date
  - ../slots/external_identifier
  - ../slots/has_or_had_provenance  # was: provenance_text - migrated per Rule 53/56 (2026-01-18)
  - ./Provenance
  - ./Description
  - ../slots/catalog_raisonne_number
  - ../slots/has_or_had_condition_note
  - ../slots/conservation_history
  - ../slots/has_or_had_conservation_record
  - ../slots/creation_place
  - ../slots/creation_timespan
  - ../slots/creator_role
  - ../slots/current_keeper
  - ../slots/current_location
  - ../slots/has_or_had_custodian_type
  - ../slots/date_created
  - ../slots/dimension
  - ../slots/exhibited_in
  - ../slots/iconography
  - ../slots/image_url
  - ../slots/inscription
  - ../slots/inventory_number
  - ../slots/loan_history
  - ../slots/medium
  - ../slots/object_alternate_name
  - ../slots/object_description
  - ../slots/object_id
  - ../slots/object_name
  - ../slots/object_type
  - ../slots/part_of_collection
  - ../slots/permanent_location
  - ../slots/has_or_had_previous_owner
  - ../slots/has_or_had_provenance_event
  - ../slots/specificity_annotation
  - ../slots/has_or_had_subject  # was: subject_depicted - migrated per Rule 53/56 (2026-01-17)
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes
default_prefix: hc
classes:
  ExhibitedObject:
    is_a: HeritageObject  # Inherits from abstract parent (added 2026-01-15)
    class_uri: crm:E22_Human-Made_Object
    description: "An individual artwork, artifact, document, or specimen that may be displayed\nin heritage exhibitions.\n\
      \nModels the OBJECT (physical or conceptual item), linking creators, custodians,\nmaterials, and exhibition history.\n\
      \n**Key Distinction**:\n\n| Concept | Class | Example |\n|---------|-------|---------|\n| Heritage institution | Custodian\
      \ | \"Mauritshuis\" |\n| Curated display | Exhibition | \"Vermeer 2023\" |\n| **Individual object** | **ExhibitedObject**\
      \ | **\"Girl with a Pearl Earring\"** |\n| Collection grouping | Collection | \"Vermeer Collection\" |\n\n**When to\
      \ Use ExhibitedObject**:\n\nUse for individual items that can be displayed or loaned:\n- Paintings, sculptures, drawings,\
      \ prints\n- Archival documents, manuscripts, photographs\n- Archaeological artifacts, ethnographic objects\n- Natural\
      \ history specimens, scientific instruments\n- Digital artworks, installations\n\n- **CIDOC-CRM**: crm:E22_Human-Made_Object\
      \ (primary - cultural heritage standard)\n  \"Physical objects purposefully created by human activity.\"\n- **Schema.org**:\
      \ schema:VisualArtwork (web discoverability for visual art)\n- **CIDOC-CRM**: crm:E19_Physical_Object (broader physical\
      \ objects)\n- **Schema.org**: schema:ArchiveComponent (for archival materials)\n- **RiC-O**: rico:RecordResource (for\
      \ archival records)\n\n**Relationship to Other Classes**:\n\n```\nCustodian (institution)\n     │\n     │── current_keeper\
      \ (who holds the object now)\n     v\nExhibitedObject (this class)\n     │\n     │── exhibited_in → Exhibition[] (where\
      \ object was/is shown)\n     │── creation_timespan → TimeSpan (when object was created)\n     │── creator → (artist/maker\
      \ information)\n     │── conservation_records → ConservationRecord[] (condition/treatments)\n     │── provenance_events\
      \ → ProvenanceEvent[] (ownership history)\n     │── loan_history → Loan[] (loan records)\n     v\nCollection (grouping\
      \ of related objects)\n```\n\n**Provenance Tracking**:\n\nExhibitedObject includes multiple provenance mechanisms:\n\
      \n- `provenance_text`: Narrative ownership history (simple string)\n- `previous_owners`: List of previous owners (simple\
      \ strings)\n- `provenance_events`: Full provenance as structured events with:\n  - Event types (PURCHASE, AUCTION, BEQUEST,\
      \ CONFISCATION, RESTITUTION)\n  - Temporal data (date, timespan)\n  - Parties (seller, buyer, source, recipient)\n \
      \ - Nazi-era flags for Washington Principles compliance\n- `acquisition_info`: How/when acquired by current keeper\n\
      \n**Conservation Records**:\n\n- `condition_notes`: Current condition (simple string)\n- `conservation_history`: Treatment\
      \ history (simple strings)\n- `conservation_records`: Full conservation documentation with:\n  - Condition assessments\
      \ (EXCELLENT to CRITICAL)\n  - Treatment records (cleaning, restoration, repair)\n  - Technical examinations (X-ray,\
      \ IR reflectography)\n  - Pre/post-loan condition checks\n\n**Loan History**:\n\n- `loan_history`: Complete loan records\
      \ with:\n  - Lender and borrower institutions\n  - Loan dates and status (REQUESTED through RETURNED)\n  - Insurance\
      \ valuations and coverage\n  - Condition reports and courier details\n\n**Example**:\n\nJohannes Vermeer's \"Girl with\
      \ a Pearl Earring\":\n- object_id: https://nde.nl/ontology/hc/object/mauritshuis-girl-pearl-earring\n- object_name:\
      \ \"Girl with a Pearl Earring\"\n- object_type: PAINTING\n- creator: \"Johannes Vermeer\"\n- date_created: c. 1665\n\
      - current_keeper: Mauritshuis\n- exhibited_in: [Vermeer 2023, various traveling exhibitions]\n"
    exact_mappings:
    - crm:E22_Human-Made_Object
    close_mappings:
    - schema:VisualArtwork
    - crm:E19_Physical_Object
    - schema:ArchiveComponent
    - rico:RecordResource
    related_mappings:
    - schema:CreativeWork
    - crm:E24_Physical_Human-Made_Thing
    - crm:E84_Information_Carrier
    slots:
    # Inherited from HeritageObject: object_id, object_name, object_description, 
    # current_keeper, current_location, has_or_had_identifier, 
    # specificity_annotation, template_specificity
    # These are listed here to apply class-specific slot_usage
    - has_accession_number
    - has_acquisition_date
    - has_acquisition_method
    - catalog_raisonne_number
    - has_or_had_condition_note
    - conservation_history
    - has_or_had_conservation_record
    - creation_place
    - creation_timespan
    - creator
    - creator_role
    - current_keeper
    - current_location
    - has_or_had_custodian_type
    - date_created
    - dimension
    - exhibited_in
    - external_identifier
    - iconography
    - image_url
    - inscription
    - inventory_number
    - loan_history
    - medium
    - object_alternate_name
    - object_description
    - object_id
    - object_name
    - object_type
    - part_of_collection
    - permanent_location
    - has_or_had_previous_owner
    - has_or_had_provenance_event
    - has_or_had_provenance  # was: provenance_text - migrated per Rule 53/56 (2026-01-18)
    - specificity_annotation
    - has_or_had_subject  # was: subject_depicted - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    # REMOVED 2026-01-15: wikidata_id - migrated to has_or_had_identifier (Rule 53)
    - has_or_had_identifier
    slot_usage:
      object_id:
        identifier: true
        required: true
        range: uriorcurie
        examples:
        - value: https://nde.nl/ontology/hc/object/mauritshuis-girl-pearl-earring
        - value: https://nde.nl/ontology/hc/object/rijksmuseum-night-watch
      object_name:
        required: true
        range: string
        examples:
        - value: Girl with a Pearl Earring
        - value: The Night Watch
        - value: Rosetta Stone
      object_alternate_name:
        required: false
        range: string
        multivalued: true
        examples:
        - value: Meisje met de parel
          description: Dutch title
        - value: The Militia Company of Captain Frans Banninck Cocq
          description: Original title of The Night Watch
      object_description:
        required: false
        range: string
        examples:
        - value: 'Oil painting by Johannes Vermeer, depicting a girl wearing an exotic

            dress and a large pearl earring. One of the most famous paintings in

            the world, sometimes called "the Mona Lisa of the North."

            '
      object_type:
        required: true
        range: ExhibitedObjectTypeEnum
        examples:
        - value: PAINTING
        - value: SCULPTURE
        - value: MANUSCRIPT
      creator:
        required: false
        range: string
        multivalued: true
        examples:
        - value: Johannes Vermeer
        - value: Rembrandt van Rijn
        - value: Unknown Egyptian artist
      creator_role:
        required: false
        range: string
        multivalued: true
        examples:
        - value: Artist
        - value: Workshop of
        - value: Attributed to
        - value: Circle of
      date_created:
        required: false
        range: string
        examples:
        - value: c. 1665
        - value: '1642'
        - value: 12th century BCE
      creation_timespan:
        required: false
        range: TimeSpan
        inlined: true
        examples:
        - value:
            begin_of_the_begin: '1664-01-01'
            end_of_the_end: '1667-12-31'
          description: c. 1665 painting date
      creation_place:
        required: false
        range: CustodianPlace
        inlined: true
        examples:
        - value:
            place_name: Delft
            country: NL
      medium:
        required: false
        range: string
        examples:
        - value: Oil on canvas
        - value: Marble
        - value: Bronze
        - value: Ink and wash on paper
        - value: Ceramic, glazed
      dimension:
        required: false
        range: string
        examples:
        - value: 44.5 × 39 cm
          description: Girl with a Pearl Earring
        - value: 363 × 437 cm
          description: The Night Watch
        - value: 114.4 × 72.3 × 27.9 cm, 762 kg
          description: Rosetta Stone
      inscription:
        required: false
        range: string
        multivalued: true
        examples:
        - value: IVMeer
          description: Vermeer signature
        - value: Rembrandt f. 1642
          description: Rembrandt signature with date
      current_keeper:
        required: false
        range: uriorcurie
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/custodian/nl/mauritshuis
        - value: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
      current_location:
        required: false
        range: CustodianPlace
        inlined: true
        examples:
        - value:
            place_name: Mauritshuis
            city: Den Haag
            country: NL
      permanent_location:
        required: false
        range: string
        examples:
        - value: Gallery 15
        - value: Dutch Golden Age wing, Room 3
      has_accession_number:
        required: false
        range: string
        examples:
        - value: '670'
          description: Mauritshuis accession number for Girl with a Pearl Earring
        - value: SK-C-5
          description: Rijksmuseum accession for The Night Watch
      inventory_number:
        required: false
        range: string
        examples:
        - value: BM-1802,0710.1
          description: British Museum inventory
      has_or_had_provenance:  # was: provenance_text - migrated per Rule 53/56 (2026-01-18)
        description: |
          Narrative provenance history for this exhibited object.
          MIGRATED from provenance_text per slot_fixes.yaml (Rule 53/56, 2026-01-18).
          Uses Provenance class with has_or_had_description for text content.
          Use description_type: "provenance_text" to indicate Getty format.
        required: false
        range: Provenance
        inlined: true
        examples:
        - value:
            has_or_had_description:
              - description_text: "Possibly Pieter van Ruijven, Delft (c. 1665); his widow, Maria de Knuijt, Delft (1674); Dissius sale, Amsterdam, May 16, 1696, lot 36; Braamcamp sale, Amsterdam, July 31, 1771, lot 54; Purchased for 30 guilders by A.A. des Tombe, The Hague (1881); Bequeathed to Mauritshuis (1903)."
                description_type: provenance_text
          description: Full provenance chain for Girl with a Pearl Earring
      has_or_had_previous_owner:
        required: false
        range: string
        multivalued: true
        examples:
        - value:
          - Pieter van Ruijven (c. 1665-1674)
          - Maria de Knuijt (1674)
          - A.A. des Tombe (1881-1903)
      has_acquisition_method:
        required: false
        range: string
        examples:
        - value: BEQUEST
          description: des Tombe bequest to Mauritshuis
      has_acquisition_date:
        required: false
        range: date
        examples:
        - value: '1903-01-01'
      exhibited_in:
        required: false
        range: uriorcurie
        multivalued: true
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/exhibition/rijksmuseum-vermeer-2023
          description: Vermeer exhibition 2023
      part_of_collection:
        required: false
        range: uriorcurie
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/collection/mauritshuis-dutch-paintings
      has_or_had_subject:  # was: subject_depicted - migrated per Rule 53/56 (2026-01-17)
        required: false
        range: string
        multivalued: true
        examples:
        - value: portrait
        - value: girl
        - value: pearl earring
        - value: turban
      iconography:
        required: false
        range: string
        examples:
        - value: 31A221 - portrait of a woman
        - value: '41D221 - jewelry: earring'
      has_or_had_condition_note:
        required: false
        range: string
        examples:
        - value: Good condition. Cleaned and restored in 1994.
      conservation_history:
        required: false
        range: string
        multivalued: true
        examples:
        - value: '1882: First cleaning'
        - value: '1994: Major restoration by Jorgen Wadum'
      image_url:
        required: false
        range: uri
        multivalued: true
        examples:
        - value: https://www.mauritshuis.nl/media/670-large.jpg
      # MIGRATED 2026-01-15: wikidata_id → has_or_had_identifier + WikiDataIdentifier (Rule 53)
      has_or_had_identifier:
        description: |
          Wikidata entity identifier (Q-number) for this exhibited object.
          MIGRATED 2026-01-15: Replaces wikidata_id slot per Rule 53.
        required: false
        range: WikiDataIdentifier
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
        - value:
            qid: "Q81858"
            label: "Girl with a Pearl Earring"
          description: Girl with a Pearl Earring Wikidata identifier
        - value:
            qid: "Q219831"
            label: "The Night Watch"
          description: The Night Watch Wikidata identifier
      external_identifier:
        required: false
        range: string
        multivalued: true
        examples:
        - value: rkdimages:23903
        - value: getty_ulan:500121212
      catalog_raisonne_number:
        required: false
        range: string
        examples:
        - value: Hofstede de Groot 1907, no. 44
        - value: Bredius 410
      has_or_had_conservation_record:
        required: false
        range: ConservationRecord
        multivalued: true
        inlined: true
        # MIGRATED 2026-01-22: condition_before/after → initial_of_the_initial/final_of_the_final + ConditionState (Rule 53)
        examples:
        - value:
            record_id: https://nde.nl/ontology/hc/conservation/mauritshuis-gwpe-1994
            record_type: TREATMENT
            record_date: '1994-03-15'
            initial_of_the_initial:
              has_or_had_type: FairCondition
              has_or_had_description:
                description_text: "Yellowed varnish, surface dirt"
            final_of_the_final:
              has_or_had_type: GoodCondition
              has_or_had_description:
                description_text: "After restoration - varnish cleaned"
            has_or_had_treatment:
              - treatment_type: CLEANING
                treatment_description: "Major restoration including cleaning of yellowed varnish"
                treated_by: "Jorgen Wadum"
          description: 1994 restoration of Girl with a Pearl Earring
      has_or_had_provenance_event:
        required: false
        range: ProvenanceEvent
        multivalued: true
        inlined: true
        examples:
        - value:
            event_id: https://nde.nl/ontology/hc/provenance/gwpe-des-tombe-bequest
            event_type: BEQUEST
            event_date: '1903-01-01'
            previous_owner: A.A. des Tombe
            new_owner_institution: https://nde.nl/ontology/hc/custodian/nl/mauritshuis
            event_description: Bequeathed to Mauritshuis by A.A. des Tombe
          description: 1903 bequest of Girl with a Pearl Earring
      loan_history:
        required: false
        range: Loan
        multivalued: true
        inlined: false
        examples:
        - value: https://nde.nl/ontology/hc/loan/mauritshuis-rijksmuseum-vermeer-2023
          description: Loan to Rijksmuseum for Vermeer 2023 exhibition
      has_or_had_custodian_type:
        equals_expression: '["hc:GalleryType", "hc:MuseumType", "hc:ArchiveOrganizationType", "hc:LibraryType", "hc:ResearchOrganizationType",
          "hc:HolySacredSiteType", "hc:BioCustodianType"]'
    comments:
    - ExhibitedObject models individual artworks/artifacts displayable in exhibitions
    - Links to Custodian via current_keeper relationship
    - 'Links to Exhibition via exhibited_in (inverse: featured_objects)'
    - Links to ConservationRecord via conservation_records (condition/treatments)
    - Links to ProvenanceEvent via provenance_events (ownership history)
    - Links to Loan via loan_history (loan records)
    - Uses CIDOC-CRM E22_Human-Made_Object as primary ontology mapping
    - Supports detailed provenance tracking via provenance_events (structured) or provenance_text (narrative)
    - creation_timespan enables CIDOC-CRM fuzzy temporal modeling for uncertain dates
    - conservation_records enables full documentation vs simple condition_notes string
    see_also:
    - https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E22
    - https://schema.org/VisualArtwork
    - https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#P50
    examples:
    - value:
        object_id: https://nde.nl/ontology/hc/object/mauritshuis-girl-pearl-earring
        object_name: Girl with a Pearl Earring
        object_alternate_name:
        - Meisje met de parel
        - Het meisje met de parel
        object_description: "Oil painting by Johannes Vermeer, depicting a girl in a blue and gold \nturban with a large pearl\
          \ earring. One of Vermeer's most celebrated\nworks, nicknamed \"the Mona Lisa of the North.\"\n"
        object_type: PAINTING
        creator:
        - Johannes Vermeer
        creator_role:
        - Artist
        date_created: c. 1665
        creation_timespan:
          begin_of_the_begin: '1664-01-01'
          end_of_the_end: '1667-12-31'
        creation_place:
          place_name: Delft
          country: NL
        medium: Oil on canvas
        dimensions: 44.5 × 39 cm
        inscription:
        - IVMeer (upper left corner)
        current_keeper: https://nde.nl/ontology/hc/custodian/nl/mauritshuis
        current_location:
          place_name: Mauritshuis
          city: Den Haag
          country: NL
        permanent_location: Gallery 15
        accession_number: '670'
        acquisition_method: BEQUEST
        acquisition_date: '1903-01-01'
        has_or_had_provenance:  # was: provenance_text - migrated per Rule 53/56 (2026-01-18)
          has_or_had_description:
            - description_text: "Possibly Pieter van Ruijven, Delft (c. 1665); his widow, Maria de Knuijt, Delft (1674); Dissius sale, Amsterdam, May 16, 1696; A.A. des Tombe, The Hague (purchased 1881); Bequeathed to Mauritshuis (1903)."
              description_type: provenance_text
        exhibited_in:
        - https://nde.nl/ontology/hc/exhibition/rijksmuseum-vermeer-2023
        has_or_had_subject:  # was: subject_depicted - migrated per Rule 53/56 (2026-01-17)
        - portrait
        - girl
        - pearl earring
        - turban
        has_or_had_identifier:
        - qid: "Q81858"
          label: "Girl with a Pearl Earring"
      description: Girl with a Pearl Earring - Vermeer masterpiece at Mauritshuis
    - value:
        object_id: https://nde.nl/ontology/hc/object/rijksmuseum-night-watch
        object_name: The Night Watch
        object_alternate_name:
        - De Nachtwacht
        - The Militia Company of Captain Frans Banninck Cocq
        object_type: PAINTING
        creator:
        - Rembrandt van Rijn
        date_created: '1642'
        medium: Oil on canvas
        dimensions: 363 × 437 cm
        inscription:
        - Rembrandt f. 1642
        current_keeper: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
        accession_number: SK-C-5
        has_or_had_identifier:
        - qid: "Q219831"
          label: "The Night Watch"
      description: The Night Watch - Rembrandt masterpiece at Rijksmuseum
    - value:
        object_id: https://nde.nl/ontology/hc/object/british-museum-rosetta-stone
        object_name: Rosetta Stone
        object_type: ARCHAEOLOGICAL_ARTIFACT
        date_created: 196 BCE
        medium: Granodiorite
        dimensions: 114.4 × 72.3 × 27.9 cm, 762 kg
        current_keeper: https://nde.nl/ontology/hc/custodian/uk/british-museum
        accession_number: EA 24
        has_or_had_identifier:
        - qid: "Q48584"
          label: "Rosetta Stone"
      description: Rosetta Stone at British Museum