Formato del patrón horizontal de la antena

Dónde se usa

El mismo lector vale en Cobertura FM, TV Digital, Interferencia y Red SFN — un patrón por sitio, cargado desde el paso donde se definen sus datos técnicos (potencia, ganancia, altura). Sin patrón cargado, la herramienta asume que la antena es omnidireccional (radia igual en todas direcciones).

Los dos formatos aceptados

Dos columnas por fila: acimut (la dirección, en grados) y campo relativo (cuánta señal manda ahí, comparada con la dirección de máxima radiación). Nada más.

CSV (también vale con punto y coma ; o tabulador en vez de coma): una fila por punto, acimut,valor. La primera línea puede ser un encabezado de texto (se detecta y se salta sola) y las líneas que empiecen con # se ignoran, así que puedes anotar la fuente del dato ahí mismo.

JSON: un objeto con la clave relative_field_percent, acimut (como texto) → valor. Sirve tanto el archivo suelto como uno completo que ya lleve el patrón dentro de un campo patron — así se puede reutilizar el patrón que trae un estudio guardado sin recortarlo a mano.

Acimut y escala

El acimut va de 0° a 359°, con 0° = Norte y creciendo en el sentido de las agujas del reloj — igual que se lee una hoja de fabricante y un mapa, no como el sentido matemático habitual.

El campo relativo puede venir en 0–1 o en 0–100 (porcentaje) — las dos convenciones que publican los fabricantes indistintamente. No hace falta decir cuál: se detecta sola por el máximo del archivo (si ningún valor pasa de 1, se asume que viene en la unidad y se multiplica por 100). El diagrama polar que se dibuja al cargar el archivo es la forma de confirmar que se leyó como se esperaba antes de gastar un cálculo.

Ejemplo

Un patrón direccional simple, con el lóbulo principal hacia el Norte (0°), en los dos formatos — el mismo patrón, escrito de las dos formas:

acimut,campo
0,100
45,80
90,40
135,15
180,10
225,15
270,40
315,80

{
  "relative_field_percent": {
    "0": 100, "45": 80, "90": 40, "135": 15,
    "180": 10, "225": 15, "270": 40, "315": 80
  }
}

No hace falta un punto por cada grado: entre dos acimutes dados, el valor se interpola en línea recta — incluido el tramo que cierra el círculo entre el último punto y el primero (315°→0° en el ejemplo de arriba). Ocho u doce puntos alcanzan para un patrón razonablemente suave; más puntos solo hacen falta si el patrón tiene lóbulos estrechos que un tramo recto no represente bien.

Qué no se acepta

PDFs ni imágenes del diagrama polar del fabricante — es deliberado, no una limitación pendiente de resolver. Medir un diagrama a ojo (o con un lector automático de píxeles) introduce un error que no se puede defender ante un regulador cuando lo pida. La tabla numérica siempre existe en la documentación del fabricante, aunque haya que pedirla aparte del PDF con el dibujo.

Para integraciones por API

Quien llame a la API directamente (sin pasar por el portal) tiene tres formas más, además de relative_field_percent — la que ya trae de su propio software de diseño de antena, sin convertirla a mano:

relative_field: campo relativo en 0–1, sin autodetección de escala (para cuando el llamador ya sabe la unidad y quiere evitarla). relative_db: atenuación relativa en dB (valores ≤ 0, 0 dB en la dirección de máxima radiación) — la forma en la que muchos fabricantes publican sus tablas. erp_kw: ERP directa por acimut en kW, como la imprime el software de proyecto — útil cuando ya se calculó la ERP en cada dirección y no hace falta separarla en patrón + potencia. En los tres casos, exactamente uno de los cuatro campos debe venir, nunca dos a la vez.