mlquantify 0.0.11.2__py3-none-any.whl → 0.1.0__py3-none-any.whl

{mlquantify-0.0.11.2.dist-info → mlquantify-0.1.0.dist-info}/METADATA

@@ -1,122 +1,137 @@
-Metadata-Version: 2.1
-Name: mlquantify
-Version: 0.0.11.2
-Summary: Quantification Library
-Home-page: https://github.com/luizfernandolj/QuantifyML/tree/master
-Maintainer: Luiz Fernando Luth Junior
-Keywords: python,machine learning,quantification,quantify
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Description-Content-Type: text/markdown
-Requires-Dist: scikit-learn
-Requires-Dist: numpy
-Requires-Dist: scipy
-Requires-Dist: joblib
-Requires-Dist: tqdm
-Requires-Dist: pandas
-Requires-Dist: xlrd
-Requires-Dist: matplotlib
-
-<h1 align="center">MLQuantify</h1>
-<h4 align="center">A Python Package for Quantification</h4>
-
-___
-
- **mlquantify** is a Python library for quantification, also known as supervised prevalence estimation, designed to estimate the distribution of classes within datasets. It offers a range of tools for various quantification methods, model selection tailored for quantification tasks, evaluation metrics, and protocols to assess quantification performance. Additionally, mlquantify includes popular datasets and visualization tools to help analyze and interpret results.
-
-___
-
-## Latest Release
-
-- **Version 0.0.1**: Inicial beta version. For a detailed list of changes, check the [changelog](#).
-- In case you need any help, refer to the [wiki](https://github.com/luizfernandolj/mlquantify/wiki).
-- Explore the [API documentation](#) for detailed developer information.
-- See also the library in the pypi site in [pypi mlquantify](https://pypi.org/project/mlquantify/)
-
-___
-
-## Installation
-
-To install mlquantify, run the following command:
-
-```bash
-pip install mlquantify
-```
-
-___
-
-## Contents
-
-| Section | Description |
-|---|---|
-| **Quantification Methods** | Methods for quantification, such as classify & Count Correct methods, Threshold Optimization, Mixture Models and more.|
-| **Dynamic class management** | All methods are dynamic, and handles multiclass and binary problems, in case of binary it makes One-Vs-All (OVA) automatically. |
-| **Model Selection** | Criteria and processes used to select the best model, such as grid-search for the case of quantification|
-| **Evaluation Metrics** | Specific metrics used to evaluate quantification performance, (e.g., AE, BIAS, NAE, SE, KLD, etc.). |
-| **Evaluation Protocols** | Evaluation protocols used, based on sampling generation (e.g., APP, NPP, etc.).. |
-| **Plotting Results** | Tools and techniques used to visualize results, such as the protocol results.|
-| **Comprehensive Documentation** | Complete documentation of the project, including code, data, and results. |
-
-___
-
-## Quick example:
-
-This code first loads the breast cancer dataset from _sklearn_, which is then split into training and testing sets. It uses the _Expectation Maximisation Quantifier (EMQ)_ with a RandomForest classifier to predict class prevalence. After training the model, it evaluates performance by calculating and printing the absolute error and bias between the real and predicted prevalences.
-
-```python
-import mlquantify as mq
-from sklearn.ensemble import RandomForestClassifier
-from sklearn.datasets import load_breast_cancer
-from sklearn.model_selection import train_test_split
-
-# Loading dataset from sklearn
-features, target = load_breast_cancer(return_X_y=True)
-
-#Splitting into train and test
-X_train, X_test, y_train, y_test = train_test_split(features, target, test_size=0.3)
-
-#Create the model, here it is the Expectation Maximisation Quantifier (EMQ) with a classifier
-model = mq.methods.EMQ(RandomForestClassifier())
-model.fit(X_train, y_train)
-
-#Predict the class prevalence for X_test
-pred_prevalence = model.predict(X_test)
-real_prevalence = mq.utils.get_real_prev(y_test)
-
-#Get the error for the prediction
-ae = mq.evaluation.absolute_error(real_prevalence, pred_prevalence)
-bias = mq.evaluation.bias(real_prevalence, pred_prevalence)
-
-print(f"Mean Squared Error (MSE) -> {ae:.4f}")
-print(f"Bias -> {bias}")
-```
-
-___
-
-## Requirements
-
-- Scikit-learn
-- pandas
-- numpy
-- joblib
-- tqdm
-- matplotlib
-- xlrd
-
-___
-
-## Documentation
-
-##### API is avaliable [here](#)
-
-- [Methods](https://github.com/luizfernandolj/mlquantify/wiki/Methods)
-- [Model Selection](https://github.com/luizfernandolj/mlquantify/wiki/Model-Selection)
-- [Evaluation](https://github.com/luizfernandolj/mlquantify/wiki/Evaluation)
-- [Plotting](https://github.com/luizfernandolj/mlquantify/wiki/Plotting)
-
-
-___
+Metadata-Version: 2.2
+Name: mlquantify
+Version: 0.1.0
+Summary: Quantification Library
+Home-page: https://github.com/luizfernandolj/QuantifyML/tree/master
+Maintainer: Luiz Fernando Luth Junior
+Keywords: python,machine learning,quantification,quantify
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Description-Content-Type: text/markdown
+Requires-Dist: scikit-learn
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: joblib
+Requires-Dist: tqdm
+Requires-Dist: pandas
+Requires-Dist: xlrd
+Requires-Dist: matplotlib
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: maintainer
+Dynamic: requires-dist
+Dynamic: summary
+
+<h1 align="center">MLQuantify</h1>
+<h4 align="center">A Python Package for Quantification</h4>
+
+___
+
+ **mlquantify** is a Python library for quantification, also known as supervised prevalence estimation, designed to estimate the distribution of classes within datasets. It offers a range of tools for various quantification methods, model selection tailored for quantification tasks, evaluation metrics, and protocols to assess quantification performance. Additionally, mlquantify includes popular datasets and visualization tools to help analyze and interpret results.
+
+___
+
+## Latest Release
+
+- **Version 0.0.11.6**: Inicial beta version. For a detailed list of changes, check the [changelog](#).
+- In case you need any help, refer to the [wiki](https://github.com/luizfernandolj/mlquantify/wiki).
+- Explore the [API documentation](#) for detailed developer information.
+- See also the library in the pypi site in [pypi mlquantify](https://pypi.org/project/mlquantify/)
+
+___
+
+## Installation
+
+To install mlquantify, run the following command:
+
+```bash
+pip install mlquantify
+```
+
+If you only want to update, run the code below:
+
+```bash
+pip install --update mlquantify
+```
+
+___
+
+## Contents
+
+| Section | Description |
+|---|---|
+| **21 Quantification Methods** | Methods for quantification, such as classify & Count Correct methods, Threshold Optimization, Mixture Models and more.|
+| **Dynamic class management** | All methods are dynamic, and handles multiclass and binary problems, in case of binary it makes One-Vs-All (OVA) automatically. |
+| **Model Selection** | Criteria and processes used to select the best model, such as grid-search for the case of quantification|
+| **Evaluation Metrics** | Specific metrics used to evaluate quantification performance, (e.g., AE, BIAS, NAE, SE, KLD, etc.). |
+| **Evaluation Protocols** | Evaluation protocols used, based on sampling generation (e.g., APP, NPP, etc.).. |
+| **Plotting Results** | Tools and techniques used to visualize results, such as the protocol results.|
+| **Comprehensive Documentation** | Complete documentation of the project, including code, data, and results. |
+
+___
+
+## Quick example:
+
+This code first loads the breast cancer dataset from _sklearn_, which is then split into training and testing sets. It uses the _Expectation Maximisation Quantifier (EMQ)_ with a RandomForest classifier to predict class prevalence. After training the model, it evaluates performance by calculating and printing the absolute error and bias between the real and predicted prevalences.
+
+```python
+import mlquantify as mq
+from sklearn.ensemble import RandomForestClassifier
+from sklearn.datasets import load_breast_cancer
+from sklearn.model_selection import train_test_split
+
+# Loading dataset from sklearn
+features, target = load_breast_cancer(return_X_y=True)
+
+#Splitting into train and test
+X_train, X_test, y_train, y_test = train_test_split(features, target, test_size=0.3)
+
+#Create the model, here it is the Expectation Maximisation Quantifier (EMQ) with a classifier
+model = mq.methods.EMQ(RandomForestClassifier())
+model.fit(X_train, y_train)
+
+#Predict the class prevalence for X_test
+pred_prevalence = model.predict(X_test)
+real_prevalence = mq.utils.get_real_prev(y_test)
+
+#Get the error for the prediction
+ae = mq.evaluation.absolute_error(real_prevalence, pred_prevalence)
+bias = mq.evaluation.bias(real_prevalence, pred_prevalence)
+
+print(f"Mean Squared Error (MSE) -> {ae:.4f}")
+print(f"Bias -> {bias}")
+```
+
+___
+
+## Requirements
+
+- Scikit-learn
+- pandas
+- numpy
+- joblib
+- tqdm
+- matplotlib
+- xlrd
+
+___
+
+## Documentation
+
+##### API is avaliable [here](#)
+
+- [Methods](https://github.com/luizfernandolj/mlquantify/wiki/Methods)
+- [Model Selection](https://github.com/luizfernandolj/mlquantify/wiki/Model-Selection)
+- [Evaluation](https://github.com/luizfernandolj/mlquantify/wiki/Evaluation)
+- [Plotting](https://github.com/luizfernandolj/mlquantify/wiki/Plotting)
+- [Utilities](https://github.com/luizfernandolj/mlquantify/wiki/Utilities)
+
+
+___

mlquantify-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+mlquantify/__init__.py,sha256=Q9jCEkG0EJoHXukrxh194mhO_Yfu-BZPRfjpQ4T1XlQ,978
+mlquantify/base.py,sha256=hJ9FYYNGeO5-WJlpJpsUiu_LQL1fimvZPPNsKptxN7w,19196
+mlquantify/model_selection.py,sha256=deMdTKarMu4DtfSy6ucTIxQKj1yrC-x3nhBT77kMOtI,12679
+mlquantify/plots.py,sha256=9XOhx4QXkN9RkkiErLuL90FWIBUV2YTEJNT4Jwfy0ac,12380
+mlquantify/classification/__init__.py,sha256=3FGf-F4SOM3gByUPsWdnBzjyC_31B3MtzuolEuocPls,22
+mlquantify/classification/methods.py,sha256=yDSbpoqM3hfF0a9ATzKqfG9S-44x-0Rq0lkAVJKTIEs,5006
+mlquantify/evaluation/__init__.py,sha256=x1grng0n_QeZpVBU8-pwagYdBMkbMRILtrp1qk_bLvk,447
+mlquantify/evaluation/measures.py,sha256=fIKyxxlD8em3oaj4u_BeXmNyUQG_A0vXWY8APPgNoJ0,6579
+mlquantify/evaluation/protocol.py,sha256=OsOXm_vf7sYlw9pQv08WxAvvgzo10bAqiDM-1cpz7nQ,24020
+mlquantify/methods/__init__.py,sha256=ya3Mn7bcz2r3oaIT7yVR4iJkAfgEAwF4xDK54C0rZ7U,536
+mlquantify/methods/aggregative.py,sha256=rL_xlX2nYECrxFSjBJNlxj6h3b-iIs7l_XgxIRSYHpw,34164
+mlquantify/methods/meta.py,sha256=sZWQHUGkm6iiqujmIpHDL_8tDdKQ161bzD5mcpXLWEY,19066
+mlquantify/methods/mixture_models.py,sha256=si2Pzaka5Kbva4QKBzLolvb_8V0ZEjp68UBAiOwl49s,35166
+mlquantify/methods/non_aggregative.py,sha256=xaBu21TUtiYkOEUKO16NaNMwdNa6-SNjfBsc5PpIMyI,4815
+mlquantify/methods/threshold_optimization.py,sha256=P88VXG-czZiaHSHTGnzFmZVzm3SoJHnrmi60Zvv7IJU,33726
+mlquantify/utils/__init__.py,sha256=logWrL6B6mukP8tvYm_UPEdO9eNA-J-ySILr7-syDoc,44
+mlquantify/utils/general.py,sha256=Li5ix_dy19dUhYNgiUsNHdqqnSVYvznUBUuyr-zYSPI,7554
+mlquantify/utils/method.py,sha256=RL4vBJGl5_6DZ59Bs62hdNXI_hnoDIWilMMyMPiOjBg,12631
+mlquantify-0.1.0.dist-info/METADATA,sha256=6ud6gvzxxaQr7oZLD3fu3piid1ZHjJuHAQZzZeUw7Rs,4939
+mlquantify-0.1.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+mlquantify-0.1.0.dist-info/top_level.txt,sha256=tGEkYkbbFElwULvqENjam3u1uXtyC1J9dRmibsq8_n0,11
+mlquantify-0.1.0.dist-info/RECORD,,

{mlquantify-0.0.11.2.dist-info → mlquantify-0.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.2)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mlquantify/classification/pwkclf.py

@@ -1,73 +0,0 @@
-from sklearn.neighbors import NearestNeighbors
-from sklearn.base import BaseEstimator
-import numpy as np
-import pandas as pd
-
-class PWKCLF(BaseEstimator):
-    """Learner based on k-Nearest Neighborst (KNN) to use on the method PWK, 
-    that also is based on KNN.
-    """
-    
-    
-    def __init__(self,
-                 alpha=1,
-                 n_neighbors=10,
-                 algorithm="auto",
-                 metric="euclidean",
-                 leaf_size=30,
-                 p=2,
-                 metric_params=None,
-                 n_jobs=None):
-
-        if alpha < 1:
-            raise ValueError("alpha must not be smaller than 1")
-        
-        self.alpha = alpha
-        self.n_neighbors = n_neighbors
-
-        self.nbrs = NearestNeighbors(n_neighbors=n_neighbors,
-                                     algorithm=algorithm,
-                                     leaf_size=leaf_size,
-                                     metric=metric,
-                                     p=p,
-                                     metric_params=metric_params,
-                                     n_jobs=n_jobs)
-
-        self.Y = None
-        self.Y_map = None
-        self.w = None
-        self.y = None
-
-    def fit(self, X, y):
-        n_samples = X.shape[0]
-        if n_samples < self.n_neighbors:
-            self.nbrs.set_params(n_neighbors=n_samples)
-            
-        self.y = y
-        
-        if isinstance(y, pd.DataFrame):
-            self.y = y.reset_index(drop=True)
-            
-        Y_cts = np.unique(y, return_counts=True)
-        self.Y = Y_cts[0]
-        self.Y_map = dict(zip(self.Y, range(len(self.Y))))
-
-        min_class_count = np.min(Y_cts[1])
-        self.w = (Y_cts[1] / min_class_count) ** (-1.0 / self.alpha)
-        self.nbrs.fit(X)
-        return self
-
-    def predict(self, X):    
-        n_samples = X.shape[0]
-        nn_indices = self.nbrs.kneighbors(X, return_distance=False)
-
-        CM = np.zeros((n_samples, len(self.Y)))
-        
-        for i in range(n_samples):
-            for j in nn_indices[i]:
-                CM[i, self.Y_map[self.y[j]]] += 1
-
-        CM = np.multiply(CM, self.w)
-        predictions = np.apply_along_axis(np.argmax, axis=1, arr=CM)
-        
-        return self.Y[predictions]

mlquantify/evaluation/measures/__init__.py

@@ -1,26 +0,0 @@
-from .ae import absolute_error
-from .kld import kullback_leibler_divergence
-from .nkld import normalized_kullback_leibler_divergence
-from .rae import relative_absolute_error
-from .nae import normalized_absolute_error
-from .bias import bias
-from .nrae import normalized_relative_absolute_error
-from .se import squared_error
-from .mse import mean_squared_error
-
-
-
-MEASURES = {
-    "ae": absolute_error,
-    "nae": normalized_absolute_error,
-    "kld": kullback_leibler_divergence,
-    "nkld": normalized_kullback_leibler_divergence,
-    "nrae": normalized_relative_absolute_error,
-    "rae": relative_absolute_error,
-    "se": squared_error,
-    "mse": mean_squared_error
-}
-
-
-def get_measure(measure:str):
-    return MEASURES.get(measure)

mlquantify/evaluation/measures/ae.py

@@ -1,11 +0,0 @@
-import numpy as np
-
-def absolute_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-        
-    abs_error = abs(prev_pred - prev_real).mean(axis=-1)
-    
-    return abs_error

mlquantify/evaluation/measures/bias.py

@@ -1,16 +0,0 @@
-import numpy as np
-
-def bias(prev_real:np.any, prev_pred:np.any):
-    classes = None
-    if isinstance(prev_real, dict):
-        classes = prev_real.keys()
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-    
-    abs_errors = abs(prev_pred - prev_real)
-    
-    if classes:
-        return {class_:abs_error for class_, abs_error in zip(classes, abs_errors)}
-
-    return abs_errors

mlquantify/evaluation/measures/kld.py

@@ -1,8 +0,0 @@
-import numpy as np
-
-def kullback_leibler_divergence(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-    return prev_real * abs(np.log((prev_real / prev_pred)))

mlquantify/evaluation/measures/mse.py

@@ -1,12 +0,0 @@
-import numpy as np
-from .se import squared_error
-
-def mean_squared_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-        
-    mean_sq_error = squared_error(prev_real, prev_pred).mean()
-    
-    return mean_sq_error

mlquantify/evaluation/measures/nae.py

@@ -1,16 +0,0 @@
-import numpy as np
-from .ae import absolute_error
-
-def normalized_absolute_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-    
-    abs_error = absolute_error(prev_real, prev_pred)
-    
-    z_abs_error = (2 * (1 - min(prev_real)))
-    
-    normalized = abs_error / z_abs_error
-    
-    return normalized

mlquantify/evaluation/measures/nkld.py

@@ -1,13 +0,0 @@
-import numpy as np
-from .kld import kullback_leibler_divergence
-
-def normalized_kullback_leibler_divergence(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-    
-    euler = np.exp(kullback_leibler_divergence(prev_real, prev_pred))
-    normalized = 2 * (euler / (euler + 1)) - 1
-    
-    return normalized

mlquantify/evaluation/measures/nrae.py

@@ -1,16 +0,0 @@
-import numpy as np
-from .rae import relative_absolute_error
-
-def normalized_relative_absolute_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-    
-    relative = relative_absolute_error(prev_real, prev_pred)
-    
-    z_relative = (len(prev_real) - 1 + ((1 - min(prev_real)) / min(prev_real))) / len(prev_real)
-    
-    normalized = relative/z_relative
-    
-    return normalized

mlquantify/evaluation/measures/rae.py

@@ -1,12 +0,0 @@
-import numpy as np
-from . import absolute_error
-
-def relative_absolute_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-
-    relative = (absolute_error(prev_real, prev_pred) / prev_real).mean(axis=-1)
-    
-    return relative

mlquantify/evaluation/measures/se.py

@@ -1,12 +0,0 @@
-import numpy as np
-from .ae import absolute_error
-
-def squared_error(prev_real:np.any, prev_pred:np.any):
-    if isinstance(prev_real, dict):
-        prev_real = np.asarray(list(prev_real.values()))
-    if isinstance(prev_pred, dict):
-        prev_pred = np.asarray(list(prev_pred.values()))
-
-    sq_abs_error = ((prev_pred - prev_real) ** 2).mean(axis=-1)
-    
-    return sq_abs_error