Search Results for

    Show / Hide Table of Contents

    Class PhraseSuggesterDescriptor<T>

    The phrase suggester adds additional logic on top of the term suggester to select entire corrected phrases instead of individual tokens weighted based on ngram-language models. In practice this suggester will be able to make better decisions about which tokens to pick based on co-occurrence and frequencies.

    Inheritance
    object
    DescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester>
    SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>
    PhraseSuggesterDescriptor<T>
    Implements
    IDescriptor
    IPhraseSuggester
    ISuggester
    Inherited Members
    SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>.Size(int?)
    SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>.Analyzer(string)
    SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>.Field(Field)
    SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>.Field<TValue>(Expression<Func<T, TValue>>)
    DescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester>.Self
    DescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester>.Assign<TValue>(TValue, Action<IPhraseSuggester, TValue>)
    object.Equals(object)
    object.Equals(object, object)
    object.GetHashCode()
    object.GetType()
    object.MemberwiseClone()
    object.ReferenceEquals(object, object)
    object.ToString()
    Namespace: OpenSearch.Client
    Assembly: OpenSearch.Client.dll
    Syntax
    public class PhraseSuggesterDescriptor<T> : SuggestDescriptorBase<PhraseSuggesterDescriptor<T>, IPhraseSuggester, T>, IDescriptor, IPhraseSuggester, ISuggester where T : class
    Type Parameters
    Name Description
    T

    Methods

    | Edit this page View Source

    Collate(Func<PhraseSuggestCollateDescriptor<T>, IPhraseSuggestCollate>)

    Checks each suggestion against the specified query to prune suggestions for which no matching docs exist in the index. The collate query for a suggestion is run only on the local shard from which the suggestion has been generated from. The query must be specified and can be templated. The current suggestion is automatically made available as the {{suggestion}} variable, which should be used in your query. You can still specify your own template params , the suggestion value will be added to the variables you specify. Additionally, you can specify a prune to control if all phrase suggestions will be returned; when set to true the suggestions will have an additional option collate_match, which will be true if matching documents for the phrase was found, false otherwise. The default value for prune is false.

    Declaration
    public PhraseSuggesterDescriptor<T> Collate(Func<PhraseSuggestCollateDescriptor<T>, IPhraseSuggestCollate> selector)
    Parameters
    Type Name Description
    Func<PhraseSuggestCollateDescriptor<T>, IPhraseSuggestCollate> selector
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    Confidence(double?)

    The confidence level defines a factor applied to the input phrases score which is used as a threshold for other suggest candidates. Only candidates that score higher than the threshold will be included in the result. For instance a confidence level of 1.0 will only return suggestions that score higher than the input phrase. If set to 0.0 the top N candidates are returned. The default is 1.0.

    Declaration
    public PhraseSuggesterDescriptor<T> Confidence(double? confidence)
    Parameters
    Type Name Description
    double? confidence
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    DirectGenerator(params Func<DirectGeneratorDescriptor<T>, IDirectGenerator>[])

    Candidate generators used to produce a list of possible terms per term in the given text. A single candidate generator is similar to a term suggester called for each individual term in the text. The output of the generators is subsequently scored in combination with the candidates from the other terms for suggestion candidates. Each of the generators is called per term in the original text.

    Declaration
    public PhraseSuggesterDescriptor<T> DirectGenerator(params Func<DirectGeneratorDescriptor<T>, IDirectGenerator>[] generators)
    Parameters
    Type Name Description
    Func<DirectGeneratorDescriptor<T>, IDirectGenerator>[] generators
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    ForceUnigrams(bool?)

    Declaration
    public PhraseSuggesterDescriptor<T> ForceUnigrams(bool? forceUnigrams = true)
    Parameters
    Type Name Description
    bool? forceUnigrams
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    GramSize(int?)

    Sets max size of the n-grams (shingles) in the field. If the field doesn’t contain n-grams (shingles), this should be omitted or set to 1. Note that OpenSearch tries to detect the gram size based on the specified field. If the field uses a shingle filter, the gram_size is set to the max_shingle_size if not explicitly set.

    Declaration
    public PhraseSuggesterDescriptor<T> GramSize(int? gramSize)
    Parameters
    Type Name Description
    int? gramSize
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    Highlight(Func<PhraseSuggestHighlightDescriptor, IPhraseSuggestHighlight>)

    Sets up suggestion highlighting. If not provided then no highlighted field is returned. If provided must contain exactly pre_tag and post_tag, which are wrapped around the changed tokens. If multiple tokens in a row are changed the entire phrase of changed tokens is wrapped rather than each token.

    Declaration
    public PhraseSuggesterDescriptor<T> Highlight(Func<PhraseSuggestHighlightDescriptor, IPhraseSuggestHighlight> selector)
    Parameters
    Type Name Description
    Func<PhraseSuggestHighlightDescriptor, IPhraseSuggestHighlight> selector
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    MaxErrors(double?)

    The maximum percentage of the terms considered to be misspellings in order to form a correction. This method accepts a float value in the range [0..1) as a fraction of the actual query terms or a number >=1 as an absolute number of query terms. The default is set to 1.0, meaning only corrections with at most one misspelled term are returned. Note that setting this too high can negatively impact performance. Low values like 1 or 2 are recommended; otherwise the time spend in suggest calls might exceed the time spend in query execution.

    Declaration
    public PhraseSuggesterDescriptor<T> MaxErrors(double? maxErrors)
    Parameters
    Type Name Description
    double? maxErrors
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    RealWordErrorLikelihood(double?)

    The likelihood of a term being a misspelled even if the term exists in the dictionary. The default is 0.95, meaning 5% of the real words are misspelled.

    Declaration
    public PhraseSuggesterDescriptor<T> RealWordErrorLikelihood(double? realWordErrorLikelihood)
    Parameters
    Type Name Description
    double? realWordErrorLikelihood
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    Separator(char?)

    The separator that is used to separate terms in the bigram field. If not set the whitespace character is used as a separator.

    Declaration
    public PhraseSuggesterDescriptor<T> Separator(char? separator)
    Parameters
    Type Name Description
    char? separator
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    ShardSize(int?)

    Sets the maximum number of suggested terms to be retrieved from each individual shard. During the reduce phase, only the top N suggestions are returned based on the size option. Defaults to 5.

    Declaration
    public PhraseSuggesterDescriptor<T> ShardSize(int? shardSize)
    Parameters
    Type Name Description
    int? shardSize
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    Smoothing(Func<SmoothingModelContainerDescriptor, SmoothingModelContainer>)

    Smoothing model to balance weight between infrequent grams (grams (shingles) are not existing in the index) and frequent grams (appear at least once in the index).

    Declaration
    public PhraseSuggesterDescriptor<T> Smoothing(Func<SmoothingModelContainerDescriptor, SmoothingModelContainer> selector)
    Parameters
    Type Name Description
    Func<SmoothingModelContainerDescriptor, SmoothingModelContainer> selector
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    Text(string)

    Sets the text / query to provide suggestions for.

    Declaration
    public PhraseSuggesterDescriptor<T> Text(string text)
    Parameters
    Type Name Description
    string text
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>
    | Edit this page View Source

    TokenLimit(int?)

    Declaration
    public PhraseSuggesterDescriptor<T> TokenLimit(int? tokenLimit)
    Parameters
    Type Name Description
    int? tokenLimit
    Returns
    Type Description
    PhraseSuggesterDescriptor<T>

    Implements

    IDescriptor
    IPhraseSuggester
    ISuggester

    Extension Methods

    SuffixExtensions.Suffix(object, string)
    • Edit this page
    • View Source
    In this article
    • Methods
      • Collate(Func<PhraseSuggestCollateDescriptor<T>, IPhraseSuggestCollate>)
      • Confidence(double?)
      • DirectGenerator(params Func<DirectGeneratorDescriptor<T>, IDirectGenerator>[])
      • ForceUnigrams(bool?)
      • GramSize(int?)
      • Highlight(Func<PhraseSuggestHighlightDescriptor, IPhraseSuggestHighlight>)
      • MaxErrors(double?)
      • RealWordErrorLikelihood(double?)
      • Separator(char?)
      • ShardSize(int?)
      • Smoothing(Func<SmoothingModelContainerDescriptor, SmoothingModelContainer>)
      • Text(string)
      • TokenLimit(int?)
    • Implements
    • Extension Methods
    Back to top Generated by DocFX