summaryrefslogtreecommitdiff
path: root/fuzzylite/fl/term/Activated.h
blob: f122a25df5c70569bbfaa67dade65cc1e42c3eb4 (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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/*
 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_ACTIVATED_H
#define FL_ACTIVATED_H

#include "fl/term/Term.h"

namespace fl {
    class TNorm;

    /**
      The Activated class is a special Term that contains pointers to the
      necessary information of a term that has been activated as part of the
      Antecedent of a Rule. The ownership of the pointers is not transferred to
      objects of this class. The Activated class was named
      `Thresholded` in versions 4.0 and earlier.

      @author Juan Rada-Vilela, Ph.D.
      @see OutputVariable
      @see Term
      @since 5.0
     */
    class FL_API Activated : public Term {
    private:
        const Term* _term;
        scalar _degree;
        const TNorm* _implication;

    public:
        explicit Activated(const Term* term = fl::null, scalar degree = 1.0,
                const TNorm* implication = fl::null);
        virtual ~Activated() FL_IOVERRIDE;
        FL_DEFAULT_COPY_AND_MOVE(Activated)

        virtual std::string className() const FL_IOVERRIDE;
        /**
          Returns the parameters of the term
          @return `"degree implication term"`
         */
        virtual std::string parameters() const FL_IOVERRIDE;
        /**
          Does nothing.
          @param parameters are irrelevant
         */
        virtual void configure(const std::string& parameters) FL_IOVERRIDE;

        virtual Complexity complexity() const FL_IOVERRIDE;
        /**
          Computes the implication of the activation degree and the membership
          function value of @f$x@f$
          @param x is a value
          @return @f$d \otimes \mu(x)@f$, where @f$d@f$ is the activation degree
         */
        virtual scalar membership(scalar x) const FL_IOVERRIDE;
        virtual std::string toString() const FL_IOVERRIDE;

        /**
          Sets the activated term
          @param term is the activated term
         */
        virtual void setTerm(const Term* term);
        /**
          Gets the activated term
          @return the activated term
         */
        virtual const Term* getTerm() const;

        /**
          Sets the activation degree of the term
          @param degree is the activation degree of the term
         */
        virtual void setDegree(scalar degree);
        /**
          Gets the activation degree of the term
          @return the activation degree of the term
         */
        virtual scalar getDegree() const;

        /**
          Sets the implication operator
          @param implication is the implication operator
         */
        virtual void setImplication(const TNorm* implication);
        /**
          Gets the implication operator
          @return the implication operator
         */
        virtual const TNorm* getImplication() const;

        virtual Activated* clone() const FL_IOVERRIDE;
    };
}
#endif /* FL_ACTIVATED_H */