MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
Extractor.hpp File Reference

Modern, digital-first extractor framework for Maya Flux. More...

Include dependency graph for Extractor.hpp:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

class  MayaFlux::Yantra::Extractor< InputType, OutputType >
 Template-flexible extractor base with instance-defined I/O types. More...
struct  MayaFlux::Yantra::ExtractorConfig
 Settings every extractor family accepts. More...

Namespaces

namespace  MayaFlux
 Main namespace for the Maya Flux audio engine.
namespace  MayaFlux::Yantra

Typedefs

template<ComputeData OutputType = std::shared_ptr<Kakshya::SignalSourceContainer>>
using MayaFlux::Yantra::ContainerExtractor = Extractor<std::shared_ptr<Kakshya::SignalSourceContainer>, OutputType>
 Extractor for signal container processing.
template<ComputeData OutputType = Kakshya::DataVariant>
using MayaFlux::Yantra::DataExtractor = Extractor<std::vector<Kakshya::DataVariant>, OutputType>
 Extractor that takes DataVariant and produces any ComputeData type.
template<ComputeData InputType = std::vector<Kakshya::DataVariant>>
using MayaFlux::Yantra::MatrixExtractor = Extractor<InputType, Eigen::MatrixXd>
 Extractor that produces Eigen matrices.
template<ComputeData InputType = std::vector<Kakshya::DataVariant>>
using MayaFlux::Yantra::NumericExtractor = Extractor<InputType, std::vector<double>>
 Extractor that produces numeric vectors.
template<ComputeData OutputType = Kakshya::Region>
using MayaFlux::Yantra::RegionExtractor = Extractor<Kakshya::Region, OutputType>
 Extractor for region-based extraction.
template<ComputeData OutputType = Kakshya::RegionGroup>
using MayaFlux::Yantra::RegionGroupExtractor = Extractor<Kakshya::RegionGroup, OutputType>
 Extractor for region group processing.
template<ComputeData OutputType = std::vector<Kakshya::RegionSegment>>
using MayaFlux::Yantra::SegmentExtractor = Extractor<std::vector<Kakshya::RegionSegment>, OutputType>
 Extractor for segment processing.
template<ComputeData InputType = std::vector<Kakshya::DataVariant>>
using MayaFlux::Yantra::VectorExtractor = Extractor<InputType, Eigen::VectorXd>
 Extractor that produces Eigen vectors.

Enumerations

enum class  MayaFlux::Yantra::ExtractionScope : uint8_t { MayaFlux::Yantra::FULL_DATA , MayaFlux::Yantra::TARGETED_REGIONS , MayaFlux::Yantra::FILTERED_CONTENT , MayaFlux::Yantra::SAMPLED_DATA }
 Scope control for extraction operations. More...
enum class  MayaFlux::Yantra::ExtractionType : uint8_t {
  MayaFlux::Yantra::DIRECT , MayaFlux::Yantra::REGION_BASED , MayaFlux::Yantra::FEATURE_GUIDED , MayaFlux::Yantra::PATTERN_BASED ,
  MayaFlux::Yantra::TRANSFORM , MayaFlux::Yantra::RECURSIVE , MayaFlux::Yantra::CUSTOM
}
 Categories of extraction operations for discovery and organization. More...

Detailed Description

Modern, digital-first extractor framework for Maya Flux.

The Extractor system provides a clean, extensible foundation for data extraction in the Maya Flux ecosystem. Unlike traditional feature extractors, this focuses on digital-first paradigms: data-driven workflows, composability, and type safety.

Core Philosophy

An extractor gives the user a specified ComputeData through two main pathways:

  1. Direct extraction: Using convert_data/extract from DataUtils
  2. Copy extraction: Copy data via extract in DataUtils

Concrete extractors can optionally integrate with analyzers when they need to extract regions/features identified by analysis.

Key Features

  • Flexible input/output: Template-based I/O types defined at instantiation
  • Type-safe extraction: C++20 concepts and compile-time guarantees
  • Extraction strategies: Direct, region-based, feature-guided, recursive
  • Composable operations: Integrates with ComputeMatrix execution modes
  • Digital-first design: Embraces computational possibilities beyond analog metaphors

Usage Examples

// Extract specific data type from DataVariant
auto extractor = std::make_shared<MyExtractor<Kakshya::DataVariant, std::vector<double>>>();
// Extract matrix from container
auto matrix_extractor = std::make_shared<MyExtractor<
std::shared_ptr<Kakshya::SignalSourceContainer>,
Eigen::MatrixXd>>();

Definition in file Extractor.hpp.