mingmath 0.2.0__tar.gz → 0.3.0__tar.gz

{mingmath-0.2.0 → mingmath-0.3.0}/PKG-INFO

@@ -1,24 +1,33 @@
 Metadata-Version: 2.4
 Name: mingmath
-Version: 0.2.0
-Summary: A Python package for undergraduate mathematics, including Calculus, Linear Algebra, Data Structures, Recursion, OOP, and Scientific Computing.
+Version: 0.3.0
+Summary: A Python package for undergraduate mathematics, including Calculus, Linear Algebra, Data Structures, Recursion, OOP, Scientific Computing, File I/O, Data Visualization, Graph Theory, and Advanced Mathematics.
 Author-email: Thayapan <m.thayapan@gmail.com>
 License: MIT
 License-File: LICENSE
-Keywords: calculus,data structures,linear algebra,mathematics,numpy,recursion,scipy,sympy
+Keywords: calculus,data structures,gmpy2,linear algebra,mathematics,matplotlib,networkx,numpy,oop,pari,plotly,pyvista,recursion,sagemath,scipy,seaborn,sympy
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Education
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Mathematics
 Requires-Python: >=3.8
+Requires-Dist: cypari2
+Requires-Dist: gmpy2
 Requires-Dist: matplotlib
+Requires-Dist: networkx
 Requires-Dist: numpy
+Requires-Dist: plotly
+Requires-Dist: pyvista
 Requires-Dist: scipy
+Requires-Dist: seaborn
 Requires-Dist: sympy
 Description-Content-Type: text/markdown
 
@@ -27,7 +36,9 @@ Description-Content-Type: text/markdown
 MingMath is a Python package for undergraduate mathematics.
 
 It provides functions related to Calculus, Linear Algebra,
-Data Structures, Recursion, OOP, and Scientific Computing.
+Data Structures, String Processing, Recursion, OOP,
+Scientific Computing, File I/O, Data Visualization,
+Graph Theory, and Advanced Mathematics.
 
 ## Features
 
@@ -79,64 +90,48 @@ Data Structures, Recursion, OOP, and Scientific Computing.
 - NumPy
 - SciPy
 - SymPy
-- Matplotlib
-
-## Installation
 
-```bash
-pip install mingmath
-```
+### File I/O
 
-## Usage
+- Write text files
+- Read text files
+- Append text to files
 
-```python
-import mingmath
+### Data Visualization
 
-# Calculus
-print(mingmath.derivative_power(3, 2))
-print(mingmath.definite_integral_power(2, 2, 0, 3))
-print(mingmath.limit_polynomial([1, 2, 3], 2))
-print(mingmath.maclaurin_exp(1))
-print(mingmath.critical_points_quadratic(1, -4, 3))
+- Matplotlib
+- Seaborn
+- Plotly
 
-# Linear Algebra
-A = [[1, 2], [3, 4]]
-B = [[5, 6], [7, 8]]
+### NetworkX
 
-print(mingmath.matrix_add(A, B))
-print(mingmath.matrix_multiply(A, B))
-print(mingmath.determinant_2x2(A))
-print(mingmath.transpose(A))
+- Create graphs
+- Calculate node degrees
+- Find shortest paths
 
-# Data Structures
-print(mingmath.reverse_string("MingMath"))
-print(mingmath.count_vowels("Mathematics"))
-print(mingmath.list_sum([1, 2, 3, 4, 5]))
+### PyVista
 
-# Recursive Functions
-print(mingmath.factorial_recursive(5))
-print(mingmath.fibonacci_recursive(10))
-print(mingmath.fibonacci_memo(10))
+- Create 3D mathematical surfaces
+- Display 3D surfaces
 
-# NumPy
-print(mingmath.numpy_mean([1, 2, 3, 4, 5]))
+### GMPY2
 
-# SymPy
-print(mingmath.sympy_derivative("x**2 + 3*x"))
-print(mingmath.sympy_integral("2*x"))
+- High-precision square root
+- High-precision value of pi
+- High-precision factorial
 
-# SciPy
-print(mingmath.scipy_mean([1, 2, 3, 4, 5]))
+### PARI/GP
 
-# OOP
-number = mingmath.HybridNumber(3)
-print(number.summary())
-```
+- Factorial
+- Integer factorization
+- Greatest common divisor (GCD)
 
-## Version
+### SageMath
 
-Current version: **0.2.0**
+- Check SageMath availability
+- Evaluate mathematical expressions
 
-## License
+## Installation
 
-MIT License
+```bash
+pip install mingmath

mingmath-0.3.0/README.md

@@ -0,0 +1,104 @@
+# MingMath Package
+
+MingMath is a Python package for undergraduate mathematics.
+
+It provides functions related to Calculus, Linear Algebra,
+Data Structures, String Processing, Recursion, OOP,
+Scientific Computing, File I/O, Data Visualization,
+Graph Theory, and Advanced Mathematics.
+
+## Features
+
+### Calculus
+
+- Power rule derivative
+- Definite integral
+- Polynomial limit
+- Maclaurin series
+- Critical points of quadratic functions
+
+### Linear Algebra
+
+- Matrix addition
+- Matrix multiplication
+- Determinant of a 2x2 matrix
+- Matrix transpose
+- Dot product
+
+### Data Structures and String Processing
+
+- String reversal
+- Vowel counting
+- List operations
+- Tuple conversion
+- Dictionary operations
+- Set union
+- Set intersection
+- Exception handling
+
+### Recursive Functions
+
+- Recursive factorial
+- Recursive Fibonacci
+- Fibonacci with memoization
+
+### Object-Oriented Programming
+
+- Class and Object
+- Magic methods
+- Single inheritance
+- Multiple inheritance
+- Multilevel inheritance
+- Hierarchical inheritance
+- Hybrid inheritance
+
+### Scientific Computing
+
+- NumPy
+- SciPy
+- SymPy
+
+### File I/O
+
+- Write text files
+- Read text files
+- Append text to files
+
+### Data Visualization
+
+- Matplotlib
+- Seaborn
+- Plotly
+
+### NetworkX
+
+- Create graphs
+- Calculate node degrees
+- Find shortest paths
+
+### PyVista
+
+- Create 3D mathematical surfaces
+- Display 3D surfaces
+
+### GMPY2
+
+- High-precision square root
+- High-precision value of pi
+- High-precision factorial
+
+### PARI/GP
+
+- Factorial
+- Integer factorization
+- Greatest common divisor (GCD)
+
+### SageMath
+
+- Check SageMath availability
+- Evaluate mathematical expressions
+
+## Installation
+
+```bash
+pip install mingmath

{mingmath-0.2.0 → mingmath-0.3.0}/pyproject.toml

@@ -1,48 +1,72 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "mingmath"
-version = "0.2.0"
-description = "A Python package for undergraduate mathematics, including Calculus, Linear Algebra, Data Structures, Recursion, OOP, and Scientific Computing."
-readme = "README.md"
-requires-python = ">=3.8"
-license = { text = "MIT" }
-
-authors = [
-    { name = "Thayapan", email = "m.thayapan@gmail.com" }
-]
-
-keywords = [
-    "mathematics",
-    "calculus",
-    "linear algebra",
-    "data structures",
-    "recursion",
-    "numpy",
-    "scipy",
-    "sympy"
-]
-
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Education",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-]
-
-dependencies = [
-    "numpy",
-    "scipy",
-    "sympy",
-    "matplotlib"
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/mingmath"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "mingmath"
+version = "0.3.0"
+
+description = "A Python package for undergraduate mathematics, including Calculus, Linear Algebra, Data Structures, Recursion, OOP, Scientific Computing, File I/O, Data Visualization, Graph Theory, and Advanced Mathematics."
+
+readme = "README.md"
+
+requires-python = ">=3.8"
+
+license = { text = "MIT" }
+
+authors = [
+    { name = "Thayapan", email = "m.thayapan@gmail.com" }
+]
+
+keywords = [
+    "mathematics",
+    "calculus",
+    "linear algebra",
+    "data structures",
+    "recursion",
+    "oop",
+    "numpy",
+    "scipy",
+    "sympy",
+    "matplotlib",
+    "seaborn",
+    "plotly",
+    "networkx",
+    "pyvista",
+    "gmpy2",
+    "pari",
+    "sagemath"
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Education",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Education",
+    "Topic :: Scientific/Engineering :: Mathematics"
+]
+
+dependencies = [
+    "numpy",
+    "scipy",
+    "sympy",
+    "matplotlib",
+    "seaborn",
+    "plotly",
+    "networkx",
+    "pyvista",
+    "gmpy2",
+    "cypari2"
+]
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mingmath"]

mingmath-0.3.0/src/mingmath/__init__.py

@@ -0,0 +1,107 @@
+"""
+MingMath - A mathematics package for undergraduate students.
+"""
+
+# Calculus
+from .calculus import (
+    derivative_power,
+    definite_integral_power,
+    limit_polynomial,
+    maclaurin_exp,
+    critical_points_quadratic,
+)
+
+# Linear Algebra
+from .linear import (
+    matrix_add,
+    matrix_multiply,
+    determinant_2x2,
+    transpose,
+    dot_product,
+)
+
+# String Processing and Data Structures
+from .data_structures import (
+    reverse_string,
+    count_vowels,
+    list_sum,
+    tuple_to_list,
+    dictionary_keys,
+    set_union,
+    set_intersection,
+)
+
+# Recursion and OOP
+from .recursive import (
+    factorial_recursive,
+    fibonacci_recursive,
+    fibonacci_memo,
+    Number,
+    PositiveNumber,
+    Printable,
+    AdvancedNumber,
+    ScientificNumber,
+    EvenNumber,
+    HybridNumber,
+)
+
+# NumPy, SciPy, SymPy, Matplotlib
+from .advanced_math import (
+    numpy_mean,
+    numpy_matrix_multiply,
+    numpy_matrix_determinant,
+    sympy_derivative,
+    sympy_integral,
+    scipy_mean,
+    plot_data,
+)
+
+# File I/O
+from .file_io import (
+    write_text_file,
+    read_text_file,
+    append_text_file,
+)
+
+# NetworkX
+from .networkx_functions import (
+    create_graph,
+    graph_degrees,
+    shortest_path,
+)
+
+# Matplotlib, Seaborn, Plotly
+from .visualization import (
+    plot_line,
+    plot_scatter,
+    plot_bar,
+)
+
+# PyVista
+from .pyvista_functions import (
+    create_3d_surface,
+    show_3d_surface,
+)
+
+# GMPY2
+from .gmpy2_functions import (
+    high_precision_sqrt,
+    high_precision_pi,
+    high_precision_factorial,
+)
+
+# PARI/GP
+from .pari_functions import (
+    pari_factorial,
+    pari_factorization,
+    pari_gcd,
+)
+
+# SageMath
+from .sage_functions import (
+    sage_available,
+    sage_calculate,
+)
+
+
+__version__ = "0.3.0"

mingmath-0.3.0/src/mingmath/file_io.py

@@ -0,0 +1,30 @@
+"""
+File I/O functions for reading and writing text files.
+"""
+
+
+def write_text_file(filename, text):
+    """Write text to a file."""
+    try:
+        with open(filename, "w", encoding="utf-8") as file:
+            file.write(text)
+    except OSError as e:
+        raise OSError(f"Cannot write file: {e}")
+
+
+def read_text_file(filename):
+    """Read text from a file."""
+    try:
+        with open(filename, "r", encoding="utf-8") as file:
+            return file.read()
+    except FileNotFoundError:
+        raise FileNotFoundError(f"File not found: {filename}")
+
+
+def append_text_file(filename, text):
+    """Append text to a file."""
+    try:
+        with open(filename, "a", encoding="utf-8") as file:
+            file.write(text)
+    except OSError as e:
+        raise OSError(f"Cannot append to file: {e}")

mingmath-0.3.0/src/mingmath/gmpy2_functions.py

@@ -0,0 +1,23 @@
+"""
+High-precision mathematics functions using GMPY2.
+"""
+
+import gmpy2
+
+
+def high_precision_sqrt(number):
+    """Calculate square root with high precision."""
+    return gmpy2.sqrt(gmpy2.mpfr(number))
+
+
+def high_precision_pi():
+    """Return pi with high precision."""
+    return gmpy2.const_pi()
+
+
+def high_precision_factorial(n):
+    """Calculate factorial using GMPY2."""
+    if n < 0:
+        raise ValueError("n must be non-negative")
+
+    return gmpy2.fac(n)

mingmath-0.3.0/src/mingmath/networkx_functions.py

@@ -0,0 +1,17 @@
+import networkx as nx
+
+
+def create_graph(edges):
+    graph = nx.Graph()
+    graph.add_edges_from(edges)
+    return graph
+
+
+def graph_degrees(edges):
+    graph = create_graph(edges)
+    return dict(graph.degree())
+
+
+def shortest_path(edges, start, end):
+    graph = create_graph(edges)
+    return nx.shortest_path(graph, start, end)

mingmath-0.3.0/src/mingmath/pari_functions.py

@@ -0,0 +1,25 @@
+"""
+Number theory functions using PARI/GP through cypari2.
+"""
+
+from cypari2 import Pari
+
+pari = Pari()
+
+
+def pari_factorial(n):
+    """Calculate factorial using PARI/GP."""
+    if n < 0:
+        raise ValueError("n must be non-negative")
+
+    return pari(f"factorial({n})")
+
+
+def pari_factorization(n):
+    """Factorize an integer using PARI/GP."""
+    return pari(f"factor({n})")
+
+
+def pari_gcd(a, b):
+    """Calculate GCD using PARI/GP."""
+    return pari(f"gcd({a}, {b})")

mingmath-0.3.0/src/mingmath/pyvista_functions.py

@@ -0,0 +1,32 @@
+"""
+PyVista functions for 3D mathematical visualization.
+"""
+
+import numpy as np
+import pyvista as pv
+
+
+def create_3d_surface(x, y, z):
+    """Create a 3D surface from x, y and z data."""
+    x = np.asarray(x)
+    y = np.asarray(y)
+    z = np.asarray(z)
+
+    if x.ndim == 1 and y.ndim == 1:
+        X, Y = np.meshgrid(x, y)
+    else:
+        X, Y = x, y
+
+    if z.shape != X.shape:
+        raise ValueError("z must have the same shape as the mesh grid")
+
+    return pv.StructuredGrid(X, Y, z)
+
+
+def show_3d_surface(x, y, z):
+    """Display a 3D surface."""
+    grid = create_3d_surface(x, y, z)
+
+    plotter = pv.Plotter()
+    plotter.add_mesh(grid)
+    plotter.show()

mingmath-0.3.0/src/mingmath/sage_functions.py

@@ -0,0 +1,26 @@
+"""
+Mathematical functions using SageMath.
+"""
+
+import shutil
+import subprocess
+
+
+def sage_available():
+    """Check whether SageMath is installed."""
+    return shutil.which("sage") is not None
+
+
+def sage_calculate(expression):
+    """Calculate an expression using SageMath."""
+    if not sage_available():
+        raise RuntimeError("SageMath is not installed or not available in PATH")
+
+    result = subprocess.run(
+        ["sage", "-c", f"print({expression})"],
+        capture_output=True,
+        text=True,
+        check=True
+    )
+
+    return result.stdout.strip()

mingmath-0.3.0/src/mingmath/visualization.py

@@ -0,0 +1,31 @@
+"""
+Data visualization functions using Matplotlib, Seaborn and Plotly.
+"""
+
+import matplotlib.pyplot as plt
+import seaborn as sns
+import plotly.express as px
+
+
+def plot_line(x, y):
+    """Create a line plot using Matplotlib."""
+    plt.plot(x, y)
+    plt.xlabel("x")
+    plt.ylabel("y")
+    plt.title("Line Plot")
+    plt.show()
+
+
+def plot_scatter(x, y):
+    """Create a scatter plot using Seaborn."""
+    sns.scatterplot(x=x, y=y)
+    plt.xlabel("x")
+    plt.ylabel("y")
+    plt.title("Scatter Plot")
+    plt.show()
+
+
+def plot_bar(x, y):
+    """Create a bar chart using Plotly."""
+    fig = px.bar(x=x, y=y, title="Bar Chart")
+    fig.show()

mingmath-0.2.0/README.md

@@ -1,118 +0,0 @@
-# MingMath Package
-
-MingMath is a Python package for undergraduate mathematics.
-
-It provides functions related to Calculus, Linear Algebra,
-Data Structures, Recursion, OOP, and Scientific Computing.
-
-## Features
-
-### Calculus
-
-- Power rule derivative
-- Definite integral
-- Polynomial limit
-- Maclaurin series
-- Critical points of quadratic functions
-
-### Linear Algebra
-
-- Matrix addition
-- Matrix multiplication
-- Determinant of a 2x2 matrix
-- Matrix transpose
-- Dot product
-
-### Data Structures and String Processing
-
-- String reversal
-- Vowel counting
-- List operations
-- Tuple conversion
-- Dictionary operations
-- Set union
-- Set intersection
-- Exception handling
-
-### Recursive Functions
-
-- Recursive factorial
-- Recursive Fibonacci
-- Fibonacci with memoization
-
-### Object-Oriented Programming
-
-- Class and Object
-- Magic methods
-- Single inheritance
-- Multiple inheritance
-- Multilevel inheritance
-- Hierarchical inheritance
-- Hybrid inheritance
-
-### Scientific Computing
-
-- NumPy
-- SciPy
-- SymPy
-- Matplotlib
-
-## Installation
-
-```bash
-pip install mingmath
-```
-
-## Usage
-
-```python
-import mingmath
-
-# Calculus
-print(mingmath.derivative_power(3, 2))
-print(mingmath.definite_integral_power(2, 2, 0, 3))
-print(mingmath.limit_polynomial([1, 2, 3], 2))
-print(mingmath.maclaurin_exp(1))
-print(mingmath.critical_points_quadratic(1, -4, 3))
-
-# Linear Algebra
-A = [[1, 2], [3, 4]]
-B = [[5, 6], [7, 8]]
-
-print(mingmath.matrix_add(A, B))
-print(mingmath.matrix_multiply(A, B))
-print(mingmath.determinant_2x2(A))
-print(mingmath.transpose(A))
-
-# Data Structures
-print(mingmath.reverse_string("MingMath"))
-print(mingmath.count_vowels("Mathematics"))
-print(mingmath.list_sum([1, 2, 3, 4, 5]))
-
-# Recursive Functions
-print(mingmath.factorial_recursive(5))
-print(mingmath.fibonacci_recursive(10))
-print(mingmath.fibonacci_memo(10))
-
-# NumPy
-print(mingmath.numpy_mean([1, 2, 3, 4, 5]))
-
-# SymPy
-print(mingmath.sympy_derivative("x**2 + 3*x"))
-print(mingmath.sympy_integral("2*x"))
-
-# SciPy
-print(mingmath.scipy_mean([1, 2, 3, 4, 5]))
-
-# OOP
-number = mingmath.HybridNumber(3)
-print(number.summary())
-```
-
-## Version
-
-Current version: **0.2.0**
-
-## License
-
-MIT License

mingmath-0.2.0/src/mingmath/__init__.py

@@ -1,93 +0,0 @@
-"""
-MingMath Package
-รวมฟังก์ชันเกี่ยวกับ Calculus, Linear Algebra,
-Data Structures, Recursion, OOP และ Scientific Computing
-"""
-
-from .calculus import (
-    derivative_power,
-    definite_integral_power,
-    limit_polynomial,
-    maclaurin_exp,
-    critical_points_quadratic
-)
-
-from .linear import (
-    matrix_add,
-    matrix_multiply,
-    determinant_2x2,
-    transpose,
-    dot_product
-)
-
-from .data_structures import (
-    reverse_string,
-    count_vowels,
-    list_sum,
-    tuple_to_list,
-    dictionary_keys,
-    set_union,
-    set_intersection
-)
-
-from .recursive import (
-    factorial_recursive,
-    fibonacci_recursive,
-    fibonacci_memo,
-    Number,
-    PositiveNumber,
-    Printable,
-    AdvancedNumber,
-    ScientificNumber,
-    EvenNumber,
-    HybridNumber
-)
-
-from .advanced_math import (
-    numpy_mean,
-    numpy_matrix_multiply,
-    numpy_matrix_determinant,
-    sympy_derivative,
-    sympy_integral,
-    scipy_mean,
-    plot_data
-)
-
-__version__ = "0.2.0"
-
-__all__ = [
-    "derivative_power",
-    "definite_integral_power",
-    "limit_polynomial",
-    "maclaurin_exp",
-    "critical_points_quadratic",
-    "matrix_add",
-    "matrix_multiply",
-    "determinant_2x2",
-    "transpose",
-    "dot_product",
-    "reverse_string",
-    "count_vowels",
-    "list_sum",
-    "tuple_to_list",
-    "dictionary_keys",
-    "set_union",
-    "set_intersection",
-    "factorial_recursive",
-    "fibonacci_recursive",
-    "fibonacci_memo",
-    "Number",
-    "PositiveNumber",
-    "Printable",
-    "AdvancedNumber",
-    "ScientificNumber",
-    "EvenNumber",
-    "HybridNumber",
-    "numpy_mean",
-    "numpy_matrix_multiply",
-    "numpy_matrix_determinant",
-    "sympy_derivative",
-    "sympy_integral",
-    "scipy_mean",
-    "plot_data"
-]