kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/GEOGRAPHIC_RESTRICTION_QUICK_STATUS.md
kempersc 67657c39b6 feat: Complete Country Class Implementation and Hypernyms Removal 
- Created the Country class with ISO 3166-1 alpha-2 and alpha-3 codes, ensuring minimal design without additional metadata.
- Integrated the Country class into CustodianPlace and LegalForm schemas to support country-specific feature types and legal forms.
- Removed duplicate keys in FeatureTypeEnum.yaml, resulting in 294 unique feature types.
- Eliminated "Hypernyms:" text from FeatureTypeEnum descriptions, verifying that semantic relationships are now conveyed through ontology mappings.
- Created example instance file demonstrating integration of Country with CustodianPlace and LegalForm.
- Updated documentation to reflect the completion of the Country class implementation and hypernyms removal.
2025-11-23 13:09:38 +01:00

2.1 KiB
Raw Blame History

Geographic Restrictions - Quick Status (2025-11-22)

✅ DONE TODAY

  1. Created Subregion.yaml - ISO 3166-2 subdivision codes (US-PA, ID-BA, DE-BY, etc.)
  2. Created Settlement.yaml - GeoNames-based city identifiers
  3. Extracted Wikidata geography - 1,217 entities, 119 countries, 119 subregions, 8 settlements
  4. Identified 72 feature types with country restrictions (33 Japan, 13 USA, 3 Netherlands, etc.)
  5. Created annotation script - Ready to add dcterms:spatial to FeatureTypeEnum

⏳ NEXT STEPS

Immediate (5 minutes):

cd /Users/kempersc/apps/glam
python3 scripts/add_geographic_annotations_to_enum.py

This adds geographic annotations to 72 feature types in FeatureTypeEnum.yaml.

Then (15 minutes):

  1. Import Subregion/Settlement into main schema (01_custodian_name.yaml)
  2. Add subregion, settlement slots to CustodianPlace
  3. Add country, subregion slots to CustodianLegalStatus (optional)

Finally (30 minutes):

  1. Create scripts/validate_geographic_restrictions.py validator
  2. Add test cases for valid/invalid geographic combinations
  3. Regenerate RDF/OWL schema with full timestamps

📊 KEY NUMBERS

  • 72 feature types need geographic validation
  • 119 countries mapped (100% coverage)
  • 119 subregions mapped (100% coverage)
  • Top restricted countries: Japan (33), USA (13), Norway (4), Netherlands (3)

📁 NEW FILES

  • schemas/20251121/linkml/modules/classes/Subregion.yaml
  • schemas/20251121/linkml/modules/classes/Settlement.yaml
  • scripts/extract_wikidata_geography.py
  • scripts/add_geographic_annotations_to_enum.py
  • data/extracted/wikidata_geography_mapping.yaml
  • data/extracted/feature_type_geographic_annotations.yaml

🔍 EXAMPLES

# Netherlands-only feature type
BUITENPLAATS:
  dcterms:spatial: NL
  
# Bali, Indonesia-only feature type  
SACRED_SHRINE_BALI:
  dcterms:spatial: ID
  iso_3166_2: ID-BA
  
# USA-only feature type
CITY_OF_PITTSBURGH_HISTORIC_DESIGNATION:
  dcterms:spatial: US

📚 FULL DETAILS

See GEOGRAPHIC_RESTRICTION_SESSION_COMPLETE.md for comprehensive session notes (4,500+ words).