libcamera v0.3.0+65-6ddd79b5
Supporting cameras in Linux since 2019
pwl.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: BSD-2-Clause */
2/*
3 * Copyright (C) 2019, Raspberry Pi Ltd
4 *
5 * Piecewise linear functions interface
6 */
7#pragma once
8
9#include <algorithm>
10#include <cmath>
11#include <functional>
12#include <string>
13#include <utility>
14#include <vector>
15
17
18#include "vector.h"
19
20namespace libcamera {
21
22namespace ipa {
23
24class Pwl
25{
26public:
28
29 struct Interval {
30 Interval(double _start, double _end)
31 : start(_start), end(_end) {}
32
33 bool contains(double value)
34 {
35 return value >= start && value <= end;
36 }
37
38 double clamp(double value)
39 {
40 return std::clamp(value, start, end);
41 }
42
43 double length() const { return end - start; }
44
45 double start, end;
46 };
47
48 Pwl();
49 Pwl(const std::vector<Point> &points);
50 int readYaml(const libcamera::YamlObject &params);
51
52 void append(double x, double y, double eps = 1e-6);
53
54 bool empty() const;
55 Interval domain() const;
56 Interval range() const;
57
58 double eval(double x, int *span = nullptr,
59 bool updateSpan = true) const;
60
61 std::pair<Pwl, bool> inverse(double eps = 1e-6) const;
62 Pwl compose(const Pwl &other, double eps = 1e-6) const;
63
64 void map(std::function<void(double x, double y)> f) const;
65
66 static Pwl
67 combine(const Pwl &pwl0, const Pwl &pwl1,
68 std::function<double(double x, double y0, double y1)> f,
69 double eps = 1e-6);
70
71 Pwl &operator*=(double d);
72
73 std::string toString() const;
74
75private:
76 static void map2(const Pwl &pwl0, const Pwl &pwl1,
77 std::function<void(double x, double y0, double y1)> f);
78 void prepend(double x, double y, double eps = 1e-6);
79 int findSpan(double x, int span) const;
80
81 std::vector<Point> points_;
82};
83
84} /* namespace ipa */
85
86} /* namespace libcamera */
A class representing the tree structure of the YAML content.
Definition: yaml_parser.h:26
Describe a univariate piecewise linear function in two-dimensional real space.
Definition: pwl.h:25
std::string toString() const
Assemble and return a string describing the piecewise linear function.
Definition: pwl.cpp:435
void append(double x, double y, double eps=1e-6)
Append a point to the end of the piecewise linear function.
Definition: pwl.cpp:163
void map(std::function< void(double x, double y)> f) const
Apply function to (x, y) values at every control point.
Definition: pwl.cpp:358
int readYaml(const libcamera::YamlObject &params)
Populate the piecewise linear function from yaml data.
Definition: pwl.cpp:128
static Pwl combine(const Pwl &pwl0, const Pwl &pwl1, std::function< double(double x, double y0, double y1)> f, double eps=1e-6)
Combine two Pwls.
Definition: pwl.cpp:408
Pwl compose(const Pwl &other, double eps=1e-6) const
Compose two piecewise linear functions together.
Definition: pwl.cpp:309
bool empty() const
Check if the piecewise linear function is empty.
Definition: pwl.cpp:209
double eval(double x, int *span=nullptr, bool updateSpan=true) const
Evaluate the piecewise linear function.
Definition: pwl.cpp:227
Interval domain() const
Get the domain of the piecewise linear function.
Definition: pwl.cpp:188
std::pair< Pwl, bool > inverse(double eps=1e-6) const
Compute the inverse function.
Definition: pwl.cpp:268
Pwl & operator*=(double d)
Multiply the piecewise linear function.
Definition: pwl.cpp:424
Pwl()
Construct an empty piecewise linear function.
Definition: pwl.cpp:101
Interval range() const
Get the range of the piecewise linear function.
Definition: pwl.cpp:197
Vector class.
Definition: vector.h:32
Top-level libcamera namespace.
Definition: backtrace.h:17
Describe an interval in one-dimensional real space.
Definition: pwl.h:29
bool contains(double value)
Check if a given value falls within the interval.
Definition: pwl.h:33
Interval(double _start, double _end)
Construct an interval.
Definition: pwl.h:30
double start
Start of the interval.
Definition: pwl.h:45
double length() const
Compute the length of the interval.
Definition: pwl.h:43
double clamp(double value)
Clamp a value such that it is within the interval.
Definition: pwl.h:38
double end
End of the interval.
Definition: pwl.h:45
Vector class.
A YAML parser helper.