glam/schemas/20251121/linkml/modules/classes/FeaturePlace.yaml
kempersc 6eb18700f0 Add SHACL validation shapes and validation script for Heritage Custodian Ontology
- Created SHACL shapes for validating temporal consistency and bidirectional relationships in custodial collections and staff observations.
- Implemented a Python script to validate RDF data against the defined SHACL shapes using the pyshacl library.
- Added command-line interface for validation with options for specifying data formats and output reports.
- Included detailed error handling and reporting for validation results.
2025-11-22 23:22:10 +01:00

325 lines
12 KiB
YAML

# Heritage Feature Place Class
# This class represents physical landscape features with heritage significance
id: https://nde.nl/ontology/hc/class/feature-place
name: feature-place-class
title: FeaturePlace Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ../enums/FeatureTypeEnum
- ../enums/PlaceSpecificityEnum
classes:
FeaturePlace:
class_uri: crm:E27_Site
description: >-
Physical feature type classification for nominal place references.
CRITICAL: This is NOT a separate place - it CLASSIFIES the CustodianPlace.
**Relationship to CustodianPlace**:
CustodianPlace provides a NOMINAL REFERENCE to where a custodian is located:
- "Rijksmuseum" (building name as place reference)
- "het herenhuis in de Schilderswijk" (mansion in a neighborhood)
- "de kerk op het Damrak" (church on a street)
FeaturePlace provides the FEATURE TYPE of that same place:
- "Rijksmuseum" → FeaturePlace: MUSEUM (building type)
- "het herenhuis" → FeaturePlace: MANSION (building type)
- "de kerk" → FeaturePlace: PARISH_CHURCH (building type)
**Key Distinction**:
| CustodianPlace | FeaturePlace |
|----------------|--------------|
| WHERE (nominal reference) | WHAT TYPE (classification) |
| "Rijksmuseum" as place name | MUSEUM building type |
| "het herenhuis in Schilderswijk" | MANSION building type |
| Emic reference | Typological classification |
| crm:E53_Place | crm:E27_Site |
**Example Integration**:
```yaml
CustodianPlace:
place_name: "Rijksmuseum"
place_language: "nl"
place_specificity: BUILDING
has_feature_type: # ← Link to FeaturePlace
feature_type: MUSEUM
feature_name: "Rijksmuseum building"
feature_description: "Monumental museum building designed by P.J.H. Cuypers (1885)"
```
**Use Cases**:
- Classify building types (mansion, church, castle, palace)
- Identify monument types (memorial, sculpture, statue)
- Categorize landscape features (park, cemetery, garden)
- Specify infrastructure types (bridge, canal, fortification)
**Ontology alignment**:
- crm:E27_Site (CIDOC-CRM physical site/feature)
- schema:LandmarksOrHistoricalBuildings (Schema.org heritage buildings)
**Institution Type**: Corresponds to 'F' (FEATURES) in GLAMORCUBESFIXPHDNT taxonomy
**Generated by ReconstructionActivity**:
FeaturePlace is generated when physical feature types are identified for
nominal place references (e.g., classifying "the building" as a MANSION).
exact_mappings:
- crm:E27_Site
- schema:LandmarksOrHistoricalBuildings
close_mappings:
- crm:E53_Place
- schema:Place
- schema:TouristAttraction
related_mappings:
- prov:Entity
- dcterms:Location
- geo:Feature
slots:
- feature_type
- feature_name
- feature_language
- feature_description
- feature_note
- classifies_place
- was_derived_from
- was_generated_by
- valid_from
- valid_to
slot_usage:
feature_type:
description: >-
Type of physical heritage feature (REQUIRED).
Specifies what kind of physical feature this is:
- MANSION: Historic mansion or large dwelling
- MONUMENT: Memorial or commemorative structure
- CHURCH: Religious building
- CASTLE: Fortified building
- CEMETERY: Burial ground
- PARK: Heritage park or garden
- etc. (298 types total)
range: FeatureTypeEnum
required: true
examples:
- value: "MANSION"
description: "Historic mansion building"
- value: "PARISH_CHURCH"
description: "Historic church building"
- value: "CEMETERY"
description: "Historic burial ground"
feature_name:
slot_uri: crm:P87_is_identified_by
description: >-
Name/label of the physical feature type classification (OPTIONAL).
CIDOC-CRM: P87_is_identified_by links E1_CRM_Entity to E41_Appellation.
Usually derived from the CustodianPlace.place_name or describes the type.
Can be omitted if only feature_type classification is needed.
range: string
required: false
examples:
- value: "Rijksmuseum building"
description: "Museum building type name"
- value: "Manor house in Schilderswijk"
description: "Mansion building type name"
- value: "Parish church structure"
description: "Church building type name"
feature_language:
slot_uri: dcterms:language
description: >-
Language of feature name.
Dublin Core: language for linguistic context.
range: string
required: false
examples:
- value: "nl"
description: "Dutch feature name"
- value: "en"
description: "English feature name"
feature_description:
slot_uri: dcterms:description
description: >-
Description of the physical feature characteristics.
Dublin Core: description for textual descriptions.
Include:
- Architectural style/period
- Physical characteristics
- Heritage significance
- Construction details
range: string
required: false
examples:
- value: "Neo-Gothic museum building designed by P.J.H. Cuypers, opened 1885"
description: "Museum building characteristics"
- value: "17th-century canal mansion with ornate gable facade"
description: "Mansion architectural features"
classifies_place:
slot_uri: dcterms:type
description: >-
Link to the CustodianPlace that this feature type classifies (REQUIRED).
Dublin Core: type for classification relationship.
This links the feature type classification back to the nominal place reference.
Example: FeaturePlace(MUSEUM) classifies_place → CustodianPlace("Rijksmuseum")
range: CustodianPlace
required: true
examples:
- value: "https://nde.nl/ontology/hc/place/rijksmuseum-location"
description: "Classifies 'Rijksmuseum' place as MUSEUM building type"
feature_note:
slot_uri: skos:note
description: >-
Contextual notes about the feature type classification.
SKOS: note for editorial annotations.
Use for:
- Classification rationale
- Architectural period
- Conservation status
- Heritage designation
range: string
required: false
examples:
- value: "Classified as museum building based on current function"
description: "Classification reasoning"
- value: "Rijksmonument #12345, Neo-Gothic style"
description: "Heritage and architectural notes"
was_derived_from:
slot_uri: prov:wasDerivedFrom
description: >-
CustodianObservation(s) from which this feature type was identified (REQUIRED).
PROV-O: wasDerivedFrom establishes observation→feature type derivation.
Feature type classification can be derived from:
- Architectural surveys describing building type
- Heritage registers classifying monuments
- Historical documents mentioning "mansion", "church", etc.
range: CustodianObservation
multivalued: true
required: true
was_generated_by:
slot_uri: prov:wasGeneratedBy
description: >-
ReconstructionActivity that classified this feature type (optional).
If present: Classification created through formal reconstruction process
If null: Feature type extracted directly without reconstruction activity
PROV-O: wasGeneratedBy links Entity (FeaturePlace) to generating Activity.
range: ReconstructionActivity
required: false
valid_from:
slot_uri: schema:validFrom
description: >-
Start of validity period for this feature type classification.
Schema.org: validFrom for temporal validity.
Use when:
- Feature type changed (mansion converted to museum building)
- Classification updated based on new evidence
range: date
required: false
examples:
- value: "1885-01-01"
description: "Building completed, classified as museum from this date"
- value: "1650-01-01"
description: "Mansion construction date"
valid_to:
slot_uri: schema:validThrough
description: >-
End of validity period for this feature type classification.
Schema.org: validThrough for temporal validity.
Use when:
- Feature demolished/destroyed
- Building repurposed (mansion → office building)
- Classification no longer valid
range: date
required: false
examples:
- value: "1950-12-31"
description: "Building demolished"
- value: "2020-06-30"
description: "Museum closed, building repurposed"
comments:
- "Represents FEATURE TYPE CLASSIFICATION: typological classification of nominal place references"
- "298 specific feature types from Wikidata heritage/place taxonomy"
- "CRITICAL: Classifies CustodianPlace, does NOT replace it"
- "Example: CustodianPlace('Rijksmuseum') has FeaturePlace(MUSEUM)"
- "Adds typological layer to nominal place references"
- "Maps to CIDOC-CRM E27_Site and Schema.org LandmarksOrHistoricalBuildings"
- "Institution Type F (FEATURES) when a physical feature IS the heritage custodian itself"
see_also:
- "http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E27"
- "https://schema.org/LandmarksOrHistoricalBuildings"
- "https://schema.org/Place"
examples:
- value:
feature_type: MUSEUM
feature_name: "Rijksmuseum building"
feature_language: "nl"
feature_description: "Neo-Gothic museum building designed by P.J.H. Cuypers, opened 1885"
feature_note: "Rijksmonument, national heritage building"
classifies_place: "https://nde.nl/ontology/hc/place/rijksmuseum-ams"
was_derived_from:
- "https://w3id.org/heritage/observation/heritage-register-entry"
was_generated_by: "https://w3id.org/heritage/activity/feature-classification-2025"
valid_from: "1885-07-13"
description: "Museum building type classification for 'Rijksmuseum' place reference"
- value:
feature_type: MANSION
feature_name: "Canal mansion"
feature_language: "en"
feature_description: "17th-century patrician mansion with ornate gable facade"
feature_note: "Classified as mansion based on architectural survey"
classifies_place: "https://nde.nl/ontology/hc/place/herenhuis-schilderswijk"
was_derived_from:
- "https://w3id.org/heritage/observation/notarial-deed-1850"
valid_from: "1650-01-01"
description: "Mansion type classification for 'het herenhuis in de Schilderswijk' place reference"
- value:
feature_type: PARISH_CHURCH
feature_name: "Medieval parish church"
feature_language: "en"
feature_description: "Gothic church building with 14th-century tower"
classifies_place: "https://nde.nl/ontology/hc/place/oude-kerk-ams"
was_derived_from:
- "https://w3id.org/heritage/observation/church-archive-catalog"
valid_from: "1306-01-01"
description: "Church building type classification for 'Oude Kerk' place reference"