Google Git
Sign in
apache / mahout / master / . / docs / 0.13.0 / api / docs / mahout-mr / org / apache / mahout / cf / taste / impl / similarity / EuclideanDistanceSimilarity.html
blob: bd324ee2a488b1f5242af16ef9831afb72a54958 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0_121) on Fri Apr 14 22:11:35 PDT 2017 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>EuclideanDistanceSimilarity (Mahout Map-Reduce 0.13.0 API)</title>
<meta name="date" content="2017-04-14">
<link rel="stylesheet" type="text/css" href="../../../../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="EuclideanDistanceSimilarity (Mahout Map-Reduce 0.13.0 API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/EuclideanDistanceSimilarity.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/CityBlockSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/GenericItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../../index.html?org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html" target="_top">Frames</a></li>
<li><a href="EuclideanDistanceSimilarity.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.mahout.cf.taste.impl.similarity</div>
<h2 title="Class EuclideanDistanceSimilarity" class="title">Class EuclideanDistanceSimilarity</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity">org.apache.mahout.cf.taste.impl.similarity.AbstractItemSimilarity</a></li>
<li>
<ul class="inheritance">
<li>org.apache.mahout.cf.taste.impl.similarity.EuclideanDistanceSimilarity</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common">Refreshable</a>, <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">ItemSimilarity</a>, <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">UserSimilarity</a></dd>
</dl>
<hr>
<br>
<pre>public final class <span class="typeNameLabel">EuclideanDistanceSimilarity</span>
extends <a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity">AbstractItemSimilarity</a></pre>
<div class="block"><p>
An implementation of a "similarity" based on the Euclidean "distance" between two users X and Y. Thinking
of items as dimensions and preferences as points along those dimensions, a distance is computed using all
items (dimensions) where both users have expressed a preference for that item. This is simply the square
root of the sum of the squares of differences in position (preference) along each dimension.</p>
<p>The similarity could be computed as 1 / (1 + distance / sqrt(n)), so the resulting values are in the range (0,1].
This would weight against pairs that overlap in more dimensions, which should indicate more similarity,
since more dimensions offer more opportunities to be farther apart. Actually, it is computed as
sqrt(n) / (1 + distance), where n is the number of dimensions, in order to help correct for this.
sqrt(n) is chosen since randomly-chosen points have a distance that grows as sqrt(n).</p>
<p>Note that this could cause a similarity to exceed 1; such values are capped at 1.</p>
<p>Note that the distance isn't normalized in any way; it's not valid to compare similarities computed from
different domains (different rating scales, for example). Within one domain, normalizing doesn't matter much as
it doesn't change ordering.</p></div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#EuclideanDistanceSimilarity-org.apache.mahout.cf.taste.model.DataModel-">EuclideanDistanceSimilarity</a></span>(<a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model">DataModel</a>&nbsp;dataModel)</code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#EuclideanDistanceSimilarity-org.apache.mahout.cf.taste.model.DataModel-org.apache.mahout.cf.taste.common.Weighting-">EuclideanDistanceSimilarity</a></span>(<a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model">DataModel</a>&nbsp;dataModel,
<a href="../../../../../../../org/apache/mahout/cf/taste/common/Weighting.html" title="enum in org.apache.mahout.cf.taste.common">Weighting</a>&nbsp;weighting)</code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>double[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#itemSimilarities-long-long:A-">itemSimilarities</a></span>(long&nbsp;itemID1,
long[]&nbsp;itemID2s)</code>
<div class="block">A bulk-get version of <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarity-long-long-"><code>ItemSimilarity.itemSimilarity(long, long)</code></a>.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>double</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#itemSimilarity-long-long-">itemSimilarity</a></span>(long&nbsp;itemID1,
long&nbsp;itemID2)</code>
<div class="block">
Returns the degree of similarity, of two items, based on the preferences that users have expressed for
the items.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#refresh-java.util.Collection-">refresh</a></span>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common">Refreshable</a>&gt;&nbsp;alreadyRefreshed)</code>
<div class="block">
Triggers "refresh" -- whatever that means -- of the implementation.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#setPreferenceInferrer-org.apache.mahout.cf.taste.similarity.PreferenceInferrer-">setPreferenceInferrer</a></span>(<a href="../../../../../../../org/apache/mahout/cf/taste/similarity/PreferenceInferrer.html" title="interface in org.apache.mahout.cf.taste.similarity">PreferenceInferrer</a>&nbsp;inferrer)</code>
<div class="block">
Attaches a <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/PreferenceInferrer.html" title="interface in org.apache.mahout.cf.taste.similarity"><code>PreferenceInferrer</code></a> to the <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity"><code>UserSimilarity</code></a> implementation.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#toString--">toString</a></span>()</code>&nbsp;</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code>double</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html#userSimilarity-long-long-">userSimilarity</a></span>(long&nbsp;userID1,
long&nbsp;userID2)</code>
<div class="block">
Returns the degree of similarity, of two users, based on the their preferences.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.apache.mahout.cf.taste.impl.similarity.AbstractItemSimilarity">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;org.apache.mahout.cf.taste.impl.similarity.<a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity">AbstractItemSimilarity</a></h3>
<code><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html#allSimilarItemIDs-long-">allSimilarItemIDs</a>, <a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html#getDataModel--">getDataModel</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="EuclideanDistanceSimilarity-org.apache.mahout.cf.taste.model.DataModel-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EuclideanDistanceSimilarity</h4>
<pre>public&nbsp;EuclideanDistanceSimilarity(<a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model">DataModel</a>&nbsp;dataModel)
throws <a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if <a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model"><code>DataModel</code></a> does not have preference values</dd>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></code></dd>
</dl>
</li>
</ul>
<a name="EuclideanDistanceSimilarity-org.apache.mahout.cf.taste.model.DataModel-org.apache.mahout.cf.taste.common.Weighting-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>EuclideanDistanceSimilarity</h4>
<pre>public&nbsp;EuclideanDistanceSimilarity(<a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model">DataModel</a>&nbsp;dataModel,
<a href="../../../../../../../org/apache/mahout/cf/taste/common/Weighting.html" title="enum in org.apache.mahout.cf.taste.common">Weighting</a>&nbsp;weighting)
throws <a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if <a href="../../../../../../../org/apache/mahout/cf/taste/model/DataModel.html" title="interface in org.apache.mahout.cf.taste.model"><code>DataModel</code></a> does not have preference values</dd>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></code></dd>
</dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="setPreferenceInferrer-org.apache.mahout.cf.taste.similarity.PreferenceInferrer-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setPreferenceInferrer</h4>
<pre>public final&nbsp;void&nbsp;setPreferenceInferrer(<a href="../../../../../../../org/apache/mahout/cf/taste/similarity/PreferenceInferrer.html" title="interface in org.apache.mahout.cf.taste.similarity">PreferenceInferrer</a>&nbsp;inferrer)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html#setPreferenceInferrer-org.apache.mahout.cf.taste.similarity.PreferenceInferrer-">UserSimilarity</a></code></span></div>
<div class="block"><p>
Attaches a <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/PreferenceInferrer.html" title="interface in org.apache.mahout.cf.taste.similarity"><code>PreferenceInferrer</code></a> to the <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity"><code>UserSimilarity</code></a> implementation.
</p></div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html#setPreferenceInferrer-org.apache.mahout.cf.taste.similarity.PreferenceInferrer-">setPreferenceInferrer</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">UserSimilarity</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>inferrer</code> - <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/PreferenceInferrer.html" title="interface in org.apache.mahout.cf.taste.similarity"><code>PreferenceInferrer</code></a></dd>
</dl>
</li>
</ul>
<a name="userSimilarity-long-long-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>userSimilarity</h4>
<pre>public&nbsp;double&nbsp;userSimilarity(long&nbsp;userID1,
long&nbsp;userID2)
throws <a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html#userSimilarity-long-long-">UserSimilarity</a></code></span></div>
<div class="block"><p>
Returns the degree of similarity, of two users, based on the their preferences.
</p></div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html#userSimilarity-long-long-">userSimilarity</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/UserSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">UserSimilarity</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>userID1</code> - first user ID</dd>
<dd><code>userID2</code> - second user ID</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>similarity between the users, in [-1,1] or <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Double.html?is-external=true#NaN" title="class or interface in java.lang"><code>Double.NaN</code></a> similarity is unknown</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/NoSuchUserException.html" title="class in org.apache.mahout.cf.taste.common">NoSuchUserException</a></code> - if either user is known to be non-existent in the data</dd>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></code> - if an error occurs while accessing the data</dd>
</dl>
</li>
</ul>
<a name="itemSimilarity-long-long-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>itemSimilarity</h4>
<pre>public final&nbsp;double&nbsp;itemSimilarity(long&nbsp;itemID1,
long&nbsp;itemID2)
throws <a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarity-long-long-">ItemSimilarity</a></code></span></div>
<div class="block"><p>
Returns the degree of similarity, of two items, based on the preferences that users have expressed for
the items.
</p></div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarity-long-long-">itemSimilarity</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">ItemSimilarity</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>itemID1</code> - first item ID</dd>
<dd><code>itemID2</code> - second item ID</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>similarity between the items, in [-1,1] or <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Double.html?is-external=true#NaN" title="class or interface in java.lang"><code>Double.NaN</code></a> similarity is unknown</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/NoSuchItemException.html" title="class in org.apache.mahout.cf.taste.common">NoSuchItemException</a></code> - if either item is known to be non-existent in the data</dd>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></code> - if an error occurs while accessing the data</dd>
</dl>
</li>
</ul>
<a name="itemSimilarities-long-long:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>itemSimilarities</h4>
<pre>public&nbsp;double[]&nbsp;itemSimilarities(long&nbsp;itemID1,
long[]&nbsp;itemID2s)
throws <a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarities-long-long:A-">ItemSimilarity</a></code></span></div>
<div class="block"><p>A bulk-get version of <a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarity-long-long-"><code>ItemSimilarity.itemSimilarity(long, long)</code></a>.</p></div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html#itemSimilarities-long-long:A-">itemSimilarities</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/similarity/ItemSimilarity.html" title="interface in org.apache.mahout.cf.taste.similarity">ItemSimilarity</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>itemID1</code> - first item ID</dd>
<dd><code>itemID2s</code> - second item IDs to compute similarity with</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>similarity between itemID1 and other items</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/NoSuchItemException.html" title="class in org.apache.mahout.cf.taste.common">NoSuchItemException</a></code> - if any item is known to be non-existent in the data</dd>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/TasteException.html" title="class in org.apache.mahout.cf.taste.common">TasteException</a></code> - if an error occurs while accessing the data</dd>
</dl>
</li>
</ul>
<a name="refresh-java.util.Collection-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>refresh</h4>
<pre>public final&nbsp;void&nbsp;refresh(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common">Refreshable</a>&gt;&nbsp;alreadyRefreshed)</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface:&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html#refresh-java.util.Collection-">Refreshable</a></code></span></div>
<div class="block"><p>
Triggers "refresh" -- whatever that means -- of the implementation. The general contract is that any
<a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common"><code>Refreshable</code></a> should always leave itself in a consistent, operational state, and that the refresh
atomically updates internal state from old to new.
</p></div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html#refresh-java.util.Collection-">refresh</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common">Refreshable</a></code></dd>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html#refresh-java.util.Collection-">refresh</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/AbstractItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity">AbstractItemSimilarity</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>alreadyRefreshed</code> - <a href="../../../../../../../org/apache/mahout/cf/taste/common/Refreshable.html" title="interface in org.apache.mahout.cf.taste.common"><code>Refreshable</code></a>s that are known to have already been
refreshed as a result of an initial call to a {#refresh(Collection)} method on some
object. This ensure that objects in a refresh dependency graph aren't refreshed twice
needlessly.</dd>
</dl>
</li>
</ul>
<a name="toString--">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>toString</h4>
<pre>public final&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toString()</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code>&nbsp;in class&nbsp;<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/EuclideanDistanceSimilarity.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/CityBlockSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../../../org/apache/mahout/cf/taste/impl/similarity/GenericItemSimilarity.html" title="class in org.apache.mahout.cf.taste.impl.similarity"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../../index.html?org/apache/mahout/cf/taste/impl/similarity/EuclideanDistanceSimilarity.html" target="_top">Frames</a></li>
<li><a href="EuclideanDistanceSimilarity.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2008&#x2013;2017 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>