aboutsummaryrefslogtreecommitdiffstats
path: root/searchlib/src/vespa/searchlib/features/distancefeature.h
blob: f190ddcaa967b3b3a6b319d42cfdfd7feab9c928 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.

#pragma once

#include <vespa/searchlib/fef/blueprint.h>
#include <vespa/searchcommon/attribute/attributecontent.h>

namespace search::features {

/** Convenience typedef. */
using GeoLocationSpecPtrs = std::vector<const search::common::GeoLocationSpec *>;

/**
 * Implements the executor for the distance feature.
 */
class DistanceExecutor : public fef::FeatureExecutor {
private:
    GeoLocationSpecPtrs                 _locations;
    const attribute::IAttributeVector * _pos;
    attribute::IntegerContent           _intBuf;
    feature_t                           _best_index;
    feature_t                           _best_x;
    feature_t                           _best_y;

    feature_t calculateDistance(uint32_t docId);
    feature_t calculate2DZDistance(uint32_t docId);

public:
    /**
     * Constructs an executor for the distance feature.
     *
     * @param locations location objects associated with the query environment.
     * @param pos the attribute to use for positions (expects zcurve encoding).
     */
    DistanceExecutor(GeoLocationSpecPtrs locations,
                     const attribute::IAttributeVector * pos);
    void execute(uint32_t docId) override;

    static const feature_t DEFAULT_DISTANCE;
};

/**
 * Implements the blueprint for the distance executor.
 */
class DistanceBlueprint : public fef::Blueprint {
private:
    vespalib::string _field_name;
    vespalib::string _arg_string;
    uint32_t _attr_id;
    bool _use_geo_pos;
    bool _use_nns_tensor;
    bool _use_item_label;

    bool setup_geopos(const vespalib::string &attr);
    bool setup_nns(const vespalib::string &attr);

public:
    DistanceBlueprint();
    ~DistanceBlueprint();
    void visitDumpFeatures(const fef::IIndexEnvironment & env, fef::IDumpFeatureVisitor & visitor) const override;
    fef::Blueprint::UP createInstance() const override;
    fef::ParameterDescriptions getDescriptions() const override {
        return fef::ParameterDescriptions().desc().string().desc().string().string();
    }
    bool setup(const fef::IIndexEnvironment & env, const fef::ParameterList & params) override;
    void prepareSharedState(const fef::IQueryEnvironment& env, fef::IObjectStore& store) const override;
    fef::FeatureExecutor &createExecutor(const fef::IQueryEnvironment &env, vespalib::Stash &stash) const override;
};

}