MixtComp

MixtComp (Mixture Composer) is a model-based clustering package for mixed data originating from the Modal team (Inria Lille).

Mixture models parameters are estimated using a SEM algorithm. Five basic models (Gaussian, Multinomial, Poisson, Weibull, NegativeBinomial) are implemented to manage real, integer and categorical variables, as well as two advanced models (Func_CS for functional data and Rank_ISR for rank data). MixtComp has the ability to natively manage missing data (completely or by interval).

MixtComp is used as an R package, but its internals are coded in C++ using state of the art libraries for faster computation. It has been engineered around the idea of easy and quick integration of all new univariate models, under the conditional independence assumption. New models will eventually be available from researches, carried out by the Modal team or by other contributors. Currently, central architecture of MixtComp is built and functionality has been field-tested through industry partnerships.

CRAN package:

Build

master:

staging:

Credits

The following people contributed to the development of MixtComp: Vincent Kubicki, Christophe Biernacki, Quentin Grimonprez, Serge Iovleff, Matthieu Marbac-Lourdelle, Étienne Goffinet.

Copyrigth Inria - Université de Lille - CNRS

Licence

MixtComp is distributed under the AGPL 3.0 licence. For more details about the licences of MixtComp and its dependencies see the LICENCE.md file.

Code organization

• MixtComp MixtComp C++ library
• JMixtComp C++ executable using JSON files as input/output
• RMixtComp Main R package loading RMixtCompIO and RMixtCompUtilities
• RMixtCompIO R package linking MixtComp C++ library with Rcpp
• RMixtCompUtilities R package containing graphical, formatting and getter functions
• RJMixtComp R package using a JMixtComp executable
• RMixtCompHier R package containing a hierarchical version of MixtComp
• pyMixtComp Minimal python interface using Boost.Python

A description of the links between packages and external libraries can be found here in a text version and here in a visual version

Documentation

• Compile MixtComp
• Install RMixtComp
• Run MixtComp in command line
• Data format
• Output object
• Solutions to common errors
• Algorithm description
• Add a model
• Add a model in R packages
• Styleguide

Scientific papers about algorithm and models are available in the article folder.

Examples

• See https://github.com/vandaele/mixtcomp-notebook for RMixtComp examples.
• See pyMixtComp/python/notebooks for pyMixtComp examples.

Other tools

• Mailing-list
• Trello

Branches

There are two branches tested with github actions

• master this branch is protected, MixtComp must always work on it.
• staging this branch is used for short development, testing new features, bug fixes... and its content is regularly pushed to master when tests are OK.