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
231 lines
7 KiB
YAML
231 lines
7 KiB
YAML
id: https://nde.nl/ontology/hc/class/BirthPlace
|
|
name: birth_place_class
|
|
title: Birth Place 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/
|
|
gn: http://www.geonames.org/ontology#
|
|
wdt: http://www.wikidata.org/prop/direct/
|
|
imports:
|
|
- linkml:types
|
|
- ../metadata
|
|
- ../slots/specificity_annotation
|
|
- ../slots/template_specificity
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScores
|
|
- ../slots/geonames_id
|
|
- ../slots/place_name
|
|
- ../slots/coordinates
|
|
- ../slots/country_code
|
|
- ../slots/modern_place_name
|
|
- ../slots/place_source_text
|
|
- ../slots/region_code
|
|
- ../slots/wikidata_id
|
|
default_prefix: hc
|
|
classes:
|
|
BirthPlace:
|
|
class_uri: schema:Place
|
|
description: >-
|
|
Structured representation of a person's place of birth with support
|
|
for historical place names, modern equivalents, and geographic identifiers.
|
|
|
|
**PURPOSE**:
|
|
|
|
BirthPlace replaces simple string birth_place slots to provide:
|
|
- Historical place name preservation
|
|
- Modern place name linkage
|
|
- Geographic identifier integration (GeoNames, Wikidata)
|
|
- Coordinate storage for mapping applications
|
|
|
|
**HISTORICAL VS. MODERN NAMES**:
|
|
|
|
Many birth places used historical names that have since changed:
|
|
- "Batavia" → "Jakarta"
|
|
- "Bombay" → "Mumbai"
|
|
- "Leningrad" → "St. Petersburg"
|
|
- "Saigon" → "Ho Chi Minh City"
|
|
|
|
BirthPlace preserves the source name while linking to modern identifiers.
|
|
|
|
**GEOGRAPHIC RESOLUTION**:
|
|
|
|
Per AGENTS.md Rule on GeoNames as authoritative source:
|
|
- `geonames_id`: Links to GeoNames for standardization
|
|
- `wikidata_id`: Links to Wikidata for additional context
|
|
- `coordinates`: Lat/lon for mapping
|
|
|
|
**ONTOLOGY ALIGNMENT**:
|
|
|
|
| Ontology | Mapping | Usage |
|
|
|----------|---------|-------|
|
|
| **Schema.org** | `schema:Place` | Primary class |
|
|
| **CIDOC-CRM** | `crm:E53_Place` | Place entity |
|
|
| **GeoNames** | `gn:Feature` | Geographic feature |
|
|
|
|
**EXAMPLE**:
|
|
|
|
```yaml
|
|
has_or_had_place_of_birth:
|
|
place_name: "Batavia"
|
|
modern_place_name: "Jakarta"
|
|
country_code: "ID"
|
|
geonames_id: 1642911
|
|
wikidata_id: "Q3630"
|
|
```
|
|
exact_mappings:
|
|
- schema:Place
|
|
close_mappings:
|
|
- crm:E53_Place
|
|
- gn:Feature
|
|
slots:
|
|
- place_name
|
|
- modern_place_name
|
|
- country_code
|
|
- region_code
|
|
- geonames_id
|
|
- wikidata_id
|
|
- coordinates
|
|
- place_source_text
|
|
- specificity_annotation
|
|
- template_specificity
|
|
slot_usage:
|
|
place_name:
|
|
range: string
|
|
required: true
|
|
description: >-
|
|
Name of the birth place as recorded in source.
|
|
May be historical name that has since changed.
|
|
examples:
|
|
- value: "Amsterdam"
|
|
description: Current name
|
|
- value: "Batavia"
|
|
description: Historical name (now Jakarta)
|
|
modern_place_name:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Modern equivalent name if place_name is historical.
|
|
Leave null if place_name is current.
|
|
examples:
|
|
- value: "Jakarta"
|
|
description: Modern name for Batavia
|
|
country_code:
|
|
range: string
|
|
required: false
|
|
pattern: "^[A-Z]{2}$"
|
|
description: >-
|
|
ISO 3166-1 alpha-2 country code.
|
|
examples:
|
|
- value: "NL"
|
|
- value: "ID"
|
|
region_code:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
ISO 3166-2 region/province code or GeoNames admin1 code.
|
|
examples:
|
|
- value: "NH"
|
|
description: Noord-Holland
|
|
geonames_id:
|
|
range: integer
|
|
required: false
|
|
description: >-
|
|
GeoNames geographic identifier for the place.
|
|
Authoritative source per AGENTS.md.
|
|
examples:
|
|
- value: 2759794
|
|
description: Amsterdam GeoNames ID
|
|
wikidata_id:
|
|
range: string
|
|
required: false
|
|
pattern: "^Q[0-9]+$"
|
|
description: >-
|
|
Wikidata entity identifier for the place.
|
|
examples:
|
|
- value: "Q727"
|
|
description: Amsterdam Wikidata ID
|
|
coordinates:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Geographic coordinates as "lat,lon" string.
|
|
examples:
|
|
- value: "52.3676,4.9041"
|
|
description: Amsterdam coordinates
|
|
place_source_text:
|
|
range: string
|
|
required: false
|
|
description: >-
|
|
Original place text from source document, preserved verbatim.
|
|
Useful when source contains additional context.
|
|
examples:
|
|
- value: "born at the family estate in rural Gelderland"
|
|
comments:
|
|
- "Replaces simple birth_place string slot (Rule 53)"
|
|
- "Preserves historical place names while linking to modern identifiers"
|
|
- "GeoNames ID is authoritative per AGENTS.md"
|
|
see_also:
|
|
- https://schema.org/birthPlace
|
|
- https://www.geonames.org/
|
|
examples:
|
|
- value:
|
|
place_name: "Amsterdam"
|
|
country_code: "NL"
|
|
region_code: "NH"
|
|
geonames_id: 2759794
|
|
wikidata_id: "Q727"
|
|
coordinates: "52.3676,4.9041"
|
|
description: Birth place with full geographic resolution
|
|
- value:
|
|
place_name: "Batavia"
|
|
modern_place_name: "Jakarta"
|
|
country_code: "ID"
|
|
geonames_id: 1642911
|
|
wikidata_id: "Q3630"
|
|
description: Historical place name with modern equivalent
|
|
- value:
|
|
place_name: "rural Gelderland"
|
|
country_code: "NL"
|
|
region_code: "GE"
|
|
place_source_text: "born at the family estate in rural Gelderland"
|
|
description: Imprecise location from archival source
|
|
annotations:
|
|
specificity_score: 0.45
|
|
specificity_rationale: >-
|
|
Birth places are relevant for person research across heritage sectors.
|
|
|
|
slots:
|
|
place_name:
|
|
description: Name of the place as recorded in source.
|
|
range: string
|
|
slot_uri: schema:name
|
|
modern_place_name:
|
|
description: Modern equivalent name if different from source name.
|
|
range: string
|
|
slot_uri: hc:modernPlaceName
|
|
country_code:
|
|
description: ISO 3166-1 alpha-2 country code.
|
|
range: string
|
|
slot_uri: schema:addressCountry
|
|
region_code:
|
|
description: ISO 3166-2 region/province code.
|
|
range: string
|
|
slot_uri: schema:addressRegion
|
|
geonames_id:
|
|
description: GeoNames geographic identifier.
|
|
range: integer
|
|
slot_uri: gn:geonamesId
|
|
wikidata_id:
|
|
description: Wikidata entity identifier.
|
|
range: string
|
|
slot_uri: wdt:P625
|
|
coordinates:
|
|
description: Geographic coordinates as lat,lon string.
|
|
range: string
|
|
slot_uri: schema:geo
|
|
place_source_text:
|
|
description: Original place text from source document.
|
|
range: string
|
|
slot_uri: hc:sourceText
|