Skip to main content

armadura-2d-andresdperezc

Librería didáctica en Python para armaduras 2D isostáticas (mecánica vectorial). Resuelve el equilibrio nodal A x = b, clasifica cada barra en tensión / compresión / nula y dibuja la figura.

Se instala con guion y se importa con guion bajo:

pip install armadura-2d-andresdperezc
from armadura_2d_andresdperezc import Armadura2D

La GUI de Streamlit no forma parte del paquete: vive en este repositorio (streamlit_app.py) y en la imagen Docker. El paquete no depende de Streamlit ni de Tkinter.

Versión 0.1.0. Python ≥ 3.10. Licencia MIT.

Requisitos y sistemas

Corre en Windows, Linux y macOS (Python 3.10 o superior).

Uso Windows Linux macOS
pip install + NumPy + matplotlib Sí Sí Sí
pytest y notebook Sí Sí Sí
Streamlit en el navegador Sí Sí Sí
Docker + Streamlit Sí (Docker Desktop) Sí Sí

Tkinter no es requisito. En Linux no hace falta python3-tk.

Instalación

Cuando el paquete esté en PyPI:

pip install armadura-2d-andresdperezc

Eso instala la lógica (NumPy) y los gráficos matplotlib. No instala Streamlit ni copia streamlit_app.py.

Desarrollo (modo editable)

Desde la carpeta del proyecto:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev,docs]"

En Linux o macOS: source .venv/bin/activate y el mismo pip install.

Si el comando python no está en el PATH (Windows), use el launcher py.

Extras opcionales:

Extra Qué añade
[gui] Streamlit, para streamlit run streamlit_app.py (hace falta el archivo del repo)
[dev] pytest, build, twine, Jupyter
[docs] Sphinx, Furo, rinohtype

Todo junto: python -m pip install -e ".[gui,dev,docs]".

Si PowerShell bloquea Activate.ps1: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned (una sola vez).

Uso básico

from armadura_2d_andresdperezc import Armadura2D

a = Armadura2D.preset_triangulo()  # también preset_warren, preset_pratt, preset_howe
r = a.resolver()
print(r.equilibrio.ok)
for barra in r.fuerzas:
    print(barra.id, barra.tipo, barra.fuerza)

fig = a.graficar(r)
fig.savefig("triangulo.png")

Unidades fijas: kN y m. El eje y es positivo hacia arriba. Tensión N > 0; compresión N < 0.

El triángulo de libro (base 4 m, altura 3 m, 50 kN hacia abajo en la cúspide) da Ry = 25 kN en cada apoyo, B1 =+50/3 kN (tensión) y B2 = B3 = −(25/3)√13 kN (compresión).

Métodos de Armadura2D

Método Resultado
preset_triangulo() / preset_warren() / preset_pratt() / preset_howe() Armadura lista para resolver()
agregar_nodo / agregar_barra / agregar_apoyo / agregar_carga Construcción libre. La GUI también la expone en el modo Propia
definir_apoyos(fijo, movil, tipo_movil="movil") Un pin y un rodillo: movil (piso, Ry) o movil_pared (pared, Rx)
ecuaciones() Sistema ΣFx = 0 y ΣFy = 0 de cada nudo, sin sustituir la solución
graficar_nudo(nudo, resultado) Cuerpo libre de un nudo
definir_cargas([(nudo, fx, fy), ...]) Sustituye el conjunto de cargas
reemplazar_coordenadas({id: (x, y), ...}) Mueve todos los nudos a la vez
longitud(barra) / angulo(barra) L en m y ángulo en radianes
resolver() ResultadoArmadura (fuerzas, reacciones, equilibrio)
verificar_equilibrio(resultado=None) Residuos Σ Fx, Σ Fy, Σ M
graficar(resultado=None) matplotlib.figure.Figure con fuerzas, cargas y reacciones
graficar_plano() La misma geometría sin resolver: nudos, barras, longitudes, apoyos y cargas
snapshot_nodos() / snapshot_barras() / snapshot_apoyos() / snapshot_cargas() Lectura para GUI y scripts (sin tocar _nodos)

Los gráficos devuelven la figura. En un script se guarda el PNG; en un notebook se muestra sola. En tests y Docker use el backend Agg.

Si la armadura no es isostática (m + r = 2j) o A es singular, se lanza ValueError con un mensaje en español.

Unidades

Magnitud Unidad
Fuerza interna, reacción, carga kN
Coordenadas y longitudes m
Ángulo rad
Momento (residuo de equilibrio) kN·m

Presets

Nombre Geometría por defecto Carga Signo típico de las diagonales
Triángulo 4 m × 3 m, 3 nudos 50 kN en la cúspide —
Warren puente 4 m × 2 m, 2 paneles 50 kN en el tablero central —
Pratt 6 nudos; diagonales hacia el centro igual tensión (3-1, 5-1)
Howe mismas cuerdas; diagonales hacia los apoyos igual compresión (4-0, 4-2)

La GUI ofrece estos cuatro y, además, una armadura propia. Se arma con las tablas o con clics en el plano: nudos en la cuadrícula de 0,5 m, barras entre dos nudos, y apoyos o cargas sobre un nudo. Borrar y afinar coordenadas sigue en la tabla.

Ejemplos (sin Streamlit)

Demuestran que el paquete funciona solo con pip:

  • python ejemplo_consola.py — triángulo de libro, Pratt y Howe; PNG en examples/.
  • examples/notebook_didactico.ipynb — teoría breve y llamadas a la librería (Jupyter; kernel del .venv).

Pruebas

python -m pip install -e ".[dev]"
pytest -v

Los tests contrastan el triángulo de libro, isostática y residuos ≈ 0 en los cuatro presets, signos Pratt vs Howe, graficar() → Figure y los ValueError de geometría ilegal. CI: .github/workflows/tests.yml.

GUI (Streamlit, opcional)

La interfaz no se publica en PyPI. Hay que clonar este repositorio:

python -m pip install -e ".[gui]"
streamlit run streamlit_app.py

Abra http://localhost:8501. Arriba están las páginas Calculadora y Ecuaciones. En la calculadora, los datos quedan a la izquierda y el plano a la derecha, tanto en una armadura precargada como en una propia. La figura con fuerzas y reacciones va centrada, antes del botón Calcular. Ese botón abre el equilibrio y las tablas. Las ecuaciones y el cuerpo libre de cada nudo están en la otra página. La GUI convierte “vertical hacia abajo (+)” a Fy negativa; las ecuaciones salen de ecuaciones(), no se reescriben en la interfaz.

Docker

Cualquier sistema con Docker abre la misma GUI en el navegador (no usa Tkinter). Streamlit escucha en 0.0.0.0:8501.

docker build -t andresperez3/armadura-2d-andresdperezc:0.1.0 .
docker run --rm -p 8501:8501 andresperez3/armadura-2d-andresdperezc:0.1.0

http://localhost:8501

El docker push a Docker Hub (usuario andresperez3) y GitHub Pages: DESPLIEGUE.md.

Documentación (Sphinx)

python -m pip install -e ".[docs]"
sphinx-build -b html docs docs/_build/html
sphinx-build -b rinoh docs docs/_build/rinoh

HTML: docs/_build/html/index.html. PDF: docs/_build/rinoh/armadura-2d-andresdperezc.pdf.

GitHub Pages: Settings → Pages → GitHub Actions (flujo en .github/workflows/pages.yml).

Publicar en PyPI (lo hace el autor)

Paso a paso, primero TestPyPI y luego PyPI: PUBLICAR_PYPI.md.

Solo se instala src/armadura_2d_andresdperezc/. streamlit_app.py, plano_ui.py, tests, docs, Docker y el notebook quedan fuera del wheel. La imagen de Docker sí copia esos dos archivos de la interfaz, porque ahí se abre la misma página.

Limitaciones (0.1.0)

  • Solo 2D e isostáticas. Hiperestática, mecanismo o A singular → ValueError.
  • Cargas solo en nudos. Sin peso propio ni carga distribuida en la barra.
  • Apoyos: un fijo (Rx, Ry) y un móvil. El móvil puede estar en un piso (solo Ry) o en una pared vertical (solo Rx). Sin empotramiento ni rodillo inclinado.
  • Sin pórticos, momento flector, 3D, diámetro, esfuerzo σ = N/A, pandeo ni códigos NSR/AISC.
  • La armadura propia se arma con tablas o con clics en el plano (cuadrícula de 0,5 m, que crece alrededor de los nudos). No es un dibujo a mano alzada.
  • Unidades fijas kN y m.

Si el desarrollo se expande, hay que volver a validarlo.

Futuro (no está en esta versión): diámetro o sección por barra y σ = N/A como postproceso, sin cambiar A x = b. Dibujar la armadura a mano alzada, sin la cuadrícula de 0,5 m, tampoco está. Tampoco hay pesos W ni cuerdas (elementos que solo trabajan a tensión): está anotado para una versión posterior, en la librería y en la imagen Docker, sin cambiar el equilibrio A x = b.

Autor

Andrés David Pérez Criollo — adperezc@udistrital.edu.co

Universidad Distrital Francisco José de Caldas.

Licencia MIT. Ver LICENSE.

Metadata

Release files for armadura-2d-andresdperezc 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for armadura-2d-andresdperezc 0.1.0
File Size Uploaded Provenance Actions
armadura_2d_andresdperezc-0.1.0.tar.gz 27.4 kB Without provenance Details for armadura_2d_andresdperezc-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for armadura-2d-andresdperezc 0.1.0
File Interpreter ABI Platform Actions
armadura_2d_andresdperezc-0.1.0-py3-none-any.whl Python 3 none any Details for armadura_2d_andresdperezc-0.1.0-py3-none-any.whl

Total release size: 46.4 kB

Release files / armadura_2d_andresdperezc-0.1.0.tar.gz

Download URL armadura_2d_andresdperezc-0.1.0.tar.gz
Size 27.4 kB
Tags Source
SHA-256 checksum
How to use checksums
eff9c964e84aa3970fbe144a35e7938d2717c1f3f0f75edf9eb3702e883eba42
BLAKE2b-256 checksum
How to use checksums
7cbe13be14892f74ee00f576913ed4db224c95941b3e4860d529dc47ead1c3c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / armadura_2d_andresdperezc-0.1.0-py3-none-any.whl

Download URL armadura_2d_andresdperezc-0.1.0-py3-none-any.whl
Size 18.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ad4b8fe2c82fa652a024128158d91894f8c5118c0a10fd30e90169069f997a8b
BLAKE2b-256 checksum
How to use checksums
31631d5f606d9ea34e3743b6b46f76782df5c13816deec2a924e27470f8083ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for armadura-2d-andresdperezc 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page