# commoncoreontology/commoncoreontologies architecture

> Architecture diagram of the GitHub repository commoncoreontology/commoncoreontologies, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/commoncoreontology/commoncoreontologies
- Repository: https://github.com/commoncoreontology/commoncoreontologies

## Overview

CCO is a suite of mid-level ontologies that provides reusable classes and relations grounded in BFO. Its principal workflow is ontology development and use: users import the ontology modules or merged release into ontology tools, then use the shared terms in datasets; per-IRI files support term resolution. The repository also maintains extensions, including the Modal Relation Ontology. The README documents the merge and major ontology scopes; sampled scripts show IRI-file generation and MRO processing details, but not their complete orchestration.

Main entry points: [`src/cco-modules`](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-modules) (Eleven Modules), [`src/cco-merged`](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-merged) (Merged Release), [`scripts/generate_cco_iris.py`](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/generate_cco_iris.py) (IRI File Generator), [`src/cco-iris`](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-iris) (Per-IRI Turtle Files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core Ontologies"]
  node_modules["Eleven Modules"]
  node_agent["Agent Ontology<br/>[AgentOntology.ttl]"]
  node_artifact["Artifact Ontology"]
  node_event["Event Ontology<br/>[EventOntology.ttl]"]
  node_geospatial["Geospatial Ontology"]
  node_information["Information Entity"]
  node_time["Time Ontology<br/>[TimeOntology.ttl]"]
  node_quality["Quality Ontology"]
  node_units["Units Ontology"]
  node_currency["Currency Ontology"]
  node_facility["Facility Ontology"]
  node_relations["Extended Relations"]
  node_merged["Merged Release"]
end

subgraph group_extensions["Extensions"]
  node_extensions["Governance Extensions"]
  node_mro["Modal Relation Ontology"]
end

subgraph group_resolution["IRI Resolution"]
  node_iri_generator["IRI File Generator"]
  node_iri_files["Per-IRI Turtle Files"]
end

subgraph group_mro["MRO Processing"]
  node_mro_extract["Property Extractor<br/>[mro_extract.py]"]
  node_mro_postprocess["MRO Postprocessor<br/>[mro_postprocess.py]"]
end

node_developers(("Ontology Developers"))
node_users(("Ontology Users"))

node_developers -->|"develops"| node_modules
node_developers -->|"contributes"| node_extensions
node_users -->|"uses terms"| node_modules
node_users -->|"imports"| node_merged
node_modules -->|"generates merge"| node_merged
node_iri_generator -->|"reads"| node_merged
node_iri_generator -->|"writes"| node_iri_files
node_users -.->|"resolves terms"| node_iri_files
node_mro_extract -.->|"precedes"| node_mro_postprocess

click node_modules "https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-modules"
click node_agent "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/AgentOntology.ttl"
click node_artifact "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/ArtifactOntology.ttl"
click node_event "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/EventOntology.ttl"
click node_geospatial "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/GeospatialOntology.ttl"
click node_information "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/InformationEntityOntology.ttl"
click node_time "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/TimeOntology.ttl"
click node_quality "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/QualityOntology.ttl"
click node_units "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/UnitsOfMeasureOntology.ttl"
click node_currency "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/CurrencyUnitOntology.ttl"
click node_facility "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/FacilityOntology.ttl"
click node_relations "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/ExtendedRelationOntology.ttl"
click node_merged "https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-merged"
click node_extensions "https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-extensions"
click node_mro "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-extensions/ModalRelationOntology.ttl"
click node_iri_generator "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/generate_cco_iris.py"
click node_iri_files "https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-iris"
click node_mro_extract "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/mro_extract.py"
click node_mro_postprocess "https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/mro_postprocess.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_modules,node_agent,node_artifact,node_event,node_geospatial,node_information,node_time,node_quality,node_units,node_currency,node_facility,node_relations,node_merged,node_users toneBlue
class node_extensions,node_mro toneAmber
class node_iri_generator,node_iri_files toneMint
class node_mro_extract,node_mro_postprocess toneRose
class node_developers toneIndigo
```

## Components

### Core Ontologies

- [Eleven Modules](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-modules): `src/cco-modules`
- [Agent Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/AgentOntology.ttl): `src/cco-iris/AgentOntology.ttl`
- [Artifact Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/ArtifactOntology.ttl): `src/cco-iris/ArtifactOntology.ttl`
- [Event Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/EventOntology.ttl): `src/cco-iris/EventOntology.ttl`
- [Geospatial Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/GeospatialOntology.ttl): `src/cco-iris/GeospatialOntology.ttl`
- [Information Entity](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/InformationEntityOntology.ttl): `src/cco-iris/InformationEntityOntology.ttl`
- [Time Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/TimeOntology.ttl): `src/cco-iris/TimeOntology.ttl`
- [Quality Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/QualityOntology.ttl): `src/cco-iris/QualityOntology.ttl`
- [Units Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/UnitsOfMeasureOntology.ttl): `src/cco-iris/UnitsOfMeasureOntology.ttl`
- [Currency Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/CurrencyUnitOntology.ttl): `src/cco-iris/CurrencyUnitOntology.ttl`
- [Facility Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/FacilityOntology.ttl): `src/cco-iris/FacilityOntology.ttl`
- [Extended Relations](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-iris/ExtendedRelationOntology.ttl): `src/cco-iris/ExtendedRelationOntology.ttl`
- [Merged Release](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-merged): `src/cco-merged`

### Extensions

- [Governance Extensions](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-extensions): `src/cco-extensions`
- [Modal Relation Ontology](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/src/cco-extensions/ModalRelationOntology.ttl): `src/cco-extensions/ModalRelationOntology.ttl`

### IRI Resolution

- [IRI File Generator](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/generate_cco_iris.py): `scripts/generate_cco_iris.py`
- [Per-IRI Turtle Files](https://github.com/commoncoreontology/commoncoreontologies/tree/develop/src/cco-iris): `src/cco-iris`

### MRO Processing

- [Property Extractor](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/mro_extract.py): `scripts/mro_extract.py`
- [MRO Postprocessor](https://github.com/commoncoreontology/commoncoreontologies/blob/develop/scripts/mro_postprocess.py): `scripts/mro_postprocess.py`

### Other components

- **Ontology Developers**
- **Ontology Users**

## Connections

- Ontology Developers → Eleven Modules: develops (evidence: `README.md`)
- Ontology Developers → Governance Extensions: contributes (evidence: `README.md`)
- Ontology Users → Eleven Modules: uses terms (evidence: `README.md`)
- Ontology Users → Merged Release: imports (evidence: `README.md`)
- Eleven Modules → Merged Release: generates merge (evidence: `README.md`)
- IRI File Generator → Merged Release: reads (evidence: `scripts/generate_cco_iris.py`)
- IRI File Generator → Per-IRI Turtle Files: writes (evidence: `scripts/generate_cco_iris.py`)
- Ontology Users → Per-IRI Turtle Files: resolves terms (evidence: `README.md`)
- Property Extractor → MRO Postprocessor: precedes
