What is Ourmine?

Ourmine is a data mining toolkit built to be easily learned/taught. It implements a variety of languages constructed in a modular way, providing the opportunity for easy extendability.

Ourmine features

• Easily obtained and can be run from any UNIX based operating system, including OSX & Linux
• Without the complications of a GUI, advanced data mining concepts can be taught effectively through the use of just a few commands
• Ourmine utilizes a modulated structure, allowing experiments to be easily conducted using Ourmine by adding any custom code
• Along with its many data preparation and formatting functions, Ourmine allows the power of interactive bash scripting to be conducted on the fly, providing a higher level of understanding and productivity
• And much more...

How to install Ourmine

Installing Ourmine is very quick and simple. From the command line, change to any directory and enter the following:

$ wget -O INSTALL ourmine.googlecode.com/svn/trunk/our/INSTALL; bash INSTALL

This will run the install script, and will place everything in the correct directories. If working, the output should look something like this:

Install beginning. About to zap any existing /Users/timm/opt/ourmine.
Enter to continue, Control-C to abort.

Downloading... On slow connections, this may take a few minutes.
Downloaded.
Ourmine installed to: /Users/timm/opt/ourmine.
To run, enter "cd /Users/timm/opt/ourmine"' then "./ourmine".
To remove, enter "rm -rf /Users/timm/opt/ourmine."
Testing for correct installation... You should see the OURMINE prompt.
Ourmine - Copyright 2009 by Tim Menzies, Adam Nelson, Gregory Gay
OURMINE> 

How to test Ourmine

At the prompt, type demo000 to show the weather.arff data set

OURMINE> demo000
@relation weather

@attribute outlook {sunny, overcast, rainy}
@attribute temperature real
@attribute humidity real
@attribute windy {TRUE, FALSE}
@attribute play {yes, no}

@data
sunny,85,85,FALSE,no
sunny,80,90,TRUE,no
overcast,83,86,FALSE,yes
rainy,70,96,FALSE,yes
rainy,68,80,FALSE,yes
rainy,65,70,TRUE,no
overcast,64,65,TRUE,yes
sunny,72,95,FALSE,no
sunny,69,70,FALSE,yes
rainy,75,80,FALSE,yes
sunny,75,70,TRUE,yes
overcast,72,90,TRUE,yes
overcast,81,75,FALSE,yes
rainy,71,91,TRUE,no

To see a decision tree learned from this data, type:

OURMINE> j4810 $Data/discrete/weather.arff | para 1 3
 
outlook = sunny
|   humidity <= 75: yes (2.0)
|   humidity > 75: no (3.0)
outlook = overcast: yes (4.0)
outlook = rainy
|   windy = TRUE: no (2.0)
|   windy = FALSE: yes (3.0)

To exit Ourmine, type control-d.

How to run Ourmine

To run Ourmine from the command line, enter:

$ cd $HOME/opt/ourmine/our
$ ./ourmine

Note: On some systems, Ourmine will be directly installed to $HOME/opt/ourmine From here you will be given the Ourmine prompt.

How to Uninstall Ourmine

Uninstalling Ourmine is even simpler than installing it. From the command line, enter:

$ rm -rf $HOME/opt/ourmine