LensKit Evaluator

Facilities for evaluating recommender algorithms.

License	GNU Lesser General Public License version 2.1 or later
GroupId	org.grouplens.lenskit
ArtifactId	lenskit-eval
Last Version	3.0-T5
Release Date	Mar 30, 2016
Type	jar
Description	LensKit Evaluator Facilities for evaluating recommender algorithms.
Project URL	http://lenskit.org
Source Code Management	http://github.com/grouplens/lenskit

Download lenskit-eval

Filename	Size
lenskit-eval-3.0-T5.pom
lenskit-eval-3.0-T5.jar	100 KB
lenskit-eval-3.0-T5-sources.jar	82 KB
lenskit-eval-3.0-T5-javadoc.jar	375 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.grouplens.lenskit/lenskit-eval/ -->
<dependency>
    <groupId>org.grouplens.lenskit</groupId>
    <artifactId>lenskit-eval</artifactId>
    <version>3.0-T5</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.grouplens.lenskit/lenskit-eval/
implementation 'org.grouplens.lenskit:lenskit-eval:3.0-T5'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.grouplens.lenskit/lenskit-eval/
implementation ("org.grouplens.lenskit:lenskit-eval:3.0-T5")

Apache Buildr

'org.grouplens.lenskit:lenskit-eval:jar:3.0-T5'

Apache Ivy

<dependency org="org.grouplens.lenskit" name="lenskit-eval" rev="3.0-T5">
  <artifact name="lenskit-eval" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.grouplens.lenskit', module='lenskit-eval', version='3.0-T5')
)

Scala SBT

libraryDependencies += "org.grouplens.lenskit" % "lenskit-eval" % "3.0-T5"

Leiningen

[org.grouplens.lenskit/lenskit-eval "3.0-T5"]

Dependencies

compile (7)

Group / Artifact	Type	Version
org.grouplens.lenskit : lenskit-groovy	jar	3.0-T5
org.slf4j : slf4j-api	jar	1.7.12
org.grouplens.lenskit : lenskit-core	jar	3.0-T5
joda-time : joda-time	jar	2.3
org.apache.ant : ant	jar	1.8.4
org.hamcrest : hamcrest-library	jar	1.3
com.google.code.findbugs : annotations	jar	2.0.1

test (3)

Group / Artifact	Type	Version
org.grouplens.lenskit : lenskit-knn	jar	3.0-T5
junit : junit	jar	4.11
org.grouplens.lenskit : lenskit-test	jar	3.0-T5

Project Modules

There are no modules declared in this project.

LensKit

Deprecation Notice: The Java implementation of LensKit is now deprecated. For new projects, use the Python version.

LensKit is an implementation of collaborative filtering algorithms and a set of tools for benchmarking them. This readme is about working with the LensKit source code. For more information about LensKit and its documentation, visit the web site or wiki. You can also find information on the wiki about how to use LensKit without downloading the source code. If this is your first time working with LensKit we recommend checking out the Getting Started guide.

LensKit is made available under the MIT license; see LICENSE.md.

Installation and Dependency Management

LensKit is built and deployed with Gradle and publishes its artifacts to Maven Central. To install it to the local Maven repository, making it available to other projects using standard Java-based tools, check out this repository and run ./gradlew install; it is then available to other projects by depending directly on it in your Maven, Gradle, Ivy, or SBT project. The source code can also be checked out and used in most Java IDEs.

Working with the Code

To work with the LensKit code, import the Gradle project into your IDE. Most modern Java IDEs include support for Gradle, including IntelliJ IDEA (used by most LensKit developers), Eclipse, and NetBeans.

No other particular setup is needed.

Modules

LensKit is comprised of several modules. The top-level lenskit module serves as a container to build them and provide common settings and dependencies. The other modules are as follows:

• lenskit-api -- the common, public recommender API exposed by LensKit, independent of its actual implementations.
• lenskit-test -- infrastructure and helper code for testing.
• lenskit-core -- the core support code and configuration facilities for the rest of LensKit. It is the entry point for most of what you want to do with LensKit, providing support for configuring and building recommenders.
• lenskit-knn -- k-NN recommenders (user-user and item-item collaborative filtering).
• lenskit-svd -- the FunkSVD recommender (and eventually real SVD recommenders).
• lenskit-slopeone -- Slope-One recommenders.
• lenskit-eval -- the evaluation framework and APIs, along with a command line evaluation runner.
• lenskit-groovy -- support for reading LensKit configurations from Groovy files.
• lenskit-all -- a metapackage you can depend on to pull in the rest of the LensKit packages.
• lenskit-cli -- the LensKit command line interface.
• lenskit-gradle -- the Gradle plugin to script the LensKit evaluator
• lenskit-integration-tests -- additional integration tests for LensKit.

Running the Tests

After you make changes, it's good to run the unit tests. You can run many of them from your IDE; run all tests in the org.grouplens.lenskit package (and subpackages) across all modules.

To run the full test suite, including data-driven unit tests and integration tests, use Gradle:

$ ./gradlew check

Copyright

LensKit is under the following copyright and license:

Copyright 2014-2017 LensKit Contributors. Copyright 2010-2014 Regents of the University of Minnesota Work on LensKit has been funded by the National Science Foundation under grants IIS 05-34939, 08-08692, 08-12148, and 10-17697.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contributing to LensKit

We welcome contribution to LensKit. If you are looking for something to work on, we recommend perusing the open tickets on GitHub or asking on the mailing list.

We prefer to receive code submissions as GitHub pull requests. To do this:

1. Fork the LensKit repository (lenskit/lenskit) on GitHub
2. Push your changes to your fork
3. Submit a pull request via the GitHub web interface

For additional details, including legal maters, please see CONTRIBUTING.md.

GroupLens Research

Versions

Version
3.0-T5 Mar 30, 2016
3.0-T4 Mar 8, 2016
3.0-T3 Feb 17, 2016
3.0-T2 Nov 3, 2015
3.0-T1 Oct 2, 2015
2.2.1 Nov 11, 2015
2.2 May 6, 2015
2.2-M4 Apr 9, 2015
2.2-M3 Feb 17, 2015
2.2-M2 Feb 4, 2015
2.2-M1 Feb 1, 2015
2.1.0.1 Aug 12, 2014
2.1 Jul 12, 2014
2.1-M4 Jun 10, 2014
2.1-M3 May 8, 2014
2.1-M2 Feb 6, 2014
2.1-M1 Jan 18, 2014
2.0.5 Nov 12, 2013
2.0.4 Oct 30, 2013
2.0.3.2 Oct 16, 2013
2.0.3.1 Oct 15, 2013
2.0.3 Oct 13, 2013
2.0.2 Sep 28, 2013
2.0.1 Sep 17, 2013
2.0 Sep 3, 2013
2.0-M2 Sep 2, 2013
2.0-M1 Aug 17, 2013
1.3 Jul 22, 2013
1.2 Jun 27, 2013
1.1 Jun 3, 2013
1.0.2 Oct 16, 2012
1.0.1 Oct 4, 2012
1.0 Sep 13, 2012
1.0-M1 Sep 8, 2012
0.11 Aug 16, 2012
0.10 Mar 29, 2012
0.9 Dec 22, 2011
0.8.1 Oct 11, 2011
0.8 Oct 1, 2011
0.7 Sep 10, 2011
0.6 Aug 27, 2011
0.5 Aug 12, 2011
0.4 Jul 30, 2011
0.3.1 Jul 19, 2011
0.3 Jul 16, 2011
0.2 Jul 1, 2011
0.1 Jun 18, 2011
0.0.3 May 27, 2011
0.0.2 Mar 29, 2011
0.0.1 Mar 26, 2011