MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
MayaFlux::Yantra::RegionKeySorter Class Reference

Orders regions by their weighted sort score. More...

#include <RegionKeySorter.hpp>

Inheritance diagram for MayaFlux::Yantra::RegionKeySorter:
Collaboration diagram for MayaFlux::Yantra::RegionKeySorter:

Public Types

using supports = Supports<RegionKeySorterConfig>
Public Types inherited from MayaFlux::Yantra::Sorter< Kakshya::RegionGroup, Kakshya::RegionGroup >
using base_type
using input_type
using output_type
Public Types inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
using input_type
using output_type

Public Member Functions

ConfigRefs configs () const override
 The stored settings, or defaults when none were set.
SortingType get_sorting_type () const override
 Gets the sorting type category for this sorter.
 RegionKeySorter (RegionKeySorterConfig config={})
 Construct a region key sorter from its settings.
Public Member Functions inherited from MayaFlux::Yantra::Sorter< Kakshya::RegionGroup, Kakshya::RegionGroup >
ConfigRefs configs () const override
 The base view of the config structs this operation holds.
std::string get_name () const override
 Gets human-readable name for this sorter.
OperationType get_operation_type () const override
 Returns the category of this operation for grammar and registry discovery.
virtual ~Sorter ()=default
Public Member Functions inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
void add_dependency (std::shared_ptr< ComputeOperation > dep)
output_type apply_operation (const input_type &input)
 Public synchronous execution interface.
output_type apply_operation_with_dependencies (const input_type &input)
 Applies the operation with dependencies resolved.
OutputType apply_to_data (const InputType &data)
 Convenience overload that extracts just the data from result.
 ComputeOperation ()
 Constructor with data type validation warnings.
const Config & config () const
 The stored config struct of type Config, or its defaults when none was set.
output_type execute (const input_type &input)
 OpUnit interface - operations can act as units in dependency graphs.
const auto & get_dependencies () const
const ExecutionContext & get_last_execution_context () const
void merge_config (const Facets &incoming)
 Adds the config structs of incoming, replacing stored ones of the same type.
output_type operator() (const InputType &data)
 Convenience overload for direct data processing (backward compatibility).
const Config * resolved_config () const
 The stored config struct of type Config, or nullptr when absent.
void set_config (Config config)
 Stores a config struct, whole, under its own type.
void set_last_execution_context (const ExecutionContext &ctx)
void set_post_execution_hook (const OperationHookCallback &hook)
void set_pre_execution_hook (const OperationHookCallback &hook)
void set_reconstruction_callback (const ReconstructionCallback &callback)
ConfigRefs stored_configs (Supports< Configs... >) const
 The stored configs among those listed, in listed order.
virtual bool validate_input (const input_type &) const
 Validates if the input data meets the operation's requirements.
virtual ~ComputeOperation ()=default
 Virtual destructor for proper cleanup of derived classes.

Protected Member Functions

Datum< Kakshya::RegionGroup > sort_implementation (const Datum< Kakshya::RegionGroup > &input) override
Protected Member Functions inherited from MayaFlux::Yantra::Sorter< Kakshya::RegionGroup, Kakshya::RegionGroup >
virtual std::string get_sorter_name () const
 Get sorter-specific name (derived classes override this).
output_type operation_function (const input_type &input) override
 Core operation implementation - called by ComputeOperation interface.
virtual output_type sort_implementation (const input_type &input)=0
 Pure virtual sorting implementation - derived classes implement this.
virtual bool validate_sorting_input (const input_type &) const
 Input validation (override for custom validation logic).
Protected Member Functions inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
output_type apply_hooks (const input_type &input, const ExecutionContext &context)
virtual std::future< output_type > apply_operation_async (const input_type &input)
 Optional async implementation - default delegates to operation_function.
virtual output_type apply_operation_chained (const input_type &input, const ExecutionContext &ctx)
 Optional chain-aware implementation - default delegates to operation_function.
virtual output_type apply_operation_internal (const input_type &input, const ExecutionContext &context)
 Internal execution method - ComputeMatrix can access this.
virtual output_type apply_operation_parallel (const input_type &input, const ExecutionContext &ctx)
 Optional parallel-aware implementation - default delegates to operation_function.
output_type convert_result (std::vector< std::vector< double > > &result_data, DataStructureInfo &metadata)
 Convert processed double data back to OutputType using metadata and optional callback.

Static Private Member Functions

static std::vector< size_t > gpu_order (const std::vector< double > &scores)
 Ascending order of the scores, computed exactly on the GPU.

Additional Inherited Members

Protected Attributes inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
ExecutionContext m_last_execution_context

Detailed Description

Orders regions by their weighted sort score.

Each region's score is weighted_sort_score over the configured keys. Regions are ordered by ascending score. A DESCENDING key negates its term, so direction lives in the keys. Empty keys leave the group unchanged. A region that lacks any key's feature is a hard error.

The GPU path orders the scores with BitonicSorter over order keys. It returns the same permutation as the CPU path: ascending, with equal scores in input order and NaN last.

Definition at line 43 of file RegionKeySorter.hpp.


The documentation for this class was generated from the following file: