Dorota Overview:
Filter:
Guides (extension) | Libraries > Dorota

Dorota Overview
ExtensionExtension

how the Dorota quark fits together

What it is

Dorota is an editor for ATS spectral data. Audio goes in, partial trajectories come out, you edit those trajectories on a canvas, and the edited result is resynthesised.

The analysis is a SuperCollider implementation of the ATS pipeline (the "z354" engine), not a wrapper around the ATSA command-line tools. That means analysis settings can be changed and results inspected without leaving sclang.

The pipeline

ATSPeakDetector
Finds spectral peaks per frame, with parabolic interpolation for sub-bin frequency and amplitude.
ATSPeakTracker
Links peaks across frames into partials by frequency-deviation matching.
ATSAnalyzer
Drives the above and produces a Z354Sound.
ATSResidual
Subtracts the deterministic resynthesis from the original to isolate the stochastic part, reported in 25 Bark bands.
ATSWriter
Writes the result as a binary .ats file.
ATSSynth
Resynthesises a Z354Sound additively.

Two layers

The quark has a compiled layer and a runtime layer.

classes/ is compiled by sclang at startup like any class library. It holds the analysis engine and Dorota, the entry point.

Core/ is loaded at runtime by Dorota: *load, into Environment: *topEnvironment. These files define interpreter globals — ~startATSSpearEditorV541 is the GUI, ~playF2ALoop the playback wiring, ~analyzeAudioToTracksV541 the analysis entry. They are not classes and are not compiled.

That split is deliberate. The GUI is several thousand lines of drawing and event code written against interpreter globals; converting it to classes wholesale would risk the one thing that currently works. Dorota is the seam: user-facing code talks to the class, and the globals behind it can be replaced piece by piece without breaking anyone's code.

Getting started

See Dorota for loading without the GUI, server requirements, and path resolution.