MayaFlux::Yantra::VisionAnalyzer< InputType, OutputType > Class Template Reference

UniversalAnalyzer that takes any pixel-bearing input, runs a VisionSequence via VisionExecutor, and surfaces structured results into the Yantra compute graph. More...

#include <VisionAnalyzer.hpp>

Inheritance diagram for MayaFlux::Yantra::VisionAnalyzer< InputType, OutputType >:

Collaboration diagram for MayaFlux::Yantra::VisionAnalyzer< InputType, OutputType >:

Public Types
using	base_type = UniversalAnalyzer< InputType, OutputType >
using	input_type = Datum< InputType >
using	output_type = Datum< OutputType >
Public Types inherited from MayaFlux::Yantra::UniversalAnalyzer< InputType, OutputType >
using	base_type = ComputeOperation< InputType, OutputType >
using	input_type = Datum< InputType >
using	output_type = Datum< OutputType >
Public Types inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
using	input_type = Datum< InputType >
using	output_type = Datum< OutputType >

Public Member Functions
VisionAnalysis	analyze_vision (const input_type &data)
	Type-safe vision analysis.
VisionAnalysis	analyze_vision (const InputType &data)
AnalysisType	get_analysis_type () const override
	Gets the analysis type category for this analyzer.
std::vector< std::string >	get_available_methods () const override
	Get available analysis methods for this analyzer.
VisionAnalysis	get_vision_analysis () const
	Get the last VisionAnalysis result.
void	reset ()
	Clear stored optical flow state.
void	set_sequence (Kinesis::Vision::VisionSequence sequence)
	Replace the pipeline and reset inter-frame executor state.
	VisionAnalyzer (Kinesis::Vision::VisionSequence sequence)
	Construct with the VisionSequence to execute each call.
Public Member Functions inherited from MayaFlux::Yantra::UniversalAnalyzer< InputType, OutputType >
std::vector< std::any >	analyze_batch (const std::vector< input_type > &inputs)
	Batch analysis for multiple inputs.
std::vector< std::any >	analyze_batch (const std::vector< InputType > &inputs)
std::any	analyze_data (const input_type &data)
	User-facing analysis method - returns analysis results directly.
std::any	analyze_data (const InputType &data)
std::map< std::string, std::any >	get_all_parameters () const override
	Retrieves all parameters and their values.
AnalysisGranularity	get_analysis_granularity () const
std::any	get_current_analysis () const
	Access cached analysis from last operation.
std::string	get_name () const override
	Gets human-readable name for this analyzer.
OperationType	get_operation_type () const override
	Returns the category of this operation for grammar and registry discovery.
std::any	get_parameter (const std::string &name) const override
	Retrieves a parameter's current value.
template<typename T >
T	get_parameter_or_default (const std::string &name, const T &default_value) const
	Helper to get typed parameter with default value.
bool	has_current_analysis () const
	Check if analysis has been performed.
void	set_analysis_granularity (AnalysisGranularity granularity)
void	set_parameter (const std::string &name, std::any value) override
	Type-safe parameter management with analysis-specific defaults.
virtual bool	supports_method (const std::string &method) const
	Check if a specific analysis method is supported.
bool	validate_input (const input_type &input) const override
	Validates input data meets analyzer requirements.
virtual	~UniversalAnalyzer ()=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.
output_type	execute (const input_type &input)
	OpUnit interface - operations can act as units in dependency graphs.
virtual const std::shared_ptr< Kakshya::SignalSourceContainer > &	get_container_for_regions () const
const auto &	get_dependencies () const
const ExecutionContext &	get_last_execution_context () const
bool	has_gpu_backend () const
output_type	operator() (const InputType &data)
	Convenience overload for direct data processing (backward compatibility)
virtual void	set_container_for_regions (const std::shared_ptr< Kakshya::SignalSourceContainer > &container)
void	set_gpu_backend (std::shared_ptr< GpuExecutionContext< InputType, OutputType > > backend)
	Attach a GPU execution backend.
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)
virtual	~ComputeOperation ()=default
	Virtual destructor for proper cleanup of derived classes.

Protected Member Functions
output_type	analyze_implementation (const input_type &input) override
	Pure virtual analysis implementation - derived classes implement this.
std::string	get_analyzer_name () const override
	Get analyzer-specific name (derived classes override this)
Protected Member Functions inherited from MayaFlux::Yantra::UniversalAnalyzer< InputType, OutputType >
virtual output_type	add_attribution_metadata (const output_type &raw_output)
	Add attribution metadata to results (override for custom attribution)
virtual output_type	apply_granularity_formatting (const output_type &raw_output)
	Apply granularity-based output formatting.
virtual output_type	create_summary_statistics (const output_type &raw_output)
	Create summary statistics from results (override for custom summaries)
virtual std::map< std::string, std::any >	get_all_analysis_parameters () const
virtual std::any	get_analysis_parameter (const std::string &name) const
output_type	operation_function (const input_type &input) override
	Core analysis implementation - must be overridden by derived classes.
virtual output_type	organize_into_groups (const output_type &raw_output)
	Organize results into hierarchical groups (override for custom grouping)
virtual void	set_analysis_parameter (const std::string &name, std::any value)
	Analysis-specific parameter handling (override for custom parameters)
template<typename AnalysisResultType >
void	store_current_analysis (AnalysisResultType &&result) const
virtual bool	validate_analysis_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.

Private Member Functions
output_type	create_pipeline_output (const input_type &input, const Kinesis::Vision::VisionResult &vr, const DataStructureInfo &info)

Private Attributes
Kinesis::Vision::VisionExecutor	m_executor
std::vector< float >	m_float_storage
Kinesis::Vision::VisionSequence	m_sequence

Additional Inherited Members
Protected Attributes inherited from MayaFlux::Yantra::UniversalAnalyzer< InputType, OutputType >
std::any	m_current_analysis
output_type	m_current_output
Protected Attributes inherited from MayaFlux::Yantra::ComputeOperation< InputType, OutputType >
std::shared_ptr< Kakshya::SignalSourceContainer >	m_container
std::shared_ptr< GpuExecutionContext< InputType, OutputType > >	m_gpu_backend
ExecutionContext	m_last_execution_context

Detailed Description

template<ComputeData InputType = std::vector<Kakshya::DataVariant>, ComputeData OutputType = std::vector<Kakshya::DataVariant>>
class MayaFlux::Yantra::VisionAnalyzer< InputType, OutputType >

UniversalAnalyzer that takes any pixel-bearing input, runs a VisionSequence via VisionExecutor, and surfaces structured results into the Yantra compute graph.

InputType can be any ComputeData type carrying pixel data:

• std::vector<DataVariant> (direct pixel variants)
• std::shared_ptr<SignalSourceContainer> (TextureContainer, VideoStreamContainer, etc.)
• Kakshya::Region / RegionGroup (pixel sub-region with container)

extract_structured_native handles all unwrapping transparently. Width and height are read from SPATIAL_X / SPATIAL_Y dimension roles in the DataStructureInfo, or from metadata keys "width" and "height" as fallback.

OutputType is std::vector<DataVariant> carrying VisionResult::pixel_image as vector<float>, matching the standard analyzer pipeline contract. Structured results (boxes, contours, keypoints, tracks, gradient, components) are stored via store_current_analysis and retrieved with get_vision_analysis() / extract_scalar_vision().

auto va = std::make_shared<StandardVisionAnalyzer>(sequence);
va->apply_operation(pixel_datum);
auto analysis = va->get_vision_analysis();
double n = extract_scalar_vision(analysis, "box_count");

Definition at line 97 of file VisionAnalyzer.hpp.

---

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

• VisionAnalyzer.hpp