{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.distortion-phenomenon","code":"thing-distortion-phenomenon","url":"https://ver.cy/models/thing/distortion-phenomenon/","name":"distortion","alternateNames":["nonlinear distortion","amplitude distortion"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"noun.phenomenon","plane":"PHY","domain":["PHY.FLW"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"energy","origin":"natural","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"An unwanted change in the waveform of an acoustic or analogue electrical signal, such as harmonic distortion, intermodulation distortion and clipping, measured for example as total harmonic distortion; distortion is also used deliberately as an effect in music, and optical and cognitive distortion are different senses.","purpose":"Let an agent explain signal distortion by type, measurement, causes and remedies, and separate deliberate effects and other senses.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Change in waveform shape","Often nonlinear","Measured as percentage or dB","Sometimes intentional"],"structure":{"bundles":[{"id":"type","name":"Type","description":"Which distortion.","layers":[{"id":"identify","name":"Identify","description":"Kind.","findings":[{"id":"identify-finding","name":"Identify","description":"Distortion type.","questions":[{"text":"Is this harmonic, intermodulation or clipping distortion?","kind":"definition"},{"text":"How can it be told by ear or on a scope?","kind":"definition"}]}]},{"id":"cause","name":"Cause","description":"Sources.","findings":[{"id":"cause-finding","name":"Cause","description":"Causes.","questions":[{"text":"What is causing the distortion, such as overdriven stages or damaged speakers?","kind":"definition"},{"text":"Where in the chain does it start?","kind":"action"}]}]}]},{"id":"measure","name":"Measure","description":"Metrics.","layers":[{"id":"thd","name":"THD","description":"Total harmonic distortion.","findings":[{"id":"thd-finding","name":"THD","description":"THD.","questions":[{"text":"What is the THD at a stated level and frequency?","kind":"measurement"},{"text":"Which standard method was used?","kind":"provenance"}]}]},{"id":"specs","name":"Specs","description":"Specifications.","findings":[{"id":"specs-finding","name":"Specs","description":"Specifications.","questions":[{"text":"Are the published distortion figures comparable between products?","kind":"boundary"},{"text":"Under what conditions were they measured?","kind":"provenance"}]}]}]},{"id":"remedy","name":"Remedy","description":"Fixing it.","layers":[{"id":"gain","name":"Gain","description":"Gain staging.","findings":[{"id":"gain-finding","name":"Gain","description":"Gain staging.","questions":[{"text":"How can gain staging prevent clipping?","kind":"action"},{"text":"What headroom is advisable?","kind":"measurement"}]}]},{"id":"safety","name":"Safety","description":"Hearing and equipment.","findings":[{"id":"safety-finding","name":"Safety","description":"Safety.","questions":[{"text":"Is loud distorted playback risking hearing or speaker damage?","kind":"boundary"},{"text":"What should be turned down first?","kind":"action"}]}]}]},{"id":"senses","name":"Senses","description":"Disambiguation.","layers":[{"id":"music","name":"Music","description":"Effects.","findings":[{"id":"music-finding","name":"Music","description":"Deliberate distortion.","questions":[{"text":"Is a deliberate distortion effect for guitar or music production meant?","kind":"boundary"},{"text":"Which entry fits?","kind":"action"}]}]},{"id":"other","name":"Other","description":"Optical and cognitive.","findings":[{"id":"other-finding","name":"Other","description":"Other senses.","questions":[{"text":"Is optical lens distortion, a cognitive distortion or distortion of facts meant?","kind":"boundary"},{"text":"Which entry fits?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Measure and report signal distortion with the method and figures used.","Adjust levels on audio or signal equipment it is authorized to operate to reduce distortion."],"mustNot":["Play sound at levels that risk hearing damage to listeners or workers.","Misstate distortion figures in product specifications or test reports.","Alter recordings used as evidence by adding or removing distortion.","Disable limiters that protect speakers, equipment or listeners."],"requiresHuman":["Modifying recordings used in legal or official proceedings."]},"ethics":{"considerations":["Loud distorted sound damages hearing, often permanently.","Honest specifications let buyers compare equipment fairly."],"affectedParties":["Listeners","Sound engineers and performers","Buyers of equipment"]},"owners":{"steward":"Nobody owns the phenomenon; the operator of the equipment answers for its output.","roles":[],"masterSystems":[]},"relations":[{"target":"oewn-11469339-n","type":"parent","note":"registry parent class"},{"target":"oewn-11445515-n","type":"parent","note":"registry parent class"},{"target":"signal degradation","type":"related","note":"category"},{"target":"total harmonic distortion","type":"related","note":"metric"},{"target":"sound","type":"related","note":"signal"},{"target":"noise","type":"related","note":"related impairment"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.distortion-phenomenon","Open English WordNet: oewn-11532198-n"]},"properties":{"applicability":"required","items":["Total harmonic distortion:  % - Calculated from the root-sum-square amplitude of measured harmonics relative to the fundamental amplitude over a stated bandwidth.","Intermodulation distortion:  % - Measured from unwanted mixing products relative to a reference signal using specified input tones and a stated measurement convention.","Clipped sample fraction:  % - Measured as the proportion of sampled waveform values meeting a defined clipping criterion over a stated observation interval."]},"recognition":{"applicability":"required","items":["Clipped or deformed waveforms","THD figures on specifications","Noise is added random signal, not waveform deformation","Not visible directly; heard as harshness or buzz and seen as deformed waveforms on oscilloscopes."]},"capabilities":{"applicability":"required","items":["identify the type of distortion","measure distortion such as THD","find causes such as clipping or poor components","separate deliberate distortion effects and other senses"]},"hazards":{"applicability":"required","items":["Speaker damage from clipped signals","Hearing damage at high volumes","Misleading specification figures"]},"interfaces":{"applicability":"required","items":["IEC 60268 sound system equipment","AES measurement standards"]},"context":{"applicability":"required","items":["Audio engineering, electronics and signal quality.","harmonic distortion","intermodulation distortion","clipping","phase and frequency distortion","deliberate guitar distortion"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-11532198-n","url":"https://en-word.net/id/oewn-11532198-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: distortion","url":"https://en.wiktionary.org/wiki/distortion","note":"word senses and usage"}],"openQuestions":["Should distortion types be separate entries?","How should measurement standards be linked?","How should optical and cognitive senses be split off?"],"resources":{"spec":"/models/things/publications/thing-distortion-phenomenon/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-distortion-phenomenon/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T13:03:37Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:27+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass"},"score":1.0}}