|
MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
|
Orders regions by their weighted sort score. More...
#include <RegionKeySorter.hpp>
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 |
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.