EEV v1

Estructura del formato

Esta página reorganiza la especificación en una vista más cómoda para la implementación. No sustituye a los archivos markdown incluidos, pero ayuda a separar el contrato del formato, las variantes de transporte y la profundidad descriptiva ligada a cada nivel de calidad.

Contrato Bloques Contenedores Transporte Calidad

El contrato mínimo

Los documentos de referencia fijan tres reglas básicas. Primero, EEV es un formato textual y versionable. Segundo, debe describir un sonido producido completo, con un inicio, una evolución y un final identificables. Tercero, la fundamental por sí sola no se considera la identidad principal del sonido.

el lector puede seguir siendo tolerante con variantes antiguas
el writer canónico debe seguir siendo estricto, legible y determinista
las secciones desconocidas pueden ignorarse en lectura tolerante

Lo que el archivo no es

Un archivo EEV no es ni un flujo de audio bruto, ni una simple imagen de espectro, ni una promesa terapéutica. Es un documento estructurado que resume el comportamiento sonoro en una forma que el código puede releer, comparar, archivar y volver a emitir.

Bloques que importan

La especificación contiene muchos detalles, pero la estructura útil es estable. Para una primera implementación seria, lo más importante es saber dónde colocar cada familia de información.

@entry

Bloque de identidad de la huella: identificadores, tipo, instrumento, contexto, calidad y estado documental. Es el punto de entrada lógico de cada elemento.

@global

Vista global de la captura: ruido de fondo, SNR, métricas transversales, duración útil y otros indicadores amplios. Algunas trazas legacy pueden tolerarse en lectura, pero no deben reemitirse de forma canónica.

@vectors / @matrix

Estos bloques contienen resúmenes compactos y mapas energéticos que sirven para comparar, indexar y hacer matching más rápido sin perder toda la estructura del sonido.

@modes / @peak_tracks

Estos bloques describen estructuras dominantes y trayectorias finas a lo largo del tiempo. Se vuelven especialmente importantes en cuanto se quiere seguir estabilidad, deriva, batimientos o reconstrucción avanzada.

ENTRY

ENTRY es el contenedor de un solo elemento. Contiene exactamente una huella. Para intercambio, pruebas, demostraciones y muchas API, es el caso más simple y a menudo el más práctico.

LIB

LIB es el contenedor de biblioteca. Agrupa una o varias entradas. Es útil para colecciones, bibliotecas embebidas, importaciones por lotes y flujos que manipulan varias huellas juntas.

Variantes de transporte

Las variantes comprimidas no cambian el modelo documental. Solo cambian la forma de transportar el texto.

Extensión	Papel	Qué recordar
.eev	texto público editable	fuente canónica funcional del canal abierto
.eevz	transporte comprimido de .eev	primero se descomprime y luego se lee el mismo texto canónico
.eevc / .eevcz	compatibilidad de solo lectura	leer archivos certificados existentes si es necesario; la verificación certificada corresponde a eevc.link

Niveles de calidad

Los cuatro niveles no definen cuatro formatos incompatibles. Regulan la profundidad descriptiva y el coste de cálculo.

Nivel	Propósito	Qué puede esperar un lector
eco	retrato ligero pero real	base descriptiva, resumen utilizable, coste reducido
standard	comparación más robusta	matrices y resúmenes más ricos sin pasar al perfil más pesado
high	mejor respeto temporal	captura temporal más fina y descripciones de comportamiento más estables
ultra	máxima ambición descriptiva	trayectorias avanzadas, datos de control más ricos y margen para futuras extensiones orientadas a la síntesis