MINE: Maximal Information-based Nonparametric Exploration


Frequently Asked Questions

We are working hard at making MINE more reliable and easy to use. Before contacting us, please check to see if your question appears on this list, and make sure that you're running the latest version of MINE, since your problem may already be fixed.

1. Can you give a a short tutorial on using MINE?

Here's an example to get you going quickly: download MINE, and download the gene expression data set into the same folder. Then type
java -jar MINE.jar Spellman.csv 0
This will instruct MINE to compare each variable to the 0-th variable (in this case, time).

2. Is the MINE application licensed for commercial use?

MINE is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. If you would like a license for commercial use, please contact us at mine@broadinstitute.org.

3. Does MINE work on textual data?

MINE works only on numeric data. If your data set contains text-valued variables, the current version of MINE will ignore those entries and pretend they were blank. You might be able to run MINE effectively by simply replacing each possible value of your text-valued variable with a number (so for instance, if you have "male" and "female" as the possible values of the variable "sex", then you could replace "female" with "1" and "male" with "0"). However, this is not appropriate in all cases.

4. What platforms was MINE tested on?

We developed MINE on Windows machines with Java SE 1.7.0_02. It has also been tested on OS X 10.6.8. We cannot guarantee MINE will work on other platforms, though we will do our best to help you out if you believe you have a platform-specific issue.

5. When I run MINE in R, I get a java.lang.ClassNotFoundException. How can I fix this?

Despite the information provided in the documentation of the rJava package, we found that changing the slashes in the line that caused the error to periods (so for example: changing '.jnew("data/Dataset"...' to '.jnew("data.Dataset"...') resolves this issue on many platforms.

6. When I run MINE, I get a java.lang.OutOfMemoryError. What should I do?

There is a limit (that depends on your computer) to the number of variable pairs MINE will be able to analyze in one go. To overcome this error, split your analysis up into smaller analyses by using, for instance, the -masterVariable option, run the sub-analyses (preferably in parallel), and combine their results. You can also increase the amount of memory that Java allocates to MINE by using Java's -Xmx command-line option.

7. When I run MINE in R, it hangs for a while, then R just closes. What should I do?

We believe we have resolved this issue. Try downloading the latest version of MINE and running it again.

8. When I run MINE, I get an error that says "java.lang.IllegalArgumentException: Comparison method violates its general contract!" How do I fix this?

We believe we have resolved this issue. Try downloading the latest version of MINE and running it again.

9. When I run MINE, I get an error that says "java.lang.UnsupportedClassVersionError: Bad version number in .class file." How do I fix this?

You probably have an older version of Java. MINE requires at least Java version 1.7. You can download the latest version of Java for free.

10. How did you make the neat graphics on this site?

We generated the graphics for the site using Processing.