EEV v1

Struttura del formato

Questa pagina riorganizza la specifica in una forma più facile da usare durante l’implementazione. Non sostituisce i file markdown inclusi, ma aiuta a separare il contratto del formato, le varianti di trasporto e la profondità descrittiva legata a ciascun livello di qualità.

Contratto Blocchi Contenitori Trasporto Qualità

Il contratto minimo

I documenti di riferimento fissano tre regole di base. Primo, EEV è un formato testuale e versionabile. Secondo, deve descrivere un suono prodotto completo, con un inizio, uno sviluppo e una fine identificabili. Terzo, la sola fondamentale non è considerata l’identità principale del suono.

il lettore può restare tollerante verso le varianti più vecchie
il writer canonico deve restare rigoroso, leggibile e deterministico
le sezioni sconosciute possono essere ignorate in lettura tollerante

Ciò che il file non è

Un file EEV non è né un flusso audio grezzo, né una semplice immagine di spettro, né una promessa terapeutica. È un documento strutturato che riassume il comportamento sonoro in una forma che il codice può rileggere, confrontare, archiviare e riemettere.

Blocchi che contano

La specifica contiene molti dettagli, ma la struttura utile è stabile. Per una prima implementazione seria, la cosa più importante è sapere dove collocare ogni famiglia di informazioni.

@entry

Blocco di identità dell’impronta: identificatori, tipo, strumento, contesto, qualità e stato documentale. È il punto di ingresso logico di ogni voce.

@global

Vista globale della cattura: rumore di fondo, SNR, metriche trasversali, durata utile e altri indicatori generali. Alcune tracce legacy possono essere tollerate in lettura, ma non devono essere riemesse in forma canonica.

@vectors / @matrix

Questi blocchi contengono riassunti compatti e mappe energetiche utili per confrontare, indicizzare e fare matching più rapidamente senza perdere l’intera struttura del suono.

@modes / @peak_tracks

Questi blocchi descrivono strutture dominanti e traiettorie fini nel tempo. Diventano particolarmente importanti quando si vuole seguire stabilità, deriva, battimenti o ricostruzione avanzata.

ENTRY

ENTRY è il contenitore a singolo elemento. Contiene esattamente un’impronta. Per scambio, test, demo e molte API è il caso più semplice e spesso il più pratico.

LIB

LIB è il contenitore libreria. Raggruppa una o più voci. È utile per collezioni, librerie incorporate, import in batch e flussi che manipolano più impronte insieme.

Varianti di trasporto

Le varianti compresse non cambiano il modello documentale. Cambiano solo il modo in cui il testo viene trasportato.

Estensione	Ruolo	Da ricordare
.eev	testo pubblico modificabile	fonte canonica funzionale del canale aperto
.eevz	trasporto compresso di .eev	prima si decomprime, poi si rilegge lo stesso testo canonico
.eevc / .eevcz	compatibilità in sola lettura	leggere file certificati esistenti se necessario; la verifica certificata appartiene a eevc.link

Livelli di qualità

I quattro livelli non definiscono quattro formati incompatibili. Regolano la profondità descrittiva e il costo computazionale.

Livello	Intento	Che cosa può aspettarsi un lettore
eco	ritratto leggero ma reale	base descrittiva, riassunto utilizzabile, costo ridotto
standard	confronto più robusto	matrici e riassunti più ricchi senza passare al profilo più pesante
high	migliore rispetto della temporalità	cattura temporale più fine e descrizioni di comportamento più stabili
ultra	massima ambizione descrittiva	traiettorie avanzate, dati di controllo più ricchi e spazio per future estensioni orientate alla sintesi