summaryrefslogtreecommitdiff
path: root/fuzzylite/fl/defuzzifier/WeightedSumCustom.h
blob: c055d1eb14d13fc9a4df210093c6304803e8966e (plain)
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
71
72
73
74
75
76
77
78
/*
 fuzzylite (R), a fuzzy logic control library in C++.
 Copyright (C) 2010-2017 FuzzyLite Limited. All rights reserved.
 Author: Juan Rada-Vilela, Ph.D. <jcrada@fuzzylite.com>

 This file is part of fuzzylite.

 fuzzylite is free software: you can redistribute it and/or modify it under
 the terms of the FuzzyLite License included with the software.

 You should have received a copy of the FuzzyLite License along with
 fuzzylite. If not, see <http://www.fuzzylite.com/license/>.

 fuzzylite is a registered trademark of FuzzyLite Limited.
 */

#ifndef FL_WEIGHTEDSUMCUSTOM_H
#define FL_WEIGHTEDSUMCUSTOM_H


#include "fl/defuzzifier/WeightedDefuzzifier.h"

namespace fl {

    /**
      The (experimental) WeightedSumCustom class is a WeightedDefuzzifier that computes the
      weighted sum of a fuzzy set represented in an Aggregated Term utilizing
      the fuzzy operators for implication and aggregation to compute the weighted
      sum. This is an experimental approach to take advantage of customization
      thanks to the object-oriented design.

      @author Juan Rada-Vilela, Ph.D.
      @see WeightedSum
      @see WeightedAverage
      @see WeightedAverageCustom
      @see WeightedDefuzzifier
      @see Defuzzifier
      @since 6.0
      @experimental
     */
    class FL_API WeightedSumCustom : public WeightedDefuzzifier {
    public:
        explicit WeightedSumCustom(Type type = Automatic);
        explicit WeightedSumCustom(const std::string& type);
        virtual ~WeightedSumCustom() FL_IOVERRIDE;
        FL_DEFAULT_COPY_AND_MOVE(WeightedSumCustom)

        virtual std::string className() const FL_IOVERRIDE;

        virtual Complexity complexity(const Term* term) const FL_IOVERRIDE;

        /**
          Computes the weighted sum of the given fuzzy set represented in an
          Aggregated Term as @f$y = \sum_i{w_iz_i} @f$,
          where @f$w_i@f$ is the activation degree of term @f$i@f$, and @f$z_i
          = \mu_i(w_i) @f$.

          If the implication and aggregation operators are set to fl::null (or
          set to AlgebraicProduct and UnboundedSum, respectively), then the
          operation of WeightedAverageCustom is the same as the WeightedAverage.
          Otherwise, the implication and aggregation operators are utilized to
          compute the multiplications and sums in @f$y@f$, respectively.

          @param term is the fuzzy set represented as an AggregatedTerm
          @param minimum is the minimum value of the range (only used for Tsukamoto)
          @param maximum is the maximum value of the range (only used for Tsukamoto)
          @return the weighted sum of the given fuzzy set
         */
        virtual scalar defuzzify(const Term* term,
                scalar minimum, scalar maximum) const FL_IOVERRIDE;
        virtual WeightedSumCustom* clone() const FL_IOVERRIDE;

        static Defuzzifier* constructor();
    };
}

#endif  /* FL_WEIGHTEDSUMCUSTOM_H */