diff --git a/README.es-ES.md b/README.es-ES.md new file mode 100644 index 0000000..0849eb1 --- /dev/null +++ b/README.es-ES.md @@ -0,0 +1,114 @@ + + +
+
+
+
+
+[](https://badge.fury.io/py/numeth)
+[](https://pypistats.org/packages/numeth)
+[](https://github.com/AbhisumatK/numeth-Numerical-Methods-Library/blob/main/LICENSE)
+
+# numeth
+
+Un paquete de Python totalmente funcional que implementa métodos numéricos fundamentales para ingeniería y matemáticas aplicadas. Diseñado para la usabilidad y la claridad educativa.
+
+## Instalación
+
+Instalar mediante pip:
+
+```
+pip install numeth
+```
+
+## Inicio Rápido
+
+Este es un ejemplo sencillo que utiliza el método de Newton-Raphson para encontrar la raíz cuadrada de 2:
+
+```python
+from numeth import newton_raphson
+
+def f(x):
+ return x**2 - 2
+
+def df(x):
+ return 2 * x
+
+root, iterations, converged = newton_raphson(f, df, x0=1.0, tol=1e-6, max_iter=100)
+print(f"Root: {root}, Iterations: {iterations}, Converged: {converged}")
+# Output: Root: 1.414213562373095, Iterations: 4, Converged: True
+```
+
+## Visualización
+
+Puede visualizar fácilmente la convergencia o los resultados de cualquier método numérico utilizando el método `.graph()`.
+
+```python
+import numeth
+
+# Integration visualization
+tr = numeth.trapezoidal(lambda x: x**2, 0, 1)
+tr.graph()
+
+# Root finding visualization
+sol = numeth.bisection(lambda x: x**2 - 2, 0, 2)
+sol.graph()
+```
+
+El método `.graph()` proporciona una representación visual de cómo funciona el algoritmo, incluyendo gráficos de funciones, áreas de integración, marcadores de raíces y líneas tangentes para diferenciación.
+
+### Métodos compatibles para visualización
+Actualmente, la visualización es compatible con casi todos los módulos:
+- **Integración**: Todos los métodos compatibles.
+- **Búsqueda de raíces**: Todos los métodos compatibles.
+- **Diferenciación**: Todos los métodos compatibles.
+- **Interpolación**: Todos los métodos compatibles.
+- **Optimización**: Todos los métodos compatibles.
+
+*Nota: Los métodos de Álgebra Lineal (Eliminación de Gauss, Descomposición LU, Jacobi, Gauss-Seidel) actualmente no son compatibles con `.graph()` porque operan sobre vectores/matrices en lugar de funciones de una sola variable.*
+
+
+
+## Métodos compatibles
+
+### Integración
+- Regla del trapecio (simple y compuesta)
+- Regla de Simpson 1/3 (simple y compuesta)
+- Regla de Simpson 3/8
+- Cuadratura de Gauss (de 2 y 3 puntos)
+
+### Diferenciación
+- Diferencia hacia adelante (primera derivada)
+- Diferencia hacia atrás (primera derivada)
+- Diferencia central (primera derivada)
+- Diferencia central (segunda derivada)
+- Extrapolación de Richardson (primera derivada)
+
+### Búsqueda de raíces
+- Método de bisección
+- Método de Newton-Raphson
+- Método de la secante
+- Método de la posición falsa
+
+### Interpolación
+- Interpolación lineal
+- Interpolación de Lagrange
+- Interpolación por diferencias divididas de Newton
+
+### Álgebra lineal
+- Eliminación de Gauss con pivoteo parcial
+- Descomposición LU (método de Doolittle)
+- Método iterativo de Jacobi
+- Método iterativo de Gauss-Seidel
+
+### Optimización
+- Búsqueda de la sección áurea (minimización)
+- Método de Newton para optimización (1D)
+
+## Cómo contribuir o reportar problemas
+
+¡Las contribuciones son bienvenidas! Por favor, envíe solicitudes de extracción (pull requests) o abra issues en el [repositorio de GitHub](https://github.com/AbhisumatK/numeth-Numerical-Methods-Library).
+
+## Licencia
+
+Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo [LICENSE](https://github.com/AbhisumatK/numeth-Numerical-Methods-Library/blob/main/LICENSE) para obtener más detalles.