RubyGems - rroonga - Versions diffs - 5.0.5-x64-mingw32 → 5.0.8-x64-mingw32 - Mend

rroonga 5.0.5-x64-mingw32 → 5.0.8-x64-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (594) hide show

data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.11. Scorer &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.11. スコアラー &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v5.0.6-226-gd7da7e7ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../index.html" />
     <link rel="up" title="7. リファレンスマニュアル" href="../reference.html" />
     <link rel="next" title="7.11.3.1. scorer_tf_at_most" href="scorers/scorer_tf_at_most.html" />
     <link rel="prev" title="7.10.1. QueryExpanderTSV" href="query_expanders/tsv.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="query_expanders/tsv.html" title="7.10.1. QueryExpanderTSV"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" accesskey="U">7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>
@@ -72,52 +72,30 @@
           <div class="body" role="main">
   <div class="section" id="scorer">
-<h1>7.11. Scorer<a class="headerlink" href="#scorer" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<h1>7.11. スコアラー<a class="headerlink" href="#scorer" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <div class="section" id="summary">
 <h2>7.11.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>Groonga has scorer module that customizes score function. Score
-function computes score of matched record. The default scorer function
-uses the number of appeared terms. It is also known as TF (term
-frequency).</p>
-<p>TF is a fast score function but it's not suitable for the following
-cases:</p>
+<p>Groongaにはスコアー関数をカスタマイズするスコアーモジュールがあります。スコアー関数はマッチしたレコードのスコアーを計算します。デフォルトのスコアー関数は出現単語数をスコアーにします。これはTF（term frequency。単語の出現数）と呼ばれている計算方法です。</p>
+<p>TFは高速なスコアー関数ですが、次のケースには適していません。</p>
 <blockquote>
 <div><ul class="simple">
-<li>Search query contains one or more frequently-appearing words such
-as &quot;the&quot; and &quot;a&quot;.</li>
-<li>Document contains many same keywords such as &quot;They are keyword,
-keyword, keyword ... and keyword&quot;. Search engine spammer may use
-the technique.</li>
+<li><p class="first">検索クエリーが「the」や「a」のように非常によく出現する単語を含んでいる。</p>
+</li>
+<li><p class="first">文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれている。検索エンジンのスパマーはこのテクニックを使うかもしれません。</p>
+</li>
 </ul>
 </div></blockquote>
-<p>Score function can solve these cases. For example, <a class="reference external" href="http://en.wikipedia.org/wiki/Tf%E2%80%93idf">TF-IDF</a> (term
-frequency-inverse document frequency) can solve the first case.
-<a class="reference external" href="http://en.wikipedia.org/wiki/Okapi_BM25">Okapi BM25</a> can solve the
-second case. But their are slower than TF.</p>
-<p>Groonga provides TF-IDF based scorer as
-<a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> but doesn't provide Okapi BM25
-based scorer yet.</p>
-<table class="docutils field-list" frame="void" rules="none">
-<col class="field-name" />
-<col class="field-body" />
-<tbody valign="top">
-<tr class="field-odd field"><th class="field-name">orphan:</th><td class="field-body"></td>
-</tr>
-</tbody>
-</table>
+<p>スコアー関数でこれらのケースを解決できます。例えば、 <a class="reference external" href="https://ja.wikipedia.org/wiki/Tf-idf">TF-IDF</a> （term frequency-inverse document frequency。その文書中での単語の出現数を、文書全体での単語の出現数で割ったもの）は最初のケースを解決できます。 <a class="reference external" href="https://en.wikipedia.org/wiki/Okapi_BM25">Okapi BM25</a> は2番目のケースを解決できます。しかし、これらはTFより遅いです。</p>
+<p>Groongaは <a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> としてTF-IDFベースのスコアラーを提供しています。しかし、Okapi BM25ベースのスコアラーはまだ提供していません。</p>
 <blockquote id="note">
-<div><p>You don't need to resolve scoring only by score function. Score
-function is highly depends on search query. You may be able to use
-metadata of matched record.</p>
-<p>For example, Google uses <a class="reference external" href="http://en.wikipedia.org/wiki/PageRank">PageRank</a> for scoring. You may be
-able to use data type (&quot;title&quot; data are important rather than
-&quot;memo&quot; data), tag, geolocation and so on.</p>
-<p>Please stop to think about only score function for scoring.</p>
+<div><p>スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。</p>
+<p>たとえば、Googleはスコアーの計算に <a class="reference external" href="https://ja.wikipedia.org/wiki/%E3%83%9A%E3%83%BC%E3%82%B8%E3%83%A9%E3%83%B3%E3%82%AF">ページランク</a> を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。</p>
+<p>スコアーの計算をスコアー関数だけで考えることはやめましょう。</p>
 </div></blockquote>
 </div>
 <div class="section" id="usage">
 <h2>7.11.2. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>このセクションではscorerの使い方について説明します。</p>
+<p>このセクションではスコアラーの使い方について説明します。</p>
 <p>使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。</p>
 <p>サンプルスキーマ:</p>
 <p>実行例:</p>
@@ -181,21 +159,19 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 </pre></div>
 </div>
 <p><a class="reference internal" href="commands/select.html#select-match-columns"><span>match_columns</span></a> の中でscore関数を使うことができます。次に構文を示します。</p>
-<p>For score function that doesn't require any parameter such as
-<a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a>:</p>
+<p><a class="reference internal" href="scorers/scorer_tf_idf.html"><em>scorer_tf_idf</em></a> のように、いくつかのスコアー関数には引数はありません。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN)
 </pre></div>
 </div>
-<p>You can specify weight:</p>
+<p>重みを指定することができます。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN) * WEIGHT
 </pre></div>
 </div>
-<p>For score function that requires one or more parameters such as
-<a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a>:</p>
+<p><a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> のように引数が必要なスコアー関数もあります。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...)
 </pre></div>
 </div>
-<p>You can specify weight:</p>
+<p>重みを指定することができます。:</p>
 <div class="highlight-none"><div class="highlight"><pre>SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...) * WEIGHT
 </pre></div>
 </div>
@@ -247,10 +223,7 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> contains 4
-<code class="docutils literal"><span class="pre">Groonga</span></code>. If you use TF based scorer that is the default scorer,
-<code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">4</span></code>. But the actual <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">2</span></code>. Because the
-<code class="docutils literal"><span class="pre">select</span></code> command uses TF-IDF based scorer <code class="docutils literal"><span class="pre">scorer_tf_idf()</span></code>.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> には <code class="docutils literal"><span class="pre">Groonga</span></code> が4つ含まれています。デフォルトのTFベースのスコアラーを使うと、 <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">4</span></code> です。しかし、実際は <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> になります。なぜなら、この <code class="docutils literal"><span class="pre">select</span></code> コマンドはTF-IDFベースの  <code class="docutils literal"><span class="pre">scorer_tf_idf()</span></code> スコアラーを使っているからです。</p>
 <p>以下は重みを使った例です。</p>
 <p>実行例:</p>
 <div class="highlight-none"><div class="highlight"><pre>select Memos \
@@ -292,12 +265,8 @@ column_create Terms content_index COLUMN_INDEX|WITH_POSITION Memos content
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> has <code class="docutils literal"><span class="pre">22</span></code> as
-<code class="docutils literal"><span class="pre">_score</span></code>. It had <code class="docutils literal"><span class="pre">2</span></code> as <code class="docutils literal"><span class="pre">_score</span></code> in the previous example that
-doesn't specify weight.</p>
-<p>Here is an example that uses scorer that requires one
-argument. <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> scorer requires
-one argument. You can limit TF score by the scorer.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> の <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">22</span></code> です。重みを指定していない前の例では <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> でした。</p>
+<p>以下は必ず引数を1つ指定しなければいけないスコアラーを使う例です。 <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> スコアラーには引数を1つ指定しなければいけません。このスコアラーを使うと、TFのスコアーの最大値を制限することができます。</p>
 <p>実行例:</p>
 <div class="highlight-none"><div class="highlight"><pre>select Memos \
   --match_columns &quot;scorer_tf_at_most(content, 2.0)&quot; \
@@ -338,38 +307,103 @@ one argument. You can limit TF score by the scorer.</p>
 # ]
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> contains 4
-<code class="docutils literal"><span class="pre">Groonga</span></code>. If you use normal TF based scorer that is the default
-scorer, <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">4</span></code>. But the actual <code class="docutils literal"><span class="pre">_score</span></code> is <code class="docutils literal"><span class="pre">2</span></code>.
-Because the scorer used in the <code class="docutils literal"><span class="pre">select</span></code> command limits the maximum
-score value to <code class="docutils literal"><span class="pre">2</span></code>.</p>
+<p><code class="docutils literal"><span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga!</span> <span class="pre">Groonga</span> <span class="pre">is</span> <span class="pre">very</span> <span class="pre">fast!</span></code> は <code class="docutils literal"><span class="pre">Groonga</span></code> を4つ含んでいます。もし、デフォルトのスコアラーである標準のTFベースのスコアラーを使っていた場合、 <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">4</span></code> になります。しかし、実際の <code class="docutils literal"><span class="pre">_score</span></code> は <code class="docutils literal"><span class="pre">2</span></code> です。なぜなら、この <code class="docutils literal"><span class="pre">select</span></code> コマンドが使っているスコアラーは最大スコアーを <code class="docutils literal"><span class="pre">2</span></code> に制限しているからです。</p>
 <p>以下は複数のスコアラーを使う例です。</p>
-<div class="highlight-none"><div class="highlight"><pre>.. groonga-command
-.. include:: ../example/reference/scorer/usage_multiple_scorers.log
-.. select Memos \
-..   --match_columns &quot;scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)&quot; \
-..   --query &quot;Groonga&quot; \
-..   --output_columns &quot;title, content, _score&quot; \
-..   --sortby &quot;-_score&quot;
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Memos \
+  --match_columns &quot;scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)&quot; \
+  --query &quot;Groonga&quot; \
+  --output_columns &quot;title, content, _score&quot; \
+  --sortby &quot;-_score&quot;
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           &quot;title&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;content&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;Groonga is fast&quot;,
+#         &quot;Groonga! Groonga! Groonga! Groonga is very fast!&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Groonga is easy&quot;,
+#         &quot;Groonga is very easy full text search engine!&quot;,
+#         2
+#       ]
+#     ]
+#   ]
+# ]
 </pre></div>
 </div>
-<p>The <code class="docutils literal"><span class="pre">--match_columns</span></code> uses <code class="docutils literal"><span class="pre">scorer_tf_idf(title)</span></code> and
-<code class="docutils literal"><span class="pre">scorer_tf_at_most(content,</span> <span class="pre">2.0)</span></code>. <code class="docutils literal"><span class="pre">_score</span></code> value is sum of them.</p>
-<p>You can use the default scorer and custom scorer in the same
-<code class="docutils literal"><span class="pre">--match_columns</span></code>. You can use the default scorer by just specifying
-a match column:</p>
-<div class="highlight-none"><div class="highlight"><pre>.. groonga-command
-.. include:: ../example/reference/scorer/usage_default_and_custom_scorers.log
-.. select Memos \
-..   --match_columns &quot;title || scorer_tf_at_most(content, 2.0)&quot; \
-..   --query &quot;Groonga&quot; \
-..   --output_columns &quot;title, content, _score&quot; \
-..   --sortby &quot;-_score&quot;
+<p>この <code class="docutils literal"><span class="pre">--match_columns</span></code> は <code class="docutils literal"><span class="pre">scorer_tf_idf(title)</span></code> と <code class="docutils literal"><span class="pre">scorer_tf_at_most(content,</span> <span class="pre">2.0)</span></code> を使っています。 <code class="docutils literal"><span class="pre">_score</span></code> の値はこれら2つの値の合計になります。</p>
+<p>同じ <code class="docutils literal"><span class="pre">--match_columns</span></code> の中でデフォルトのスコアラーとカスタムスコアラーを使うことができます。単にマッチ対象のカラムを指定するとデフォルトのスコアラーを使います。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Memos \
+  --match_columns &quot;title || scorer_tf_at_most(content, 2.0)&quot; \
+  --query &quot;Groonga&quot; \
+  --output_columns &quot;title, content, _score&quot; \
+  --sortby &quot;-_score&quot;
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           &quot;title&quot;,
+#           &quot;ShortText&quot;
+#         ],
+#         [
+#           &quot;content&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;Groonga is fast&quot;,
+#         &quot;Groonga! Groonga! Groonga! Groonga is very fast!&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Groonga is easy&quot;,
+#         &quot;Groonga is very easy full text search engine!&quot;,
+#         2
+#       ]
+#     ]
+#   ]
+# ]
 </pre></div>
 </div>
-<p>The <code class="docutils literal"><span class="pre">--match_columns</span></code> uses the default scorer (TF) for <code class="docutils literal"><span class="pre">title</span></code> and
-<a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> for
-<code class="docutils literal"><span class="pre">content</span></code>. <code class="docutils literal"><span class="pre">_score</span></code> value is sum of them.</p>
+<p>この <code class="docutils literal"><span class="pre">--match_columns</span></code> は <code class="docutils literal"><span class="pre">title</span></code> にはデフォルトのスコアラー（TF）を使い、 <code class="docutils literal"><span class="pre">content</span></code> には <a class="reference internal" href="scorers/scorer_tf_at_most.html"><em>scorer_tf_at_most</em></a> を使います。 <code class="docutils literal"><span class="pre">_score</span></code> の値はこれらのスコアラーの結果の合計になります。</p>
 </div>
 <div class="section" id="built-in-scorers">
 <h2>7.11.3. 組み込みスコアラー<a class="headerlink" href="#built-in-scorers" title="このヘッドラインへのパーマリンク">¶</a></h2>
@@ -391,7 +425,7 @@ a match column:</p>
         <div class="sphinxsidebarwrapper">
   <h3><a href="../index.html">目次</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.11. Scorer</a><ul>
+<li><a class="reference internal" href="#">7.11. スコアラー</a><ul>
 <li><a class="reference internal" href="#summary">7.11.1. 概要</a></li>
 <li><a class="reference internal" href="#usage">7.11.2. 使い方</a></li>
 <li><a class="reference internal" href="#built-in-scorers">7.11.3. 組み込みスコアラー</a></li>
@@ -441,7 +475,7 @@ a match column:</p>
         <li class="right" >
           <a href="query_expanders/tsv.html" title="7.10.1. QueryExpanderTSV"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_at_most.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.11.3.1. scorer_tf_at_most &mdash; Groonga v5.0.6-226-gd7da7e7ドキュメント</title>
+    <title>7.11.3.1. scorer_tf_at_most &mdash; Groonga v5.0.7-264-ga2dae20ドキュメント</title>
     <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../../',
-        VERSION:     '5.0.6-226-gd7da7e7',
+        VERSION:     '5.0.7-264-ga2dae20',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,10 +26,10 @@
     <script type="text/javascript" src="../../_static/doctools.js"></script>
     <script type="text/javascript" src="../../_static/translations.js"></script>
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v5.0.6-226-gd7da7e7ドキュメント" href="../../index.html" />
-    <link rel="up" title="7.11. Scorer" href="../scorer.html" />
+    <link rel="top" title="Groonga v5.0.7-264-ga2dae20ドキュメント" href="../../index.html" />
+    <link rel="up" title="7.11. スコアラー" href="../scorer.html" />
     <link rel="next" title="7.11.3.2. scorer_tf_idf" href="scorer_tf_idf.html" />
-    <link rel="prev" title="7.11. Scorer" href="../scorer.html" />
+    <link rel="prev" title="7.11. スコアラー" href="../scorer.html" />
   </head>
   <body role="document">
 <div class="header">
@@ -59,11 +59,11 @@
           <a href="scorer_tf_idf.html" title="7.11.3.2. scorer_tf_idf"
              accesskey="N">次へ</a> |</li>
         <li class="right" >
-          <a href="../scorer.html" title="7.11. Scorer"
+          <a href="../scorer.html" title="7.11. スコアラー"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
-          <li class="nav-item nav-item-2"><a href="../scorer.html" accesskey="U">7.11. Scorer</a> &raquo;</li>
+          <li class="nav-item nav-item-2"><a href="../scorer.html" accesskey="U">7.11. スコアラー</a> &raquo;</li>
       </ul>
     </div>
@@ -83,8 +83,144 @@
 </div>
 <div class="section" id="summary">
 <h2>7.11.3.1.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> is a scorer based on TF (term frequency).</p>
-<p>TODO</p>
+<p><code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> はTF（term frequency。単語の出現数）ベースのスコアラーです。</p>
+<p>TF-IDFベースのスコアラーを含むTFベースのスコアラーは次のケースに対して適していません。</p>
+<p>文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれているとその文書のスコアーが高くなってしまいます。これは意図した挙動ではありません。検索エンジンのスパマーはこのテクニックを使うかもしれません。</p>
+<p><code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> はTFベースのスコアラーですが、このケースを解決できます。</p>
+<p><code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> はスコアーの最大値を制限します。つまり、 <code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> は1つのマッチの影響を制限することができるということです。</p>
+<p>文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれていても、 <code class="docutils literal"><span class="pre">scorer_tf_at_most(column,</span> <span class="pre">2.0)</span></code> はスコアーの値として大きくても <code class="docutils literal"><span class="pre">2</span></code> しか返しません。</p>
+<blockquote id="note">
+<div><p>スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。</p>
+<p>たとえば、Googleはスコアーの計算に <a class="reference external" href="https://ja.wikipedia.org/wiki/%E3%83%9A%E3%83%BC%E3%82%B8%E3%83%A9%E3%83%B3%E3%82%AF">ページランク</a> を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。</p>
+<p>スコアーの計算をスコアー関数だけで考えることはやめましょう。</p>
+</div></blockquote>
+</div>
+<div class="section" id="syntax">
+<h2>7.11.3.1.2. 構文<a class="headerlink" href="#syntax" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このスコアラーの引数は1つです。:</p>
+<div class="highlight-none"><div class="highlight"><pre>scorer_tf_at_most(column, max)
+scorer_tf_at_most(index, max)
+</pre></div>
+</div>
+</div>
+<div class="section" id="usage">
+<h2>7.11.3.1.3. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このセクションではscorerの使い方について説明します。</p>
+<p>使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。</p>
+<p>サンプルスキーマ:</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>table_create Logs TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs message COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Terms TABLE_PAT_KEY ShortText \
+  --default_tokenizer TokenBigram \
+  --normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Terms message_index COLUMN_INDEX|WITH_POSITION Logs message
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+</pre></div>
+</div>
+<p>サンプルデータ:</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>load --table Logs
+[
+{&quot;message&quot;: &quot;Notice&quot;},
+{&quot;message&quot;: &quot;Notice Notice&quot;},
+{&quot;message&quot;: &quot;Notice Notice Notice&quot;},
+{&quot;message&quot;: &quot;Notice Notice Notice Notice&quot;},
+{&quot;message&quot;: &quot;Notice Notice Notice Notice Notice&quot;}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 5]
+</pre></div>
+</div>
+<p>次のように <a class="reference internal" href="../commands/select.html#select-match-columns"><span>match_columns</span></a> で <code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code> を指定します。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre>select Logs \
+  --match_columns &quot;scorer_tf_at_most(message, 3.0)&quot; \
+  --query &quot;Notice&quot; \
+  --output_columns &quot;message, _score&quot; \
+  --sortby &quot;-_score&quot;
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           &quot;message&quot;,
+#           &quot;Text&quot;
+#         ],
+#         [
+#           &quot;_score&quot;,
+#           &quot;Int32&quot;
+#         ]
+#       ],
+#       [
+#         &quot;Notice Notice Notice Notice Notice&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Notice Notice Notice Notice&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Notice Notice Notice&quot;,
+#         3
+#       ],
+#       [
+#         &quot;Notice Notice&quot;,
+#         2
+#       ],
+#       [
+#         &quot;Notice&quot;,
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+</pre></div>
+</div>
+<p>もし、文書が <code class="docutils literal"><span class="pre">Notice</span></code> という単語を3個以上含んでいたら、スコアーは <code class="docutils literal"><span class="pre">3</span></code> になります。なぜなら、この <code class="docutils literal"><span class="pre">select</span></code> ではスコアーの最大値を <code class="docutils literal"><span class="pre">3.0</span></code> と指定しているからです。</p>
+<p>もし、文書が <code class="docutils literal"><span class="pre">Notice</span></code> という単語を1つか2つしか含んでいなかったら、スコアーは <code class="docutils literal"><span class="pre">1</span></code> か <code class="docutils literal"><span class="pre">2</span></code> になります。なぜなら、スコアーが指定された最大値 <code class="docutils literal"><span class="pre">3.0</span></code> より小さいからです。</p>
+</div>
+<div class="section" id="parameters">
+<h2>7.11.3.1.4. 引数<a class="headerlink" href="#parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このセクションではすべての引数について説明します。</p>
+<div class="section" id="required-parameters">
+<h3>7.11.3.1.4.1. 必須引数<a class="headerlink" href="#required-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>1つだけ必須の引数があります。</p>
+<div class="section" id="column">
+<h4>7.11.3.1.4.1.1. <code class="docutils literal"><span class="pre">column</span></code><a class="headerlink" href="#column" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>マッチ対象のデータカラムです。このデータカラムにはインデックスが張られていなければいけません。</p>
+</div>
+<div class="section" id="index">
+<h4>7.11.3.1.4.1.2. <code class="docutils literal"><span class="pre">index</span></code><a class="headerlink" href="#index" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>検索に使うインデックスカラムです。</p>
+</div>
+</div>
+<div class="section" id="optional-parameters">
+<h3>7.11.3.1.4.2. 省略可能引数<a class="headerlink" href="#optional-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>省略可能な引数はありません。</p>
+</div>
+</div>
+<div class="section" id="return-value">
+<h2>7.11.3.1.5. 戻り値<a class="headerlink" href="#return-value" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>このスコアラーは <a class="reference internal" href="../types.html#builtin-type-float"><span>Float</span></a> でスコアーの値を返します。</p>
+<p><a class="reference internal" href="../commands/select.html"><em>select</em></a> は <code class="docutils literal"><span class="pre">Float</span></code> ではなく <code class="docutils literal"><span class="pre">Int32</span></code> で <code class="docutils literal"><span class="pre">_score</span></code> を返します。これは、後方互換性を維持するために <code class="docutils literal"><span class="pre">Float</span></code> から <code class="docutils literal"><span class="pre">Int32</span></code> にキャストしているためです。</p>
+<p>スコアーは制限つきのTFで計算します。</p>
+</div>
+<div class="section" id="see-also">
+<h2>7.11.3.1.6. 参考<a class="headerlink" href="#see-also" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<ul class="simple">
+<li><a class="reference internal" href="../scorer.html"><em>スコアラー</em></a></li>
+</ul>
 </div>
 </div>
@@ -98,13 +234,26 @@
   <ul>
 <li><a class="reference internal" href="#">7.11.3.1. <code class="docutils literal"><span class="pre">scorer_tf_at_most</span></code></a><ul>
 <li><a class="reference internal" href="#summary">7.11.3.1.1. 概要</a></li>
+<li><a class="reference internal" href="#syntax">7.11.3.1.2. 構文</a></li>
+<li><a class="reference internal" href="#usage">7.11.3.1.3. 使い方</a></li>
+<li><a class="reference internal" href="#parameters">7.11.3.1.4. 引数</a><ul>
+<li><a class="reference internal" href="#required-parameters">7.11.3.1.4.1. 必須引数</a><ul>
+<li><a class="reference internal" href="#column">7.11.3.1.4.1.1. <code class="docutils literal"><span class="pre">column</span></code></a></li>
+<li><a class="reference internal" href="#index">7.11.3.1.4.1.2. <code class="docutils literal"><span class="pre">index</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#optional-parameters">7.11.3.1.4.2. 省略可能引数</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#return-value">7.11.3.1.5. 戻り値</a></li>
+<li><a class="reference internal" href="#see-also">7.11.3.1.6. 参考</a></li>
 </ul>
 </li>
 </ul>
   <h4>前のトピックへ</h4>
   <p class="topless"><a href="../scorer.html"
-                        title="前の章へ">7.11. Scorer</a></p>
+                        title="前の章へ">7.11. スコアラー</a></p>
   <h4>次のトピックへ</h4>
   <p class="topless"><a href="scorer_tf_idf.html"
                         title="次の章へ">7.11.3.2. <code class="docutils literal"><span class="pre">scorer_tf_idf</span></code></a></p>
@@ -142,11 +291,11 @@
           <a href="scorer_tf_idf.html" title="7.11.3.2. scorer_tf_idf"
              >次へ</a> |</li>
         <li class="right" >
-          <a href="../scorer.html" title="7.11. Scorer"
+          <a href="../scorer.html" title="7.11. スコアラー"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.6-226-gd7da7e7ドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.0.7-264-ga2dae20ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
-          <li class="nav-item nav-item-2"><a href="../scorer.html" >7.11. Scorer</a> &raquo;</li>
+          <li class="nav-item nav-item-2"><a href="../scorer.html" >7.11. スコアラー</a> &raquo;</li>
       </ul>
     </div>
     <div class="footer" role="contentinfo">