EEV v1

Formatstruktur

Diese Seite ordnet die Spezifikation in einer Form neu, die sich in der Implementierung leichter nutzen lässt. Sie ersetzt die mitgelieferten Markdown-Dateien nicht, hilft aber dabei, Formatvertrag, Transportvarianten und die beschreibende Tiefe jeder Qualitätsstufe sauber zu trennen.

Vertrag Blöcke Container Transport Qualität

Der minimale Vertrag

Die Referenzdokumente legen drei Grundregeln fest. Erstens ist EEV ein textuelles, versionierbares Format. Zweitens muss es einen vollständig erzeugten Klang mit erkennbarem Anfang, Verlauf und Ende beschreiben. Drittens gilt die Grundfrequenz allein nicht als primäre Identität des Klangs.

der Reader darf gegenüber älteren Varianten tolerant bleiben
der kanonische Writer muss strikt, lesbar und deterministisch bleiben
unbekannte Abschnitte dürfen von einem toleranten Reader ignoriert werden

Was die Datei nicht ist

Eine EEV-Datei ist weder ein roher Audiostream noch ein bloßes Spektrumbild noch ein therapeutisches Versprechen. Sie ist ein strukturiertes Dokument, das Klangverhalten in einer Form zusammenfasst, die Code erneut lesen, vergleichen, archivieren und wieder ausgeben kann.

Wichtige Blöcke

Die Spezifikation enthält viele Details, doch das nützliche Grundgerüst ist stabil. Für eine erste ernsthafte Implementierung ist vor allem wichtig zu wissen, wo jede Informationsfamilie hingehört.

@entry

Identitätsblock des Fingerprints: Kennungen, Typ, Instrument, Kontext, Qualität und Dokumentstatus. Er ist der logische Einstiegspunkt für jeden Eintrag.

@global

Globale Sicht auf die Aufnahme: Grundrauschen, SNR, transversale Metriken, nutzbare Dauer und weitere übergreifende Indikatoren. Einige Legacy-Spuren können beim Lesen toleriert werden, sollen aber nicht kanonisch erneut ausgegeben werden.

@vectors / @matrix

Diese Blöcke tragen kompakte Zusammenfassungen und Energiekarten, die zum Vergleichen, Indexieren und schnelleren Matching dienen, ohne die gesamte Struktur des Klangs zu verlieren.

@modes / @peak_tracks

Diese Blöcke beschreiben dominante Strukturen und feine Verläufe über die Zeit. Sie werden besonders wichtig, sobald man Stabilität, Drift, Schwebungen oder fortgeschrittene Rekonstruktion verfolgen will.

ENTRY

ENTRY ist der Einzelobjekt-Container. Er enthält genau einen Fingerprint. Für Austausch, Tests, Demos und viele APIs ist dies der einfachste und oft praktischste Fall.

LIB

LIB ist der Bibliotheks-Container. Er gruppiert einen oder mehrere Einträge. Er ist nützlich für Sammlungen, eingebettete Bibliotheken, Stapelimporte und Workflows, die mehrere Fingerprints gemeinsam verarbeiten.

Transportvarianten

Komprimierte Varianten verändern das Dokumentmodell nicht. Sie verändern nur die Art, wie der Text transportiert wird.

Erweiterung	Rolle	Merksatz
.eev	editierbarer öffentlicher Text	kanonische fachliche Quelle des offenen Kanals
.eevz	komprimierter Transport für .eev	zuerst dekomprimieren, dann denselben kanonischen Text lesen
.eevc / .eevcz	Nur-Lese-Kompatibilität	bestehende zertifizierte Dateien bei Bedarf lesen; die zertifizierte Verifikation gehört zu eevc.link

Qualitätsstufen

Die vier Stufen definieren keine vier inkompatiblen Formate. Sie regeln die beschreibende Tiefe und den Rechenaufwand.

Stufe	Ziel	Was ein Reader erwarten darf
eco	leichtes, aber reales Porträt	beschreibende Basis, nutzbare Zusammenfassung, geringerer Aufwand
standard	robusterer Vergleich	reichere Matrizen und Zusammenfassungen ohne direkt zum schwersten Profil zu wechseln
high	bessere zeitliche Treue	feinere zeitliche Erfassung und stabilere Verhaltensbeschreibungen
ultra	maximale beschreibende Ambition	fortgeschrittene Verläufe, reichere Steuerdaten und Raum für künftige syntheseorientierte Erweiterungen