make_granular_matrix()

MAYAFLUX_API std::shared_ptr< GranularMatrix > MayaFlux::Yantra::Granular::make_granular_matrix	(	ComputationContext	attribution_context = ComputationContext::SPECTRAL,
		GranularOutput	output = GranularOutput::REGION_GROUP,
		GrainTaper	taper = {}
	)

Construct a GranularMatrix with grammar rules appropriate for the requested output type.

REGION_GROUP: registers segment, attribute, sort (existing behaviour). CONTAINER: registers segment, attribute, sort, then appends reconstruct. The reconstruct rule reads the source container from ExecutionContext::execution_metadata["container"] and writes stitched per-channel audio into a SoundFileContainer. CONTAINER_ADDITIVE: same as CONTAINER but uses an overlap-add reconstruct rule

Parameters

attribution_context	ComputationContext assigned to the attribution rule.
output	Terminal output type for this pipeline.
taper	Optional per-grain taper for OLA output.

Returns

Configured GranularMatrix instance.

Definition at line 729 of file GranularWorkflow.cpp.

{
    auto matrix = std::make_shared<GranularMatrix>();
 
    matrix->create_operation<SegmentOp>("segment");
    matrix->create_operation<AttributeOp>("attribute");
    matrix->create_operation<SortOp>("sort");
 
    matrix->get_grammar()->create_rule("segment") //
        .with_context(ComputationContext::TEMPORAL)
        .with_priority(100)
        .with_description("Fixed hop-size grain segmentation")
        .matches_type<Kakshya::RegionGroup>()
        .executes(segment_grains)
        .build();
 
    matrix->get_grammar()->create_rule("attribute") //
        .with_context(attribution_context)
        .with_priority(75)
        .with_description("Per-grain feature attribution via analyzer or lambda")
        .matches_type<Kakshya::RegionGroup>()
        .executes(attribute_grains)
        .build();
 
    matrix->get_grammar()->create_rule("sort") //
        .with_context(ComputationContext::STRUCTURAL)
        .with_priority(50)
        .with_description("Attribute-keyed grain sort, CPU or GPU")
        .matches_type<Kakshya::RegionGroup>()
        .executes(sort_grains)
        .build();
 
    if (output == GranularOutput::CONTAINER) {
        matrix->get_grammar()->create_rule("reconstruct") //
            .with_context(ComputationContext::STRUCTURAL)
            .with_priority(25)
            .with_description("Stitch sorted grains into a SoundFileContainer")
            .matches_type<Kakshya::RegionGroup>()
            .executes(reconstruct_grains)
            .build();
    } else if (output == GranularOutput::CONTAINER_ADDITIVE) {
        auto ola_executor =
            [t = std::move(taper)](const std::any& in, const ExecutionContext& ctx) -> std::any {
            ExecutionContext patched = ctx;
            if (t) {
                patched.execution_metadata["grain_taper"] = t;
            }
            return reconstruct_grains_additive(in, patched);
        };
 
        matrix->get_grammar()->create_rule("reconstruct") //
            .with_context(ComputationContext::STRUCTURAL)
            .with_priority(25)
            .with_description("Additive grain reconstruction into SoundFileContainer")
            .matches_type<Kakshya::RegionGroup>()
            .executes(ola_executor)
            .build();
    } else if (output == GranularOutput::STREAM) {
        matrix->get_grammar()->create_rule("reconstruct") //
            .with_context(ComputationContext::STRUCTURAL)
            .with_priority(25)
            .with_description("Stitch sorted grains into a DynamicSoundStream")
            .matches_type<Kakshya::RegionGroup>()
            .executes(reconstruct_grains_stream)
            .build();
    } else if (output == GranularOutput::STREAM_ADDITIVE) {
        auto ola_executor =
            [t = std::move(taper)](const std::any& in, const ExecutionContext& ctx) -> std::any {
            ExecutionContext patched = ctx;
            if (t)
                patched.execution_metadata["grain_taper"] = t;
            return reconstruct_grains_additive_stream(in, patched);
        };
 
        matrix->get_grammar()->create_rule("reconstruct") //
            .with_context(ComputationContext::STRUCTURAL)
            .with_priority(25)
            .with_description("Additive grain reconstruction into DynamicSoundStream")
            .matches_type<Kakshya::RegionGroup>()
            .executes(ola_executor)
            .build();
    }
 
    return matrix;
}

References attribute_grains, CONTAINER, CONTAINER_ADDITIVE, MayaFlux::Yantra::ExecutionContext::execution_metadata, reconstruct_grains, reconstruct_grains_additive, reconstruct_grains_additive_stream, reconstruct_grains_stream, segment_grains, sort_grains, STREAM, STREAM_ADDITIVE, MayaFlux::Yantra::STRUCTURAL, and MayaFlux::Yantra::TEMPORAL.

Referenced by process(), and process().

Here is the caller graph for this function: