kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/Loan.yaml
kempersc fc405445c6 Refactor and update schema definitions 
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

299 lines
12 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/Loan
name: Loan
title: Loan 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#
aat: http://vocab.getty.edu/aat/
imports:
- linkml:types
- ../enums/LoanStatusEnum
- ../metadata
- ../slots/courier_detail
- ../slots/courier_required
- ../slots/custody_received_by
- ../slots/has_or_had_contact_point
- ../slots/has_or_had_objective
- ../slots/has_or_had_score
- ../slots/has_or_had_type
- ../slots/insurance_currency
- ../slots/insurance_provider
- ../slots/insurance_value
- ../slots/is_or_was_approved_on
- ../slots/is_or_was_based_on
- ../slots/is_or_was_displayed_at
- ../slots/is_or_was_extended
- ../slots/is_or_was_returned
- ../slots/is_or_was_signed_on
- ../slots/lender
- ../slots/lender_contact
- ../slots/loan_agreement_url
- ../slots/loan_end_date
- ../slots/loan_id
- ../slots/loan_note
- ../slots/loan_number
- ../slots/loan_purpose
- ../slots/loan_start_date
- ../slots/loan_status
- ../slots/loan_timespan
- ../slots/loan_type
- ../slots/original_end_date
- ../slots/outbound_condition_report_url
- ../slots/request_date
- ../slots/return_condition_report_url
- ../slots/shipping_method
- ../slots/special_requirement
- ../slots/temporal_extent
default_prefix: hc
classes:
Loan:
class_uri: crm:E10_Transfer_of_Custody
description: "A loan of one or more objects from a lending institution to a borrowing institution.\n\nModels the TEMPORARY TRANSFER OF CUSTODY, not ownership transfer (see ProvenanceEvent\nfor ownership changes).\n\n**Key Distinction**:\n\n| Concept | Class | Description |\n|---------|-------|-------------|\n| Permanent ownership change | ProvenanceEvent | Sale, gift, bequest |\n| **Temporary custody transfer** | **Loan** | **Exhibition loan, study loan** |\n| Object condition | ConservationRecord | Condition assessments |\n\n**Loan Types**:\n\n- **Exhibition Loan**: Object loaned for public display in an exhibition\n- **Study Loan**: Object loaned for research or scholarly examination\n- **Long-term Loan**: Extended loan (typically 1+ years) for permanent display\n- **Institutional Transfer**: Inter-departmental or inter-branch transfer\n\n- **CIDOC-CRM**: crm:E10_Transfer_of_Custody (primary)\n \"The handing over of physical custody of an object from one party to another.\"\n- **Schema.org**:\
\ schema:BorrowAction / schema:LendAction (borrower/lender actions)\n- **SPECTRUM**: Loans Out / Loans In procedures\n\n**SPECTRUM Alignment**:\n\nThis class models both:\n- **Loans Out**: When the custodian is the lender\n- **Loans In**: When the custodian is the borrower\n\n**Relationship to Other Classes**:\n\n```\nCustodian (lender)\n \u2502\n \u2502\u2500\u2500 lends objects via Loan\n v\nLoan (this class)\n \u2502\n \u2502\u2500\u2500 loaned_objects \u2192 ExhibitedObject[]\n \u2502\u2500\u2500 borrower \u2192 Custodian\n \u2502\u2500\u2500 exhibition_ref \u2192 Exhibition (optional)\n v\nCustodian (borrower)\n```\n\n**Example**:\n\nMauritshuis loans \"Girl with a Pearl Earring\" to Rijksmuseum for Vermeer 2023:\n- loan_id: https://nde.nl/ontology/hc/loan/mauritshuis-rijksmuseum-vermeer-2023-001\n- loaned_objects: [mauritshuis-girl-pearl-earring]\n- lender: Mauritshuis\n- custody_received_by: Rijksmuseum\n- loan_status: CLOSED\n- loan_start_date:\
\ 2023-02-10\n- loan_end_date: 2023-06-04\n- exhibition_ref: Vermeer 2023\n"
exact_mappings:
- crm:E10_Transfer_of_Custody
close_mappings:
- schema:BorrowAction
- schema:LendAction
- aat:300055864
related_mappings:
- crm:E8_Acquisition
- schema:TransferAction
slots:
- temporal_extent
- is_or_was_based_on
- is_or_was_approved_on
slot_usage:
is_or_was_approved_on:
range: TimeSpan
examples:
- value:
start_of_the_start: '2021-09-20'
loan_start_date:
required: false
range: date
examples:
- value: '2023-02-10'
loan_end_date:
required: false
range: date
examples:
- value: '2023-06-04'
original_end_date:
required: false
range: date
examples:
- value: '2023-05-15'
is_or_was_extended:
required: false
range: Extension
multivalued: true
inlined: true
examples:
- value:
has_or_had_quantity:
has_or_had_unit:
has_or_had_label: event
temporal_extent:
range: TimeSpan
inlined: true
required: false
examples:
- value:
end_of_the_end: '2023-06-07'
loan_timespan:
required: false
range: TimeSpan
inlined: true
examples:
- value:
begin_of_the_begin: '2023-02-10'
end_of_the_end: '2023-06-04'
loan_agreement_url:
required: false
range: uri
examples:
- value: https://docs.mauritshuis.nl/loans/agreements/2023-001.pdf
insurance_value:
required: false
range: decimal
examples:
- value: 30000000
insurance_currency:
required: false
range: string
examples:
- value: EUR
- value: USD
- value: GBP
insurance_provider:
required: false
range: string
examples:
- value: AXA Art Insurance
- value: Government Indemnity Scheme (UK)
- value: Rijksindemniteit (NL)
courier_required:
required: false
range: boolean
examples:
- value: true
courier_detail:
required: false
range: string
examples:
- value: 'Outbound: Dr. J. Wadum (conservator). Return: Museum registrar.'
shipping_method:
required: false
range: string
examples:
- value: Climate-controlled art transport by Hasenkamp
- value: Hand-carried by courier on commercial flight
outbound_condition_report_url:
required: false
range: uri
examples:
- value: https://docs.mauritshuis.nl/conservation/reports/670-2023-02-outbound.pdf
return_condition_report_url:
required: false
range: uri
examples:
- value: https://docs.mauritshuis.nl/conservation/reports/670-2023-06-return.pdf
is_or_was_returned:
required: false
range: ReturnEvent
multivalued: true
inlined: true
inlined_as_list: true
examples:
- value:
- return_date: '2023-06-07'
has_or_had_condition:
- has_or_had_type: GoodCondition
has_or_had_description:
description_text: UNCHANGED - returned in same condition
- value:
- return_date: '2023-06-07'
has_or_had_condition:
- has_or_had_type: FairCondition
has_or_had_description:
description_text: MINOR_DAMAGE - small scratch on frame, documented
has_or_had_objective:
required: false
range: uriorcurie
inlined: false
examples:
- value: https://nde.nl/ontology/hc/exhibition/rijksmuseum-vermeer-2023
is_or_was_displayed_at:
required: false
range: DisplayLocation
inlined: true
multivalued: true
examples:
- value:
has_or_had_label: Philips Wing, Gallery 0.1
loan_note:
required: false
range: string
multivalued: true
examples:
- value: Object required custom climate-controlled display case
- value: Insurance claim filed for minor frame damage during transport
special_requirement:
required: false
range: string
multivalued: true
examples:
- value: Maintain 45-55% relative humidity
- value: Maximum 50 lux illumination
- value: No photography permitted
- value: Must be displayed in glazed case
has_or_had_type:
equals_expression: '["hc:GalleryType", "hc:MuseumType", "hc:ArchiveOrganizationType", "hc:LibraryType", "hc:ResearchOrganizationType", "hc:HolySacredSiteType", "hc:BioCustodianType"]'
comments:
- Loan models temporary custody transfer between heritage institutions
- Links to ExhibitedObject via loaned_objects relationship
- Links to Custodian via lender and borrower relationships
- Links to Exhibition via exhibition_ref for exhibition loans
- Uses CIDOC-CRM E10_Transfer_of_Custody as primary ontology mapping
- Aligns with SPECTRUM Loans Out / Loans In procedures
see_also:
- https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E10
- https://collectionstrust.org.uk/spectrum/
- https://schema.org/BorrowAction
examples:
- value:
loan_id: https://nde.nl/ontology/hc/loan/mauritshuis-rijksmuseum-2023-001
loan_number: MH-OUT-2023-0042
lender: https://nde.nl/ontology/hc/custodian/nl/mauritshuis
lender_contact: Dr. Maria van der Berg, Registrar
custody_received_by: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
has_or_had_contact_point: Anna de Wit, Exhibition Coordinator
loan_status: CLOSED
loan_type: EXHIBITION_LOAN
loan_purpose: Major Vermeer retrospective exhibition
request_date: '2021-06-15'
is_or_was_based_on:
has_or_had_label: Loan Agreement 2023-001
is_or_was_signed_on: '2022-03-15'
loan_start_date: '2023-02-10'
loan_end_date: '2023-06-04'
temporal_extent:
end_of_the_end: '2023-06-07'
insurance_value: 30000000
insurance_currency: EUR
insurance_provider: Rijksindemniteit
courier_required: true
courier_details: Conservator Dr. J. Wadum accompanied both transits
shipping_method: Climate-controlled art transport by Hizkia
has_or_had_objective: https://nde.nl/ontology/hc/exhibition/rijksmuseum-vermeer-2023
is_or_was_displayed_at:
- has_or_had_label: Philips Wing, Gallery 0.1
is_or_was_returned:
- return_date: '2023-06-07'
has_or_had_condition:
- has_or_had_type: GoodCondition
has_or_had_description:
description_text: UNCHANGED - returned in same condition as loaned
special_requirement:
- Maintain 45-55% relative humidity
- Maximum 50 lux illumination
- Anti-reflective glazed case
- value:
loan_id: https://nde.nl/ontology/hc/loan/rijksmuseum-national-gallery-2024-001
lender: https://nde.nl/ontology/hc/custodian/nl/rijksmuseum
custody_received_by: https://nde.nl/ontology/hc/custodian/uk/national-gallery
loan_status: DECLINED
loan_type: EXHIBITION_LOAN
loan_purpose: Proposed Dutch Golden Age exhibition
request_date: '2023-01-15'
loan_note:
- Declined due to ongoing Operation Night Watch conservation project
- Object too large and fragile for transport
- value:
loan_id: https://nde.nl/ontology/hc/loan/leiden-university-rkd-2024-001
lender: https://nde.nl/ontology/hc/custodian/nl/leiden-university-libraries
custody_received_by: https://nde.nl/ontology/hc/custodian/nl/rkd
loan_status: RETURNED
loan_type: STUDY_LOAN
loan_purpose: Technical analysis for Rembrandt drawings catalogue
loan_start_date: '2024-03-01'
loan_end_date: '2024-04-15'
temporal_extent:
end_of_the_end: '2024-04-12'
courier_required: false
is_or_was_returned:
- return_date: '2024-04-12'
has_or_had_condition:
- has_or_had_type: GoodCondition
has_or_had_description:
description_text: UNCHANGED - returned in same condition
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
Reference in a new issue View git blame Copy permalink