py-math-ext 1.0.0__tar.gz

py_math_ext-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Neo Östlund Zetterberg
+
+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.

py_math_ext-1.0.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: py-math-ext
+Version: 1.0.0
+Summary: A Hybrid Symbolic-Numeric Mathematics Engine
+Author-email: Neo Östlund Zetterberg <20091103neo@gmail.com>
+Project-URL: Homepage, https://github.com/NeoZett-School/Math-Extention
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Math-Extension
+**A Hybrid Symbolic-Numeric Mathematics Engine for Python.**
+
+`Math-Extention` is a powerful library designed to bridge the gap between simple numerical calculators and complex symbolic engines. By using a **Traceable** architecture, it remembers how a formula was built, allowing for automatic differentiation, multi-variable systems solving, and advanced regression—all while maintaining high-speed numerical performance through a custom Matrix core.
+
+## 🚀 Key Features
+* **Symbolic Traceability**: Every operation is stored in a tree, allowing for `f.diff(x)` (Recursive Automatic Differentiation).
+* **Advanced Regressions**: Linear, Polynomial, Exponential, Logarithmic, Power, and Multiple Linear Regression with $R^2$ validation.
+* **Omniscient Root Finding**: Automatically detects polynomial degrees and calculates search ranges using Cauchy's Bound—no more manual guessing.
+* **Non-Linear System Solver**: Solves systems of equations using a Jacobian-based multi-variable Newton-Raphson method.
+* **Matrix Core**: Pure-Python implementation featuring Gaussian Elimination with Partial Pivoting, Inversion, and Determinants.
+
+---
+
+## 🛠 Installation & Setup
+
+To use this in your project, clone the repository:
+
+```batch
+git clone https://github.com/NeoZett-School/Math-Extention.git
+```
+
+---
+
+## 📖 Quick Start Examples
+
+### 1. Symbolic Differentiation & "Smart" Solving
+Solve for the roots of a cubic function. The solver automatically detects the degree (3) and sets the search range using Cauchy's Bound.
+
+```python
+from math_extention import Canvas, Symbol, Function, Solver
+
+canvas = Canvas()
+x = Symbol('x')
+
+f = Function('x', x**3 - 6*x**2 + 9*x + 15)
+
+# The solver investigates the complexity of 'f' and finds all real roots
+roots = Solver.solve_all(f, target=0, symbol=x)
+print(f"Roots of {f.written}: {roots}")
+```
+
+### 2. Solving Non-Linear Systems (Jacobian Method)
+Find the intersection points of a unit circle and a diagonal line.
+
+```python
+from math_extention import Canvas, Symbol, RegressionPoly
+
+canvas = Canvas()
+x = Symbol("x")
+
+data = [(0, 1), (1, 2.1), (2, 3.9), (3, 9.2)]
+reg = RegressionPoly(data, degree=2)
+
+coeffs = reg.calculate() # Returns [a0, a1, a2]
+accuracy = reg.r_squared() # Returns the Coefficient of Determination
+
+print(f"Model: {reg.create_function('x').written}")
+print(f"R^2 Accuracy: {accuracy:.4f}")
+```
+
+### 3. Data Regression & Goodness of Fit ($R^2$)
+Fit a polynomial to data and verify the accuracy of the model.
+
+```python
+from math_extention import Canvas, Symbol, RegressionPoly
+
+canvas = Canvas()
+x = Symbol("x")
+
+data = [(0, 1), (1, 2.1), (2, 3.9), (3, 9.2)]
+reg = RegressionPoly(data, degree=2)
+
+coeffs = reg.calculate() # Returns [a0, a1, a2]
+accuracy = reg.r_squared() # Returns the Coefficient of Determination
+
+print(f"Model: {reg.create_function('x').written}")
+print(f"R^2 Accuracy: {accuracy:.4f}")
+```
+
+---
+
+## 🧪 Technical Architecture
+
+### The `Traceable` Object
+Unlike standard Python floats, a `Traceable` object stores its "history." When you perform `x * 2`, it returns a new object that knows its operator was `*` and its parents were `x` and `2`. This allows the engine to perform the **Chain Rule** recursively for differentiation:
+* **Power Rule**: Handles $x^n$.
+* **Exponential Rule**: Handles $a^x$.
+* **General Power Rule**: Handles $f(x)^{g(x)}$.
+
+### The `Matrix` Engine
+The `Matrix` class handles the heavy lifting for regressions and system solving.
+* **Partial Pivoting**: Ensures numerical stability by selecting the largest available pivot.
+* **Normal Equations**: Used in all regression classes to solve $(X^T X)\beta = X^T Y$.
+
+---
+
+## 📈 Roadmap
+- [x] Trigonometric support (`sin`, `cos`, `tan`).
+- [x] Automatic Complexity (Degree) Detection.
+- [x] Multiple Linear Regression.
+- [ ] LaTeX String Exporting for documentation.
+- [ ] Residual Analysis Plotting.
+
+---

py_math_ext-1.0.0/README.md

@@ -0,0 +1,105 @@
+# Math-Extension
+**A Hybrid Symbolic-Numeric Mathematics Engine for Python.**
+
+`Math-Extention` is a powerful library designed to bridge the gap between simple numerical calculators and complex symbolic engines. By using a **Traceable** architecture, it remembers how a formula was built, allowing for automatic differentiation, multi-variable systems solving, and advanced regression—all while maintaining high-speed numerical performance through a custom Matrix core.
+
+## 🚀 Key Features
+* **Symbolic Traceability**: Every operation is stored in a tree, allowing for `f.diff(x)` (Recursive Automatic Differentiation).
+* **Advanced Regressions**: Linear, Polynomial, Exponential, Logarithmic, Power, and Multiple Linear Regression with $R^2$ validation.
+* **Omniscient Root Finding**: Automatically detects polynomial degrees and calculates search ranges using Cauchy's Bound—no more manual guessing.
+* **Non-Linear System Solver**: Solves systems of equations using a Jacobian-based multi-variable Newton-Raphson method.
+* **Matrix Core**: Pure-Python implementation featuring Gaussian Elimination with Partial Pivoting, Inversion, and Determinants.
+
+---
+
+## 🛠 Installation & Setup
+
+To use this in your project, clone the repository:
+
+```batch
+git clone https://github.com/NeoZett-School/Math-Extention.git
+```
+
+---
+
+## 📖 Quick Start Examples
+
+### 1. Symbolic Differentiation & "Smart" Solving
+Solve for the roots of a cubic function. The solver automatically detects the degree (3) and sets the search range using Cauchy's Bound.
+
+```python
+from math_extention import Canvas, Symbol, Function, Solver
+
+canvas = Canvas()
+x = Symbol('x')
+
+f = Function('x', x**3 - 6*x**2 + 9*x + 15)
+
+# The solver investigates the complexity of 'f' and finds all real roots
+roots = Solver.solve_all(f, target=0, symbol=x)
+print(f"Roots of {f.written}: {roots}")
+```
+
+### 2. Solving Non-Linear Systems (Jacobian Method)
+Find the intersection points of a unit circle and a diagonal line.
+
+```python
+from math_extention import Canvas, Symbol, RegressionPoly
+
+canvas = Canvas()
+x = Symbol("x")
+
+data = [(0, 1), (1, 2.1), (2, 3.9), (3, 9.2)]
+reg = RegressionPoly(data, degree=2)
+
+coeffs = reg.calculate() # Returns [a0, a1, a2]
+accuracy = reg.r_squared() # Returns the Coefficient of Determination
+
+print(f"Model: {reg.create_function('x').written}")
+print(f"R^2 Accuracy: {accuracy:.4f}")
+```
+
+### 3. Data Regression & Goodness of Fit ($R^2$)
+Fit a polynomial to data and verify the accuracy of the model.
+
+```python
+from math_extention import Canvas, Symbol, RegressionPoly
+
+canvas = Canvas()
+x = Symbol("x")
+
+data = [(0, 1), (1, 2.1), (2, 3.9), (3, 9.2)]
+reg = RegressionPoly(data, degree=2)
+
+coeffs = reg.calculate() # Returns [a0, a1, a2]
+accuracy = reg.r_squared() # Returns the Coefficient of Determination
+
+print(f"Model: {reg.create_function('x').written}")
+print(f"R^2 Accuracy: {accuracy:.4f}")
+```
+
+---
+
+## 🧪 Technical Architecture
+
+### The `Traceable` Object
+Unlike standard Python floats, a `Traceable` object stores its "history." When you perform `x * 2`, it returns a new object that knows its operator was `*` and its parents were `x` and `2`. This allows the engine to perform the **Chain Rule** recursively for differentiation:
+* **Power Rule**: Handles $x^n$.
+* **Exponential Rule**: Handles $a^x$.
+* **General Power Rule**: Handles $f(x)^{g(x)}$.
+
+### The `Matrix` Engine
+The `Matrix` class handles the heavy lifting for regressions and system solving.
+* **Partial Pivoting**: Ensures numerical stability by selecting the largest available pivot.
+* **Normal Equations**: Used in all regression classes to solve $(X^T X)\beta = X^T Y$.
+
+---
+
+## 📈 Roadmap
+- [x] Trigonometric support (`sin`, `cos`, `tan`).
+- [x] Automatic Complexity (Degree) Detection.
+- [x] Multiple Linear Regression.
+- [ ] LaTeX String Exporting for documentation.
+- [ ] Residual Analysis Plotting.
+
+---

py_math_ext-1.0.0/math_extension/__init__.py

@@ -0,0 +1,11 @@
+"""Math Extention allow symbols as variables and expressions, functions to use in different type of regression."""
+
+from sys import version_info
+from warnings import warn
+if version_info < (3, 10):
+    warn(
+        message = "Math Extention expects a python version >=3.10",
+        category = RuntimeWarning
+    )
+from .core import *
+__all__ = core.__all__

py_math_ext-1.0.0/math_extension/__init__.pyi

@@ -0,0 +1,2 @@
+from .core import *
+__all__ = core.__all__