HelperFunctions

Функции
std::string	HelperFunctions::GenerateCsvFilename (std::string additional_text="")
	Генерирует имя CSV файла для сохранения метаданных Подробнее...
cv::Scalar	HelperFunctions::RatioToRgb (double ratio)
	Генерирует имя TXT файла для сохранени Подробнее...
void	HelperFunctions::FindLocalMaxima (cv::Mat &input_array, cv::Mat &local_maxima, double threshold_value)
	Эта функция пригодится. Разберусь с ней чуть позже Подробнее...
template<typename T >
std::string	HelperFunctions::ToStringWithPrecision (const T value, const int n=9)
	Выполняет округление числа с определенной точностью Подробнее...
template<class T >
void	HelperFunctions::DeadzoneFilter (std::vector< T > &input_vector)
	Частотный фильтр для нижней части диапазона Подробнее...
template<class T >
std::vector< T >	HelperFunctions::MakeShorterFromStart (std::vector< T > src, int n)
	Укорачивает вектор, убирая элементы слева (спереди) Подробнее...
template<typename T >
T	HelperFunctions::CalculateMeanDifferenceInVector (std::vector< T > src)
	Вычисляет среднее значение разности элементов массива в виде ((a0 - a1) + (a1 - a2)) / 3. Подробнее...
template<typename T >
int	HelperFunctions::FindGlobalMaxIdx (std::vector< T > src)
	Возвращает индекс самого большого элемента вектора src. Подробнее...
template<typename T >
int	HelperFunctions::FindGlobalMinIdx (std::vector< T > src)
	Возвращает индекс самого маленького элемента вектора src. Подробнее...
template<typename T >
T	HelperFunctions::CalculateMaxDifferenceInVector (std::vector< T > src)
	Вычисляет максимальное значение разности элементов массива Подробнее...

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

Функции

CalculateMaxDifferenceInVector()

template<typename T >

T HelperFunctions::CalculateMaxDifferenceInVector

(

std::vector< T >

src

)

Вычисляет максимальное значение разности элементов массива

Аргументы

src	- входной вектор для анализа

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

    {
        std::vector<T> difference_vector;
 
        auto it = src.begin();
        while (it != (src.end() - 1))
        {
            difference_vector.push_back(*(it + 1) - *it);
            it++;
        }
 
        cv::Scalar cv_scalar_mean_val = cv::mean(src);
        T mean_val = cv_scalar_mean_val[0];
 
        return difference_vector[FindGlobalMaxIdx(difference_vector)] / mean_val;
    }

CalculateMeanDifferenceInVector()

template<typename T >

T HelperFunctions::CalculateMeanDifferenceInVector

(

std::vector< T >

src

)

Вычисляет среднее значение разности элементов массива в виде ((a0 - a1) + (a1 - a2)) / 3.

Аргументы

src	- входной вектор для анализа

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

    {
        std::vector<T> difference_vector;
 
        auto it = src.begin();
        while (it != (src.end() - 1))
        {
            difference_vector.push_back(*(it + 1) - *it);
            it++;
        }
 
        T mean_difference;
 
        it = difference_vector.begin();
        mean_difference = *it;
        it++;
 
        while (it != difference_vector.end())
        {
            mean_difference += *it;
            it++;
        }
        mean_difference /= difference_vector.size();
 
        return mean_difference;
    }

DeadzoneFilter()

template<class T >

void HelperFunctions::DeadzoneFilter

(

std::vector< T > &

input_vector

)

Частотный фильтр для нижней части диапазона

Аргументы

input_vector

массив, в котором будет проведена фильтрация

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

    {
        float dead_zone_factor = 0.1f;
        for (int i = 0; i < static_cast<int>(input_vector.size() * dead_zone_factor); i++)
        {
            input_vector.erase(std::begin(input_vector));
        }
    }

FindGlobalMaxIdx()

template<typename T >

int HelperFunctions::FindGlobalMaxIdx

(

std::vector< T >

src

)

Возвращает индекс самого большого элемента вектора src.

Аргументы

src	- входной вектор для анализа

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

    {
        auto it = src.begin();
        int idx = 0;
        T last_max = 0;
        while (it != src.end())
        {
            if (*it > last_max)
            {
                idx = std::distance(src.begin(), it);
                last_max = *it;
            }
            it++;
        }
 
        return idx;
    }

FindGlobalMinIdx()

template<typename T >

int HelperFunctions::FindGlobalMinIdx

(

std::vector< T >

src

)

Возвращает индекс самого маленького элемента вектора src.

Аргументы

src	- входной вектор для анализа

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

    {
        auto it = src.begin();
        int idx = 0;
        T last_max = 0;
        while (it != src.end())
        {
            if (*it < last_max)
            {
                idx = std::distance(src.begin(), it);
                last_max = *it;
            }
            it++;
        }
 
        return idx;
    }

FindLocalMaxima()

void HelperFunctions::FindLocalMaxima	(	cv::Mat &	input_array,
		cv::Mat &	local_maxima,
		double	threshold_value
	)

Эта функция пригодится. Разберусь с ней чуть позже

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

{
    cv::Mat dilated_input_image, thresholded_input_image, thresholded_input_8bit;
    dilate(input_array, dilated_input_image, cv::Mat());
    compare(input_array, dilated_input_image, local_maxima, cv::CMP_EQ);
    threshold(input_array, thresholded_input_image, threshold_value, 255, cv::THRESH_BINARY);
    thresholded_input_image.convertTo(thresholded_input_8bit, CV_8U);
    bitwise_and(local_maxima, thresholded_input_8bit, local_maxima);
}

GenerateCsvFilename()

std::string HelperFunctions::GenerateCsvFilename

(

std::string

additional_text = ""

)

Генерирует имя CSV файла для сохранения метаданных

Возвращает

имя файла

См. также

OutputToCsv

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

{
    // Имя файла, в который будет производиться запись
    std::string csv_file_name;
    // Начало названия выходного файла
    csv_file_name = "C:/Users/seeyo/source/repos/Visual-Vibration-Tracking-V2/output/metadata/output_";
    // Добавляем дополнительный текст при желании
    csv_file_name += additional_text;
    // Время
    auto time = std::time(nullptr);
    // Записываем текущее время
    std::stringstream date_n_time;
    date_n_time << std::put_time(std::localtime(&time), "%F_%T");
    // Переводим дату и время в строковый тип
    std::string date_n_time_str = date_n_time.str();
    // Меняем ":" на "-" для корректного имени файла
    std::replace(date_n_time_str.begin(), date_n_time_str.end(), ':', '-');
    // Добавляем дату и время к имени файла + расширение файла
    csv_file_name += date_n_time_str + ".csv";
 
    std::cout << csv_file_name << std::endl;
 
    return csv_file_name;
}

MakeShorterFromStart()

template<class T >

std::vector< T > HelperFunctions::MakeShorterFromStart	(	std::vector< T >	src,
		int	n
	)

Укорачивает вектор, убирая элементы слева (спереди)

Аргументы

input_vector	вектор, который будет укорочен
n	количество элементов справа (сзади), которые не будут удалены

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

    {
        auto it = src.end();
        std::vector<T> dst;
 
        if (n < src.size())
            return src;
 
        while (it != (src.end() - n))
        {
            dst.push_back(*it);
            it--;
        }
 
        return dst;
    }

RatioToRgb()

cv::Scalar HelperFunctions::RatioToRgb

(

double

ratio

)

Генерирует имя TXT файла для сохранени

Конвертирует отношение в диапазоне [0; 1] в RGB цвет

Аргументы

ratio

отношение

Возвращает

: RGB цвет

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

{
    //
    int normalized = static_cast<int>(ratio * 256 * 4);
 
    // find the region for this position
    int region = normalized / 256;
 
    // find the distance to the start of the closest region
    int x = normalized % 256;
 
    int r = 0, g = 0, b = 0;
 
    switch (region)
    {
    case 0: r = 0;      g = 0;      b = 255;    g += x; break; // синий:сине-зеленый
    case 1: r = 0;      g = 255;    b = 255;    b -= x; break; // сине-зеленый:зеленый
    case 2: r = 0;      g = 255;    b = 0;      r += x; break; // зеленый:желтый
    case 3: r = 255;    g = 255;    b = 0;      g -= x; break; // желтый:красный
    }
    
    return cv::Scalar(b, g, r);
}

ToStringWithPrecision()

template<typename T >

std::string HelperFunctions::ToStringWithPrecision	(	const T	value,
		const int	n = 9
	)

Выполняет округление числа с определенной точностью

Аргументы

value	число, требующее округления
n	номер знака (до которого будет округлено число)

Возвращает

: округленное число

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

    {
        std::ostringstream out;
        out.precision(n);
        out << std::fixed << value;
        return out.str();
    }