IPD — Interaction Preserving Discretisation

How to Compile

You can compile the code yourself from scratch as follows

cd /code javac .java multibinning/business/.java multibinning/data/*.java

You can then create the .jar file as follows

jar cmf mainclass.txt ipd.jar .class multibinning/business/.class multibinning/data/*.java

How to Run

You run IPD as follows

java -jar ipd.jar

where for the IPD methors you'll need to specify the following parameters:

Parameter	Meaning
-FILE_INPUT	name of input file
-FILE_CP_OUTPUT	name of output file for cut points per dimension
-FILE_RUNTIME_OUTPUT	name of output file for runtime in microseconds
-FILE_DATA_OUTPUT	name of output file for discretized data in .arff format
-NUM_ROWS	number of data points
-NUM_MEASURE_COLS	number of numeric dimensions
-NUM_CAT_CONTEXT_COLS	number of categorical dimensions
-MAX_VAL	maximum value, used for normalization
-METHOD	method used (0 for IPD_opt, 2 for IPD_gr)

For example,

java -jar ipd.jar -FILE_INPUT example/simple.csv -FILE_CP_OUTPUT cuts.txt
-FILE_RUNTIME_OUTPUT runtime.txt -FILE_DATA_OUTPUT out.txt -NUM_ROWS 209
-NUM_MEASURE_COLS 2 -NUM_CAT_CONTEXT_COLS 0 -MAX_VAL 1.0 -METHOD 0

the output files of which have been included in /example.

Related Publications

Nguyen, H-V, Müller, E, Vreeken, J & Böhm, K Unsupervised Interaction-Preserving Discretization of Multivariate Data. Data Mining and Knowledge Discovery vol.28(5), pp 1366-1397, Springer, 2014.

All synthetic and benchmark data sets used in Nguyen et al. (2014) can be found in /data. The benchmark datasets were drawn from the UCI Machine Learning Repository. The PAMAP data sets can be found at the PAMAP website.

Unadvertised and Disabled Functionality

The IPD code contains a wide spectrum of discretisation methods that are currently not documented. Two such methods, Supervised Univariate Discretisation, and PCA-based Discretisation, require the Weka framework.

While these are enabled in the provided jar file, to ease compilation and general use of the code, these have hence been disabled in the code.

Credits

Most of the IPD code was written by Hoang Vu Nguyen. Kailash Budhathoki fixed bugs and helped making the code easier to use.

EDA/ipd

About

Resources

Stars

Watchers

Forks

Releases

Contributors 2

Languages