================================================================================
CÓDIGO FUENTE DEL SISTEMA OAM - ANEXO AL TRABAJO DE GRADO
================================================================================

Autor: Deiby Fernando Ariza Cadena
Código: 2195590
Director: Dr. Omar Javier Tijaro Rojas
Programa: Ingeniería Electrónica
Facultad: Ingenierías Fisicomecánicas
Universidad Industrial de Santander

Título del trabajo:
"Codificación y Decodificación a partir del Momento Angular Orbital
de la Luz y GNU Radio"

================================================================================
CONTENIDO DE ESTE ANEXO
================================================================================

Este anexo contiene el código fuente completo del sistema de comunicación
óptica basado en Momento Angular Orbital (OAM) desarrollado como parte del
trabajo de grado.

El código implementa:
- Simulador de comunicaciones ópticas de espacio libre basado en OAM
- Generación de haces Laguerre-Gauss con cargas topológicas configurables
- Modelo de turbulencia atmosférica según Kolmogorov
- Codificación/decodificación por proyección modal
- Sistema de visualización multi-dashboard
- Integración con GNU Radio para diseño visual

================================================================================
REPOSITORIO PÚBLICO
================================================================================

El código fuente está disponible públicamente en:
https://github.com/DeibyArizac/OAM

Versión incluida en este anexo: Repositorio al momento de la entrega del
trabajo de grado (noviembre 2025)

================================================================================
ARCHIVOS PRINCIPALES
================================================================================

oam_complete_system.py      - Sistema completo standalone (ejecución directa)
oam_complete_flowgraph.grc  - Diseño visual en GNU Radio Companion
oam_system_config.py        - Configuración centralizada del sistema
pipeline.py                 - Sistema de pipeline de datos
oam_source.py               - Generador de mensajes digitales
oam_encoder.py              - Codificador bit-to-mode
oam_channel.py              - Simulador de canal atmosférico
oam_decoder.py              - Decodificador por proyección modal
oam_visualizer.py           - Sistema de visualización multi-dashboard
README.md                   - Documentación completa del sistema
requirements.txt            - Dependencias de Python
install.sh                  - Script de instalación

Carpeta grc/                - Definiciones de bloques GNU Radio
Carpeta assets/             - Recursos adicionales

================================================================================
REQUISITOS DEL SISTEMA
================================================================================

Sistema operativo: Ubuntu 22.04 LTS (recomendado) o compatible
Python: 3.8 o superior
GNU Radio: 3.10 o superior

Dependencias Python:
- numpy
- scipy
- matplotlib
- PyQt5
- gnuradio

Consulte requirements.txt para versiones específicas.

================================================================================
INSTALACIÓN Y USO
================================================================================

Para instrucciones detalladas de instalación, configuración y uso del sistema,
consulte:

1. README.md en este directorio
2. Manual de Instalación (Anexo separado en PDF)
3. Capítulo de Desarrollo en el documento de tesis

================================================================================
LICENCIA
================================================================================

Este código se proporciona como parte del trabajo académico y está sujeto a
las políticas de propiedad intelectual de la Universidad Industrial de
Santander.

Para uso, modificación o distribución, contactar al autor o a la dirección
del programa académico.

================================================================================
CONTACTO
================================================================================

Para consultas técnicas sobre el código o el sistema:
Correo institucional: 2195590@correo.uis.edu.co

================================================================================
FECHA DE ENTREGA
================================================================================

Noviembre de 2025

================================================================================
