summaryrefslogtreecommitdiff
path: root/fuzzylite/fl/term/Trapezoid.h
blob: ebf5ed80eb98f18fa847288011a1dbacd2cf5bf7 (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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*
 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_TRAPEZOID_H
#define FL_TRAPEZOID_H

#include "fl/term/Term.h"

namespace fl {

    /**
      The Trapezoid class is a basic Term that represents the trapezoidal
      membership function.

      @image html trapezoid.svg

      @author Juan Rada-Vilela, Ph.D.
      @see Term
      @see Variable
      @since 4.0
     */
    class FL_API Trapezoid : public Term {
    private:
        scalar _vertexA, _vertexB, _vertexC, _vertexD;
    public:
        explicit Trapezoid(const std::string& name = "",
                scalar vertexA = fl::nan,
                scalar vertexB = fl::nan,
                scalar vertexC = fl::nan,
                scalar vertexD = fl::nan,
                scalar height = 1.0);
        virtual ~Trapezoid() FL_IOVERRIDE;
        FL_DEFAULT_COPY_AND_MOVE(Trapezoid)

        virtual std::string className() const FL_IOVERRIDE;
        /**
          Returns the parameters of the term
          @return `"vertexA vertexB vertexC vertexD [height]"`
         */
        virtual std::string parameters() const FL_IOVERRIDE;
        /**
          Configures the term with the parameters
          @param parameters as `"vertexA vertexB vertexC vertexD [height]"`
         */
        virtual void configure(const std::string& parameters) FL_IOVERRIDE;

        virtual Complexity complexity() const FL_IOVERRIDE;
        /**
          Computes the membership function evaluated at @f$x@f$
          @param x
          @return @f$\begin{cases}
          0h & \mbox{if $x \not\in[a,d]$}\cr
          h \times \min(1, (x - a) / (b - a)) & \mbox{if $x < b$}\cr
          1h & \mbox{if $x \leq c$}\cr
          h (d - x) / (d - c) & \mbox{if $x < d$}\cr
          0h & \mbox{otherwise}
          \end{cases}@f$

          where @f$h@f$ is the height of the Term,
                @f$a@f$ is the first vertex of the Trapezoid,
                @f$b@f$ is the second vertex of the Trapezoid,
                @f$c@f$ is the third vertex of the Trapezoid,
                @f$d@f$ is the fourth vertex of the Trapezoid
         */
        virtual scalar membership(scalar x) const FL_IOVERRIDE;

        /**
          Sets the first vertex of the trapezoid
          @param a is the first vertex of the trapezoid
         */
        virtual void setVertexA(scalar a);
        /**
          Gets the first vertex of the trapezoid
          @return the first vertex of the trapezoid
         */
        virtual scalar getVertexA() const;

        /**
          Sets the second vertex of the trapezoid
          @param b is the second vertex of the trapezoid
         */
        virtual void setVertexB(scalar b);
        /**
          Gets the second vertex of the trapezoid
          @return the second vertex of the trapezoid
         */
        virtual scalar getVertexB() const;

        /**
          Sets the third vertex of the trapezoid
          @param c is the third vertex of the trapezoid
         */
        virtual void setVertexC(scalar c);
        /**
          Gets the third vertex of the trapezoid
          @return the third vertex of the trapezoid
         */
        virtual scalar getVertexC() const;

        /**
          Sets the fourth vertex of the trapezoid
          @param d is the fourth vertex of the trapezoid
         */
        virtual void setVertexD(scalar d);
        /**
          Gets the fourth vertex of the trapezoid
          @return the fourth vertex of the trapezoid
         */
        virtual scalar getVertexD() const;

        virtual Trapezoid* clone() const FL_IOVERRIDE;

        static Term* constructor();
    };
}
#endif /* FL_TRAPEZOID_H */