rgwfuncs 0.0.39__py3-none-any.whl → 0.0.42__py3-none-any.whl

rgwfuncs/__init__.py

@@ -1,7 +1,7 @@
 # This file is automatically generated
 # Dynamically importing functions from modules
 
-from .algebra_lib import compute_constant_expression, compute_constant_expression_involving_matrices, compute_constant_expression_involving_ordered_series, compute_prime_factors, python_polynomial_expression_to_latex, simplify_polynomial_expression, solve_homogeneous_polynomial_expression
+from .algebra_lib import compute_constant_expression, compute_constant_expression_involving_matrices, compute_constant_expression_involving_ordered_series, compute_prime_factors, expand_polynomial_expression, python_polynomial_expression_to_latex, simplify_polynomial_expression, solve_homogeneous_polynomial_expression
 from .df_lib import append_columns, append_percentile_classification_column, append_ranged_classification_column, append_ranged_date_classification_column, append_rows, append_xgb_labels, append_xgb_logistic_regression_predictions, append_xgb_regression_predictions, bag_union_join, bottom_n_unique_values, cascade_sort, delete_rows, drop_duplicates, drop_duplicates_retain_first, drop_duplicates_retain_last, filter_dataframe, filter_indian_mobiles, first_n_rows, from_raw_data, insert_dataframe_in_sqlite_database, last_n_rows, left_join, limit_dataframe, load_data_from_path, load_data_from_query, load_data_from_sqlite_path, mask_against_dataframe, mask_against_dataframe_converse, numeric_clean, order_columns, print_correlation, print_dataframe, print_memory_usage, print_n_frequency_cascading, print_n_frequency_linear, rename_columns, retain_columns, right_join, send_data_to_email, send_data_to_slack, send_dataframe_via_telegram, sync_dataframe_to_sqlite_database, top_n_unique_values, union_join, update_rows
 from .docs_lib import docs
 from .interactive_shell_lib import interactive_shell

rgwfuncs/algebra_lib.py

@@ -320,6 +320,50 @@ def python_polynomial_expression_to_latex(
     latex_result = latex(expr)
     return latex_result
 
+def expand_polynomial_expression(
+    expression: str,
+    subs: Optional[Dict[str, float]] = None
+) -> str:
+    """
+    Expands a polynomial expression written in Python syntax and converts it to LaTeX format.
+
+    This function takes an algebraic expression written in Python syntax, 
+    applies polynomial expansion, and converts the expanded expression 
+    to a LaTeX formatted string. The expression should be compatible with sympy.
+
+    Parameters:
+    expression (str): The algebraic expression to expand and convert to LaTeX. 
+                      The expression should be written using Python syntax.
+    subs (Optional[Dict[str, float]]): An optional dictionary of substitutions 
+                                       to apply to variables in the expression 
+                                       before expansion.
+
+    Returns:
+    str: The expanded expression represented as a LaTeX string.
+
+    Raises:
+    ValueError: If the expression cannot be parsed due to syntax errors.
+    """
+    transformations = standard_transformations + (implicit_multiplication_application,)
+    
+    def parse_and_expand_expression(expr_str: str, sym_vars: Dict[str, symbols]) -> symbols:
+        try:
+            expr = parse_expr(expr_str, local_dict=sym_vars, transformations=transformations)
+            if subs:
+                subs_symbols = {symbols(k): v for k, v in subs.items()}
+                expr = expr.subs(subs_symbols)
+            return expr.expand()
+        except (SyntaxError, ValueError, TypeError) as e:
+            raise ValueError(f"Error parsing expression: {expr_str}. Error: {e}")
+
+    variable_names = set(re.findall(r'\b[a-zA-Z]\w*\b', expression))
+    sym_vars = {var: symbols(var) for var in variable_names}
+
+    expr = parse_and_expand_expression(expression, sym_vars)
+    latex_result = latex(expr)
+    return latex_result
+
+
 
 def simplify_polynomial_expression(
     expression: str,

{rgwfuncs-0.0.39.dist-info → rgwfuncs-0.0.42.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rgwfuncs
-Version: 0.0.39
+Version: 0.0.42
 Summary: A functional programming paradigm for mathematical modelling and data science
 Home-page: https://github.com/ryangerardwilson/rgwfunc
 Author: Ryan Gerard Wilson
@@ -23,13 +23,16 @@ Requires-Dist: xgboost
 Requires-Dist: requests
 Requires-Dist: slack-sdk
 Requires-Dist: google-api-python-client
-Requires-Dist: boto
+Requires-Dist: boto3
 
 # RGWFUNCS
 
 ***By Ryan Gerard Wilson (https://ryangerardwilson.com)***
 
-This library is meant to make ML/ Data Science pipelines more readable. It assumes a linux environment, and the existence of a `.rgwfuncsrc` file for certain features (like db querying, sending data to slack, etc.)
+
+This library is meant to protect your eyes (and brain) from OOP syntax. It is unbelievably sad that some of the best work done in creating math and data science libraries in Python has been corrupted by the OOP mind-virus. 
+
+By creating a functional-programming wrapper around these libraries, we aim to soothe. This library assumes a Linux environment and the existence of a `.rgwfuncsrc` file for certain features (like database querying, sending data to Slack, etc.).
 
 --------------------------------------------------------------------------------
 
@@ -363,6 +366,42 @@ Converts a polynomial expression written in Python syntax to a LaTeX formatted s
 
 --------------------------------------------------------------------------------
 
+### 6. `expand_polynomial_expression`
+
+Expands a polynomial expression written in Python syntax and converts it into a LaTeX formatted string. This function takes algebraic expressions provided as strings using Python's syntax, applies polynomial expansion through SymPy, and translates them into LaTeX representations, suitable for academic or professional documentation. It supports expressions with named variables and provides an option to substitute specific values into the expression before expansion.
+
+- Parameters:
+  - `expression` (str): The algebraic expression to expand and convert to LaTeX. This string should be formatted using Python syntax acceptable by SymPy.
+  - `subs` (Optional[Dict[str, float]]): An optional dictionary of substitutions where the keys are variable names in the expression, and the values are the numbers with which to substitute those variables before expanding.
+
+- Returns:
+  - `str`: The LaTeX formatted string of the expanded expression.
+
+- Raises:
+  - `ValueError`: If the expression cannot be parsed due to syntax errors.
+
+- Example:
+
+    from rgwfuncs import expand_polynomial_expression
+
+    # Expand a simple polynomial expression and convert to LaTeX
+    latex_result1 = expand_polynomial_expression("(x + y)**2")
+    print(latex_result1)  # Output: "x^{2} + 2 x y + y^{2}"
+
+    # Expand polynomial expression with substituted values
+    latex_result2 = expand_polynomial_expression("(x + y)**2", {"x": 3, "y": 4})
+    print(latex_result2)  # Output: "49"
+
+    # Another example with partial substitution
+    latex_result3 = expand_polynomial_expression("(x + y)**2", {"x": 3})
+    print(latex_result3)  # Output: "y^{2} + 6 y + 9"
+
+    # Handling trigonometric functions with symbolic variables
+    latex_result4 = expand_polynomial_expression("sin(x + z**2) + cos(y)", {"x": 55})
+    print(latex_result4)  # Output: "cos y + sin \\left(z^{2} + 55\\right)"
+
+--------------------------------------------------------------------------------
+
 ### 6. `simplify_polynomial_expression`
 
 Simplifies an algebraic expression in polynomial form and returns it in LaTeX format. Takes an algebraic expression, in polynomial form, written in Python syntax and simplifies it. The result is returned as a LaTeX formatted string, suitable for academic or professional documentation.

rgwfuncs-0.0.42.dist-info/RECORD

@@ -0,0 +1,12 @@
+rgwfuncs/__init__.py,sha256=j1SH_GGf9EPXWvhKd_RWDMUI8GXvJGniq4whdmC-tRk,1550
+rgwfuncs/algebra_lib.py,sha256=OWltGhJqlP7mS0VszjeSICKQZjNlCrLjWVlaKwrb4Og,23435
+rgwfuncs/df_lib.py,sha256=b6uMBbj7JrTUusbBGSlGI6jJ37yCN5lb6Oiq-C9oGzg,68987
+rgwfuncs/docs_lib.py,sha256=y3wSAOPO3qsA4HZ7xAtW8HimM8w-c8hjcEzMRLJ96ao,1960
+rgwfuncs/interactive_shell_lib.py,sha256=A7EWsYxAfDev_N0-2GjRvAtp0bAwBPHIczXb8Gu9fzI,1107
+rgwfuncs/str_lib.py,sha256=rtAdRlnSJIu3JhI-tA_A0wCiPK2m-zn5RoGpBxv_g-4,2228
+rgwfuncs-0.0.42.dist-info/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
+rgwfuncs-0.0.42.dist-info/METADATA,sha256=xxKivycP7sQ5oLN65i5CIzl3H_yAMTf7HgO9uLUM_Vk,52072
+rgwfuncs-0.0.42.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+rgwfuncs-0.0.42.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
+rgwfuncs-0.0.42.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
+rgwfuncs-0.0.42.dist-info/RECORD,,

rgwfuncs-0.0.39.dist-info/RECORD

@@ -1,12 +0,0 @@
-rgwfuncs/__init__.py,sha256=CLPRpLtzXxyFHEjS-MrxnhXH0LdS6THjAC5sCHg0m3c,1520
-rgwfuncs/algebra_lib.py,sha256=g-sNkf9Hz4i17uRIgLUYLQlyUu8yROgsoJMujdj0U3Y,21577
-rgwfuncs/df_lib.py,sha256=b6uMBbj7JrTUusbBGSlGI6jJ37yCN5lb6Oiq-C9oGzg,68987
-rgwfuncs/docs_lib.py,sha256=y3wSAOPO3qsA4HZ7xAtW8HimM8w-c8hjcEzMRLJ96ao,1960
-rgwfuncs/interactive_shell_lib.py,sha256=A7EWsYxAfDev_N0-2GjRvAtp0bAwBPHIczXb8Gu9fzI,1107
-rgwfuncs/str_lib.py,sha256=rtAdRlnSJIu3JhI-tA_A0wCiPK2m-zn5RoGpBxv_g-4,2228
-rgwfuncs-0.0.39.dist-info/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
-rgwfuncs-0.0.39.dist-info/METADATA,sha256=Q_t5qkxs2q8wPBnTxvfna07rjDXSUyIYOvpbshtv780,49825
-rgwfuncs-0.0.39.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-rgwfuncs-0.0.39.dist-info/entry_points.txt,sha256=j-c5IOPIQ0252EaOV6j6STio56sbXl2C4ym_fQ0lXx0,43
-rgwfuncs-0.0.39.dist-info/top_level.txt,sha256=aGuVIzWsKiV1f2gCb6mynx0zx5ma0B1EwPGFKVEMTi4,9
-rgwfuncs-0.0.39.dist-info/RECORD,,