EEV v1

Formaatstructuur

Deze pagina herschikt de specificatie in een vorm die tijdens de implementatie gemakkelijker te gebruiken is. Ze vervangt de meegeleverde markdownbestanden niet, maar helpt om het formaatcontract, de transportvarianten en de beschrijvende diepte per kwaliteitsniveau helder uit elkaar te houden.

Het minimale contract

De referentiedocumenten leggen drie basisregels vast. Ten eerste is EEV een tekstueel, versioneerbaar formaat. Ten tweede moet het een volledig geproduceerd geluid beschrijven met een herkenbaar begin, verloop en einde. Ten derde wordt de grondtoon op zichzelf niet als de primaire identiteit van het geluid beschouwd.

  • de lezer mag tolerant blijven voor oudere varianten
  • de canonieke writer moet strikt, leesbaar en deterministisch blijven
  • onbekende secties mogen door een tolerante lezer worden genegeerd

Wat het bestand niet is

Een EEV-bestand is noch een ruwe audiostream, noch een eenvoudige spectrumafbeelding, noch een therapeutische belofte. Het is een gestructureerd document dat klankgedrag samenvat in een vorm die code opnieuw kan lezen, vergelijken, archiveren en opnieuw kan uitgeven.

Blokken die tellen

De specificatie bevat veel details, maar het bruikbare skelet is stabiel. Voor een eerste serieuze implementatie is vooral belangrijk te weten waar elke informatiefamilie thuishoort.

@entry

Identiteitsblok van de vingerafdruk: identificatoren, type, instrument, context, kwaliteit en documentstatus. Dit is het logische startpunt van elk item.

@global

Globaal beeld van de opname: ruisvloer, SNR, transversale metriek, bruikbare duur en andere brede indicatoren. Sommige legacy-sporen kunnen bij het lezen worden getolereerd, maar mogen niet canoniek opnieuw worden uitgegeven.

@vectors / @matrix

Deze blokken bevatten compacte samenvattingen en energiekaarten die worden gebruikt om sneller te vergelijken, indexeren en matchen zonder de volledige structuur van het geluid te verliezen.

@modes / @peak_tracks

Deze blokken beschrijven dominante structuren en fijne trajecten in de tijd. Ze worden vooral belangrijk zodra je stabiliteit, drift, zwevingen of geavanceerde reconstructie wilt volgen.

ENTRY

ENTRY is de container voor één item. Hij bevat precies één vingerafdruk. Voor uitwisseling, tests, demo’s en veel API’s is dit het eenvoudigste en vaak het meest praktische geval.

LIB

LIB is de bibliotheekcontainer. Hij groepeert één of meer entries. Hij is nuttig voor collecties, ingebedde bibliotheken, batchimport en workflows die meerdere vingerafdrukken samen verwerken.

Transportvarianten

Gecomprimeerde varianten veranderen het documentmodel niet. Ze veranderen alleen de manier waarop de tekst wordt vervoerd.

Extensie Rol Wat te onthouden
.eevbewerkbare openbare tekstcanonieke functionele bron van het open kanaal
.eevzgecomprimeerd transport van .eeveerst decomprimeren en daarna dezelfde canonieke tekst lezen
.eevc / .eevczalleen-lezen-compatibiliteitlees indien nodig bestaande gecertificeerde bestanden; gecertificeerde verificatie hoort bij eevc.link

Kwaliteitsniveaus

De vier niveaus definiëren geen vier incompatibele formaten. Ze regelen de beschrijvende diepte en de rekenkost.

Niveau Doel Wat een lezer mag verwachten
ecolicht maar echt portretbeschrijvende basis, bruikbare samenvatting, lagere kost
standardrobuustere vergelijkingrijkere matrices en samenvattingen zonder meteen naar het zwaarste profiel te gaan
highbetere temporele trouwfijnere temporele opname en stabielere gedragsbeschrijvingen
ultramaximale beschrijvende ambitiegeavanceerde trajecten, rijkere stuurdata en ruimte voor toekomstige synthesegerichte uitbreidingen