PyPyNum 1.17.0__tar.gz → 1.17.1__tar.gz

{pypynum-1.17.0 → pypynum-1.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyPyNum
-Version: 1.17.0
+Version: 1.17.1
 Summary: PyPyNum is a Python library for math & science computations, covering algebra, calculus, stats, with data structures like matrices, vectors, tensors. It offers numerical tools, programs, and supports computational ops, functions, processing, simulation, & visualization in data science & ML, crucial for research, engineering, & data processing.
 Home-page: https://github.com/PythonSJL/PyPyNum
 Author: Shen Jiayi
@@ -671,12 +671,11 @@ Keywords: math,数学,mathematics,数学计算,numerical,数值,computation,计
 Requires-Python: >=3.4
 Description-Content-Type: text/markdown
 
-# <font color = blue>PyPyNum</font>
+# PyPyNum
 
-<font color = gree>PyPyNum is a Python library for math & science computations, covering algebra, calculus, stats, with
-data structures like matrices, vectors, tensors. It offers numerical tools, programs, and supports computational ops,
-functions, processing, simulation, & visualization in data science & ML, crucial for research, engineering, & data
-processing.</font><font color = red>[Python>=3.4]</font>
+PyPyNum is a multifunctional Python math lib. It includes modules for math, data analysis, array ops, crypto, physics,
+randomness, data prep, stats, solving eqns, image processing, interp, matrix calc, and high-precision math. Designed for
+scientific computing, data science, and machine learning, PyPyNum provides efficient and versatile tools.
 
 ```
  ________   ___    ___  ________   ___    ___  ________    ___  ___   _____ ______
@@ -693,7 +692,7 @@ processing.</font><font color = red>[Python>=3.4]</font>
 [![Downloads](https://static.pepy.tech/badge/pypynum/month)](https://pepy.tech/project/pypynum)
 [![Downloads](https://static.pepy.tech/badge/pypynum/week)](https://pepy.tech/project/pypynum)
 
-## Version -> 1.17.0 | PyPI -> https://pypi.org/project/PyPyNum/ | Gitee -> https://www.gitee.com/PythonSJL/PyPyNum | GitHub -> https://github.com/PythonSJL/PyPyNum
+## Version -> 1.17.1 | PyPI -> https://pypi.org/project/PyPyNum/ | Gitee -> https://www.gitee.com/PythonSJL/PyPyNum | GitHub -> https://github.com/PythonSJL/PyPyNum
 
 ![LOGO](PyPyNum.png)
 
@@ -825,138 +824,71 @@ Python interpreter and run it!
 ```
 !=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
 
-The current version has correctly implemented the SVD function
-for matrix singular value decomposition
-
-The functions "lower_gamma" and "upper_gamma" have been renamed
-to "lowergamma" and "uppergamma", respectively
-
-Rename the submodule "quats" to "hypcmpnms" which means
-"hypercomplex numbers"
-
-Fixed calculation errors that existed before the quaternion
-class
-
-Fixed the issue caused by name change in the "pprint_matrix"
-function
-
-(Of course, other features have also undergone minor
-modifications, and the effect may differ from previous versions)
-
-!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
-
-The following are newly added functions or classes:
-
-(These functions have been tested multiple times and no issues
-have been found so far. If there are any problems, please
-contact me promptly.)
-
-!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
-
-Octonion(s: typing.Union[int, float], t: typing.Union[int,
-float], u: typing.Union[int, float], v: typing.Union[int,
-float], w: typing.Union[int, float], x: typing.Union[int,
-float], y: typing.Union[int, float], z: typing.Union[int,
-float])
-
-This is an octonion class, with many operational functions for
-octonions. Octonions are an eight-dimensional extension of
-complex numbers, initially introduced by John T. Graves in 1843.
-Characterized by their non-associative nature, they consist of
-seven imaginary units, denoted as i, j, k, l, m, n, and o. These
-entities are applied in physics and computer graphics, albeit
-their non-associativity constraint hinders their extensive
-computational utilization.
-
-Example:
-
-o = Octonion(1, 2, 3, 4, 5, 6, 7, 8)
-o = (1+2i+3j+4k+5l+6m+7n+8o)
-o * o = (-202+4i+6j+8k+10l+12m+14n+16o)
-round(o.inverse(), 6) = (0.004902-0.009804i-0.014706j-0.019608k-0.02451l-0.029412m-0.034314n-0.039216o)
-round(o * o.inverse(), 16) = (1.0+0.0i+0.0j+0.0k+0.0l+0.0m+0.0n-0.0o)
-round(o / o, 16) = (1.0+0.0i+0.0j+0.0k+0.0l+0.0m+0.0n-0.0o)
-
-Provides a good function `octo` for creating Octonion classes.
-
-octo(s: real = 0, t: real = 0, u: real = 0, v: real = 0, w: real
-= 0, x: real = 0, y: real = 0, z: real = 0) -> Octonion
-
-!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
-
-diag_indices(n: <class 'int'>, k: <class 'int'>, m: <class
-'int'>) -> <class 'tuple'>
-
-This function computes the indices for the k-th diagonal in an n
-x m matrix. It returns a tuple of two tuples, each containing a
-sequence of integers representing the row and column indices,
-respectively, for the k-th diagonal in the matrix. The first
-tuple corresponds to the row indices, and the second to the
-column indices. The value of k indicates the diagonal: k=0 for
-the main diagonal, k>0 for diagonals above the main diagonal,
-and k<0 for diagonals below.
-
-diag(v: typing.Any, k: <class 'int'>, n: <class 'int'>, m:
-<class 'int'>) -> typing.Any
-
-This function performs dual operations similar to the NumPy
-`diag` function: 1. When `v` is a sequence, it constructs a
-diagonal matrix by placing the elements of `v` on the k-th
-diagonal. 2. When `v` is a matrix, it extracts the elements from
-the k-th diagonal and returns them as a 1D sequence. The
-argument `k` specifies the diagonal to be operated on, where k=0
-refers to the main diagonal, k>0 identifies diagonals above the
-main, and k<0 identifies diagonals below the main diagonal.
-
-!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
-
-damerau(x: typing.Union[list, tuple, str], y: typing.Union[list,
-tuple, str]) -> <class 'int'>
-
-Calculate the Damerau-Levenshtein
-distance between two sequences. The Damerau-Levenshtein distance
-is a measure of the difference between two sequences. It is an
-extension of the Levenshtein distance that allows transpositions
-(i.e., swapping two adjacent characters) to be considered as a
-single edit operation. This function supports any type of
-iterable sequences, such as strings, lists, or tuples.
-Example:
->>> damerau("ensure", "nester")
-3
-
-strip_helper(sequence: typing.Any, keys_set: <class 'set'>,
-strip_start: <class 'bool'>, strip_end: <class 'bool'>) ->
-typing.Any
-
-Removes elements from the start and/or
-end of a sequence that match the specified keys.
-Example:
->>> strip_helper([1, 2, 3, 4, 5, 1, 2], {1, 2}, True, True)
-[3, 4, 5]
-
-strip(sequence: typing.Any, keys: typing.Any) -> typing.Any
-
-Removes elements from both the start and
-end of a sequence that match the specified keys.
-Example:
->>> strip([1, 2, 3, 4, 5, 1, 2], [1, 2])
-[3, 4, 5]
-
-lstrip(sequence: typing.Any, keys: typing.Any) -> typing.Any
-
-Removes elements from the start of a
-sequence that match the specified keys.
-Example:
->>> lstrip([1, 2, 3, 4, 5, 1, 2], [1, 2])
-[3, 4, 5, 1, 2]
-
-rstrip(sequence: typing.Any, keys: typing.Any) -> typing.Any
-
-Removes elements from the end of a
-sequence that match the specified keys.
-Example:
->>> rstrip([1, 2, 3, 4, 5, 1, 2], [1, 2])
-[1, 2, 3, 4, 5]
+The `pypynum.images` module
+now encompasses three classes,
+expanding its image processing functionality.
+The original `PNG` class
+has been transformed to be based on
+the `BaseImage` class.
+This update includes a specific fix
+for the `read` method in `PNG`,
+addressing issues with reading
+large images.
+1. `BaseImage`: A foundational class
+for image processing, offering
+basic methods like image creation,
+pixel access, and metadata retrieval.
+2. `BMP`: A subclass of `BaseImage`,
+tailored for BMP image handling,
+providing specialized BMP functionalities.
+3. `PNG`: The `PNG` class, now built on
+`BaseImage`, with an improved `read`
+method that solves the problem of
+reading large PNG files.
+This fix to the `read` method in `PNG`
+ensures efficient processing of large images,
+maintaining image quality and integrity.
+The module's enhanced capabilities
+make it more robust and user-friendly
+for handling substantial PNG files.
+
+
+<<< The following are some usage examples >>>
+
+
+# Import BMP and PNG classes
+from pypynum import BMP, PNG
+
+# Instantiate BMP class
+bmp_image = BMP()
+# Instantiate a BMP image with specified dimensions and color
+bmp_image.new(width=100, height=100, color=(255, 0, 0), color_mode="RGB", bit_depth=8)
+# Set pixel color at (50, 50) to blue
+bmp_image[50, 50] = (0, 0, 255)
+# Save the BMP image
+bmp_image.write("output_bmp.bmp")
+# Instantiate PNG class
+png_image = PNG()
+# Instantiate a PNG image with specified dimensions and color
+png_image.new(width=100, height=100, color=(0, 255, 0), color_mode="RGB", bit_depth=8)
+# Set pixel color at (50, 50) to yellow
+png_image[50, 50] = (255, 255, 0)
+# Save the PNG image
+png_image.write("output_png.png")
+# Create BMP reader to read the BMP image
+bmp_reader = BMP()
+# Read the BMP image from the file
+bmp_reader.read("output_bmp.bmp")
+# Print the BMP image and pixel at (50, 50)
+print("BMP Image:", bmp_reader)
+print("BMP Pixel at (50, 50):", bmp_reader[50, 50])
+# Create PNG reader to read the PNG image
+png_reader = PNG()
+# Read the PNG image from the file
+png_reader.read("output_png.png")
+# Print the PNG image and pixel at (50, 50)
+print("PNG Image:", png_reader)
+print("PNG Pixel at (50, 50):", png_reader[50, 50])
 
 !=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=!=
 ```
@@ -994,7 +926,7 @@ PyPyNum
 │       ├── asarray(data: Any) -> Any
 │       ├── aslist(data: Any) -> Any
 │       ├── boolarray(data: Any) -> Any
-│       ├── fill(shape: typing.Union[list, tuple], sequence: typing.Union[list, tuple], repeat: bool, pad: typing.Any, rtype: typing.Callable) -> typing.Any
+│       ├── fill(shape: typing.Union[list, tuple], sequence: typing.Union[list, tuple, str], repeat: bool, pad: typing.Any, rtype: typing.Callable) -> typing.Any
 │       ├── full(shape: typing.Union[list, tuple], fill_value: typing.Any, rtype: typing.Callable) -> typing.Any
 │       ├── full_like(a: typing.Any, fill_value: typing.Any, rtype: typing.Callable) -> typing.Any
 │       ├── get_shape(data: Any) -> Any
@@ -1131,7 +1063,9 @@ PyPyNum
 │       └── quat(w: typing.Union[int, float], x: typing.Union[int, float], y: typing.Union[int, float], z: typing.Union[int, float]) -> pypynum.hypcmpnms.Quaternion
 ├── images
 │   ├── CLASS
-│   │   └── PNG(object)/__init__(self: Any) -> None
+│   │   ├── BMP(pypynum.images.BaseImage)/__init__(self: Any) -> None
+│   │   ├── BaseImage(object)/__init__(self: Any) -> None
+│   │   └── PNG(pypynum.images.BaseImage)/__init__(self: Any) -> None
 │   └── FUNCTION
 │       └── crc(data: Any, length: Any, init: Any, xor: Any) -> Any
 ├── interp
@@ -1674,7 +1608,7 @@ PyPyNum
 ### Code Testing
 
 ```python
-from pypynum import (arrays, geoms, hypcmpnms, logics, matrices, symbols, tensors, vectors,
+from pypynum import (arrays, geoms, hypcmpnms, logics, matrices, multiprec, special, vectors,
                      ciphers, consts, equations, maths, plotting, random, regs, tools)
 
 ...
@@ -1765,48 +1699,46 @@ print(m1.rank())
 2
 """
 
-print(symbols.BASIC)
-print(symbols.ENGLISH)
-print(symbols.GREEK)
-print(symbols.parse_expr("-(10+a-(3.14+b0)*(-5))**(-ζn1-2.718/mΣ99)//9"))
+mp_complex1 = multiprec.MPComplex("1.4142135623730950488016887242096980785696718753769",
+                                  "2.7182818284590452353602874713527", sigfigs=30)
+mp_complex2 = multiprec.MPComplex("1.7320508075688772935274463415059",
+                                  "3.141592653589793238462643383279502884197169399375105820974944", sigfigs=40)
+modulus = mp_complex1.modulus(sigfigs=25)
+print("Modulus of the complex1:", modulus)
+sqrt_complex = mp_complex2.sqrt()
+print("Square root of the complex2:", sqrt_complex)
+power_result = mp_complex1 ** mp_complex2
+print("Power of complex1 raised to complex2:", power_result)
+euler_gamma = multiprec.mp_euler_gamma(sigfigs=45)
+print("Value of Euler's gamma constant:", euler_gamma)
+log_2 = multiprec.mp_log(2, 10, sigfigs=50)
+print("Logarithm of 2 (base 10):", log_2)
+exp_e_squared = multiprec.mp_exp(multiprec.mp_e() ** 2, sigfigs=20)
+print("Value of exp(e^2):", exp_e_squared)
 
 """
-%()*+-./0123456789
-ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
-C:\Users\Administrator\PycharmProjects\pythonProject\pypynum\tensors.py:16: FutureWarning: The 'Tensor' class is deprecated and will be removed in a future version. Please use the 'Array' class instead for similar functionality.
-  warn("The 'Tensor' class is deprecated and will be removed in a future version. "
-ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρστυφχψω
-[['10', '+', 'a', '-', ['3.14', '+', 'b0'], '*', '-5'], '**', ['-ζn1', '-', '2.718', '/', 'mΣ99'], '//', '9']
+Modulus of the complex1: 3.064156670102011971734464
+Square root of the complex2: 1.630869996965458756791024890326755654659+0.9631646481434200567938527724670041364524i
+Power of complex1 raised to complex2: 0.144632311554759549910373681031-0.17337039786352194417298867399i
+Value of Euler's gamma constant: 0.577215664901532860606512090082402431042159336
+Logarithm of 2 (base 10): 0.30102999566398119521373889472449302676818988146211
+Value of exp(e^2): 1618.1779919126535017
 """
 
-t0 = tensors.ten([[[1, 2], [3, 4]], [[5, 6], [7, 8]]])
-t1 = tensors.ten([[[9, 10], [11, 12]], [[13, 14], [15, 16]]])
-print(t0)
-print(t1)
-print(t0 + t1)
-print(t0 @ t1)
+print("Bessel Function of the first kind, order 0 at x=1:", special.besselj0(1))
+print("Modified Bessel function of the first kind, order 1 at x=1:", special.besseli1(1))
+print("Hypergeometric function 0F1 at z=0.5 with b0=1:", special.hyp0f1(1, 0.5))
+print("Hypergeometric function 1F1 at z=1 with a0=1, b0=1:", special.hyp1f1(1, 1, 1))
+print("q-Pochhammer Symbol with a=2+1j, q=0.5+0.1j, n=2+1j:", special.qpochhammer(2 + 1j, 0.5 + 0.1j, 2 + 1j))
+print("q-Gamma Function at n=2 with q=0.5+0.1j:", special.qgamma(2, 0.5 + 0.1j))
 
 """
-[[[1 2]
-  [3 4]]
-
- [[5 6]
-  [7 8]]]
-[[[ 9 10]
-  [11 12]]
-
- [[13 14]
-  [15 16]]]
-[[[10 12]
-  [14 16]]
-
- [[18 20]
-  [22 24]]]
-[[[ 31  34]
-  [ 71  78]]
-
- [[155 166]
-  [211 226]]]
+Bessel Function of the first kind, order 0 at x=1: 0.7651976865579666
+Modified Bessel function of the first kind, order 1 at x=1: 0.565159103992485
+Hypergeometric function 0F1 at z=0.5 with b0=1: 1.5660829297563503
+Hypergeometric function 1F1 at z=1 with a0=1, b0=1: 2.7182818284590455
+q-Pochhammer Symbol with a=2+1j, q=0.5+0.1j, n=2+1j: (-0.33353429405776575+1.8573191887407854j)
+q-Gamma Function at n=2 with q=0.5+0.1j: (0.9999999999999989-4.953510875709033e-16j)
 """
 
 string = "PyPyNum"
@@ -1983,10 +1915,10 @@ print(random.randint(0, 9, [2, 3, 4]))
 print(random.uniform(0, 9, [2, 3, 4]))
 
 """
-[[[0.4847228830212484, 0.21191111573518406, 0.5373857787327614, -0.8093138913140422], [-0.7011162169944548, -0.9912705888373583, 0.7186439322555127, -0.2274581920158257], [1.3914572485772865, 0.7075164958432888, 0.7592813432866642, 0.035360908326509295]], [[-0.015103635361811502, 0.2260790803894067, -0.0479692229109478, -0.18601862902940933], [1.2607730202510887, -1.3885699518983425, 0.6662735518373, 0.31158223208478136], [-0.6163262301739749, 0.45335816472937096, -0.3099931166324452, 0.33766139602898054]]]
-[[[0.9908387599158799, 0.21201658430651493, 0.9437298457409969, 0.05879243950811597], [0.5031188669965702, 0.4848728511699505, 0.01579620200535503, 0.45437774795329555], [0.25978581761821773, 0.8368846886830117, 0.305587930563909, 0.25483467458201103]], [[0.9555384002609535, 0.4956682731616203, 0.2577575820069856, 0.42012684095465547], [0.7236210201681477, 0.20749387839946765, 0.41822591597474046, 0.3049876771209371], [0.5482188347875343, 0.9725069497850535, 0.0009136275067901378, 0.6566715689489501]]]
-[[[0, 8, 3, 1], [0, 8, 6, 8], [6, 0, 4, 6]], [[3, 0, 3, 5], [7, 1, 4, 4], [6, 5, 6, 7]]]
-[[[0.5283612378290214, 7.262524059790431, 7.772626276903747, 5.054257930459873], [4.346895596478688, 4.245631516109806, 1.4873778244242264, 0.21200334989526515], [5.560169637820303, 7.944316673669743, 1.142117411431089, 4.0928173218897665]], [[1.5511337413790796, 3.9871009562400013, 6.859553134546862, 6.823314677935608], [6.528323813176091, 2.1511397393620104, 2.207094001588672, 7.546888086887966], [8.716377217873646, 5.754127816115938, 8.725415670845436, 8.033482314572911]]]
+[[[0.19564108603837504, 1.01920370166293, -0.0432622197313817, 1.8767392228517594], [-0.9372140720220945, 0.6455939848661518, 0.06219926062283103, -0.03646501719525719], [-0.6575861228704779, -1.627831653990843, 1.4669927522358261, -2.1082184047042944]], [[-0.4550416369776341, 0.5921202822490813, 0.1393176939653395, -0.1994214479986489], [-0.559257919413219, -1.629764620332396, 0.04658277611512766, 0.20529751771180757], [0.492656546311569, 0.9731757491363898, -0.3281597719355017, -0.6855996837842998]]]
+[[[0.9897608447208633, 0.9091539554606014, 0.839742901348473, 0.7483640950392159], [0.1271954637618754, 0.23914774960655272, 0.6603167703557995, 0.09706202212722614], [0.1020987366479954, 0.16628877700140854, 0.9844464087410161, 0.8213963537473721]], [[0.268434775377716, 0.8021623176316018, 0.48319517625501174, 0.30410149780944096], [0.8970313978138931, 0.9980790184879383, 0.1185467392465952, 0.19570961919567464], [0.08626090792820118, 0.5790211560246683, 0.7475290741004703, 0.8048613204213184]]]
+[[[9, 0, 7, 5], [2, 7, 3, 5], [7, 6, 4, 2]], [[3, 4, 2, 0], [4, 2, 2, 1], [4, 5, 4, 9]]]
+[[[8.067902792666303, 3.1398970785364244, 7.875028237778611, 7.766921948037462], [3.337337214716076, 2.852783099370506, 1.028257336777862, 7.822605535085232], [7.111199916783942, 5.890725764603359, 3.038605829888671, 6.272148674191553]], [[1.076715403659712, 6.806086377982102, 5.699002266942416, 1.1654651363361368], [1.3920577362733448, 8.527352563852686, 2.359964996027981, 5.183071574749471], [7.8250627862940725, 1.6259461468536924, 8.333173856724002, 5.068032713313034]]]
 """
 
 print(regs.lin_reg(list(range(5)), [2, 4, 6, 7, 8]))