DGCV 0.2.0__tar.gz → 0.2.2__tar.gz

{dgcv-0.2.0/src/DGCV.egg-info → dgcv-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: DGCV
-Version: 0.2.0
+Version: 0.2.2
 Summary: Differential Geometry with Complex Variables
 Author: David Sykes
 Author-email: David Sykes <david@realandimaginary.com>
@@ -24,7 +24,7 @@ DGCV was developed using Python 3.12, with dependencies on the SymPy and Pandas
 - Fully featured symbolic representations of vector fields, differential forms, and tensor fields
 - Intuitive interactions with complex structures from holomorphic coordinate systems: DGCV objects dynamically manage coordinate transformations between real and holomorphic coordinates during computation as necessary, so objects can be represented in and freely converted between either coordinate format at any time. 
 - Dedicated python classes for representing common differential geometric structures including Riemannian metrics, Kahler structures, and more
-- Custom LaTeX rendering: Integrated LaTeX support for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
+- Custom LaTeX rendering for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
 
 ## Installation
 
@@ -66,7 +66,7 @@ DGCV documentation is hosted at [https://www.realandimaginary.com/dgcv/](https:/
 DGCV is licensed under the MIT License. See the `LICENSE.txt` file for more information.
 
 ## Author
-DGCV was created and is maintained by [David Sykes](https://github.com/YikesItsSykes).
+DGCV was created and is maintained by [David Sykes](https://www.realandimaginary.com).
 
 ---
 

{dgcv-0.2.0 → dgcv-0.2.2}/README.md

@@ -10,7 +10,7 @@ DGCV was developed using Python 3.12, with dependencies on the SymPy and Pandas
 - Fully featured symbolic representations of vector fields, differential forms, and tensor fields
 - Intuitive interactions with complex structures from holomorphic coordinate systems: DGCV objects dynamically manage coordinate transformations between real and holomorphic coordinates during computation as necessary, so objects can be represented in and freely converted between either coordinate format at any time. 
 - Dedicated python classes for representing common differential geometric structures including Riemannian metrics, Kahler structures, and more
-- Custom LaTeX rendering: Integrated LaTeX support for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
+- Custom LaTeX rendering for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
 
 ## Installation
 
@@ -52,7 +52,7 @@ DGCV documentation is hosted at [https://www.realandimaginary.com/dgcv/](https:/
 DGCV is licensed under the MIT License. See the `LICENSE.txt` file for more information.
 
 ## Author
-DGCV was created and is maintained by [David Sykes](https://github.com/YikesItsSykes).
+DGCV was created and is maintained by [David Sykes](https://www.realandimaginary.com).
 
 ---
 

{dgcv-0.2.0 → dgcv-0.2.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 requires-python = ">=3.6"
 name = "DGCV"
-version = "0.2.0"
+version = "0.2.2"
 description = "Differential Geometry with Complex Variables"
 authors = [{ name = "David Sykes", email = "david@realandimaginary.com" }]
 license = { text = "MIT" }

{dgcv-0.2.0 → dgcv-0.2.2}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = DGCV
-version = 0.2.0
+version = 0.2.2
 description = A package for Differential Geometry with Complex Variables
 author = David Sykes
 author_email = david@realandimaginary.com

{dgcv-0.2.0 → dgcv-0.2.2}/setup.py

@@ -15,7 +15,7 @@ To get started, check out the Jupyter Notebook tutorials:
 
 setup(
     name="DGCV",
-    version="0.2.0",
+    version="0.2.2",
     description="Differential Geometry with Complex Variables",
     long_description=long_description,  # This shows up on PyPI
     long_description_content_type='text/markdown',

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV/RiemannianGeometry.py

@@ -665,85 +665,6 @@ class metricClass(Basic):
         else:
             return f"\\left({latex(coeff)}\\right)"
 
-    def __add__(self, other):
-        """
-        Adds two differential forms (i.e., DFClass instances). The addition is performed 
-        by combining the coefficients of both forms. If the variable spaces of the forms 
-        are not the same, the resulting form will have a variable space that is the union 
-        of both input spaces.
-        
-        Parameters
-        ----------
-        other : DFClass
-            Another differential form to add. The variable spaces of the two forms need not 
-            be identical. The result will use the union of the variable spaces of the two 
-            forms.
-        
-        Returns
-        -------
-        DFClass
-            A new differential form representing the sum of the two input forms.
-        
-        Raises
-        ------
-        TypeError
-            If the argument `other` is not an instance of `DFClass`.
-        
-        Examples
-        --------
-        >>> from sympy import symbols
-        >>> from DGCV import DFClass
-        >>> x1, x2 = symbols('x1 x2')
-        >>> d_x1 = DFClass([x1], {0: 1}, 1)
-        >>> d_x2 = DFClass([x2], {0: 1}, 1)
-        >>> d_sum = d_x1 + d_x2
-        >>> print(d_sum)
-        d_x1 + d_x2
-        """
-        if isinstance(other, DFClass):
-            return addDF(self, other)
-        else:
-            raise TypeError("Unsupported operand type(s) for + with DFClass")
-
-    def __sub__(self, other):
-        """
-        Subtracts one differential form from another (i.e., DFClass instances). The subtraction 
-        is performed by negating the second form and then adding it to the first form. If the 
-        variable spaces of the forms are not the same, the resulting form will have a variable 
-        space that is the sum of both input spaces.
-        
-        Parameters
-        ----------
-        other : DFClass
-            Another differential form to subtract. The variable spaces of the two forms need not 
-            be identical. The result will use the sum of the variable spaces of the two forms.
-        
-        Returns
-        -------
-        DFClass
-            A new differential form representing the difference between the two input forms.
-        
-        Raises
-        ------
-        TypeError
-            If the argument `other` is not an instance of `DFClass`.
-        
-        Examples
-        --------
-        >>> from sympy import symbols
-        >>> from DGCV import DFClass
-        >>> x1, x2 = symbols('x1 x2')
-        >>> d_x1 = DFClass([x1], {0: 1}, 1)
-        >>> d_x2 = DFClass([x2], {0: 1}, 1)
-        >>> d_diff = d_x1 - d_x2
-        >>> print(d_diff)
-        d_x1 - d_x2
-        """
-        if isinstance(other, DFClass):
-            return addDF(self, scaleDF(-1, other))
-        else:
-            raise TypeError("Unsupported operand type(s) for - with DFClass")
-
 class LeviCivitaConnectionClass(Basic):
 
     def __new__(cls, varSpace, Christoffel_symbols_of_the_second_kind, variable_handling_default='standard'):
@@ -751,37 +672,68 @@ class LeviCivitaConnectionClass(Basic):
         obj = Basic.__new__(cls, varSpace,Christoffel_symbols_of_the_second_kind)
         return obj
 
-    def __init__(self, varSpace, Christoffel_symbols_of_the_second_kind,variable_handling_default='standard'):
-        if not isinstance(Christoffel_symbols_of_the_second_kind,ImmutableSparseNDimArray):
-            raise TypeError('The `LeviCivitaConnection` class initializer expects a symmtric tensor field class (STFClass) object in its first argument.')
-        shapeCheck=Christoffel_symbols_of_the_second_kind.shape
-        if len(shapeCheck)!=3 and len(set(shapeCheck))!=1:
-            raise TypeError('The `LeviCivitaConnection` class initializer was given array data for the `Christoffel_symbols_of_the_second_kind` of invalid shape.')
-        if len(varSpace)!= shapeCheck[0]:
-            TypeError('The `LeviCivitaConnection` class initializer was given array data for the `Christoffel_symbols_of_the_second_kind` of invalid size relative to the provided coordinate space. Number of coordinates must match the Christoffel symbols\' index range.')
-        if variable_handling_default=='complex':
-            if all(var in variable_registry['conversion_dictionaries']['realToSym'] for var in self.varSpace):
-                self._varSpace_type= 'real'
-            elif all(var in variable_registry['conversion_dictionaries']['symToReal'] for var in self.varSpace):
+    from sympy.tensor.array import ImmutableSparseNDimArray
+
+    def __init__(self, varSpace, Christoffel_symbols_of_the_second_kind, variable_handling_default='standard'):
+        # Attempt to convert the input to an ImmutableSparseNDimArray
+        if not isinstance(Christoffel_symbols_of_the_second_kind, ImmutableSparseNDimArray):
+            try:
+                Christoffel_symbols_of_the_second_kind = ImmutableSparseNDimArray(Christoffel_symbols_of_the_second_kind)
+            except Exception as e:
+                raise TypeError(
+                    'The `LeviCivitaConnection` class initializer expects an ImmutableSparseNDimArray '
+                    'or array-like data that can be converted to one. '
+                    f'Failed to convert the input: {e}'
+                )
+
+        # Check the shape of the Christoffel symbols
+        shapeCheck = Christoffel_symbols_of_the_second_kind.shape
+        if len(shapeCheck) != 3 or len(set(shapeCheck)) != 1:
+            raise TypeError(
+                'The `LeviCivitaConnection` class initializer was given array data for the '
+                '`Christoffel_symbols_of_the_second_kind` of invalid shape.'
+            )
+
+        # Check that the coordinate space matches the Christoffel symbols' size
+        if len(varSpace) != shapeCheck[0]:
+            raise TypeError(
+                'The `LeviCivitaConnection` class initializer was given array data for the '
+                '`Christoffel_symbols_of_the_second_kind` of invalid size relative to the provided coordinate space. '
+                'Number of coordinates must match the Christoffel symbols\' index range.'
+            )
+
+        # Handle variable type based on the default handling mode
+        if variable_handling_default == 'complex':
+            if all(var in variable_registry['conversion_dictionaries']['realToSym'] for var in varSpace):
+                self._varSpace_type = 'real'
+            elif all(var in variable_registry['conversion_dictionaries']['symToReal'] for var in varSpace):
                 self._varSpace_type = 'complex'
             else:
-                raise KeyError('To initialize a `LeviCivitaConnectionClass` instance with variable_handling_default=\'complex\', `varSpace` must contain only variables from DGCV\'s complex variables systems, and all variables in `varSpace` must be simulataneously among the real and imaginary types, or simulateneously among the holomorphic and antiholomorphic types. Use `complexVarProc` to easily create DGCV complex variable systems.')
+                raise KeyError(
+                    'To initialize a `LeviCivitaConnectionClass` instance with variable_handling_default=\'complex\', '
+                    '`varSpace` must contain only variables from DGCV\'s complex variables systems, and all variables in '
+                    '`varSpace` must be simultaneously among the real and imaginary types, or simultaneously among the '
+                    'holomorphic and antiholomorphic types. Use `complexVarProc` to easily create DGCV complex variable systems.'
+                )
         else:
-            self._varSpace_type='standard'
+            self._varSpace_type = 'standard'
+
+        # Assign attributes
         self.Christoffel_symbols = Christoffel_symbols_of_the_second_kind
-        self.varSpace=varSpace
+        self.varSpace = varSpace
         
     def __call__(self,vf1,vf2):
         if not all([isinstance(vf1,VFClass), isinstance(vf2,VFClass)]):
             raise TypeError('`LeviCivitaConnectionClass` only operates on pairs of VFClass objects.')
         dimLoc=len(self.varSpace)
         def _coeff(VF1,VF2,l):
-            term1=addVF(*[diff(VF2.coeffs[l],self.varSpace[j])*VF1.coeffs[j] for j in range(dimLoc)])
-            term2=addVF(*[self.Christoffel_symbols[l,j,k]*VF1.coeffs[j]*VF2.coeffs[k] for j in range(dimLoc) for k in range(dimLoc)])
+            term1=sum([diff(VF2.coeffs[l],self.varSpace[j])*VF1.coeffs[j] for j in range(dimLoc)])
+            term2=sum([self.Christoffel_symbols[j,k,l]*VF1.coeffs[j]*VF2.coeffs[k] for j in range(dimLoc) for k in range(dimLoc)])
+            return term1+term2
 
         if self._varSpace_type=='standard':
             vf1=changeVFBasis(vf1,self.varSpace)
-            vf2=changeDFBasis(vf2,self.varSpace)
+            vf2=changeVFBasis(vf2,self.varSpace)
             newCoeffs=[_coeff(vf1,vf2,l) for l in range(dimLoc)]
             return VFClass(self.varSpace,newCoeffs)
         elif self._varSpace_type=='real':

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV/__init__.py

@@ -11,7 +11,7 @@ _ = get_variable_registry()
 ############# library
 from .classesAndVariables import DFClass, VFClass, STFClass, TFClass, DGCVPolyClass, FAClass, AlgebraElement, createVariables, holToReal, realToSym, symToHol, holToSym, realToHol, symToReal, allToReal, allToHol, allToSym, complex_struct_op, conjugate_DGCV, conj_with_real_coor, re_with_real_coor, im_with_real_coor, conj_with_hol_coor, re_with_hol_coor, im_with_hol_coor, cleanUpConjugation, compressDGCVClass, VF_coeffs, changeVFBasis, addVF, scaleVF, VF_bracket, changeDFBasis, changeTFBasis, changeSTFBasis, scaleDF, addDF, exteriorProduct, addSTF, addTF, scaleTF, tensorProduct, holVF_coeffs, antiholVF_coeffs, complexVFC, conjComplex, realPartOfVF, createFiniteAlg, algebraDataFromVF, algebraDataFromMatRep, killingForm, adjointRepresentation, listVar, clearVar, DGCV_snapshot, variableSummary
 from .combinatorics import chooseOp, permSign, carProd
-from .complexGeometry import Del, DelBar, KahlerStructure
+from .complexStructures import Del, DelBar, KahlerStructure
 from .CRGeometry import tangencyObstruction, weightedHomogeneousVF, findWeightedCRSymmetries, model2Nondegenerate
 from .polynomials import createPolynomial, createBigradPolynomial, monomialWeight, getWeightedTerms
 from .RiemannianGeometry import metricClass, metric_from_matrix, LeviCivitaConnectionClass

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV/classesAndVariables.py

@@ -2633,7 +2633,7 @@ class DGCVPolyClass(Basic):
         return filtered_monomials
 
     def get_coeffs(self, min_degree=0, max_degree=None, format='unformatted', return_coeffs=False):
-            return get_monomials(self, min_degree=0, max_degree=max_degree, format=format, return_coeffs=True)
+            return self.get_monomials(self, min_degree=0, max_degree=max_degree, format=format, return_coeffs=True)
 
     @property
     def holomorphic_part(self):
@@ -3295,7 +3295,6 @@ class FAClass(Basic):
         return det != 0
     
 # algebra element class
-
 class AlgebraElement(Basic):
     def __new__(cls, algebra, coeffs, format_sparse=False):
         # Ensure the algebra is of type FAClass

dgcv-0.2.0/src/DGCV/complexGeometry.py → dgcv-0.2.2/src/DGCV/complexStructures.py

@@ -1,9 +1,7 @@
 """
 DGCV: Differential Geometry with Complex Variables
 
-This module provides tools uniquely relevant for complex differential geometry within the DGCV package. It includes 
-Dolbeault operators (Del and DelBar) and a class for constructing and analyzing Kähler 
-structures.
+This module provides tools uniquely relevant for complex differential geometry within the DGCV package. It includes Dolbeault operators (Del and DelBar) and a class for constructing and analyzing Kähler structures.
 
 Key Functions:
     - Del(): Applies the holomorphic Dolbeault operator ∂ to a differential form or scalar.

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV/coordinateMaps.py

@@ -1,7 +1,7 @@
 
 from .classesAndVariables import allToReal, allToSym, VF_coeffs, addVF, STFClass, DFClass, TFClass
 from .RiemannianGeometry import metricClass
-from .complexGeometry import KahlerStructure
+from .complexStructures import KahlerStructure
 from .vectorFieldsAndDifferentialForms import get_VF, get_DF
 from .config import get_variable_registry
 from sympy import Basic, simplify, re, im

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV/polynomials.py

@@ -1,12 +1,55 @@
+"""
+DGCV: Polynomial Tools
+
+This module integrates DGCV's complex variable handling features with SymPy's core polynomial functionality. 
+It provides functions for creating and manipulating polynomials with variable coefficients registered 
+in DGCV's Variable Management Framework (VMF). The polynomials created by these functions are compatible 
+with the DGCVPolyClass, which wraps SymPy.Poly objects to support DGCV's framework for managing complex 
+variable systems.
+
+Key Functions:
+
+Polynomial Creation:
+    - createPolynomial(): Constructs a polynomial with specified degree and variables, supporting 
+      homogeneous and weighted homogeneous options.
+    - createBigradPolynomial(): Creates a polynomial that is weighted-homogeneous with respect 
+      to two independent weight systems.
+
+Term and Monomial Handling:
+    - getWeightedTerms(): Extracts terms from a polynomial that satisfy specific weighted homogeneity 
+      conditions.
+    - monomialWeight(): Computes the weight of a monomial with respect to a given weight system.
+
+Usage Notes:
+- All functions in this module register created variables in the VMF for consistency across the DGCV framework. 
+- These functions are designed to work seamlessly with DGCVPolyClass objects but can also operate on standard 
+  SymPy expressions.
+
+Dependencies:
+    - sympy: Core symbolic mathematics library used for polynomial manipulation.
+    - functools: Provides the `reduce` function for processing monomials.
+    - operator: Supplies the `mul` operator for combining monomial components.
+    - warnings: Used for issuing warnings in functions.
+    - DGCV modules:
+        - combinatorics: Handles combinatorial logic for generating polynomial terms.
+        - classesAndVariables: Interfaces with the DGCV framework for variable management.
+        - config: Provides `_cached_caller_globals` for managing global variable states.
+
+Author: David Sykes (https://www.realandimaginary.com/dgcv/)
+
+License:
+    MIT License
+"""
+
 ############## dependencies
 import sympy
-from sympy import prod, ln, exp
+from sympy import prod, ln, exp, expand
 from .combinatorics import *
 from .classesAndVariables import *
 from .config import _cached_caller_globals
 from functools import reduce
 from operator import mul
-
+import warnings
 
 ############## creating polynomials (monomialsOfPoly is in classesAndVariables.py)
 
@@ -170,6 +213,8 @@ def createBigradPolynomial(arg1, arg2, arg3, arg4, arg5, _tempVar=None, returnMo
     else:
         return sum(monomials)
     
+from sympy import simplify, expand, ln, exp, Poly
+import warnings
 
 def monomialWeight(arg1, arg2, arg3):
     """
@@ -192,16 +237,28 @@ def monomialWeight(arg1, arg2, arg3):
     Raises
     ------
     ValueError
-        If the length of *arg2* and *arg3* do not match, or if *arg1* is not a valid monomial.
-    
+        If the length of *arg2* and *arg3* do not match.
+
     Notes
     -----
+    - A warning is issued if the input is not detected as a monomial.
     - The weight is computed by taking the logarithm of the monomial and substituting 
       each variable with an exponential weight as specified in *arg3*.
     """
     if len(arg2) != len(arg3):
         raise ValueError("The number of variables and weights must match.")
     
+    # Expand and simplify the expression
+    arg1 = simplify(expand(arg1))
+
+    # Check if the expression is a monomial
+    try:
+        poly = Poly(arg1, *arg2)
+        if len(poly.terms()) > 1:
+            warnings.warn(f"Input {arg1} is not a monomial (contains multiple terms). Proceeding anyway.")
+    except Exception:
+        warnings.warn(f"Input {arg1} could not be interpreted as a polynomial in {arg2}. Proceeding anyway.")
+
     # Isolate the coefficient by setting all variables to 1
     coeffLoc = simplify(arg1.subs([(var, 1) for var in arg2]))
     

{dgcv-0.2.0 → dgcv-0.2.2/src/DGCV.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: DGCV
-Version: 0.2.0
+Version: 0.2.2
 Summary: Differential Geometry with Complex Variables
 Author: David Sykes
 Author-email: David Sykes <david@realandimaginary.com>
@@ -24,7 +24,7 @@ DGCV was developed using Python 3.12, with dependencies on the SymPy and Pandas
 - Fully featured symbolic representations of vector fields, differential forms, and tensor fields
 - Intuitive interactions with complex structures from holomorphic coordinate systems: DGCV objects dynamically manage coordinate transformations between real and holomorphic coordinates during computation as necessary, so objects can be represented in and freely converted between either coordinate format at any time. 
 - Dedicated python classes for representing common differential geometric structures including Riemannian metrics, Kahler structures, and more
-- Custom LaTeX rendering: Integrated LaTeX support for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
+- Custom LaTeX rendering for clean visual representation of mathematical objects, ideal for sharing mathematical ideas through clear Jupyter notebooks.
 
 ## Installation
 
@@ -66,7 +66,7 @@ DGCV documentation is hosted at [https://www.realandimaginary.com/dgcv/](https:/
 DGCV is licensed under the MIT License. See the `LICENSE.txt` file for more information.
 
 ## Author
-DGCV was created and is maintained by [David Sykes](https://github.com/YikesItsSykes).
+DGCV was created and is maintained by [David Sykes](https://www.realandimaginary.com).
 
 ---
 

{dgcv-0.2.0 → dgcv-0.2.2}/src/DGCV.egg-info/SOURCES.txt

@@ -12,7 +12,7 @@ src/DGCV/__init__.py
 src/DGCV/_safeguards.py
 src/DGCV/classesAndVariables.py
 src/DGCV/combinatorics.py
-src/DGCV/complexGeometry.py
+src/DGCV/complexStructures.py
 src/DGCV/config.py
 src/DGCV/coordinateMaps.py
 src/DGCV/finiteDimAlgebras.py