Дочерний (от VibratingPoint) класс. Предназначен для помещения множества цветных точек на кадр и отслеживания вибрации каждой из них Подробнее...

#include <colored_point_handler.h>

Граф наследования:ColoredPointHandler:

[см. легенду]

Граф связей класса ColoredPointHandler:

[см. легенду]

Открытые члены
	ColoredPointHandler (Point2f init_coordinates, double sampling_rate, int point_id, float radius_resize_factor, std::string output_csv_filename)
	Конструктор этого класса Подробнее...

	~ColoredPointHandler ()
	Деструктор этого класса Подробнее...

void	Draw (Mat &frame) override
	Отрисовывает точку и данные, связанные с ней Подробнее...

void	SetColoringMode (int coloring_mode)
	Устанавливает нужный режим отрисовки цветом Подробнее...

Открытые члены унаследованные от Histogram
	Histogram (int width, int height, int x_limit, int id, std::vector< double > &x_values, std::vector< float > &y_values)
	Конструктор этого класса Подробнее...

	~Histogram ()
	Деструктор этого класса Подробнее...

void	DetectEvent (int event, int x, int y, int flags)
	callback функция для определения события (используется для хэндлинга клика мышью) Подробнее...

void	ShowHistogram ()
	Выводит гистограмму в окно гистограммы Подробнее...

void	SetXValues (std::vector< double > x_values)
	Устанавливает X-ы Подробнее...

void	SetYValues (std::vector< float > y_values)
	Устанавливает Y-ы Подробнее...

void	SetHistogramFlag (bool flag)
	Устанавливает статус флага отрисовки гистограммы Подробнее...

void	SetHistogramWindowProperty (int prop_id, int prop_value)
	Обновляет статус окна гистограммы (например, для вывода на передний план) Подробнее...

Открытые члены унаследованные от VibratingPoint
void	ExecuteFFT ()
	Выполняет БПФ для нахождения частоты вибрации. Подробнее...

void	AddNewPointPosition (Point2f position)
	Добавляет новую пространственную координату в конец контейнера VibratingPoint::point_coordinates_;. Подробнее...

void	AddNewPointTime (double time)
	Добавляет новую временную координату (время кадра, на котором новая позиция точки была трекнута) в конец контейнера VibratingPoint::point_time_coordinates_;. Подробнее...

bool	IsInteracted (Point2i coordinates)
	Проверяет точку на наличие взаимодействия с ней (если курсор попал в область взаимодействия точки VibratingPoint::interaction_box_) Подробнее...

void	SetSensivity (double sensivity)
	Устанавливает чувствительность, влияющую на confidence. Подробнее...

void	CalculateAmplitude ()
	Проводит необходимые для вычисления амплитуды вычисления Подробнее...

virtual void	Draw (Mat &frame)=0
	Отрисовывает точку на кадре Подробнее...

Point2f	GetLastFoundCoordinates ()
	Возвращает последний элемент вектора координат Подробнее...

std::vector< double >	GetCurrentVibrationFrequency ()
	Возвращает вектор текущих частот точки Подробнее...

double	GetCurrentMainFrequency ()
	Возвращает текущую "основную" частоту Подробнее...

Point3f	GetRelativeAmplitude ()
	Возвращает последнюю найденную относительную амплитуду Подробнее...

Point3f	GetCurrentAmplitude ()
	Возвращает последнюю найденную относительную амплитуду Подробнее...

double	GetCurrentConfidenceLevel ()
	Возвращает последний найденный уровень достоверности Подробнее...

Открытые члены унаследованные от OutputToCsv
	OutputToCsv (std::string output_file_name, std::vector< Point2f > &point_coordinates, std::vector< double > &point_time_coordinates, int point_id)
	Конструктор этого класса Подробнее...

void	Write ()
	Добавляет данные для записи Подробнее...

Закрытые типы
enum	coloring_mode { DEFAULT , COLORING_BASED_ON_FREQUENCY , COLORING_BASED_ON_AMPLITUDE }
	Перечисление, используемое для более удобного отображения текущего режима подсветки точки Подробнее...

Закрытые члены
void	DrawHistogram () override
	Отрисовывает гистограмму Подробнее...

void	DrawPoint (Mat &frame)
	Отрисовывает точку на кадре Подробнее...

void	DrawInteractionRectangle (Mat &frame)
	Отрисовывает прямоугольник взаимодействия Подробнее...

void	UpdatePointColor () override
	Обновляет текущий цвет точки Подробнее...

Закрытые данные
int	coloring_mode_

float	radius_resize_factor_
	Коэффициент рескейла для радиуса точки Подробнее...

int	point_id_
	ID точки (нет блин почки) Подробнее...

Scalar	point_color_
	Цвет точки Подробнее...

Дополнительные унаследованные члены
Открытые статические члены унаследованные от Histogram
static void	OnMouse (int event, int x, int y, int flags, void *userdata)
	callback функция для определения события (используется для хэндлинга клика мышью) Подробнее...

Статические открытые данные унаследованные от VibratingPoint
static std::pair< double, double >	extremum_amplitude_
	Максимум и минимум амплитуды среди всех VibratingPoint объектов-наследников Подробнее...

virtual void	DrawHistogram ()=0
	Отрисовывает гистограмму спектра частот колебаний точки (полученную после БПФ в методе ExecuteFFT()) Подробнее...

virtual void	UpdatePointColor ()=0
	Обновляем текущий цвет точки Подробнее...

Защищенные данные унаследованные от Histogram
bool	is_histogram_plotted_
	Флаг для отрисовки гистограммы Подробнее...

Защищенные данные унаследованные от VibratingPoint
Rect	interaction_box_
	Прямоугольник (область) взаимодействия с точкой Подробнее...

int	interaction_offset_
	Половина длины прямоугольника взаимодействия Подробнее...

bool	interacted_
	Флаг взаимодействия с точкой Подробнее...

Point3f	relative_amplitude_
	Относительные амплитуды вибрации по x, y. Выражается отношением амплитуды Подробнее...

Point3f	current_amplitude_
	Фактические амплитуды вибрации по x, y. Выражаюытся в пикселях Подробнее...

std::vector< Point2f >	point_coordinates_
	Контейнер для координат точки Подробнее...

std::vector< double >	x_coordinates_
	Контейнер для координат точки по оси X. Подробнее...

std::vector< double >	y_coordinates_
	Контейнер для координат точки по оси Y. Подробнее...

std::vector< cv::Point2f >	vec_meaned_coordinates_of_point_
	Контейнер для координат точки относительно нулевого уровня Подробнее...

std::vector< double >	frequencies_
	Контейнер для частот точки Подробнее...

double	main_frequency_
	Главная частота (основная) Подробнее...

std::vector< double >	point_time_coordinates_
	Контейнер для временных координат точки Подробнее...

double	sampling_rate_
	Частота сэмплирования (фактически - FPS исходного видео) Подробнее...

int	current_point_radius_
	Радиус точки, который нужен для её отрисовки Подробнее...

int	default_point_radius_
	Дефолтный радиус точки Подробнее...

std::vector< double >	x_
	Контейнер для хранения координат гистограммы по оси X (фактически - найденный спектр частот вибрации точки после выполнения БПФ) Подробнее...

std::vector< float >	y_
	Контейнер для хранения координат гистограммы по оси Y (фактически - найденные магнитуды точки после выполнения БПФ) Подробнее...

double	sensivity_
	Чувствительность определения вибрации Подробнее...

double	confidence_level_
	Рейтинг достоверности вибрации Подробнее...

Подробное описание

Дочерний (от VibratingPoint) класс. Предназначен для помещения множества цветных точек на кадр и отслеживания вибрации каждой из них

Объект класса - "цветная" точка на видео, положение которой отслеживается с течением времени для вычисления частоты вибрации этой точки

Точку можно отрисовать методом Draw() на кадре

Также при взаимодействии с точкой (VibratingPoint::IsInteracted()) будет выводиться гистограмма частот в отдельное окно (DrawHistogram())

См. определение в файле colored_point_handler.h строка 26

Перечисления

◆ coloring_mode

enum ColoredPointHandler::coloring_mode

private

Перечисление, используемое для более удобного отображения текущего режима подсветки точки

См. определение в файле colored_point_handler.h строка 31

    {
        DEFAULT,
        COLORING_BASED_ON_FREQUENCY,
        COLORING_BASED_ON_AMPLITUDE,
    };

Конструктор(ы)

◆ ColoredPointHandler()

ColoredPointHandler::ColoredPointHandler	(	Point2f	init_coordinates,
		double	sampling_rate,
		int	point_id,
		float	radius_resize_factor,
		std::string	output_csv_filename
	)

Конструктор этого класса

Аргументы

init_coordinates	самые первые координаты точки (фактически - координаты клика мышью на окне, куда выводилось исходное видео)
sampling_rate	частота сэмплирования (фактически - FPS исходного видео)
point_id	ID точки
radius_resize_factor	коэффициент масштабирования радиуса отрисовываемой точки
output_csv_filename	имя (путь) csv-файла для записи метаданных

Заметки: Коэффициент масштабирования: FrameHandler::InitTextResizeFactors()

См. определение в файле colored_point_handler.cpp строка 3

                                                                                                                                                                :
    Histogram{ 600, 300, sampling_rate / 2, point_id, x_, y_ },
    OutputToCsv{ output_csv_filename, point_coordinates_, point_time_coordinates_, point_id },
    point_id_{ point_id },
    radius_resize_factor_{ radius_resize_factor },
    coloring_mode_{ COLORING_BASED_ON_FREQUENCY }
{
    interaction_offset_ = 3;
    sampling_rate_ = sampling_rate;
 
    // Добавляем первые координаты клика мышью
    point_coordinates_.push_back(init_coordinates);
    interaction_box_ = Rect(
        Point2i(init_coordinates.x - interaction_offset_, init_coordinates.y - interaction_offset_),
        Point2i(init_coordinates.x + interaction_offset_, init_coordinates.y + interaction_offset_)
    );
    interacted_ = false;
 
    default_point_radius_ = 4 * radius_resize_factor;
    current_point_radius_ = default_point_radius_;
 
    frequencies_.push_back(0.0);
    relative_amplitude_ = Point3f(0.0, 0.0, 0.0);
 
    sensivity_ = 0.01;
    confidence_level_ = 1.0;
 
    point_color_ = Scalar(0, 0, 255);
}

◆ ~ColoredPointHandler()

ColoredPointHandler::~ColoredPointHandler ( )

Деструктор этого класса

Вызывает метод родительского класса OutputToCsv Write() для записи метаданных

См. определение в файле colored_point_handler.cpp строка 33

{
    Write();
}

Методы

◆ Draw()

void ColoredPointHandler::Draw ( Mat & frame )

overridevirtual

Отрисовывает точку и данные, связанные с ней

Аргументы

frame изображение, на котором будет происходить отрисовка

Замещает VibratingPoint.

См. определение в файле colored_point_handler.cpp строка 38

{
    // отрисовываем круг вокруг точки
    DrawPoint(frame);
    // отрисовываем гистограмму
    DrawHistogram();
}

◆ DrawHistogram()

void ColoredPointHandler::DrawHistogram ( )

overrideprivatevirtual

Отрисовывает гистограмму

Замещает VibratingPoint.

См. определение в файле colored_point_handler.cpp строка 51

{
    if (is_histogram_plotted_)
    {
        SetXValues(x_);
        SetYValues(y_);
        ShowHistogram();
    }
}

◆ DrawInteractionRectangle()

void ColoredPointHandler::DrawInteractionRectangle ( Mat & frame )

private

Отрисовывает прямоугольник взаимодействия

Аргументы

frame изображение, на котором будет происходить отрисовка

См. определение в файле colored_point_handler.cpp строка 68

{
    rectangle(frame, interaction_box_, Scalar(0, 0, 255), 1);
}

◆ DrawPoint()

void ColoredPointHandler::DrawPoint ( Mat & frame )

private

Отрисовывает точку на кадре

Аргументы

frame изображение, на котором будет происходить отрисовка

См. определение в файле colored_point_handler.cpp строка 61

{
    UpdatePointColor();
    // отрисовываем круг вокруг точки
    circle(frame, point_coordinates_.back(), current_point_radius_, point_color_, FILLED);
}

◆ SetColoringMode()

void ColoredPointHandler::SetColoringMode ( int coloring_mode )

Устанавливает нужный режим отрисовки цветом

Аргументы

coloring_mode режим, который нужно установить

Заметки: ColoredPointHandler::coloring_mode

См. определение в файле colored_point_handler.cpp строка 46

{
    coloring_mode_ = coloring_mode;
}

◆ UpdatePointColor()

void ColoredPointHandler::UpdatePointColor ( )

overrideprivatevirtual

Обновляет текущий цвет точки

Замещает VibratingPoint.

См. определение в файле colored_point_handler.cpp строка 73

{
    switch (coloring_mode_)
    {
    case DEFAULT:
    {
        current_point_radius_ = default_point_radius_;
        point_color_ = Scalar(0, 0, 255);
        break;
    }
    case COLORING_BASED_ON_FREQUENCY:
    {
        current_point_radius_ = default_point_radius_;
        // переведём диапазон частоты [0; range_limit] в [0; 255] int color value;
        if (!frequencies_.empty())
        {
            point_color_ = HelperFunctions::RatioToRgb(main_frequency_ / (sampling_rate_ / 2));
        }
        break;
    }
    case COLORING_BASED_ON_AMPLITUDE:
    {
        current_point_radius_ = default_point_radius_;
        // переведём диапазон амплитуд [0; max_amplitude_] в [0; 255] int color value;
        double current_amplitude_absolute = sqrt(current_amplitude_.x * current_amplitude_.x + current_amplitude_.y * current_amplitude_.y);
        double ratio = (current_amplitude_absolute - extremum_amplitude_.second) / (extremum_amplitude_.first - extremum_amplitude_.second);
        point_color_ = HelperFunctions::RatioToRgb(ratio);
        if (point_color_ == Scalar(0, 0, 0))
        {
            std::cout << "ratio: " << ratio << std::endl;
            std::cout << "current_amplitude_.x: " << current_amplitude_.x << std::endl;
            std::cout << "max ampl: " << extremum_amplitude_.first << std::endl;
            std::cout << "min ampl: " << extremum_amplitude_.second << std::endl;
        }
        break;
    }
    }
    if (interacted_)
    {
        point_color_ = Scalar(255, 255, 255);
        current_point_radius_ *= 3;
    }
}

Данные класса

◆ coloring_mode_

int ColoredPointHandler::coloring_mode_

private

См. определение в файле colored_point_handler.h строка 90

◆ point_color_

Scalar ColoredPointHandler::point_color_

private

Цвет точки

См. определение в файле colored_point_handler.h строка 102

◆ point_id_

int ColoredPointHandler::point_id_

private

ID точки (нет блин почки)

См. определение в файле colored_point_handler.h строка 98

◆ radius_resize_factor_

float ColoredPointHandler::radius_resize_factor_

private

Коэффициент рескейла для радиуса точки

См. определение в файле colored_point_handler.h строка 94

Объявления и описания членов классов находятся в файлах:

C:/Users/seeyo/source/repos/Visual-Vibration-Tracking-V2/include/VVT-V2/colored_point_handler.h
C:/Users/seeyo/source/repos/Visual-Vibration-Tracking-V2/source/colored_point_handler.cpp

Открытые члены

Закрытые типы

Закрытые члены

Закрытые данные

Дополнительные унаследованные члены

Подробное описание

Перечисления

◆ coloring_mode

Конструктор(ы)

◆ ColoredPointHandler()

◆ ~ColoredPointHandler()

Методы

◆ Draw()

◆ DrawHistogram()

◆ DrawInteractionRectangle()

◆ DrawPoint()

◆ SetColoringMode()

◆ UpdatePointColor()

Данные класса

◆ coloring_mode_

◆ point_color_

◆ point_id_

◆ radius_resize_factor_