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

#include <lonely_point_handler.h>

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

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

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

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

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

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

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

Point2f	GetTextCoordinates ()
	Возвращает точку, необходимую для отображения координат Подробнее...

Rect	GetInteractionRect ()
	Возвращает координаты прямоугольника взаимодействия Подробнее...

Открытые члены унаследованные от 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 ()
	Добавляет данные для записи Подробнее...

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

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

void	DrawPointTrack (Mat &frame)
	Отрисовывает линию перемещения (трек) точки Подробнее...

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

void	DrawTextData (Mat &frame)
	Отрисовывает текстовые данные рядом с точкой Подробнее...

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

Закрытые данные
float	text_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())

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

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

◆ LonelyPointHandler()

LonelyPointHandler::LonelyPointHandler	(	Point2f	init_coordinates,
		double	sampling_rate,
		int	point_id,
		float	text_resize_factor,
		std::string	output_csv_filename
	)

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

Аргументы

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

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

См. определение в файле lonely_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 },
    text_resize_factor_{ text_resize_factor }
{
    interaction_offset_ = 50;
    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;
 
    frequencies_.push_back(0.0);
    relative_amplitude_ = Point3f(0.0, 0.0, 0.0);
 
    sensivity_ = 0.01;
    confidence_level_ = 1.0;
}

◆ ~LonelyPointHandler()

LonelyPointHandler::~LonelyPointHandler ( )

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

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

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

{
    Write();
}

Методы

◆ Draw()

void LonelyPointHandler::Draw ( Mat & frame )

overridevirtual

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

Аргументы

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

Замещает VibratingPoint.

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

{
    // отрисовываем прямоугольник взаимодействия (если оно есть)
    DrawInteractionRectangle(frame);
    // отрисовываем линии точек
    DrawPointTrack(frame);
    // отрисовываем круг вокруг точки
    DrawPoint(frame);
    // отрисовываем гистограмму
    DrawHistogram();
    // отрисовываем частоту вибрации
    DrawTextData(frame);
}

◆ DrawHistogram()

void LonelyPointHandler::DrawHistogram ( )

overrideprivatevirtual

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

Замещает VibratingPoint.

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

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

◆ DrawInteractionRectangle()

void LonelyPointHandler::DrawInteractionRectangle ( Mat & frame )

private

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

Аргументы

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

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

{
    if (interacted_)
        rectangle(frame, interaction_box_, Scalar(0, 255, 0), 2);
}

◆ DrawPoint()

void LonelyPointHandler::DrawPoint ( Mat & frame )

private

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

Аргументы

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

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

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

◆ DrawPointTrack()

void LonelyPointHandler::DrawPointTrack ( Mat & frame )

private

Отрисовывает линию перемещения (трек) точки

Аргументы

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

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

{
    if (point_coordinates_.size() > 2)
        line(frame, point_coordinates_[point_coordinates_.size() - 2], point_coordinates_[point_coordinates_.size() - 1], Scalar(0, 255, 0), 1, LINE_AA);
}

◆ DrawTextData()

void LonelyPointHandler::DrawTextData ( Mat & frame )

private

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

Аргументы

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

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

{
    int font = FONT_HERSHEY_PLAIN;
    double font_scale = 1.5 * text_resize_factor_;
    int thickness = 2;
    int line_spacing = 20;
    int row_spacing = 5;
    // Количество строк частот, выводимых на экран
    int lines_amount = 3;
    int baseline;
    // отрисовываем частоту вибрации
    putText(
        frame,
        "hz: " + HelperFunctions::ToStringWithPrecision(main_frequency_, 2),
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y + text_resize_factor_ * line_spacing),
        font,
        font_scale,
        Scalar(0, 69, 255),
        thickness
    );
 
    // отрисовываем амплитуды вибрации и ID точки
    // ID точки
    putText(
        frame,
        "ID: " + std::to_string(point_id_),
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y - text_resize_factor_ * line_spacing),
        font,
        font_scale,
        Scalar(100, 255, 100),
        thickness
    );
 
    // Статус определения вибрации
 
    std::string confidence_string;
 
    {
        if (confidence_level_ > 5.0)
            confidence_string = "enough";
        else
            confidence_string = HelperFunctions::ToStringWithPrecision(confidence_level_, 1);
    }
 
    putText(
        frame,
        "Conf: " + confidence_string,
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y),
        font,
        font_scale,
        Scalar(100, 255, 100),
        thickness
    );
    putText(
        frame,
        "y: " + HelperFunctions::ToStringWithPrecision(relative_amplitude_.y * 100, 2),
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y - text_resize_factor_ * 2 * line_spacing),
        font,
        font_scale,
        Scalar(0, 255, 255),
        thickness
    );
    putText(
        frame,
        "x: " + HelperFunctions::ToStringWithPrecision(relative_amplitude_.x * 100, 2),
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y - text_resize_factor_ * 3 * line_spacing),
        font,
        font_scale,
        Scalar(0, 255, 255),
        thickness
    );
    putText(
        frame,
        "abs: " + HelperFunctions::ToStringWithPrecision(sqrt(current_amplitude_.x * current_amplitude_.x + current_amplitude_.y * current_amplitude_.y), 3),
        Point(point_coordinates_.front().x + 15, point_coordinates_.front().y - text_resize_factor_ * 4 * line_spacing),
        font,
        font_scale,
        Scalar(0, 255, 255),
        thickness
    );
    // uncomment когда появится 3-я координата для амплитуды :)
    /*putText(
        frame,
        "z: " + std::to_string(relative_amplitude_.z),
        Point(point_coordinates_.front().x, point_coordinates_.front().y - res_mp_ * 4 * line_spacing),
        FONT_HERSHEY_PLAIN,
        font_scale,
        Scalar(0, 255, 255),
        thickness
    );*/
}

◆ GetInteractionRect()

Rect LonelyPointHandler::GetInteractionRect ( )

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

Возвращает: Прямоугольник (область) взаимодействия

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

{
    return interaction_box_;
}

◆ GetTextCoordinates()

Point2f LonelyPointHandler::GetTextCoordinates ( )

Возвращает точку, необходимую для отображения координат

Возвращает: Координаты текста для отображения

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

{
    if (!point_coordinates_.empty())
        return point_coordinates_[0];
    else return Point2f(0.0, 0.0);
}

◆ UpdatePointColor()

void LonelyPointHandler::UpdatePointColor ( )

overrideprivatevirtual

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

Замещает VibratingPoint.

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

{
    // default
    point_color_ = Scalar(255, 75, 25);
 
    if (interacted_)
        point_color_ = point_color_ + Scalar(0, 75, 25); // синий светлее
 
    point_color_ *= confidence_level_ / 5.0;
}

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

◆ point_color_

Scalar LonelyPointHandler::point_color_

private

Цвет точки

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

◆ point_id_

int LonelyPointHandler::point_id_

private

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

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

◆ text_resize_factor_

float LonelyPointHandler::text_resize_factor_

private

Коэффициент рескейла для отрисовки данных

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

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

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

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

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

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

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

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

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

◆ LonelyPointHandler()

◆ ~LonelyPointHandler()

Методы

◆ Draw()

◆ DrawHistogram()

◆ DrawInteractionRectangle()

◆ DrawPoint()

◆ DrawPointTrack()

◆ DrawTextData()

◆ GetInteractionRect()

◆ GetTextCoordinates()

◆ UpdatePointColor()

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

◆ point_color_

◆ point_id_

◆ text_resize_factor_