Schema Reference
Schema reference
OpenDecisions v1 schema, types, properties, and vocabulary (schema.org-style)
OpenDecisions v1: Schema reference
This section documents the OpenDecisions v1 schema at a schema.org level: every type, every property, expected types, and usage. The schema models decision-relevant facts (institutions, programs, cost, outcomes) and derived labels with provenance and uncertainty.
Namespace: https://schema.opendecisions.org/v1/
Schema version: odg/v1
Format: JSON-LD (RDF/Schema.org conventions)
Types
Each type is a distinct class in the vocabulary. Click through to see all properties, expected types, and nested structures.
| Type | Description |
|---|---|
| Institution | A higher education institution (university or college). Identity, classification, enrollment, accreditation, contact. |
| Program | A field of study or degree program; the atomic decision unit. Identity, eligibility, funding, visa, outcomes. |
| AdmissionCycle | A single admissions cycle (e.g. Fall 2024): counts, test scores, policies. |
| CostProfile | Cost of attendance, net price by income, financial aid, and debt for an institution and year. |
| OutcomeStats | Institution-level outcomes: completion, retention, earnings, repayment. |
| CohortStats | Student body composition, income distribution, regional context. |
| Source | Provenance record. Every published numeric claim must reference at least one Source. |
| DerivedIndex | Container for computed decision-label indexes (DQI, CCI, AFuI, CRI, OVI, AFI, ACI) with value, uncertainty, explanation. |
Cross-cutting definitions
| Document | Description |
|---|---|
| Identifiers | Global ID patterns: institutionId, programId, cycleId, sourceId, indexId. |
| Provenance | Shared provenance object (sources, updatedAt) required on every factual entity. |
| Data types | Primitives, rates/proportions, null/suppression, k_min. |
How to use this reference
- Browse by type: Use the type table above; each type page lists all properties and nested types.
- Look up a field: Use the Full field reference for every field in one place.
- Machine-readable: Vocabulary files in the schema repo:
vocabulary/odg-schema-full.jsonld,vocabulary/types/*.jsonld,vocabulary/odg-vocabulary.json.
Relationship to schema.org
- OpenDecisions types use RDF/Schema.org-style definitions:
rdfs:Class,rdf:Property,rdfs:label,rdfs:comment,schema:domainIncludes,schema:rangeIncludes. - OpenDecisions is a separate vocabulary at
https://schema.opendecisions.org/v1/and does not replace schema.org. - Where useful, OpenDecisions reuses schema.org terms (e.g.
schema:name,schema:url,schema:publisher,schema:license).