opacity reason

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

Why a frame is opaque to the describing reader (spec §7.6): an encrypt-class codec without a key, a codec the reader lacks, or damage. Functional and REQUIRED (see shapes): opacity without a stated reason is indistinguishable from data loss.

Structure

Property shape: object property; gmeow:OpaqueFrame -> gmeow:OpacityReason; functional

Practical Pattern

Use gmeow:opacityReason from gmeow:OpaqueFrame to gmeow:OpacityReason when the relationship itself belongs in the native GMEOW graph.

Example Snippets

These snippets are generated from canonical slice examples and trimmed to the Turtle blocks where this term appears.

Dist Package

• Source: slices/core/gts/examples/dist-package.ttl
• Examples catalog: open in catalog#example-slices-core-gts-examples-dist-package

@prefix gmeow: <https://blackcatinformatics.ca/gmeow/> .
@prefix ex:    <https://blackcatinformatics.ca/gmeow/examples/> .
@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .



# A sealed frame: opacity is vantage-relative — transparent to its recipient.
ex:gts-opaque-frame-001
    a gmeow:OpaqueFrame ;
    rdfs:label "sealed evidence attachment"@en ;
    gmeow:opaqueFrameIn ex:gts-dist-segment-core ;
    gmeow:opacityReason gmeow:opacityMissingKey ;
    gmeow:sealedRecipient ex:agent-archivist-001 .

Common Companion Terms

gmeow:OpaqueFrame, gmeow:OpacityReason

Usage Advice

Use when

• Use whenever a frame is surfaced as opaque — it is required, because a stated reason (missing key, unknown codec, damage) is what distinguishes a deliberately sealed or unreadable frame from silent data loss.

Avoid when

• Avoid omitting it on any opaque frame and avoid stacking several reasons (it is functional — one reason per reader-frame pair); the reason is relative to the describing reader, not a property of the bytes.

How to use

• Point the gmeow:OpaqueFrame at exactly one gmeow:OpacityReason; for missing-key opacity, pair it with gmeow:sealedRecipient to name the agents for whom the frame is not opaque at all.

Examples

• ex:frame7 gmeow:opacityReason gmeow:opacityMissingKey.