########################################################################### # # SSTIM Engine Configuration Module # # Version: 0.20.0 # Date: 2026-10-19 # Author: Renato Fabbri # License: CC BY 4.0 # # Protected ontology source. Public term IRIs remain stable across the # 0.13 modular redistribution (ADR 0043). # ########################################################################### @prefix sstim: . @prefix sstim-v: . @prefix sstim-sh: . @prefix sstim-ex: . @prefix sstim-eco: . @prefix owl: . @prefix rdf: . @prefix rdfs: . @prefix xsd: . @prefix skos: . @prefix dct: . @prefix prov: . @prefix mod: . @prefix bfo: . @prefix obi: . @prefix iao: . @prefix cob: . @prefix ro: . ########################################################################### # Module metadata ########################################################################### a owl:Ontology ; owl:versionInfo "0.20.0" ; dct:title "SSTIM Engine Configuration Module"@en ; dct:description "Generic engine configurations, tracks, defaults, revision links, and configuration-to-stimulus, technique, framework, and caution relations."@en ; dct:isPartOf ; dct:requires , , ; dct:creator ; dct:publisher ; dct:created "2026-08-01"^^xsd:date ; dct:issued "2026-10-19"^^xsd:date ; dct:modified "2026-10-19"^^xsd:date ; dct:license . ########################################################################### # Configurations, tracks, and configuration relations ########################################################################### sstim:Preset a owl:Class ; rdfs:subClassOf iao:0000030 ; rdfs:label "Preset"@en, "Preset"@it, "Preset"@pt, "Preset"@es ; skos:altLabel "Patch"@en ; skos:definition "A reusable, versioned parameter configuration that makes a particular engine, instrument or design produce an intended sensory stimulation. A preset follows a protocol or framework but is not itself the protocol, and it is not the stimulation: it is the set of settings from which one engine reproduces it."@en ; skos:scopeNote "Engine-dependent by nature. Two engines that produce identical stimulation may have entirely unrelated presets, and two research groups will have unrelated schemas, so the field list is a property of a schema rather than of this class. The BSC catalog format and Patch Studio's patch-studio-model-1 are two such schemas; they are conformance profiles of this class, not distinct classes. \"Patch\" is a synonym, from modular-synthesis usage. The engine-independent description of what actually reaches the subject is sstim:StimulusSpecification, which is a different layer (ADR 0041)."@en ; skos:historyNote "Until 0.11.x the definition named \"audio architecture\" as a constituent. That described the BSC catalog format, not presets: a sensory stimulation preset may carry visual, haptic, respiratory, olfactory, gustatory or electromagnetic layers, as sstim-ex:StimulusChannel already recognises. Corrected by ADR 0041."@en ; rdfs:seeAlso , , ; rdfs:isDefinedBy . sstim:targetsFrequencyBand a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:FrequencyBand ; rdfs:label "targets frequency band"@en ; skos:definition "Links a preset to 1–2 target frequency bands. RDF property values are unordered; use sstim:primaryFrequencyBand to identify which one is primary (RDF-08, 2026-07-24 audit)."@en ; rdfs:isDefinedBy . sstim:primaryFrequencyBand a owl:ObjectProperty, owl:FunctionalProperty ; rdfs:subPropertyOf sstim:targetsFrequencyBand ; rdfs:domain sstim:Preset ; rdfs:range sstim:FrequencyBand ; rdfs:label "primary frequency band"@en ; skos:definition "The single primary band among a preset's sstim:targetsFrequencyBand values, when more than one is declared. Corrects the former convention of an implicit 'first entry is primary' ordering, which RDF property values do not carry (RDF-08, 2026-07-24 audit)."@en ; rdfs:isDefinedBy . sstim:forImplementation a owl:ObjectProperty, owl:FunctionalProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:SensoryStimulationImplementation ; rdfs:label "for implementation"@en ; skos:definition "Links a preset to the implementation whose parameter model it configures."@en ; rdfs:isDefinedBy . sstim:followsProtocol a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:SensoryStimulationProtocol ; rdfs:label "follows protocol"@en ; skos:definition "Links a preset to the sensory stimulation protocol whose rules or constraints it follows."@en ; rdfs:isDefinedBy . sstim:hasIntendedEffect a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:IntendedEffect ; rdfs:label "has intended effect"@en ; skos:definition "Links a preset to one or more controlled design-intent categories. The relation describes purpose and does not assert that the effect occurred."@en ; rdfs:isDefinedBy . sstim:hasCautionTag a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:CautionTag ; rdfs:label "has caution tag"@en ; skos:definition "Links a preset to a safety or usage advisory flag. A preset may carry zero or more caution tags."@en ; rdfs:isDefinedBy . sstim:derivedFrom a owl:ObjectProperty, owl:AsymmetricProperty, owl:IrreflexiveProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:Preset ; rdfs:label "derived from"@en ; skos:definition "Links a preset to its immediate predecessor preset version. The relation is directional, asymmetric, and not transitive; use repeated links to traverse a longer revision history."@en ; rdfs:isDefinedBy . sstim:presetVersion a owl:DatatypeProperty, owl:FunctionalProperty ; rdfs:domain sstim:Preset ; rdfs:range xsd:string ; rdfs:label "preset version"@en ; skos:definition "Semantic version string (X.Y.Z) of this preset."@en ; rdfs:isDefinedBy . sstim:durationSeconds a owl:DatatypeProperty, owl:FunctionalProperty ; # A configuration may carry a default duration, which a session may override; # ADR 0041 §3 treats "changing the default duration, if the preset has one" # as one of the liberties a session takes. The union admits both without # entailing that a preset is a session specification. rdfs:range xsd:integer ; rdfs:label "duration (seconds)"@en ; skos:definition "Intended total duration in whole seconds, either of a session specification or as the default carried by a preset."@en ; skos:scopeNote "Whole seconds deliberately, as with sstim:actualDurationSeconds and unlike the decimal durations around it. This is an intended duration — something a person chose, or a preset shipped as its default — and intent is not authored at sub-second precision. What actually happened is measured separately and finely: sstim:deliveredDurationSeconds is a decimal. Recorded because the second-pass review of 2026-08-17 found two integer durations among nine decimals with nothing saying whether the difference was meaningful; the other one was answered the same day and this one was not."@en ; rdfs:isDefinedBy . sstim:masterVolume a owl:DatatypeProperty, owl:FunctionalProperty ; # As sstim:durationSeconds above — a configuration may carry a default gain. rdfs:range xsd:decimal ; rdfs:label "master volume"@en ; skos:definition "Normalized master output gain, from 0 (silent) to 1 (implementation maximum); an engine control, not a calibrated sound-pressure level. The delivered level belongs to sstim:StimulusSpecification (ADR 0041)."@en ; rdfs:isDefinedBy . sstim:specifiedBy a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:StimulusSpecification ; rdfs:label "specified by"@en ; skos:definition "Links an engine configuration to the stimulus specification it realises."@en ; skos:scopeNote "Many presets may realise one specification; that is the point, and it is what makes cross-engine comparison possible. The link is asserted by whoever measured or derived it and is never inferred: what stimulus a preset produces depends on the engine, the transducer and the listening conditions, so entailing it would reintroduce exactly the engine-dependence this layer exists to escape."@en ; rdfs:isDefinedBy . sstim:masterBrightness a owl:DatatypeProperty, owl:FunctionalProperty ; rdfs:range xsd:decimal ; rdfs:label "master brightness"@en ; skos:definition "Normalized master visual output level, from 0 (dark) to 1 (implementation maximum); an engine control, not a calibrated luminance. The visual counterpart of sstim:masterVolume, whose absence was the audio-centrism ADR 0041 corrected. The delivered luminance is sstim:luminanceCdM2."@en ; rdfs:isDefinedBy . sstim:Track a owl:Class ; rdfs:subClassOf iao:0000030 ; rdfs:label "Track"@en ; skos:definition "A single layer within an engine configuration, carrying the parameters that specify what that layer contributes to the arrangement. A track is exactly one of audio, visual, haptic or control."@en ; skos:scopeNote "The generic superclass for audio, visual, haptic, and control layers. A configuration schema may define its own Track subclasses; the BSC framework's catalog voice, for example, specialises sstim:AudioTrack."@en ; skos:historyNote "Until 0.19.0 this note said the optional Patch Studio profile specialised sstim:Voice under sstim:AudioTrack, a subsumption ADR 0041 added after renaming the former Patch Studio control voices to LFO and Permutation. ADR 0061 moved the catalog voice to the BSC framework's vocabulary as bsc-v:Voice."@en ; rdfs:seeAlso ; rdfs:isDefinedBy . sstim:AudioTrack a owl:Class ; rdfs:subClassOf sstim:Track ; rdfs:label "Audio Track"@en ; skos:definition "A track whose output is audible: an isochronic tone, a binaural carrier pair, a plain carrier, noise, a drone, or a sample."@en ; rdfs:isDefinedBy . sstim:VisualTrack a owl:Class ; rdfs:subClassOf sstim:Track ; rdfs:label "Visual Track"@en ; skos:definition "A track whose output is visible. Rate-bearing visual tracks are subject to the runtime flash-rate safety limits recorded in the exposure module."@en ; rdfs:seeAlso ; rdfs:isDefinedBy . sstim:HapticTrack a owl:Class ; rdfs:subClassOf sstim:Track ; rdfs:label "Haptic Track"@en ; skos:definition "A track whose output is delivered as vibration through a device actuator."@en ; rdfs:isDefinedBy . sstim:ControlTrack a owl:Class ; rdfs:subClassOf sstim:Track ; rdfs:label "Control Track"@en ; skos:definition "A track that produces no sensory output of its own and instead supplies a time-varying control signal modulating parameters of other tracks, such as a breathing-guidance oscillation."@en ; skos:historyNote "Until 0.19.0 the definition named the BSC catalog's Martigli breathing guidance and its symmetry-derived signals as the current kinds of control track; ADR 0061 removed the dependence."@en ; skos:editorialNote "The modulation this definition describes is prose the graph cannot state: no property links a control track to the track and parameter it modulates. Two consequences follow. A configuration cannot be read to discover what drives what, and the control signal is not separable from the preset that contains it, so no shared signal object exists for two channels or two studies to be compared by. This is the abstract-signal half of SSTIM_DIRECTIONS.md §5: a time-varying function with a period or envelope and no modality, which a rendering then binds to a renderable parameter of some sensory channel. Carrier and modulator describe one audio rendering of such a signal, not the general structure — a carrier is needed because 10 Hz falls below the audible range, while a 10 Hz light flicker or vibration is presented directly."@en ; rdfs:seeAlso , ; rdfs:isDefinedBy . sstim:composedOfTrack a owl:ObjectProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:Track ; rdfs:label "composed of track"@en ; skos:definition "Links an engine configuration to the layers it is composed of, whatever schema the configuration follows."@en ; skos:historyNote "Until 0.19.0 a parallel property, sstim:composedOf, linked a BSC catalog preset to its voices. ADR 0061 deprecated it in favour of this one: a catalog voice is a track, so one composition link serves every schema."@en ; rdfs:isDefinedBy . sstim:breathGuideTrack a owl:ObjectProperty, owl:FunctionalProperty ; rdfs:domain sstim:Preset ; rdfs:range sstim:Track ; rdfs:label "breath guide track"@en ; skos:definition "The track whose oscillation paces the participant's breathing, when the configuration guides breathing at all. At most one, and it must be one of the configuration's own tracks."@en ; skos:scopeNote "A single pointer cannot contradict itself. It replaces a pair of fields that could: a preset-level flag saying breathing is guided, and a flag on each layer saying which one guides it. Absence means the configuration does not guide breathing."@en ; skos:historyNote "Added in 0.19.0 by ADR 0061, replacing sstim:hasBreathGuide and sstim:isBreathReference. It matches the breathReference field of SSTIM's preset schema."@en ; rdfs:isDefinedBy . [] a owl:AllDisjointClasses ; owl:members ( sstim:AudioTrack sstim:VisualTrack sstim:HapticTrack sstim:ControlTrack ) . ########################################################################### # End of configuration ###########################################################################