Opacity Reason

• CURIE: gmeow:OpacityReason
• IRI: https://blackcatinformatics.ca/gmeow/OpacityReason
• Category: class
• Defined by: gmeow:slices/gts
• Box roles: TBox role (What is this?)

Why a frame is opaque to a given reader (spec §7.6) — a missing capability or damage. An open value vocabulary; opacity is vantage-relative, so the reason is a fact about a reader-frame pair, not about the bytes.

Structure

Subclass of: gufo:QualityValue

Practical Pattern

Use gmeow:OpacityReason as a specialized kind of gufo:QualityValue. Add statement metadata or a standpoint when the assertion needs provenance, confidence, or vantage.

Usage Advice

Use when

• Use as the value vocabulary naming why a frame is opaque to a reader — unknown codec, missing key, or damage — the required reason that keeps opacity distinguishable from data loss.

Avoid when

• Avoid minting reasons as subclasses (they are individuals) and avoid reading a reason as a property of the bytes; it is true of a reader-frame pair, so the same frame may carry no reason at all for a recipient who can decode it.

How to use

• Reference a seeded reason from a frame via gmeow:opacityReason; pair gmeow:opacityMissingKey with gmeow:sealedRecipient to name the agents for whom the frame is transparent.

Examples

• gmeow:opacityMissingKey a gmeow:OpacityReason.