robust-mixed-dist 0.1.7__tar.gz

robust_mixed_dist-0.1.7/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+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.

robust_mixed_dist-0.1.7/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: robust-mixed-dist
+Version: 0.1.7
+Summary: Compute statistical robust distances for mixed data.
+Home-page: https://github.com/FabioScielzoOrtiz/robust_mixed_dist-package
+Author: Fabio Scielzo Ortiz
+Author-email: fabio.scielzoortiz@gmail.com
+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
+Requires-Dist: polars
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: scipy
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# robust-mixed-dist
+
+Data scientists address real-world problems using multivariate and heterogeneous
+datasets, characterized by multiple variables of different natures. Selecting a suitable
+distance function between units is crucial, as many statistical techniques and machine
+learning algorithms depend on this concept. Traditional distances, such as Euclidean
+or Manhattan, are unsuitable for mixed-type data, and although Gower distance was
+designed to handle this kind of data, it may lead to suboptimal results in the presence
+of outlying units or underlying correlation structure.
+
+In the paper ***Grané , Aurea; Scielzo-Ortiz, Fabio. “On generalized Gower distance for mixed-type data: extensive simulation study and new software tools”. SORT-Statistics and Operations Research Transactions, pp. 213-44, doi:10.57645/20.8080.02.28.*** robust distances for mixed-type data are defined and explored, namely **robust generalized Gower** and **robust related metric scaling**. In addition,  the new Python package `robust-mixed-dist` is developed, which enables to
+compute these robust proposals as well as classical ones.
+
+The package is located in Python Package Index (PyPI), the standard repository of packages for the Python programming language: https://pypi.org/project/robust_mixed_dist/
+
+**Package documentation** can be found here: https://fabioscielzoortiz.github.io/robust-mixed-dist-docu/intro.html

robust_mixed_dist-0.1.7/README.md

@@ -0,0 +1,16 @@
+# robust-mixed-dist
+
+Data scientists address real-world problems using multivariate and heterogeneous
+datasets, characterized by multiple variables of different natures. Selecting a suitable
+distance function between units is crucial, as many statistical techniques and machine
+learning algorithms depend on this concept. Traditional distances, such as Euclidean
+or Manhattan, are unsuitable for mixed-type data, and although Gower distance was
+designed to handle this kind of data, it may lead to suboptimal results in the presence
+of outlying units or underlying correlation structure.
+
+In the paper ***Grané , Aurea; Scielzo-Ortiz, Fabio. “On generalized Gower distance for mixed-type data: extensive simulation study and new software tools”. SORT-Statistics and Operations Research Transactions, pp. 213-44, doi:10.57645/20.8080.02.28.*** robust distances for mixed-type data are defined and explored, namely **robust generalized Gower** and **robust related metric scaling**. In addition,  the new Python package `robust-mixed-dist` is developed, which enables to
+compute these robust proposals as well as classical ones.
+
+The package is located in Python Package Index (PyPI), the standard repository of packages for the Python programming language: https://pypi.org/project/robust_mixed_dist/
+
+**Package documentation** can be found here: https://fabioscielzoortiz.github.io/robust-mixed-dist-docu/intro.html

robust_mixed_dist-0.1.7/robust_mixed_dist/binary.py

@@ -0,0 +1,110 @@
+import polars as pl
+import pandas as pd
+from scipy.spatial import distance
+from scipy.spatial.distance import pdist, squareform
+
+################################################################################
+
+def sokal_dist_matrix(X):
+    """
+    Calculates the Sokal distance matrix for a data matrix `X` using SciPy.
+
+    Parameters (inputs)
+    ----------
+    X: a pandas/polars DataFrame or a NumPy array. It represents a data matrix.
+
+    Returns (outputs)
+    -------
+    M: the Sokal distance matrix between the rows of X.
+    """
+        
+    if isinstance(X, pl.DataFrame):
+        X = X.to_numpy()
+    if isinstance(X, pd.DataFrame):
+        X = X.to_numpy()    
+
+    # Compute the pairwise distances using pdist and convert to a square form.
+    M = squareform(pdist(X, metric='sokalmichener'))
+    
+    return M
+
+################################################################################
+
+def sokal_dist(xi, xr) :
+    """
+    Calculates the Sokal distance between a pair of vectors.
+
+    Parameters (inputs)
+    ----------
+    xi, xr: a pair of quantitative vectors. They represent a couple of statistical observations.
+
+    Returns (outputs)
+    -------
+    The Sokal distance between the observations `xi` and `xr`.
+    """
+
+    if isinstance(xi, (pl.DataFrame, pd.DataFrame)) :
+        xi = xi.to_numpy().flatten()
+    elif isinstance(xi, (pd.Series, pl.Series)) :
+        xi = xi.to_numpy() 
+    if isinstance(xr, (pl.DataFrame, pd.DataFrame)) :
+        xr = xr.to_numpy().flatten()
+    elif isinstance(xr, (pd.Series, pl.Series)) :
+        xr = xr.to_numpy() 
+
+    return distance.sokalmichener(xi, xr)
+
+################################################################################
+
+def jaccard_dist_matrix(X):
+    """
+    Calculates the Jaccard distance matrix for a data matrix `X` using SciPy.
+
+    Parameters (inputs)
+    ----------
+    X: a pandas/polars DataFrame or a NumPy array. It represents a data matrix.
+
+    Returns (outputs)
+    -------
+    M: the Jaccard distance matrix between the rows of X.
+    """
+
+    if isinstance(X, pl.DataFrame):
+        X = X.to_numpy()
+    if isinstance(X, pd.DataFrame):
+        X = X.to_numpy()    
+
+    # Compute the pairwise distances using pdist and convert to a square form.
+    M = squareform(pdist(X, metric='jaccard'))
+    
+    return M
+
+################################################################################
+
+def jaccard_dist(xi, xr) :
+    """
+    Calculates the Jaccard distance between a pair of vectors.
+
+    Parameters (inputs)
+    ----------
+    xi, xr: a pair of quantitative vectors. They represent a couple of statistical observations.
+
+    Returns (outputs)
+    -------
+    The Jaccard distance between the observations `xi` and `xr`.
+    """
+
+    if isinstance(xi, (pl.DataFrame, pd.DataFrame)) :
+        xi = xi.to_numpy().flatten()
+    elif isinstance(xi, (pd.Series, pl.Series)) :
+        xi = xi.to_numpy() 
+    if isinstance(xr, (pl.DataFrame, pd.DataFrame)) :
+        xr = xr.to_numpy().flatten()
+    elif isinstance(xr, (pd.Series, pl.Series)) :
+        xr = xr.to_numpy() 
+        
+    return distance.jaccard(xi, xr)
+
+################################################################################
+
+