Aether Research Institute · EMWave · Geometry Discovery Observatory · v1.4.6

EMWave Technical Manual Geometry Discovery Observatory

ModelPlane Wave
PanelsScope / Field / Research Dock
AudienceLab / Engineering
BACK
Instrument documentation

Modular signal, field, phasor and resonance analysis laboratory

EMWave is a browser-based modular laboratory workstation for inspecting coherent sine-wave systems. It combines a multi-channel signal generator, time-domain oscilloscope, normalized 3D electromagnetic field engine, polarization selector, Poynting-vector flow visualization, Spectrum Laboratory, Vector Phasor Laboratory, Lissajous state-space laboratory, advanced measurement engine, guided experiment library, optional measurement worker, diagnostics layer and audio monitor into one synchronized engineering instrument.

The current architecture separates calculation, rendering, orchestration, diagnostics, UI interaction and audio processing into dedicated modules. The tool is intended for technicians, engineers, lab users, educators and researchers who want to study how frequency, phase, amplitude and harmonic relationships modify a resulting composite field while preserving reproducible operating states.

Current system layout · v1.4.6

The online release is organized as a docked source workflow. The left Source Dock owns configuration and transport; the persistent header owns operation; the central observatory owns the plots. The lower Research Dock provides full-width space for map-based and atlas-based work.

  • Compact laboratories: Spectrum, Vector Phasor, Lissajous Measurement, Geometry Fingerprint and Symbol Observatory.
  • Research Dock laboratories: Resonance Landscape, Experiment Constellation, Discovery Laboratory and Atlas Observatory.
  • Observatory layer: rankings, outliers, rare families, emerging families, region intelligence, statistics and genealogy.
  • Source layer: Manual CH1–CH6, Live Audio, Microphone, File Playback and Hybrid routing into the same laboratories.
  • Runtime layer: persistent workers, scheduler queue, cancellation, cache system, diagnostics and responsive dock controls.

1. Purpose of the observatory

The instrument is designed to make wave superposition, state-space geometry and atlas growth visible and measurable. A signal source can be the manual CH1–CH6 generator, browser/tab audio, a local audio file or a hybrid mix. The active source stream is transformed into geometry, measured as fingerprints, and classified inside the Discovery and Atlas workflow.

  • Signal synthesis: define controlled sine components by frequency, phase and amplitude.
  • Signal-source routing: switch between Manual, Live Audio, Microphone, File Playback and Hybrid without changing the laboratories.
  • Time-domain inspection: observe the resulting waveform and channel contributions.
  • Spatial field interpretation: inspect a normalized plane-wave field model in 3D.
  • Spectrum laboratory: identify dominant components, beat spacing and frequency ratios.
  • Vector Phasor Laboratory: inspect active channel phasors, resultant magnitude and cancellation behavior.
  • Geometry laboratories: visualize Lissajous, topology, resonance landscapes, constellations, fingerprints and atlas regions derived from the active signal model.
  • Measurement inspection: evaluate RMS, Vpp, THD, crest factor, form factor, phase relations and signal classification.
  • Worker foundation: prepare measurement frames off the UI thread where supported, with safe fallback behavior.
  • Diagnostics: verify module availability, DOM wiring, renderer health and regression-sensitive browser behavior.
  • Auditory monitoring: listen to the generator/audio source path with speaker-safe output scaling.
Operator note: Use the laboratories as synchronized views of the same active source. Manual channels, live audio, microphone, file playback, hybrid routing and Symbol Observatory all feed the same Scope, 3D, Spectrum, Phasor, Lissajous, Discovery and Atlas workflows.

2. Channel setup

The channel selector defines how many sources are active. The instrument supports one to six active channels. Inactive channels are forced to zero contribution and are removed from the scope, audio model, 3D field model and the compact laboratory column, including Spectrum, Phasor, Lissajous and Fingerprint laboratories. Large map-based laboratories open in the full-width Research Dock.

  • 1 CH: single-tone reference mode.
  • 2 CH: interference, phase and beat experiments.
  • 3 CH: useful for three-phase and 120° phase studies.
  • 4–6 CH: harmonic stacks, complex modulation and multi-source comparison.

3. Frequency control

Frequency can be adjusted with the slider or entered directly as a numeric value. The valid range is 1 Hz to 20 kHz per channel. The upper range was selected so the synthesized waveform can still be used for audio monitoring on normal computer audio hardware.

  • Slider: fast exploratory adjustment.
  • Numeric field: exact entry for known frequencies.
  • Shared URL state: frequency values are stored in the browser URL for reproducible setups.

4. Phase control

Phase defines the angular offset of each channel relative to its own sine reference. Phase is expressed in degrees from 0° to 360° and is internally converted to radians for calculation.

  • 0°: reference alignment.
  • 90°: quadrature relationship.
  • 120° / 240°: typical three-phase separation.
  • 180°: inverted component relative to a same-frequency reference.

5. Amplitude control

Amplitude is controlled with a precision stepper instead of a small slider. This gives stable handling when small changes matter. The control supports 0.001 resolution and a range from 0.000 to 5.000.

  • − / + buttons: coarse interactive adjustment.
  • Numeric entry: direct precision value entry.
  • 0.000: effectively removes the channel contribution while keeping the channel visible.

6. Digital Scope Laboratory · time domain

The digital scope displays all active channels and the summed result Σ. It is the primary laboratory for waveform shape, phase interaction, constructive interference, destructive interference and beat patterns.

ReadoutMeaningInterpretation
VppPeak-to-peak valueMaximum minus minimum of the visible composite waveform.
RMSRoot-mean-square valueEffective magnitude of the visible waveform window.
FreqZero-crossing frequency estimateEstimated from average zero-crossing intervals of Σ.
PeriodEstimated periodCalculated from the detected frequency when valid.
Zero-XZero-crossing countNumber of sign transitions in the displayed time span.
SamplesEvaluated data pointsAdaptive sample density used for the visible scope waveform.

7. Time span and animation

The span control sets the visible time window of the digital scope. It also influences the 3D propagation window so the spatial field view stays coupled to the same base timing concept.

  • Short span: detailed inspection of fast oscillation and phase relation.
  • Long span: beat patterns, modulation envelopes and low-frequency structure.
  • RUN: starts 3D field evolution.
  • Speed: controls the animation phase increment, not the physical frequency itself.

8. 3D field engine

The 3D Field Laboratory presents a normalized plane-wave model. The propagation axis is displayed in base-wavelength units so the geometry remains readable even when the physical wavelength is extremely large at low frequency.

  • E-field: synthesized electric-field trace.
  • B-field · c: magnetic component scaled by c for comparable visual magnitude.
  • Propagation axis: normalized spatial axis, displayed in λ₀ units.
  • Camera: orbit, zoom and inspect the field without changing the signal model.

9. Polarization modes

The polarization control modifies the transverse field geometry used by the 3D engine. It is intended for visual and conceptual comparison of linear, circular and elliptical field motion.

  • Linear: one dominant transverse electric-field axis.
  • Circular: equal quadrature component, producing rotating field geometry.
  • Elliptic: reduced quadrature component, producing elliptical field motion.
  • Orbital: replaces the conventional transverse field presentation with a signal-derived state-space trajectory based on E(t), quadrature state and normalized dE/dt.

10. Poynting-vector flow

The S-control enables a sparse energy-flow layer. The particles are not charge carriers. They are visual indicators for directional energy transport according to the field relationship S = E × B.

  • S ON: shows directional energy-flow indicators.
  • S OFF: removes the flow markers for a cleaner field-only laboratory.
  • Purpose: helps connect field geometry with propagation direction.

11. Spectrum Laboratory

The Spectrum Laboratory shows analytic bins derived directly from the configured sine components. It is not a noisy sampled FFT display. When multiple active channels share the same frequency, their amplitudes are vector-summed using phase information before display.

OutputMeaningUse case
DominantLargest frequency bin by amplitudeQuickly identifies the strongest configured spectral component.
BeatSmallest spacing between active frequency binsUseful for two-tone experiments and slow envelope behavior.
RatioApproximate frequency relationshipUseful for harmonic stacks and integer-ratio tuning.

12. Vector Phasor Laboratory

The Vector Phasor Laboratory displays each active channel as a rotating vector. The vector angle is calculated from θ = 2πft + φ, using the configured frequency, phase and amplitude of the channel. Same-frequency channels produce a conventional static phasor relationship when RUN is stopped; different-frequency channels rotate at their own angular rates during RUN mode.

ReadoutMeaningInterpretation
ResultantVector sum magnitude ΣLarge values indicate constructive vector addition; small values indicate cancellation.
PhaseAngle of the resultant vectorExpressed relative to the laboratory real-axis reference.
CancelCancellation index0% means little cancellation; values approaching 100% indicate strong vector cancellation.
A balanced three-phase setup with equal amplitudes and 0° / 120° / 240° phase spacing should pull the resultant vector close to the center. Non-harmonic systems show continuously evolving vector relationships during RUN mode.

13. Orbital / Lissajous Polarization Laboratory

The Lissajous laboratory is a dedicated analytical laboratory for signal-state geometry. It plots X = E(t) against a quadrature state derived from the same active channel configuration. The trace therefore originates from the real signal model rather than from decorative particles or arbitrary animation.

ReadoutMeaningInterpretation
Density / AgeAccumulated hit density plus age-colored phosphor trailStable regions become brighter while older path samples fade through color and the newest state appears warm and bright.
TopologyCrossing and loop structureDetects visible self-intersections, estimates loop count and classifies the curve as Simple, Looped, Multi-loop, Braided or Dense weave.
WindingNet rotation around the centroidReports whether the trajectory wraps around its center and how strongly the orbit circulates.
StateClosure and frequency-ratio classificationClassifies the orbit as Closed, Quasi-Closed or Open and keeps the recognized ratio visible for harmonic comparison.
SignatureCompact topological fingerprintCombines ratio, topology class, crossing count, winding number and eccentricity into a repeatable lab-style descriptor.
LandscapePhase / frequency-ratio mapScans CH2/CH1 frequency ratio against relative phase and colors each point by normalized occupied Lissajous area, with closure contours overlaid.

Integer frequency ratios such as 1:1, 2:1, 3:2, 4:3 or 5:4 form closed or slowly repeating figures. Non-harmonic ratios evolve without exact closure. The trace now uses an age-colored phosphor layer: older samples remain dimmer, newer samples become brighter, and the live marker reports the instantaneous X/Y state. The topology layer marks detected crossings and reports loops, winding, symmetry, eccentricity and path length so experimental setups can be compared as geometric structures, not only as waveforms. The Resonance Landscape view extends this idea by scanning a phase / frequency-ratio field and revealing where stable, high-area Lissajous geometries form ridges, islands and valleys.

14. Resonance Landscape Explorer

The Resonance Landscape is a geometric parameter-space map. Instead of showing only the current Lissajous figure, it scans a controlled region of CH2/CH1 frequency ratio and relative phase. Each point in the map represents a synthesized Lissajous state generated from the same signal engine.

Map elementMeaningInterpretation
X axisFrequency ratio CH2 / CH1Shows where ratios such as 1:1, 5:4, 4:3, 3:2 or 2:1 live in the scanned space.
Y axisRelative phaseShows how the same ratio changes geometry as phase rotates from 0° to 360°.
Metric selectorArea, closure, crossings, loops, winding, complexity, symmetry or closure errorChanges what the landscape color represents while keeping the same ratio-versus-phase scan.
ContoursClosure structureWhite contour lines indicate where the Lissajous figure tends toward periodic closure.
LIVECurrent operating pointMarks the ratio and phase currently configured by the channel controls.
PEAK / RAREStrongest area or rare topology region found in the scanIdentifies either the occupied-area maximum or the selected topology/complexity target.
The Resonance Landscape Laboratory turns a single experiment into a map of nearby experiments. It is useful for finding high-area resonant geometry, stable closure islands, quasi-periodic regions, symmetry islands and phase-sensitive topology changes.

15. Geometry Fingerprint Laboratory

The Geometry Fingerprint Laboratory gives the current signal-derived structure a compact measurable identity. Fingerprints encode closure, symmetry, crossings, winding, area and complexity so discoveries can be compared, ranked and classified automatically. It combines area, closure, crossings, loop estimate, winding number, symmetry and a combined complexity score into a short fingerprint ID.

  • Fingerprint ID: stable hash-like label generated from the current geometry metrics.
  • Area / Closure: compact measures of occupied orbit size and periodic return quality.
  • Cross / Loops / Wind: topology indicators used for comparing geometric families.
  • Sym / Complex: symmetry average and combined structural complexity score.
The fingerprint is intended as a reproducible identity marker for laboratory notes, experiment comparison and constellation-map, atlas-navigation and future automatic-discovery workflows.

16. Experiment Constellation Laboratory

The Constellation Laboratory maps experiments as points in normalized geometry space. Each point is derived from area, closure, crossings, loops, winding number, symmetry and complexity, so the view compares relationships between experiments rather than only displaying one waveform.

  • Atlas regions: labels such as Reference Basin, Closure Ridge, Harmonic Flower Field, Winding Island, Symmetry Plateau, Open Drift Sea and Topological Outlier summarize the active geometry neighborhood.
  • Nearest neighbors: the LIVE point is connected to the closest known experiments by normalized Euclidean distance.
  • Interactive loading: clicking a constellation point loads that experiment through the same control and URL-state path as the Experiment Library. Ctrl-click / Cmd-click copies a direct share URL for that experiment.
  • Purpose: helps locate families, unusual cases and nearby experiments for guided exploration.

16. 3D Orbital POL mode vs. Lissajous analysis

Orbital POL mode changes the 3D Field Laboratory into a spatial state-space representation using E(t), quadrature B-state and normalized dE/dt. The Lissajous Laboratory is a compact 2D laboratory plot focused on measurable trajectory width, height, area, closure and rotation behavior.

  • Orbital POL: 3D state-space field presentation in the main field window.
  • Lissajous Laboratory: 2D oscilloscope-style persistence display for analytical comparison.
  • Resonance Landscape Laboratory: ratio-versus-phase map showing selectable area, closure, topology, symmetry and complexity metrics.
  • Both: derived from the active channel frequencies, phases and amplitudes.

17. Audio monitor and source layer

The instrument now separates the signal source from the laboratories. Manual CH1–CH6 generation, Live Audio, Microphone, File Playback and Hybrid mode all feed the same Scope, Spectrum, Lissajous, 3D POL, Discovery and Atlas paths. The Audio Monitor controls speaker-safe playback/monitoring, while the Source Dock controls what signal enters the laboratories.

  • Manual: original CH1–CH6 sine generator path; this remains the reference workflow.
  • Live Audio: browser-tab capture through the visible Capture Tab Audio action; no transport row is shown because the browser stream is controlled by the capture session.
  • Microphone: live microphone input through the visible Arm Mic action; no file transport is shown because the signal is live.
  • File Playback: local WAV / MP3 / FLAC import with a dedicated File Transport module: Import Audio File, Play, Pause, Stop, Loop, elapsed time and file status.
  • Hybrid: manual CH1–CH6 plus tab/file audio as an additional mix layer, with Capture Tab Audio, Import File Audio, Play, Pause, Stop and Loop controls.
  • Quality: Eco / Normal / High control render load; Freeze intentionally holds the current audio/specimen frame for inspection and will stop live visual motion until another quality mode is selected.
Use low monitor levels first, especially with headphones or lab amplifiers. Browser tab capture and microphone/file access remain user-controlled browser actions.

18. Docking Observatory UI

v1.2.6 moved the growing source and transport controls from a horizontal cockpit into a vertical Source Dock. The dock is for configuration; the persistent header controls are for operation. This keeps RUN / STOP, AUDIO ON / OFF, FOCUS / EDIT, EXP, DIAG and PERF visible even when the plots are maximized.

  • Edit mode: Source Dock visible for setup, transport, time span, audio level and channel tuning.
  • Focus mode: Source Dock hidden; Scope receives most additional width while 3D remains proportioned as a state-space/quadrature view.
  • Header operation: RUN / STOP and AUDIO ON / OFF remain accessible in all major layouts.
  • Large labs: Discovery, Atlas, Heatmap, Fingerprint and Comparison remain compatible with the docked layout.

19. Source workflow

File and audio workflows are source preparations, not destructive changes to the laboratories. Switching source modes should not erase the manual generator configuration, and a loaded file remains available until a new file is chosen or the page is reloaded.

  • Live Audio: use Capture Tab Audio, then choose a browser tab and enable tab-audio sharing when the browser asks.
  • Microphone: use Arm Mic and grant microphone permission; the live stream enters the same analysis laboratories.
  • File Playback: use Import Audio File, then control the local WAV / MP3 / FLAC source with Play / Pause / Stop / Loop.
  • Hybrid + File: import a file and mix it with CH1–CH6 using the Hybrid Mix slider.
  • Hybrid + Tab: capture tab audio and mix it with CH1–CH6.
  • Freeze: captures a static audio/specimen moment for slower high-detail inspection. It is not a playback fault if animation stops in this mode.

20. Shareable setups

The instrument writes operating parameters into the URL. This allows exact setups to be shared, archived or reloaded later without a separate project file.

  • Stored: channels, frequency, phase, amplitude, time span, audio level, polarization, S-state and selected laboratory mode.
  • Useful for: reports, documentation, teaching examples and lab notebooks.
  • Note: changing controls updates the URL automatically.

21. Showpiece Experiment Library

The Showpiece Experiment Library now acts as a guided laboratory layer, not only as a preset loader. Each entry loads a complete operating state: active channel count, frequency, phase, amplitude, time span, polarization mode and laboratory mode. The cards also describe purpose, observation targets, difficulty, demonstration value and expected laboratory response.

  • Purpose: accelerate training, demonstrations and laboratory discussion without random presets.
  • Reproducibility: loading an experiment updates the same URL state as manual operation, including source mode and audio quality where the preset defines them, so the resulting setup can be shared or archived.
  • Analytical coupling: experiments are selected to show clear relationships across the scope, Spectrum Laboratory, Vector Phasor Laboratory, Topological Lissajous Laboratory, Resonance Landscape, Discovery Engine and 3D field view.
  • Favorites: the star control stores preferred experiments locally in the browser using localStorage.
  • Filters: category buttons reduce the list to fundamentals, three-phase, Lissajous, resonance landscape, special ratios, harmonics, orbital, engineering, showpieces or favorites.
  • Expected response: every card indicates which laboratory should show the most important behavior before the experiment is loaded.
Recommended entryPrimary relationshipUseful observation
Single Tone ReferenceOne active sourceBaseline waveform, single spectrum bin and one clean phasor.
Live Audio Orbit PrepBrowser-tab audio sourcePrepares capture routing for AUDIO L/R scope traces and audio-driven orbital geometry.
Microphone Input PrepLive microphone sourcePrepares permission-based microphone capture for real-time Scope, Spectrum and Lissajous inspection.
File Playback ObservatoryExternal audio file sourcePrepares import, transport and routing for audio-derived Scope, Spectrum and 3D geometry.
Hybrid Audio + CH MixManual generator plus audio layerTests CH1–CH6 stability while tab/file audio is mixed into the same laboratories.
Balanced 3-Phase0° / 120° / 240° phase systemSymmetric vectors, rotating space-vector behavior and near-zero resultant.
Circular PolarizationEqual quadrature componentsRotating transverse field and circular state-space behavior.
Beat FrequencyClosely spaced tonesEnvelope modulation, phasor drift and spectral spacing.
Harmonic FlowerInteger frequency ratiosClosed orbital structures generated only from active signal data.
Harmonic Geometry 4:3Ratio / phase landscapePlaces the live experiment in the resonance landscape and reveals closure contours.
Fibonacci 89:144Fibonacci / golden-family ratioLoads Discovery mode with a long-cycle rational approximation near the golden-ratio family.
Prime Pair 97:101Close prime ratioShows long-period geometry and slow beat-like evolution useful for novelty scans.
Topology ExplorerLoop and crossing behaviorShows crossing markers, loop estimates, winding number and geometric fingerprint.
Vector CancellationAnti-phase equal-frequency sourcesSmall resultant vector despite large individual channel vectors.
The library does not inject decorative geometry. All observed structures are generated from the active sine components and their configured phase, amplitude and frequency relationships. For first-time demonstrations, start with Balanced 3-Phase, Circular Polarization, Beat Frequency, Harmonic Flower and Harmonic Geometry 4:3 because these setups activate meaningful behavior across all major laboratories. Use Special Ratio Geometry when exploring Fibonacci, Lucas, prime, detuned and irrational-approximation families with the Discovery engine. Use the filter buttons when teaching a specific topic or preparing a short presentation sequence.

22. Special Ratio Geometry experiments

The Special Ratio Geometry EXP group contains reproducible two-channel experiments based on Fibonacci pairs, Lucas-related pairs, prime pairs, deliberate detuning and rational approximations of irrational constants such as √2, √3 and the golden ratio. These presets load directly into Discovery mode with orbital polarization so local geometry-space variants can be scanned immediately.

Discovery candidates support the full workflow: select a marker, use Load Discovery to apply its frequency, phase and amplitude values to the live instrument, then use Save Discovery when the candidate should become a persistent atlas / EXP entry.

  • Important accuracy note: browser controls use finite numeric frequencies, so golden-ratio and square-root examples are rational approximations, not mathematically exact irrational ratios.
  • Fibonacci / Lucas pairs: useful for long-cycle periodic figures that approach golden-family behavior while remaining exactly reproducible.
  • Prime pairs: useful for long repeat lengths, slow beat-like structure and dense state-space fingerprints.
  • Detuned harmonic cases: useful for comparing a known ratio island, such as 4:3, against a nearby drifting variant.
These experiments do not claim special physical resonance by themselves. They are numerical geometry probes for the instrument's Lissajous metrics, fingerprint system, constellation map and Discovery engine.

23. Technical assumptions and model boundary

The instrument uses a normalized analytical plane-wave representation. It is not a full electromagnetic field solver and does not model antenna geometry, boundary conditions, conductive losses, material permeability, dielectric dispersion, near-field coupling or calibrated RF power density.

  • Good for: coherent wave relationships, phase studies, harmonic structure, polarization concepts and teaching demonstrations.
  • Not intended for: certified RF exposure analysis, antenna design sign-off, EMC compliance, finite-element simulation or calibrated power measurement.
  • Laboratory rule: validate absolute voltage, current, phase, field strength and power with calibrated measurement equipment.
Treat this instrument as an analytical companion to real measurements. It is excellent for understanding relationships, but real hardware behavior still depends on probes, grounding, bandwidth, parasitics, coupling paths, sensor response and instrument calibration.

22. Example experiments

ExperimentSuggested setupWhat to observe
Single tone reference1 CH, 60 Hz, 0°, A = 1.000Clean sine wave, single spectral bin and stable 3D field geometry.
Phase cancellation2 CH, same frequency, phases 0° and 180°Amplitude reduction or cancellation depending on equal amplitudes.
Beat frequency2 CH, 440 Hz and 444 HzSlow envelope in time domain and 4 Hz spacing in the spectrum readout.
Three-phase system3 CH, 50 Hz, phases 0° / 120° / 240°Symmetric phase structure, near-zero phasor resultant and cancellation behavior.
Harmonic stack3–6 CH, integer multiples of F0Composite waveform shape, base-frequency readout and ratio display.
Circular polarizationUse polarization selector: CircularRotating transverse field geometry in the 3D Field Laboratory.

23. Signal Measurement Laboratory

The Signal Measurement Laboratory adds compact electrical readouts for the summed waveform Σ. The values are calculated from the same sampled scope signal and analytic spectrum bins used by the instrument, so the panel remains synchronized with the visible time-domain and frequency-domain laboratories.

ReadoutMeaningUse case
CrestPeak absolute value divided by RMSDetects peaky or impulse-like composite waveform behavior.
FormRMS divided by average rectified valueShows how close the waveform is to an ideal sine reference.
Avg RectMean of absolute Σ valueUseful for rectifier and envelope interpretation.
MeanArithmetic average of Σ over the visible scope windowIndicates DC offset or incomplete-cycle bias in the selected span.
THDHarmonic-bin estimate relative to the lowest active binUseful for harmonic stacks; non-harmonic components are not counted as harmonic distortion.
ClassSignal classificationIdentifies single tone, harmonic mix, non-harmonic mix or near cancellation.

The phase table reports each active channel relative to CH1. For channels with a different frequency, the displayed angle is an initial phase offset φ0 rather than a fixed phase relationship over time.

21. Measurement Worker Foundation

The instrument now includes an optional Web Worker layer for calculation-heavy measurement preparation. The worker can build timestamped measurement frames containing waveform summary, scope metrics, spectrum bins, phasor data, Lissajous metrics and advanced signal measurements without blocking the main UI thread.

  • Main thread: owns DOM interaction, Plotly rendering, WebGL scene updates, audio control and user events.
  • Worker thread: owns DOM-free measurement-frame preparation using the same core and measurement modules.
  • Worker bridge: initializes the worker, tracks status, exposes requestMeasurementFrame() and provides fallback-safe orchestration.
  • Status: the footer Worker readout and diagnostics panel show whether the worker is ready, active or in fallback mode.
This release introduces the worker architecture as a stable foundation. Existing plots continue to use the proven synchronous rendering path, while the worker is available for recorder frames, future replay/export features and later step-by-step migration of heavier analysis calculations.

22. Developer Observatory

The instrument includes a hidden developer observatory for release checks, diagnostics, profiling and CSS architecture review. These tools are disabled by default and are controlled by the small DEV checkbox in the footer. When DEV is enabled, the DIAG, PERF, PROFILE and CSS buttons appear in the header. When DEV is disabled, all developer panels close and the normal operator interface remains clean.

PanelQuestion answeredMain information shown
DIAGIs everything alive?Module availability, DOM wiring, Plotly health, URL state, worker state, audio state, experiment wiring and health checks.
PERFHow fast is the instrument right now?FPS, render timing, scope/field/analysis timing, Plotly timing, worker latency, queue depth and throughput indicators.
PROFILEWhere is the time going?Hotspot ranking, call counters, worst spikes, frame budget, worker timing, render-domain summary and runtime profiling controls.
CSSHow healthy is the stylesheet architecture?Rule counts, selector counts, ownership groups, matched/unmatched selectors, invalid selectors and important-declaration statistics.
The developer panel manager keeps DIAG, PERF, PROFILE and CSS mutually exclusive. Opening one closes the others, the active header button marks the visible panel, ESC closes the active panel and the footer DEV checkbox remains the master switch. These tools are intended for engineering verification and do not change measurement behavior.

23. PROFILE · runtime microscope

PROFILE extends the basic performance view with a deeper runtime microscope. It is designed to guide future optimization with measurements instead of guesswork.

  • Overview: ranks the most expensive operations, counts calls, shows worst spikes and reports frame-budget distribution.
  • Timeline: displays a rolling last-10-second activity history for Scope, Field, Plotly, Workers, Animation and DOM domains.
  • Baseline: stores a local performance reference and compares current runtime behavior against the saved baseline.
  • Worker profiler: reports worker latency, worker compute time and queue-related timing when worker tasks are active.
  • Export / copy: allows profile snapshots to be copied or exported for development notes and regression comparison.
PROFILE is not an optimizer by itself. It is an observation tool: it shows whether time is spent in calculation, Plotly rendering, animated restyle calls, DOM/readout updates, worker latency or resize paths, so future changes can be tested against a measurable baseline.

24. Built-in verification tools

The online instrument includes built-in verification paths for quick browser-side checks, diagnostics, performance inspection, profiling and stylesheet auditing. Development-only documents and standalone test pages are intentionally not shipped in the public package.

ToolAccessPurpose
Self-test modeOpen instrument with self-testRuns the browser self-test path for selector dispatch, URL state and renderer update checks.
Developer panelsEnable DEV in the footer, then choose DIAG / PERF / PROFILE / CSSOpens one developer panel at a time without stacking panels or disturbing the normal instrument layout.
DiagnosticsDIAGDisplays module, DOM, Plotly, URL, worker, audio, experiment and health-check status during development.
PerformancePERFDisplays timing data for scope, field, analysis, Plotly rendering, worker latency, queue depth and FPS.
ProfilerPROFILEDisplays hotspot ranking, timeline, frame budget, spike list, worker timing and baseline comparison.
CSS auditCSSDisplays stylesheet ownership, selector matching, invalid selectors and important-declaration statistics.
Normal users can operate the instrument without enabling DEV, diagnostics, performance mode, profiling or self-test mode. These tools are kept available because they make release testing and future optimization substantially safer.

25. Symbol Observatory

Symbol Observatory maps text and number systems into the existing signal engine. The v1.4.6 Number Wheel Observatory and Math Flow Explainer adds a node-and-transition view for digital-root, Rodin-cycle and modular arithmetic paths, so operators can see the actual number walk behind the generated frequencies. The Universal Symbol Alphabet supports Latin A-Z/a-z, digits 0-9, Greek Α-Ω/α-ω, mathematical signs, punctuation and an explicit space separator. Symbols can be written directly into CH1-CH6, compressed into one channel as a sentence signature, distributed as word channels, or reduced into a compact fingerprint so the normal Scope, 3D, Spectrum, Lissajous, Fingerprint and Atlas workflows can inspect the generated geometry.

  • Encoding methods: Linear Symbol Set, Prime, Fibonacci, Golden Ratio, Musical 12-TET, Pythagorean, Just-Ratio Symbol Set, Symbol Index Proportional, Binary Weight, Morse Weight, Digital Root, Rodin Cycle 1-2-4-8-7-5 (Index) and Modular Doubling 2ⁿ mod 9 (Text Order). These define how each symbol index becomes a frequency before folding into the 1 Hz–20 kHz instrument range.
  • Number geometry: Digital Root, Rodin Cycle and Modular Doubling are treated as neutral modular-arithmetic pattern generators. Rodin-cycle mode is symbol-index based; modular-doubling mode is text-order based. They are useful for symbolic topology, closure, winding and visual comparison, not as physical energy claims.
  • Base frequency: defines the seed carrier. Changing the base moves the whole symbolic structure while preserving the selected alphabet mathematics.
  • Targets: Symbols → Channels maps visible letters directly; Sentence → One Channel compresses a whole sentence into CH1; Words → Channels assigns up to six words to CH1–CH6; Sentence Fingerprint creates a compact multi-channel signature.
  • Advanced targets: Ratio Geometry Glyphs uses frequency ratios and phase offsets for Lissajous-style shape alphabets; Phase Symbol Set keeps frequency nearly fixed while phase carries the symbol; Amplitude Symbol Set emphasizes amplitude coding; Fourier DNA Channels distributes a sentence checksum and slot signatures over six harmonic channels.
  • Mapping modes: First Symbols maps direct symbols; Word Superposition chooses representative symbols; Sequential Prep reserves a safe UI path for later animated streams.
  • Channel output: APPLY SYMBOL MAP sets channel count, channel frequencies, phase angles and amplitudes. CLOSE returns the laboratory panel to Spectrum so Symbol Observatory does not occupy the work area when not needed.
  • Publishable DNA: EXPORT WAV renders the active Symbol DNA texture into a mono 44.1 kHz WAV file for external testing, documentation or publishing. SAVE DNA stores a reproducible JSON profile with the text, encoding, base, target, mode, mapping and audio texture.
  • DNA Library: saved profiles can be loaded later, renamed, duplicated, deleted after confirmation, exported as a full JSON library or imported again. The selected entry displays its text, encoding, target, mode, base frequency, creation date and audio-DNA summary.
  • Clear behavior: CLEAR SYMBOL DNA disengages the special symbol texture so normal channel/audio operation is restored without closing the Observatory.

26. Version history

This manual is written for operation, not as a development diary. Detailed revision notes are kept outside the Help page so the documentation stays light, readable and timeless.

GenerationMain additionOperator value
v1.0Core ObservatoryMulti-channel signal generation, scope, 3D field view and foundational laboratories.
v1.1Atlas IntelligenceSaved discoveries, regions, statistics, genealogy and map-based exploration.
v1.2Research DockDiscovery comparison, replay, heavy laboratory layouts and stronger diagnostics.
v1.3Symbol ObservatoryText-to-signal mapping, symbol geometry, DNA profiles and publishable symbolic structures.
v1.4Source workflowsManual, Live Audio, Microphone, File Playback and Hybrid workflows with production CSS architecture.
v1.4.5Developer Panel ManagerDEV checkbox integration, mutually exclusive DIAG / PERF / PROFILE / CSS panels and consistent developer overlay styling.
v1.4.6Runtime Timeline + BaselinePROFILE Overview, Timeline and Baseline views for hotspot ranking, regression detection and exportable runtime snapshots.
For development-level details, keep a separate changelog or archive file with the project sources. Normal operators only need the current behavior and the generation-level overview above.