パッケージ org.springframework.data.domain

クラス Similarity

java.lang.ObjectSE
org.springframework.data.domain.Score
org.springframework.data.domain.Similarity
実装されているすべてのインターフェース:
SerializableSE
public final class Similarity extends Score
ScoringFunction によって決定された正規化された類似度スコアを表す値オブジェクト。

類似度は [0.0, 1.0] の範囲に制限されます。0.0 は最も類似度が低い値、1.0 は最も類似度が高い値を表します。この正規化により、異なるスコアリングモデルやシステム間で類似度スコアを一貫して比較できるようになります。

主にベクトル検索や近似最近傍法で使用され、正規化された関連性に基づいて結果がランク付けされます。ベクトル検索では通常、クエリベクトルとの類似度に基づいて順序付けられた結果のコレクションが返されます。

このクラスは、情報検索コンテキスト、推奨システム、結果の正規化された比較を必要とするその他のアプリケーションで使用するために設計されています。

Similarity インスタンスには、類似性 value と、それを生成するために使用される ScoringFunction に関する情報の両方が含まれており、スコアの適切な解釈のためのコンテキストを提供します。

インスタンスは不変であり、範囲ベースの比較をサポートしているため、フィルタリングやランキング操作に適しています。このクラスは Score を継承し、共通のスコアリング機能を継承しながら、類似性に特化したセマンティクスを追加しています。

導入:
4.0
作成者:
Mark Paluch
関連事項:

  • メソッドの詳細

    • of

      public static Similarity of(double similarity)
      ScoringFunction.unspecified() を使用して、プレーンな similarity 値から新しい Similarity を作成します。
      パラメーター:
      similarity - 特定の ScoringFunction がない場合の類似度値。範囲は 0 から 1 までです。
      戻り値:
      新しい Similarity

    • of

      public static Similarity of(double similarity, ScoringFunction function)
      生の値とそれに関連付けられた ScoringFunction から新しい Similarity を作成します。
      パラメーター:
      similarity - [0.0, 1.0] 範囲内の類似度値。
      function - この類似性を生み出したスコアリング関数。
      戻り値:
      新しい Similarity インスタンス。
      例外:
      IllegalArgumentExceptionSE - 値が許容範囲外の場合。

    • raw

      public static Similarity raw(double similarity, ScoringFunction function)
      検証なしで生の Similarity 値を作成します。

      検索エンジンやデータベースなどの信頼できるソースから類似度の値を受け入れるときに使用することを目的としています。

      パラメーター:
      similarity - [0.0, 1.0] 範囲内の類似度値。
      function - この類似性を生み出したスコアリング関数。
      戻り値:
      新しい Similarity インスタンス。

    • between

      public static Range<Similarity> between(Similarity min, Similarity max)
      指定された Similarity の間に Range を作成します。
      パラメーター:
      min - 下限値。
      max - 上限値。
      戻り値:
      指定された値間の Range。

    • between

      public static Range<Similarity> between(double minValue, double maxValue)
      特定のスコアリング関数を使用して、指定された値 without specifying から最小および最大の Similarity を作成し、新しい Range を作成します。
      パラメーター:
      minValue - 低い値は 0 から 1 の範囲です。
      maxValue - 上限値は 0 から 1 の範囲です。
      戻り値:
      指定された値間の Range。

    • between

      public static Range<Similarity> between(double minValue, double maxValue, ScoringFunction function)
      生の値と指定されたスコアリング関数を使用して、Similarity 値の Range を作成します。
      パラメーター:
      minValue - 類似度の値が低い。
      maxValue - 類似度の上限値。
      function - 値に関連付けるスコアリング関数。
      戻り値:
      Similarity 値の Range。

    • equals

      public boolean equals(ObjectSE o)
      オーバーライド:
      クラス Score の equals