# bitwrap ontology

> A public music-genre ontology for the bitwrap suite (beats, DJ and musician apps): the genres a
> Petri-net beat sequencer can generate, with tempo, scale, groove, Euclidean drum rhythms,
> instruments and chord progressions; song structures and section profiles; and the engine concepts
> (rhythm rings, Markov melody, control nets) linked to the pflow ontology at https://ontology.pflow.xyz.
> Namespace https://ontology.bitwrap.io/ns#. Version 0.1.0, released 2026-11-11. Draft scope: 19 genres.

Queries run over the materialized graph (6434 triples): the asserted ontology plus its
RDFS/OWL-RL consequences, so subclass closure is already present.

## Query

- [SPARQL endpoint](https://ontology.bitwrap.io/sparql): SPARQL 1.1 protocol, read-only. SELECT, ASK,
  CONSTRUCT, DESCRIBE only. At most 1000 rows and 5 seconds per query; rate limited.
  Results are JSON (application/sparql-results+json) or CSV; graphs are N-Triples or Turtle.
- [MCP server](https://ontology.bitwrap.io/mcp): the same data as MCP tools (Streamable HTTP, no auth):
  sparql_query, describe_term, search_terms, list_classes, list_genres, get_genre, get_release.
- Term pages: one individual per URL, as Turtle, N-Triples or HTML, for example
  https://ontology.bitwrap.io/genre/techno, https://ontology.bitwrap.io/groove/four-on-floor, https://ontology.bitwrap.io/section/drop,
  https://ontology.bitwrap.io/concept/bjorklund. Use describe_term or search_terms to find slugs.
- [Graph explorer](https://ontology.bitwrap.io/explore): for people. Browse the graph in a browser, computed
  client-side from the pack; browsing makes no SPARQL calls.

## Download

- [Ontology, content negotiated](https://ontology.bitwrap.io/ns): Turtle, JSON-LD, N-Triples or RDF/XML
  by Accept header, or https://ontology.bitwrap.io/ns.ttl, /ns.jsonld, /ns.nt, /ns.rdf directly.
- [Whole release](https://ontology.bitwrap.io/release/bitwrap-ontology-0.1.0.tar): ontology in four formats, pack, certificate, manifest, verifier
- [SHA256SUMS](https://ontology.bitwrap.io/release/SHA256SUMS): per-file digests for sha256sum -c
- [verify-pack.py](https://ontology.bitwrap.io/release/verify-pack.py): recomputes the pack digests with only the Python standard library
- [Dataset description (VoID)](https://ontology.bitwrap.io/.well-known/void)

## License

The ontology is dedicated to the public domain under CC0 1.0 Universal
(https://creativecommons.org/publicdomain/zero/1.0/). Use it for anything, with no attribution required. This covers the
ontology data, not the source code of the projects it describes.

## Notes

- The downloadable ontology is the asserted one; the SPARQL graph also holds the
  RDFS/OWL-RL consequences. The certificate covers the RDFS rules only.
- Pack content digest: f60849dc02b67ca415a64c9c71dd5147e8b0ffc25ff44ad9efcf590638b5d085