1  # 📡 Calculadora de Antenas EnKryP — Versión Castellano
  2  
  3  **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.  
  4  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.
  5  
  6  ![Antenas EnKryP](images/amateur-radio.jpg)
  7  ---
  8  
  9  ## 🧭 Características principales
 10  
 11  ### 🔬 **1. Motor de cálculo técnico avanzado**
 12  El sistema implementa fórmulas verificadas para las principales configuraciones de antenas:
 13  
 14  - Dipolo de media onda (λ/2)  
 15  - Monopolo de cuarto de onda (λ/4)  
 16  - Vertical 5/8 λ (con adaptación pendiente de bobina)  
 17  - Dipolo plegado  
 18  - Vertical de 1/2 λ  
 19  - Antena J-Pole completa (radiador + stub + alimentación)  
 20  - Yagi de 3 a 5 elementos con separaciones definidas  
 21  - Cálculo multi-frecuencia
 22  
 23  Las fórmulas han sido revisadas para garantizar coherencia electromagnética y resultados dentro de márgenes prácticos de construcción.
 24  
 25  ---
 26  
 27  ### 📐 **2. Factores de velocidad corregidos**
 28  Se ha adoptado un enfoque riguroso respecto a los factores de velocidad:
 29  
 30  | Material | Uso | Factor aplicado |
 31  |---------|------|-----------------|
 32  | Aire | Elementos radiantes | 0.97 |
 33  | Teflón (aislante externo) | Elementos radiantes | 0.95 |
 34  | PVC | Coaxial / cuerpos aislantes | 0.80 |
 35  | Foam | Aislantes | 0.85 |
 36  
 37  **Importante:**  
 38  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).
 39  
 40  ---
 41  
 42  ### 🖥️ **3. Interfaz interactiva de consola**
 43  La herramienta guía al usuario durante todo el proceso:
 44  
 45  - Introducción de frecuencias múltiples  
 46  - Selección de materiales  
 47  - Elección de antenas individuales o lotes completos  
 48  - Exportación de informes  
 49  - Diagramas ASCII instantáneos  
 50  - Validación de rangos de cálculo
 51  
 52  ---
 53  
 54  ### 📄 **4. Generación automática de informes profesionales**
 55  Incluye dos sistemas de exportación:
 56  
 57  #### ✔️ Informe HTML profesional  
 58  Con:
 59  - Ficha técnica  
 60  - Medidas exactas  
 61  - Diagramas  
 62  - Materiales necesarios  
 63  - Verificación de cálculo  
 64  - Hoja de auditoría interna  
 65  
 66  #### ✔️ Diagrama constructivo detallado  
 67  Pensado para impresión o consulta en obra.
 68  
 69  Ambos formatos conservan un diseño elegante, contrastado y técnico.
 70  
 71  ---
 72  
 73  ### 🛑 **5. Sistema de verificación inteligente**
 74  El programa valida automáticamente si el cálculo entra dentro de los rangos electromagnéticos habituales:
 75  
 76  - Ajustes por acortamiento  
 77  - Rango óptimo de resonancia  
 78  - Advertencias cuando el factor de velocidad no es apropiado  
 79  - Señalización de posibles errores de entrada
 80  
 81  ---
 82  
 83  ## ⚙️ Funcionamiento interno (visión técnica)
 84  
 85  ### Fórmulas implementadas (resumen)
 86  - **Longitud de onda:**  
 87    `λ = c / f`
 88  
 89  - **Dipolo λ/2:**  
 90    `L = (λ / 2) × factor_material`
 91  
 92  - **Monopolo λ/4:**  
 93    `L = (λ / 4) × factor_material`
 94  
 95  - **Vertical 5/8:**  
 96    `L = (λ × 5/8) × factor_material`
 97  
 98  - **J-Pole (radiador):**  
 99    `L ≈ (λ / 2) × 1.05 × factor_material`
100  
101  - **Stub J-Pole:**  
102    `L ≈ (λ / 4) × factor_material`
103  
104  - **Yagi 3–5 elementos (modelo práctico):**  
105    Basado en porcentajes clásicos: reflector +5%, directores entre −5% y −12%.
106  
107  ---
108  
109  ## 🧪 Validación y auditoría
110  
111  Este código ha sido sometido a revisión técnica externa.  
112  Los puntos validados:
113  
114  - Correctitud de fórmulas fundamentales  
115  - Corrección en factores de velocidad  
116  - Modelos prácticos adecuados para uso real  
117  - Exportación profesional funcional  
118  - Modularización del código  
119  
120  Puntos abiertos para evolución profesional:
121  
122  - Optimización de Yagi según objetivo (ganancia/F·B/ancho de banda)  
123  - Implementación del cálculo real de la bobina en antenas 5/8  
124  - Inclusión del diámetro del conductor como parámetro central  
125  - Mejor modelado del stub y punto de alimentación en J-Pole  
126  
127  ---
128  
129  ## 🧱 Estructura del repositorio
130