Metadata-Version: 2.4
Name: PyStructMatrix
Version: 1.0.4
Summary: Motor de análisis matricial para estructuras planas (2D)
Author-email: Anshel Chuquiviguel <anshel.chuquiviguel@utec.edu.pe>
License: MIT License
        
        Copyright (c) 2025 Anshel Chuquiviguel Zaña
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSEv2.txt
Requires-Dist: numpy
Requires-Dist: matplotlib
Dynamic: license-file

# PyStructMatrix
Motor de análisis matricial para estructuras planas (2D)

**PyStructMatrix** es una librería en Python para el **análisis estructural en 2D mediante el método matricial**, orientada a pórticos y estructuras de barras.  
Está diseñada con un enfoque **modular, claro y extensible**, ideal tanto para uso académico como profesional.

## Características

✔ Análisis matricial de estructuras 2D  
✔ Elementos tipo barra / pórtico  
✔ Cargas distribuidas y nodales  
✔ Liberaciones de momento  
✔ Visualización básica del modelo  
✔ Código orientado a objetos  

## 📋 Prerrequisitos

Asegúrate de tener instalados los siguientes módulos:

```bash
pip install numpy
pip install matplotlib
```

## 🚀 Instalación

```bash
pip install PyStructMatrix
```

## 📖 Uso

Ejemplo básico:

```python
from PyStructMatrix import StructuralMatrixAnalysis, StructuralPlotter

# Crear el sistema estructural
system = StructuralMatrixAnalysis()

# Visualizar resultados
plotter = StructuralPlotter(system)
```

_Para más ejemplos, consulta el [directorio de ejemplos](https://github.com/anshelcz/PyStructMatrix/edit/main/examples)._

## 🏗️ Componentes principales

### StructuralMatrixAnalysis

Clase principal que gestiona:
- Definición de nodos y elementos
- Ensamblaje de la matriz de rigidez global
- Aplicación de cargas y condiciones de borde
- Resolución del sistema estructural
- Almacenamiento de resultados (desplazamientos, fuerzas internas, reacciones)

### StructuralPlotter

Herramienta de visualización para:
- Geometría estructural
- Numeración de nodos y elementos
- Resultados del análisis (en desarrollo)

## 📊 Funcionalidades

- **Análisis estático lineal** de estructuras planas
- **Soporte para diferentes tipos de elementos**: barras axiales y elementos viga-columna
- **Cargas aplicables**: fuerzas nodales, momentos y cargas distribuidas
- **Condiciones de apoyo**: empotrado, articulado, rodillo
- **Resultados**: desplazamientos, fuerzas internas, reacciones de apoyo
- **Visualización**: gráficos de la estructura antes y después de la deformación

## 📄 Licencia

Distribuido bajo la Licencia MIT. Consulta el archivo `LICENSE` para más información.

## 📧 Contacto

**Autor:** Anshel Chuquiviguel  
**Email:** anshel.chuquiviguel@utec.edu.pe  
