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

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">