Estudiante: Xavier Misael Armenta Muñoz
Asignatura: Mecánica y Electromagnetismo
Carrera: Ingeniería en Sistemas Computacionales
Fecha de entrega: 02/06/2026
Este simulador es una herramienta computacional desarrollada en Python para analizar sistemas de cargas eléctricas puntuales. Permite representar distribuciones de carga en una dimensión (1D) y dos dimensiones (2D), calculando de forma precisa las fuerzas de interacción mediante la Ley de Coulomb y el campo eléctrico resultante mediante el principio de superposición.
- Lenguaje: Python 3.x
- NumPy: Utilizada para el manejo de vectores, componentes rectangulares y cálculos de magnitudes.
- Matplotlib: Empleada para la generación de visualizaciones estáticas, diagramas de fuerzas y mapas de campo eléctrico.
- Plotly: Gráficos interactivos con zoom y hover para las visualizaciones 2D y mapas de campo.
- Streamlit: Interfaz web interactiva con manipulación directa de cargas mediante arrastre.
- Dataclasses: Para una representación estructurada y limpia del modelo de datos de las cargas.
- fpdf2: Generación del reporte PDF.
Tener instalado Python 3.8 o superior.
- Clonar el repositorio o descargar la carpeta del proyecto.
- Crear un entorno virtual (opcional pero recomendado):
python -m venv venv source venv/bin/activate # En Linux/Mac
- Instalar las dependencias necesarias:
pip install -r requirements.txt
Interfaz de línea de comandos:
python main.pyInterfaz web interactiva (Streamlit):
streamlit run app.pyLa interfaz web permite arrastrar las cargas directamente sobre el diagrama, ver la fuerza neta en tiempo real y generar mapas de campo eléctrico configurables.
- Modo 1D: Ingrese 2 cargas sobre el eje X (ej. q₁ = +2 µC en x = 0, q₂ = −2 µC en x = 1). El sistema mostrará la fuerza de atracción y la dirección de los vectores.
- Modo 2D: Ingrese 3 cargas en un triángulo. Seleccione una carga para ver la fuerza neta resultante y su ángulo de inclinación.
- Campo Eléctrico: Defina puntos en el plano (ej. (0, 0), (1, 1), (2, 2)) para obtener la magnitud y dirección del campo eléctrico total en esas coordenadas.
Se calcula la fuerza entre cada par de cargas mediante:
F = k · |q₁·q₂| / r²
donde k = 8.99 × 10⁹ N·m²/C². El simulador descompone automáticamente esta fuerza en sus componentes Fx y Fy.
La fuerza neta F⃗_neta sobre una carga se obtiene sumando vectorialmente todas las fuerzas individuales ejercidas por las demás cargas del sistema:
F⃗_neta = Σ F⃗ᵢ
Se calcula en cualquier punto del espacio sumando las contribuciones de cada carga i:
E⃗_total = Σ k · (qᵢ / rᵢ²) · r̂ᵢ
El simulador genera automáticamente tres tipos de gráficos que se guardan en la carpeta assets/screenshots/:
Dos cargas positivas (rojo) separadas 1 m. La flecha verde indica la fuerza neta de repulsión sobre la carga seleccionada.
Tres cargas positivas en triángulo equilátero. La fuerza neta sobre la carga superior es puramente vertical (Fx=0 por simetría).
Líneas de campo eléctrico generadas por una carga positiva en el origen. La intensidad se muestra en escala logarítmica (colores más claros = mayor intensidad).
El programa incluye protecciones contra:
- Entradas no numéricas.
- Cargas en posiciones idénticas (división entre cero).
- Cálculo de campo eléctrico exactamente sobre una carga.
- Auto-interacción de cargas.