detect_regions_by_energy()

template<OperationReadyData DataType>

std::vector< Kakshya::Region > MayaFlux::Yantra::detect_regions_by_energy	(	const DataType &	input,
		double	energy_threshold,
		uint32_t	min_region_size,
		uint32_t	window_size,
		uint32_t	hop_size
	)

Detect regions based on energy threshold using existing EnergyAnalyzer.

Template Parameters

DataType

OperationReadyData type

Parameters

input	Input data
energy_threshold	Energy threshold for region detection
min_region_size	Minimum size of detected regions in samples
window_size	Analysis window size
hop_size	Hop size between windows

Returns

Detected regions

Definition at line 618 of file MatrixHelper.hpp.

{
    auto energy_analyzer = std::make_shared<StandardEnergyAnalyzer>(window_size, hop_size);
    energy_analyzer->set_energy_method(EnergyMethod::RMS);
    auto energy_result = energy_analyzer->analyze_energy(input);
 
    std::vector<Kakshya::Region> regions;
 
    if (energy_result.channels.empty()) {
        return regions;
    }
 
    const auto& first_channel = energy_result.channels[0];
    std::optional<uint64_t> region_start;
 
    for (size_t i = 0; i < first_channel.energy_values.size(); ++i) {
        bool above_threshold = first_channel.energy_values[i] > energy_threshold;
 
        if (above_threshold && !region_start.has_value()) {
            if (i < first_channel.window_positions.size()) {
                region_start = first_channel.window_positions[i].first;
            }
        } else if (!above_threshold && region_start.has_value()) {
            if (i < first_channel.window_positions.size()) {
                uint64_t region_end = first_channel.window_positions[i].second;
 
                if (region_end - region_start.value() >= min_region_size) {
                    Kakshya::Region region;
                    region.start_coordinates = { region_start.value() };
                    region.end_coordinates = { region_end };
                    regions.push_back(region);
                }
                region_start.reset();
            }
        }
    }
 
    if (region_start.has_value() && !first_channel.window_positions.empty()) {
        uint64_t region_end = first_channel.window_positions.back().second;
        if (region_end - region_start.value() >= min_region_size) {
            Kakshya::Region region;
 
            region.start_coordinates = { region_start.value() };
            region.end_coordinates = { region_end };
            regions.push_back(region);
        }
    }
 
    return regions;
}

References MayaFlux::Kakshya::Region::end_coordinates, RMS, and MayaFlux::Kakshya::Region::start_coordinates.