# 📡 Calculadora de Antenas EnKryP — Versión Castellano

**Repositorio oficial de la Calculadora de Antenas EnKryP**, una herramienta avanzada para el diseño, cálculo, documentación y validación técnica de antenas de radiofrecuencia.  
Este proyecto ha sido desarrollado para radioaficionados, técnicos y profesionales que requieren cálculos fiables, reportes exportables y una base teórica sólida aplicada a antenas reales.

![Antenas EnKryP](images/amateur-radio.jpg)
---

## 🧭 Características principales

### 🔬 **1. Motor de cálculo técnico avanzado**
El sistema implementa fórmulas verificadas para las principales configuraciones de antenas:

- Dipolo de media onda (λ/2)  
- Monopolo de cuarto de onda (λ/4)  
- Vertical 5/8 λ (con adaptación pendiente de bobina)  
- Dipolo plegado  
- Vertical de 1/2 λ  
- Antena J-Pole completa (radiador + stub + alimentación)  
- Yagi de 3 a 5 elementos con separaciones definidas  
- Cálculo multi-frecuencia

Las fórmulas han sido revisadas para garantizar coherencia electromagnética y resultados dentro de márgenes prácticos de construcción.

---

### 📐 **2. Factores de velocidad corregidos**
Se ha adoptado un enfoque riguroso respecto a los factores de velocidad:

| Material | Uso | Factor aplicado |
|---------|------|-----------------|
| Aire | Elementos radiantes | 0.97 |
| Teflón (aislante externo) | Elementos radiantes | 0.95 |
| PVC | Coaxial / cuerpos aislantes | 0.80 |
| Foam | Aislantes | 0.85 |

**Importante:**  
Los elementos radiantes trabajan mayoritariamente en aire; por tanto, ya no se utilizan factores de velocidad propios del coaxial (error habitual en calculadoras no profesionales).

---

### 🖥️ **3. Interfaz interactiva de consola**
La herramienta guía al usuario durante todo el proceso:

- Introducción de frecuencias múltiples  
- Selección de materiales  
- Elección de antenas individuales o lotes completos  
- Exportación de informes  
- Diagramas ASCII instantáneos  
- Validación de rangos de cálculo

---

### 📄 **4. Generación automática de informes profesionales**
Incluye dos sistemas de exportación:

#### ✔️ Informe HTML profesional  
Con:
- Ficha técnica  
- Medidas exactas  
- Diagramas  
- Materiales necesarios  
- Verificación de cálculo  
- Hoja de auditoría interna  

#### ✔️ Diagrama constructivo detallado  
Pensado para impresión o consulta en obra.

Ambos formatos conservan un diseño elegante, contrastado y técnico.

---

### 🛑 **5. Sistema de verificación inteligente**
El programa valida automáticamente si el cálculo entra dentro de los rangos electromagnéticos habituales:

- Ajustes por acortamiento  
- Rango óptimo de resonancia  
- Advertencias cuando el factor de velocidad no es apropiado  
- Señalización de posibles errores de entrada

---

## ⚙️ Funcionamiento interno (visión técnica)

### Fórmulas implementadas (resumen)
- **Longitud de onda:**  
  `λ = c / f`

- **Dipolo λ/2:**  
  `L = (λ / 2) × factor_material`

- **Monopolo λ/4:**  
  `L = (λ / 4) × factor_material`

- **Vertical 5/8:**  
  `L = (λ × 5/8) × factor_material`

- **J-Pole (radiador):**  
  `L ≈ (λ / 2) × 1.05 × factor_material`

- **Stub J-Pole:**  
  `L ≈ (λ / 4) × factor_material`

- **Yagi 3–5 elementos (modelo práctico):**  
  Basado en porcentajes clásicos: reflector +5%, directores entre −5% y −12%.

---

## 🧪 Validación y auditoría

Este código ha sido sometido a revisión técnica externa.  
Los puntos validados:

- Correctitud de fórmulas fundamentales  
- Corrección en factores de velocidad  
- Modelos prácticos adecuados para uso real  
- Exportación profesional funcional  
- Modularización del código  

Puntos abiertos para evolución profesional:

- Optimización de Yagi según objetivo (ganancia/F·B/ancho de banda)  
- Implementación del cálculo real de la bobina en antenas 5/8  
- Inclusión del diámetro del conductor como parámetro central  
- Mejor modelado del stub y punto de alimentación en J-Pole  

---

## 🧱 Estructura del repositorio