summaryrefslogtreecommitdiff
path: root/fuzzylite/fl/defuzzifier/Centroid.h
blob: b056eace061bfc0fa2ec984c76eca4c4738401cf (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
/*
 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_CENTROID_H
#define FL_CENTROID_H

#include "fl/defuzzifier/IntegralDefuzzifier.h"

namespace fl {

    /**
      The Centroid class is an IntegralDefuzzifier that computes the centroid
      of a fuzzy set represented in a Term.

      @author Juan Rada-Vilela, Ph.D.
      @see BiSector
      @see IntegralDefuzzifier
      @see Defuzzifier
      @since 4.0
     */
    class FL_API Centroid : public IntegralDefuzzifier {
    public:
        explicit Centroid(int resolution = defaultResolution());
        virtual ~Centroid() FL_IOVERRIDE;
        FL_DEFAULT_COPY_AND_MOVE(Centroid)

        virtual std::string className() const FL_IOVERRIDE;

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

        /**
          Computes the centroid of a fuzzy set. The defuzzification process
          integrates over the fuzzy set utilizing the boundaries given as
          parameters. The integration algorithm is the midpoint rectangle
          method (https://en.wikipedia.org/wiki/Rectangle_method).

          @param term is the fuzzy set
          @param minimum is the minimum value of the fuzzy set
          @param maximum is the maximum value of the fuzzy set
          @return the @f$x@f$-coordinate of the centroid of the fuzzy set
         */
        virtual scalar defuzzify(const Term* term,
                scalar minimum, scalar maximum) const FL_IOVERRIDE;
        virtual Centroid* clone() const FL_IOVERRIDE;

        static Defuzzifier* constructor();
    };
}

#endif /* FL_CENTROID_H */