You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mahout.apache.org by co...@apache.org on 2009/10/09 14:52:01 UTC

[CONF] Apache Lucene Mahout > RecommendationExamples

Space: Apache Lucene Mahout (http://cwiki.apache.org/confluence/display/MAHOUT)
Page: RecommendationExamples (http://cwiki.apache.org/confluence/display/MAHOUT/RecommendationExamples)

Added by Isabel Drost:
---------------------------------------------------------------------
h1. Introduction 

This quick start page describes how to run the recommendation examples provided by Mahout. Mahout comes with four recommendation mining examples. They are based on netflixx, jester, grouplens and bookcrossing respectively.

h1. Steps 

h2. Testing it on one single machine w/o cluster 

In the examples directory type: 
{code} 
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.bookcrossing.BookCrossingRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" 
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.netflix.NetflixRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" 
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.netflix.TransposeToByUser" -Dexec.args="<OPTIONS>" 
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.jester.JesterRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" 
mvn -q exec:java -Dexec.mainClass="org.apache.mahout.cf.taste.example.grouplens.GroupLensRecommenderEvaluatorRunner" -Dexec.args="<OPTIONS>" 
{code} 

h2. Running it on the cluster 

* In $MAHOUT_HOME/, build the jar containing the job (mvn install) The job will be generated in $MAHOUT_HOME/core/target/ and it's name will contain the Mahout version number. For example, when using Mahout 0.1 release, the job will be mahout-core-0.1.jar 
* (Optional) 1 Start up Hadoop: $HADOOP_HOME/bin/start-all.sh 
* Put the data: $HADOOP_HOME/bin/hadoop fs -put <PATH TO DATA> testdata 
* Run the Job: $HADOOP_HOME/bin/hadoop jar $MAHOUT_HOME/core/target/mahout-core-<MAHOUT VERSION>.job org.apache.mahout.cf.taste.example.<JOB> <OPTIONS> 
* Get the data out of HDFS and have a look. Use bin/hadoop fs -lsr output to view all outputs. 

h1. Command line options 
{code} 
Usage: <JOB>
--input (-i) input The Path for input preferences. This argument is optional except for the netflix example.
--help (-h) Print out help 
{code} 



Change your notification preferences: http://cwiki.apache.org/confluence/users/viewnotifications.action