معرفی شرکت ها

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

توضیحات

A monitoring tool for machine learning systems that focus on data drift

ویژگی	مقدار
سیستم عامل	OS Independent
نام فایل	cinnamon-0.1.2
نام	cinnamon
نسخه کتابخانه	0.1.2
نگهدارنده	[]
ایمیل نگهدارنده	[]
نویسنده	Yohann Le Faou
ایمیل نویسنده	lefaou.yohann@gmail.com
آدرس صفحه اصلی	https://github.com/zelros/cinnamon
آدرس اینترنتی	https://pypi.org/project/cinnamon/
مجوز	MIT

<h1 align="center">CinnaMon</h1>  <a href="https://opensource.org/licenses/MIT"> <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT_license"> </a> CinnaMon is a Python library which offers a number of tools to detect, explain, and correct data drift in a machine learning system. At its core, CinnaMon allows to study data drift between two given datasets. It is particularly useful in a monitoring context where the first dataset is the training (or validation) data and the second dataset is the production data. ## ⚡️ Quickstart As a quick example, let's illustrate the use of CinnaMon on the breast cancer data where we voluntarily introduce some data drift. ### Setup the data and build a model ```python >>> import pandas as pd >>> from sklearn import datasets >>> from sklearn.model_selection import train_test_split >>> from xgboost import XGBClassifier # load breast cancer data >>> dataset = datasets.load_breast_cancer() >>> X = pd.DataFrame(dataset.data, columns = dataset.feature_names) >>> y = dataset.target # split data in train and valid dataset >>> X_train, X_valid, y_train, y_valid = train_test_split(X, y, test_size=0.3, random_state=2021) # introduce some data drift in valid by filtering with 'worst symmetry' feature >>> y_valid = y_valid[X_valid['worst symmetry'].values > 0.3] >>> X_valid = X_valid.loc[X_valid['worst symmetry'].values > 0.3, :].copy() # fit a XGBClassifier on the training data >>> clf = XGBClassifier(use_label_encoder=False) >>> clf.fit(X=X_train, y=y_train, verbose=10) ``` ### Initialize ModelDriftExplainer and fit it on train and validation data ```python >>> from cinnamon.drift import ModelDriftExplainer # initialize a drift explainer with the built XGBClassifier and fit it on train # and valid data >>> drift_explainer = ModelDriftExplainer(model=clf) >>> drift_explainer.fit(X1=X_train, X2=X_valid, y1=y_train, y2=y_valid) ``` ### Detect data drift by looking at main graphs and metrics ```python # Distribution of logit predictions >>> drift_explainer.plot_prediction_drift(bins=15) ``` <img height="320px" src="doc/img/plot_prediction_drift.png" alt="plot_prediction_drift"> We can see on this graph that because of the data drift we introduced in validation data the distribution of predictions are different (they do not overlap well). We can also compute the corresponding drift metrics: ```python # Corresponding metrics >>> drift_explainer.get_prediction_drift() [{'mean_difference': -3.643428434667366, 'wasserstein': 3.643428434667366, 'kolmogorov_smirnov': KstestResult(statistic=0.2913775225333014, pvalue=0.00013914094110123454)}] ``` Comparing the distributions of predictions for two datasets is one of the main indicator we use in order to detect data drift. The two other indicators are: - distribution of the target (see `get_target_drift`) - performance metrics (see `get_performance_metrics_drift`) ### Explain data drift by computing the drift values Drift values can be thought as equivalent of feature importance but in terms of data drift. ```python # plot drift values >>> drift_explainer.plot_tree_based_drift_values(n=7) ``` <img height="320px" src="doc/img/plot_drift_values.png" alt="plot_drift_values"> Here the feature `worst symmetry` is rightly identified as the one which contributes the most to the data drift. ### More See "notes" below to explore all the functionalities of CinnaMon. ## 🛠 Installation CinnaMon is intended to work with **Python 3.9 or above**. Installation can be done with `pip`: ```sh pip install cinnamon ``` ## 🔗 Notes - The two main classes of CinnaMon are `ModelDriftExplainer` and `AdversarialDriftExplainer` - `ModelDriftExplainer` currently only support `XGBoost` models (both regression and classification are supported) - See notebooks in the `examples/` directory to have an overview of all functionalities. Notably: - [Covariate shift example with IEEE data](https://github.com/zelros/cinnamon/blob/master/examples/ieee_fraud_simulated_covariate_shift_card6.ipynb) - [Concept drift example with IEEE data](https://github.com/zelros/cinnamon/blob/master/examples/ieee_fraud_simulated_concept_drift_card6.ipynb) These two notebooks also go deeper into the topic of how to correct data drift, making use of `AdversarialDriftExplainer` - See also the [slide presentation](https://yohannlefaou.github.io/publications/2021-cinnamon/Detect_explain_and_correct_data_drift_in_a_machine_learning_system.pdf) of the CinnaMon library. - There is (yet) no formal documentation for CinnaMon but docstrings are up to date for the two main classes. ## 👍 Contributing Check out the [contribution](https://github.com/zelros/cinnamon/blob/master/CONTRIBUTING.md) section. ## 📝 License CinnaMon is free and open-source software licensed under the [MIT](https://github.com/zelros/cinnamon/blob/master/LICENSE.txt).

نیازمندی

مقدار	نام
>=1.0	pandas
>=0.24	scikit-learn
>=1.4	xgboost
>=1.0	catboost
-	matplotlib
-	treelib

زبان مورد نیاز

مقدار	نام
>=3.6	Python

نحوه نصب

نصب پکیج whl cinnamon-0.1.2:

pip install cinnamon-0.1.2.whl

نصب پکیج tar.gz cinnamon-0.1.2:

pip install cinnamon-0.1.2.tar.gz