SelvarClustMV software


Context :

SelvarClustMV is a software implemented in C++ with object-oriented programming. It is devoted to the variable selection in model-based clustering, taking into account missing values. It is a greedy algorithm associated to the SR modeling proposed in Maugis et al. (Biometrics, 2009), taking into account missing values. This software allows to study data where individuals are described by quantitative block variables. It returns a data clustering and the selected model, composed of the number of clusters and the variable partition. This software is here only proposed for Gaussian mixtures whose variance matrices are assumed to be identical and free (m=[pkLC]).

Main references :


LINUX WINDOWS

Installing in Linux :

  1. SelvarClustMV uses Mixmod software (version 2.1.1) available here.
    First, install the mixmod software (see the Quick Start for an installation help).
    In the following, we call mixmodDir the full path of the directory where Mixmod software is located.


  2. Declare the path of Mixmod by adding the following command in the bash shell : export PATH=mixmodDir/Mixmod/BIN:$PATH


  3. Download the following .zip file containing the .cpp files, the .hpp files and the Makefile for Linux.

    SelvarClustMV.zip

    Unzip SelvarClustMV.zip in a directory. In the following, the full path of this directory is called SelvarClustMVDir.
    Compile with the command make. The executable SelvarClustMV is then created. You can declare this executable in the bash shell with the command export PATH=SelvarClustMVDir:$PATH

Arguments and Usage in Linux:

For running the SelvarClustMV algorithm, use the following command : nohup ./SelvarClustMV Arg1 Arg2 Arg3 Arg4 Arg5

with the following arguments :

Arg1 : path of the file containing the data
Arg2 : path of the file containing the position of missing values (0 if the value is missing and 1 otherwise)
Arg3 : path of the file containing the block variable sizes (a column given the size of each block variable)
Arg4 : path of the file containing the considered cluster numbers (a column given the considered numbers of Gaussian mixture components).
Arg5 : path of the directory where the results will be saved

Results :

After using the SelvarClustMV algorithm, the directory given in Arg5 for saving results contains the following files:


Installing in Windows :

  1. SelvarClustMV uses Mixmod software (version 2.1.1) available here.
    First, install the mixmod software in the folder C:\Program Files\Mixmod and with the name Mixmod. See the Quick Start for an installation help.


  2. Declare the path of Mixmod : From the desktop, right-click My Computer and click properties. In the System Properties window, click on the Advanced tab. In the Advanced section, click the Environment Variables button. Finally, in the Environment Variables window, highlight the path variable in the Systems Variable section and click edit. Add a semicolon and the path C:\Program Files\Mixmod\BIN.


  3. Download the following executable in a directory whose the full path is called SelvarClustMVDir in the following.

    SelvarClustMVWindows.exe

Arguments and Usage in Windows:

For running the SelvarClustMV algorithm, use the following command : SelvarClustMVDir\SelvarClustMVWindows.exe Arg1 Arg2 Arg3 Arg4 Arg5

with the following arguments :

Arg1 : path of the file containing the data
Arg2 : path of the file containing the position of missing values (0 if the value is missing and 1 otherwise)
Arg3 : path of the file containing the block variable sizes (a column given the size of each block variable)
Arg4 : path of the file containing the considered cluster numbers (a column given the considered numbers of Gaussian mixture components).
Arg5 : path of the directory where the results will be saved

Results :

The directory given in Arg5 for saving results contains the following files:


Bugs and Feedback - Contacts

Send an e-mail with the subject "Bugs-SelvarClustMV" at cathy.maugis -AT- insa-toulouse.fr