StepMix
For StepMixR, please refer to this repository.
A Python package following the scikit-learn API for model-based clustering and generalized mixture modeling (latent class/profile analysis) of continuous and categorical data. StepMix handles missing values through Full Information Maximum Likelihood (FIML) and provides multiple stepwise Expectation-Maximization (EM) estimation methods based on pseudolikelihood theory. Additional features include support for covariates and distal outcomes, various simulation utilities, and non-parametric bootstrapping, which allows inference in semi-supervised and unsupervised settings.
Reference
If you find StepMix useful, please consider citing our arXiv preprint:
@article{morin2023stepmix,
title={StepMix: A Python Package for Pseudo-Likelihood Estimation of Generalized Mixture Models with External Variables},
author={Morin, Sacha and Legault, Robin and Bakk, Zsuzsa and Gigu{\`e}re, Charles-{\'E}douard and de la Sablonni{\`e}re, Roxane and Lacourse, {\'E}ric},
journal={arXiv preprint arXiv:2304.03853},
year={2023}
}
Install
You can install StepMix with pip, preferably in a virtual environment:
pip install stepmix
Quickstart
A simple StepMix mixture using the continuous variables of the Iris Dataset:
import pandas as pd
from sklearn.datasets import load_iris
from sklearn.metrics import rand_score
from stepmix.stepmix import StepMix
# Load dataset in a Dataframe
data_continuous, target = load_iris(return_X_y=True, as_frame=True)
# Continuous StepMix Model with 3 latent classes
model = StepMix(n_components=3, measurement="continuous", verbose=0, random_state=123)
# Fit model and predict clusters
model.fit(data_continuous)
pred_continuous = model.predict(data_continuous)
# A Rand score close to 1 indicates good alignment between clusters and flower types
print(rand_score(pred_continuous, target))
StepMix also provides support for categorical mixtures:
# Create categorical data based on the Iris Dataset quantiles
data_categorical = data_continuous.copy()
for col in data_categorical:
data_categorical[col] = pd.qcut(data_continuous[col], q=3).cat.codes
# Categorical StepMix Model with 3 latent classes
model = StepMix(n_components=3, measurement="categorical", verbose=0, random_state=123)
# Fit model and predict clusters
model.fit(data_categorical)
pred_categorical = model.predict(data_categorical)
# A Rand score close to 1 indicates good alignment between clusters and flower types
print(rand_score(pred_categorical, target))
Please refer to the StepMix tutorials to learn how to handle missing values and combine continuous and categorical data in the same model.
Tutorials
Detailed tutorials are available in notebooks:
- Generalized Mixture Models with StepMix:
an in-depth look at how latent class models can be defined with StepMix. The tutorial uses the Iris Dataset as an example
and covers:
- Continuous LCA models (latent profile analysis/gaussian mixture model);
- Binary LCA models;
- Categorical LCA models;
- Mixed variables mixture models (continuous and categorical data);
- Missing Values through Full-Information Maximum Likelihood.
- Stepwise Estimation with StepMix:
a tutorial demonstrating how to define measurement and structural models. The tutorial discusses:
- LCA models with distal outcomes;
- LCA models with covariates;
- 1-step, 2-step and 3-step estimation;
- Corrections (BCH or ML) and other options for 3-step estimation.
- Model Selection:
a short tutorial discussing:
- Selecting the number of components in a mixture model (
n_components); - Comparing models with fit indices: AIC and BIC.
- Selecting the number of components in a mixture model (
- Parameters, Bootstrapping and CI:
a tutorial discussing how to:
- Access StepMix parameters;
- Bootstrap StepMix estimators;
- Quickly plot confidence intervals.
Metadata
Release files for stepmix 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stepmix-1.0.3.tar.gz | 46.5 kB | Without provenance | Details for stepmix-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stepmix-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for stepmix-1.0.3-py3-none-any.whl |
Total release size: 83.5 kB
Release files / stepmix-1.0.3.tar.gz
| Download URL | stepmix-1.0.3.tar.gz |
|---|---|
| Size | 46.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7c50d4e28fb07bb0119e82747aaacbbe880b19d2e2f470f96107ffe94c52d085
|
|
BLAKE2b-256 checksum How to use checksums |
9c6667b028222877d4a5062721ae80e4ca018a3c875ec75c336f8e6422ffe106
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.28.1
|
Release files / stepmix-1.0.3-py3-none-any.whl
| Download URL | stepmix-1.0.3-py3-none-any.whl |
|---|---|
| Size | 37.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f75eeb58498bbff1a59677d4648c858724c3ed79a6221a6a0191538c2bc5fa7f
|
|
BLAKE2b-256 checksum How to use checksums |
368c872cabf183c0e25fd4926f33b87c183e40088ccfaf7c816c3ddcd167dd57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.28.1
|
Security for stepmix 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.