# uml2semantics

Convert UML-style TSV specifications into OWL 2 ontologies. Model classes, properties, enumerations, datatype facets, choice patterns, annotations, and property chains, then export RDF/XML, Turtle, JSON-LD, N-Triples, TriG, or N3.

```
flowchart TD
  A["TSV Inputs"] --> B["uml2semantics CLI"]
  B --> C["OWL 2 Ontology"]
  C --> D["External reasoners and validation tools"]
```

## Start here

- [Install and convert your first model](<https://chris-day.github.io/uml2semantics-python/Getting-Started.html>).
- [Build the ISO 20022 ontology](<https://chris-day.github.io/uml2semantics-python/Examples.html#10-build-the-iso-20022-ontology>).
- [Look up CLI options](<https://chris-day.github.io/uml2semantics-python/CLI-Usage.html>) and [TSV columns](<https://chris-day.github.io/uml2semantics-python/TSV-Specification.html>).
- [Use the Python API](<https://chris-day.github.io/uml2semantics-python/Python-API.html>).
- [Diagnose errors and warnings](<https://chris-day.github.io/uml2semantics-python/Troubleshooting.html>).

## Model semantics

[Choices](<https://chris-day.github.io/uml2semantics-python/Choice-Patterns.html>), [datatypes and facets](<https://chris-day.github.io/uml2semantics-python/Datatypes-and-Facets.html>), [enumerations](<https://chris-day.github.io/uml2semantics-python/Enumerations.html>), [annotations](<https://chris-day.github.io/uml2semantics-python/Annotations.html>), and [property chains](<https://chris-day.github.io/uml2semantics-python/Property-Chains.html>) explain the supported mappings.

## Develop and maintain

Read the [architecture](<https://chris-day.github.io/uml2semantics-python/Architecture.html>), [test coverage](<https://chris-day.github.io/uml2semantics-python/Golden-Tests.html>), and [documentation workflow](<https://chris-day.github.io/uml2semantics-python/Documentation.html>). The repository retains the canonical [changelog](<https://github.com/chris-day/uml2semantics-python/blob/main/CHANGELOG.md>) and [Apache-2.0 license](<https://github.com/chris-day/uml2semantics-python/blob/main/LICENSE>).

## Attribution

Based on Henriette Harmse's [UML-to-OWL reference](<https://henrietteharmse.com/uml-vs-owl/uml-class-diagram-to-owl-and-sroiq-reference/>) and [reference implementation](<https://github.com/henrietteharmse/uml2semantics>). For a larger example, see [ISO-20022](<https://github.com/chris-day/ISO-20022>).

These pages consolidate the original project wiki. Maintain documentation in this repository's `docs/`; the separate wiki is retained as a historical source.
