98 lines
2.1 KiB
Markdown
98 lines
2.1 KiB
Markdown
# Finnish ISIL Database - Quick Start Guide
|
|
|
|
## Files in This Directory
|
|
|
|
1. **finland_isil_complete_20251120.json** (104 KB)
|
|
- Raw JSON data from API
|
|
- 817 total records
|
|
- Complete dataset
|
|
|
|
2. **finland_isil_complete_20251120.csv** (55 KB)
|
|
- CSV export for spreadsheet analysis
|
|
- Headers: isil, name, linda, cities, former, active
|
|
|
|
3. **FINLAND_ISIL_HARVEST_REPORT.md** (12 KB)
|
|
- Comprehensive analysis report
|
|
- Institution type breakdown
|
|
- Geographic distribution
|
|
- API documentation
|
|
|
|
4. **QUICK_START.md** (this file)
|
|
- Quick reference guide
|
|
|
|
## Quick Stats
|
|
|
|
- **Total**: 817 institutions
|
|
- **Active**: 750 (91.8%)
|
|
- **Inactive**: 67 (8.2%)
|
|
- **Coverage**: 200+ cities
|
|
|
|
## Institution Types
|
|
|
|
- Public Libraries: 479 (58.6%)
|
|
- Academic Libraries: 232 (28.4%)
|
|
- Museums: 15 (1.8%)
|
|
- Archives: 4 (0.5%)
|
|
- Special Libraries: 9 (1.1%)
|
|
- Other: 78 (9.5%)
|
|
|
|
## Top Cities
|
|
|
|
1. Helsinki: 127 institutions
|
|
2. Turku: 35
|
|
3. Espoo: 23
|
|
4. Tampere: 19
|
|
5. Kuopio: 15
|
|
|
|
## Data Source
|
|
|
|
- **API**: https://isil.kansalliskirjasto.fi/api/query
|
|
- **Provider**: National Library of Finland
|
|
- **Standard**: ISO 15511:2019 (ISIL)
|
|
- **Harvest Date**: November 20, 2025
|
|
|
|
## Usage Examples
|
|
|
|
### Load JSON in Python
|
|
```python
|
|
import json
|
|
|
|
with open('finland_isil_complete_20251120.json', 'r') as f:
|
|
data = json.load(f)
|
|
records = data['data']
|
|
print(f"Loaded {len(records)} institutions")
|
|
```
|
|
|
|
### Load CSV in Python
|
|
```python
|
|
import pandas as pd
|
|
|
|
df = pd.read_csv('finland_isil_complete_20251120.csv')
|
|
print(df.head())
|
|
```
|
|
|
|
### Query API Directly
|
|
```bash
|
|
# Get all records
|
|
curl "https://isil.kansalliskirjasto.fi/api/query"
|
|
|
|
# Search by city
|
|
curl "https://isil.kansalliskirjasto.fi/api/query?cities=helsinki"
|
|
|
|
# Search by name
|
|
curl "https://isil.kansalliskirjasto.fi/api/query?name=kansalliskirjasto"
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
1. Convert to LinkML `HeritageCustodian` format
|
|
2. Classify institution types (LIBRARY/ARCHIVE/MUSEUM)
|
|
3. Geocode city names to coordinates
|
|
4. Cross-link with Wikidata Q-numbers
|
|
5. Add to GLAM master database
|
|
|
|
## See Also
|
|
|
|
- Full analysis: `FINLAND_ISIL_HARVEST_REPORT.md`
|
|
- GLAM project: `/Users/kempersc/apps/glam/`
|
|
- Schema: `/Users/kempersc/apps/glam/schemas/`
|