DelayedBinaryIsometricOperation.hpp

Go to the documentation of this file.

#ifndef TATAMI_DELAYED_BINARY_ISOMETRIC_OPERATION_H
#define TATAMI_DELAYED_BINARY_ISOMETRIC_OPERATION_H
 
#include "../../base/Matrix.hpp"
#include "../../utils/new_extractor.hpp"
#include "../../utils/copy.hpp"
#include "../../utils/Index_to_container.hpp"
#include "../../dense/SparsifiedWrapper.hpp"
#include "../depends_utils.hpp"
#include "helper_interface.hpp"
 
#include <memory>
#include <vector>
#include <type_traits>
#include <cstddef>
 
namespace tatami {
 
namespace DelayedBinaryIsometricOperation_internal {
 
/********************
 *** Dense simple ***
 ********************/
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseSimpleFull final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseSimpleFull(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        const Options& opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row)
    {
        my_left_ext = new_extractor<false, oracle_>(left, my_row, oracle, opt);
        my_right_ext = new_extractor<false, oracle_>(right, my_row, std::move(oracle), opt);
        my_extent = my_row ? left.ncol() : left.nrow();
 
        resize_container_to_Index_size(my_right_holding_buffer, my_extent);
        if constexpr(!same_value) {
            my_left_holding_buffer.resize(my_right_holding_buffer.size());
        }
    }
 
    const OutputValue_* fetch(const Index_ i, OutputValue_* const buffer) {
        const auto rptr = my_right_ext->fetch(i, my_right_holding_buffer.data());
 
        if constexpr(same_value) {
            const auto lptr = my_left_ext->fetch(i, buffer);
            copy_n(lptr, my_extent, buffer);
            my_helper.dense(my_row, my_oracle.get(i), static_cast<Index_>(0), my_extent, buffer, rptr, buffer);
        } else {
            auto lptr = my_left_ext->fetch(i, my_left_holding_buffer.data());
            my_helper.dense(my_row, my_oracle.get(i), static_cast<Index_>(0), my_extent, lptr, rptr, buffer);
        }
 
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
 
    std::unique_ptr<DenseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
    Index_ my_extent;
    std::vector<InputValue_> my_right_holding_buffer;
 
    static constexpr bool same_value = std::is_same<OutputValue_, InputValue_>::value;
    typename std::conditional<!same_value, std::vector<InputValue_>, bool>::type my_left_holding_buffer;
};
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseSimpleBlock final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseSimpleBlock(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row),
        my_block_start(block_start),
        my_block_length(block_length)
    {
        my_left_ext = new_extractor<false, oracle_>(left, my_row, oracle, my_block_start, my_block_length, opt);
        my_right_ext = new_extractor<false, oracle_>(right, my_row, std::move(oracle), my_block_start, my_block_length, opt);
 
        resize_container_to_Index_size(my_right_holding_buffer, my_block_length);
        if constexpr(!same_value) {
            my_left_holding_buffer.resize(my_right_holding_buffer.size());
        }
    }
 
    const OutputValue_* fetch(const Index_ i, OutputValue_* const buffer) {
        const auto rptr = my_right_ext->fetch(i, my_right_holding_buffer.data());
 
        if constexpr(same_value) {
            const auto lptr = my_left_ext->fetch(i, buffer);
            copy_n(lptr, my_block_length, buffer);
            my_helper.dense(my_row, my_oracle.get(i), my_block_start, my_block_length, buffer, rptr, buffer);
        } else {
            const auto lptr = my_left_ext->fetch(i, my_left_holding_buffer.data());
            my_helper.dense(my_row, my_oracle.get(i), my_block_start, my_block_length, lptr, rptr, buffer);
        }
 
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
 
    Index_ my_block_start, my_block_length;
    std::unique_ptr<DenseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
    std::vector<InputValue_> my_right_holding_buffer;
 
    static constexpr bool same_value = std::is_same<OutputValue_, InputValue_>::value;
    typename std::conditional<!same_value, std::vector<InputValue_>, bool>::type my_left_holding_buffer;
};
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseSimpleIndex final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseSimpleIndex(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        const Options& opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row),
        my_indices_ptr(std::move(indices_ptr))
    {
        my_left_ext = new_extractor<false, oracle_>(left, my_row, oracle, my_indices_ptr, opt);
        my_right_ext = new_extractor<false, oracle_>(right, my_row, std::move(oracle), my_indices_ptr, opt);
 
        resize_container_to_Index_size(my_right_holding_buffer, my_indices_ptr->size());
        if constexpr(!same_value) {
            my_left_holding_buffer.resize(my_right_holding_buffer.size());
        }
    }
 
    const OutputValue_* fetch(const Index_ i, OutputValue_* const buffer) {
        const auto rptr = my_right_ext->fetch(i, my_right_holding_buffer.data());
        const auto& indices = *my_indices_ptr;
 
        if constexpr(same_value) {
            const auto lptr = my_left_ext->fetch(i, buffer);
            copy_n(lptr, indices.size(), buffer);
            my_helper.dense(my_row, my_oracle.get(i), indices, buffer, rptr, buffer);
        } else {
            const auto lptr = my_left_ext->fetch(i, my_left_holding_buffer.data());
            my_helper.dense(my_row, my_oracle.get(i), indices, lptr, rptr, buffer);
        }
 
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
 
    VectorPtr<Index_> my_indices_ptr;
    std::unique_ptr<DenseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
    std::vector<InputValue_> my_right_holding_buffer;
 
    static constexpr bool same_value = std::is_same<OutputValue_, InputValue_>::value;
    typename std::conditional<!same_value, std::vector<InputValue_>, bool>::type my_left_holding_buffer;
};
 
/**********************
 *** Dense expanded ***
 **********************/
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseExpandedFull final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseExpandedFull(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row)
    {
        opt.sparse_extract_value = true;
        opt.sparse_extract_index = true;
        opt.sparse_ordered_index = true;
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), opt);
        my_extent = my_row ? left.ncol() : left.nrow();
 
        resize_container_to_Index_size(my_left_vbuffer, my_extent);
        my_right_vbuffer.resize(my_left_vbuffer.size());
 
        resize_container_to_Index_size(my_output_vbuffer, my_extent);
 
        resize_container_to_Index_size(my_left_ibuffer, my_extent);
        my_right_ibuffer.resize(my_left_ibuffer.size());
        my_output_ibuffer.resize(my_left_ibuffer.size());
    }
 
    const OutputValue_* fetch(Index_ i, OutputValue_* const buffer) {
        const auto lres = my_left_ext->fetch(i, my_left_vbuffer.data(), my_left_ibuffer.data());
        const auto rres = my_right_ext->fetch(i, my_right_vbuffer.data(), my_right_ibuffer.data());
 
        i = my_oracle.get(i);
        const auto num = my_helper.sparse(my_row, i, lres, rres, my_output_vbuffer.data(), my_output_ibuffer.data(), true, true);
 
        // Avoid calling my_helper.fill() if possible, as this might throw
        // zero-related errors with non-IEEE-float types.
        if (num < my_extent) { 
            std::fill_n(buffer, my_extent, my_helper.fill(my_row, i));
        }
 
        for (Index_ j = 0; j < num; ++j) {
            buffer[my_output_ibuffer[j]] = my_output_vbuffer[j];
        }
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
 
    std::unique_ptr<SparseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
    Index_ my_extent;
 
    std::vector<InputValue_> my_left_vbuffer, my_right_vbuffer;
    std::vector<OutputValue_> my_output_vbuffer;
    std::vector<Index_> my_left_ibuffer, my_right_ibuffer, my_output_ibuffer;
};
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseExpandedBlock final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseExpandedBlock(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row),
        my_block_start(block_start),
        my_block_length(block_length)
    {
        opt.sparse_extract_value = true;
        opt.sparse_extract_index = true;
        opt.sparse_ordered_index = true;
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, my_block_start, my_block_length, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), my_block_start, my_block_length, opt);
 
        resize_container_to_Index_size(my_left_vbuffer, my_block_length);
        my_right_vbuffer.resize(my_left_vbuffer.size());
 
        resize_container_to_Index_size(my_output_vbuffer, my_block_length);
 
        resize_container_to_Index_size(my_left_ibuffer, my_block_length);
        my_right_ibuffer.resize(my_left_ibuffer.size());
        my_output_ibuffer.resize(my_left_ibuffer.size());
    }
 
    const OutputValue_* fetch(Index_ i, OutputValue_* const buffer) {
        const auto lres = my_left_ext->fetch(i, my_left_vbuffer.data(), my_left_ibuffer.data());
        const auto rres = my_right_ext->fetch(i, my_right_vbuffer.data(), my_right_ibuffer.data());
 
        i = my_oracle.get(i);
        const auto num = my_helper.sparse(my_row, i, lres, rres, my_output_vbuffer.data(), my_output_ibuffer.data(), true, true);
 
        // Avoid calling my_helper.fill() if possible, as this might throw
        // zero-related errors with non-IEEE-float types.
        if (num < my_block_length) { 
            std::fill_n(buffer, my_block_length, my_helper.fill(my_row, i));
        }
 
        for (Index_ j = 0; j < num; ++j) {
            buffer[my_output_ibuffer[j] - my_block_start] = my_output_vbuffer[j];
        }
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
    Index_ my_block_start, my_block_length;
 
    std::unique_ptr<SparseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
 
    std::vector<InputValue_> my_left_vbuffer, my_right_vbuffer;
    std::vector<OutputValue_> my_output_vbuffer;
    std::vector<Index_> my_left_ibuffer, my_right_ibuffer, my_output_ibuffer;
};
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class DenseExpandedIndex final : public DenseExtractor<oracle_, OutputValue_, Index_> {
public:
    DenseExpandedIndex(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row),
        my_extent(indices_ptr->size())
    {
        // Create a remapping vector to map the extracted indices back to the
        // dense buffer. We use the 'remapping_offset' to avoid allocating the
        // full extent of the dimension.
        const auto& indices = *indices_ptr;
        if (my_extent) {
            my_remapping_offset = indices.front();
            resize_container_to_Index_size(my_remapping, indices.back() - my_remapping_offset + 1);
            for (Index_ i = 0; i < my_extent; ++i) {
                my_remapping[indices[i] - my_remapping_offset] = i;
            }
        }
 
        opt.sparse_extract_value = true;
        opt.sparse_extract_index = true;
        opt.sparse_ordered_index = true;
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, indices_ptr, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), std::move(indices_ptr), opt);
 
        resize_container_to_Index_size(my_left_vbuffer, my_extent);
        my_right_vbuffer.resize(my_left_vbuffer.size());
 
        resize_container_to_Index_size(my_output_vbuffer, my_extent);
 
        resize_container_to_Index_size(my_left_ibuffer, my_extent);
        my_right_ibuffer.resize(my_left_ibuffer.size());
        my_output_ibuffer.resize(my_left_ibuffer.size());
    }
 
    const OutputValue_* fetch(Index_ i, OutputValue_* const buffer) {
        const auto lres = my_left_ext->fetch(i, my_left_vbuffer.data(), my_left_ibuffer.data());
        const auto rres = my_right_ext->fetch(i, my_right_vbuffer.data(), my_right_ibuffer.data());
 
        i = my_oracle.get(i);
        const auto num = my_helper.sparse(my_row, i, lres, rres, my_output_vbuffer.data(), my_output_ibuffer.data(), true, true);
 
        // Avoid calling my_helper.fill() if possible, as this might throw
        // zero-related errors with non-IEEE-float types.
        if (num < my_extent) { 
            std::fill_n(buffer, my_extent, my_helper.fill(my_row, i));
        }
 
        for (Index_ j = 0; j < num; ++j) {
            buffer[my_remapping[my_output_ibuffer[j] - my_remapping_offset]] = my_output_vbuffer[j];
        }
        return buffer;
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
    Index_ my_extent;
 
    std::vector<Index_> my_remapping;
    Index_ my_remapping_offset = 0;
 
    std::unique_ptr<SparseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
 
    std::vector<InputValue_> my_left_vbuffer, my_right_vbuffer;
    std::vector<OutputValue_> my_output_vbuffer;
    std::vector<Index_> my_left_ibuffer, my_right_ibuffer, my_output_ibuffer;
};
 
/**************
 *** Sparse ***
 **************/
 
template<bool oracle_, typename OutputValue_, typename InputValue_, typename Index_, class Helper_>
class Sparse final : public SparseExtractor<oracle_, OutputValue_, Index_> {
public:
    Sparse(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row)
    {
        initialize(my_row ? left.ncol() : left.nrow(), opt);
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), opt);
    }
 
    Sparse(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row)
    {
        initialize(block_length, opt);
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, block_start, block_length, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), block_start, block_length, opt);
    }
 
    Sparse(
        const Matrix<InputValue_, Index_>& left,
        const Matrix<InputValue_, Index_>& right,
        const Helper_& helper, 
        const bool row, 
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        Options opt) :
        my_helper(helper),
        my_row(row),
        my_oracle(oracle, my_helper, row)
    {
        initialize(indices_ptr->size(), opt); // do this before the move.
        my_left_ext = new_extractor<true, oracle_>(left, my_row, oracle, indices_ptr, opt);
        my_right_ext = new_extractor<true, oracle_>(right, my_row, std::move(oracle), std::move(indices_ptr), opt);
    }
 
private:
    void initialize(std::size_t extent, Options& opt) {
        my_report_value = opt.sparse_extract_value;
        my_report_index = opt.sparse_extract_index;
 
        resize_container_to_Index_size(my_left_ibuffer, extent);
        my_right_ibuffer.resize(my_left_ibuffer.size());
 
        if (my_report_value) {
            resize_container_to_Index_size(my_left_vbuffer, extent);
            my_right_vbuffer.resize(my_left_vbuffer.size());
        }
 
        opt.sparse_ordered_index = true;
        opt.sparse_extract_index = true;
    }
 
public:
    SparseRange<OutputValue_, Index_> fetch(const Index_ i, OutputValue_* const value_buffer, Index_* const index_buffer) {
        const auto left_ranges = my_left_ext->fetch(i, my_left_vbuffer.data(), my_left_ibuffer.data());
        const auto right_ranges = my_right_ext->fetch(i, my_right_vbuffer.data(), my_right_ibuffer.data());
        const auto num = my_helper.sparse(
            my_row, 
            my_oracle.get(i), 
            left_ranges, 
            right_ranges, 
            value_buffer,
            index_buffer,
            my_report_value,
            my_report_index
        );
 
        return SparseRange(
            num, 
            (my_report_value ? value_buffer: NULL),
            (my_report_index ? index_buffer: NULL)
        );
    }
 
private:
    const Helper_& my_helper;
    bool my_row;
    DelayedIsometricOperation_internal::MaybeOracleDepends<oracle_, Helper_, Index_> my_oracle;
 
    std::unique_ptr<SparseExtractor<oracle_, InputValue_, Index_> > my_left_ext, my_right_ext;
    std::vector<InputValue_> my_left_vbuffer, my_right_vbuffer;
    std::vector<Index_> my_left_ibuffer, my_right_ibuffer;
 
    bool my_report_value = false;
    bool my_report_index = false;
};
 
}
template<
    typename OutputValue_,
    typename InputValue_,
    typename Index_,
    class Helper_ = DelayedBinaryIsometricOperationHelper<OutputValue_, InputValue_, Index_>
>
class DelayedBinaryIsometricOperation : public Matrix<OutputValue_, Index_> {
public:
    DelayedBinaryIsometricOperation(
        std::shared_ptr<const Matrix<InputValue_, Index_> > left,
        std::shared_ptr<const Matrix<InputValue_, Index_> > right,
        std::shared_ptr<const Helper_> helper
    ) : 
        my_left(std::move(left)), my_right(std::move(right)), my_helper(std::move(helper)) 
    {
        const auto NR = my_left->nrow();
        const auto NC = my_left->ncol();
        if (NR != my_right->nrow() || NC != my_right->ncol()) {
            throw std::runtime_error("shape of the left and right matrices should be the same");
        }
 
        const auto expected_rows = my_helper->nrow();
        if (expected_rows.has_value() && *expected_rows != NR) {
            throw std::runtime_error("number of matrix rows is not consistent with those expected by 'helper'");
        }
        const auto expected_cols = my_helper->ncol();
        if (expected_cols.has_value() && *expected_cols != NC) {
            throw std::runtime_error("number of matrix columns is not consistent with those expected by 'helper'");
        }
 
        my_prefer_rows_proportion = (my_left->prefer_rows_proportion() + my_right->prefer_rows_proportion()) / 2;
 
        if (my_helper->is_sparse()) {
            my_is_sparse = my_left->is_sparse() && my_right->is_sparse();
 
            // Well, better than nothing, I guess.
            my_is_sparse_proportion = (my_left->is_sparse_proportion() + my_right->is_sparse_proportion())/2;
        }
    }
 
private:
    std::shared_ptr<const Matrix<InputValue_, Index_> > my_left, my_right;
    std::shared_ptr<const Helper_> my_helper;
 
    double my_prefer_rows_proportion;
    double my_is_sparse_proportion = 0;
    bool my_is_sparse = false;
 
public:
    Index_ nrow() const {
        return my_left->nrow();
    }
 
    Index_ ncol() const {
        return my_left->ncol();
    }
 
    bool is_sparse() const {
        return my_is_sparse;
    }
 
    double is_sparse_proportion() const {
        return my_is_sparse_proportion;
    }
 
    bool prefer_rows() const { 
        return my_prefer_rows_proportion > 0.5;
    }
 
    double prefer_rows_proportion() const { 
        return my_prefer_rows_proportion;
    }
 
    bool uses_oracle(bool row) const {
        return my_left->uses_oracle(row) || my_right->uses_oracle(row);
    }
 
    using Matrix<OutputValue_, Index_>::dense;
 
    using Matrix<OutputValue_, Index_>::sparse;
 
    /********************
     *** Myopic dense ***
     ********************/
private:
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_simple_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseSimpleFull<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_simple_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseSimpleBlock<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            block_start,
            block_length,
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_simple_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseSimpleIndex<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            std::move(indices_ptr),
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_expanded_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseExpandedFull<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_expanded_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseExpandedBlock<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            block_start,
            block_length,
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_expanded_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        const Options& opt)
    const {
        return std::make_unique<DelayedBinaryIsometricOperation_internal::DenseExpandedIndex<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
            *my_left,
            *my_right,
            *my_helper,
            row, 
            std::move(oracle),
            std::move(indices_ptr),
            opt
        );
    }
 
    template<bool oracle_, typename ... Args_>
    std::unique_ptr<DenseExtractor<oracle_, OutputValue_, Index_> > dense_internal(const bool row, Args_&& ... args) const {
        if (my_is_sparse) {
            if (DelayedIsometricOperation_internal::can_dense_expand(*my_helper, row)) {
                return dense_expanded_internal<oracle_>(row, std::forward<Args_>(args)...);
            }
        }
 
        return dense_simple_internal<oracle_>(row, std::forward<Args_>(args)...);
    }
 
public:
    std::unique_ptr<MyopicDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        const Options& opt
    ) const {
        return dense_internal<false>(row, false, opt);
    }
 
    std::unique_ptr<MyopicDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt
    ) const {
        return dense_internal<false>(row, false, block_start, block_length, opt);
    }
 
    std::unique_ptr<MyopicDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        VectorPtr<Index_> indices_ptr,
        const Options& opt
    ) const {
        return dense_internal<false>(row, false, std::move(indices_ptr), opt);
    }
 
    /*********************
     *** Myopic sparse ***
     *********************/
private:
    template<bool oracle_>
    std::unique_ptr<SparseExtractor<oracle_, OutputValue_, Index_> > sparse_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Options& opt)
    const {
        if (my_is_sparse) {
            return std::make_unique<DelayedBinaryIsometricOperation_internal::Sparse<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
                *my_left,
                *my_right,
                *my_helper,
                row, 
                std::move(oracle),
                opt
            );
        }
 
        return std::make_unique<FullSparsifiedWrapper<oracle_, OutputValue_, Index_> >(
            dense_internal<oracle_>(row, std::move(oracle), opt),
            row ? my_left->ncol() : my_left->nrow(),
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<SparseExtractor<oracle_, OutputValue_, Index_> > sparse_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt)
    const {
        if (my_is_sparse) {
            return std::make_unique<DelayedBinaryIsometricOperation_internal::Sparse<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
                *my_left,
                *my_right,
                *my_helper,
                row, 
                std::move(oracle),
                block_start,
                block_length,
                opt
            );
        }
 
        return std::make_unique<BlockSparsifiedWrapper<oracle_, OutputValue_, Index_> >(
            dense_internal<oracle_>(row, std::move(oracle), block_start, block_length, opt),
            block_start,
            block_length,
            opt
        );
    }
 
    template<bool oracle_>
    std::unique_ptr<SparseExtractor<oracle_, OutputValue_, Index_> > sparse_internal(
        const bool row,
        MaybeOracle<oracle_, Index_> oracle,
        VectorPtr<Index_> indices_ptr,
        const Options& opt)
    const {
        if (my_is_sparse) {
            return std::make_unique<DelayedBinaryIsometricOperation_internal::Sparse<oracle_, OutputValue_, InputValue_, Index_, Helper_> >(
                *my_left,
                *my_right,
                *my_helper,
                row, 
                std::move(oracle),
                std::move(indices_ptr),
                opt
            );
        }
 
        return std::make_unique<IndexSparsifiedWrapper<oracle_, OutputValue_, Index_> >(
            dense_internal<oracle_>(row, std::move(oracle), indices_ptr, opt),
            indices_ptr,
            opt
        );
    }
 
public:
    std::unique_ptr<MyopicSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        const Options& opt
    ) const {
        return sparse_internal<false>(row, false, opt);
    }
 
    std::unique_ptr<MyopicSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt
    ) const {
        return sparse_internal<false>(row, false, block_start, block_length, opt);
    }
 
    std::unique_ptr<MyopicSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        VectorPtr<Index_> indices_ptr,
        const Options& opt
    ) const {
        return sparse_internal<false>(row, false, std::move(indices_ptr), opt);
    }
 
    /**********************
     *** Oracular dense ***
     **********************/
public:
    std::unique_ptr<OracularDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle,
        const Options& opt)
    const {
        return dense_internal<true>(row, std::move(oracle), opt);
    }
 
    std::unique_ptr<OracularDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt)
    const {
        return dense_internal<true>(row, std::move(oracle), block_start, block_length, opt);
    }
 
    std::unique_ptr<OracularDenseExtractor<OutputValue_, Index_> > dense(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle,
        VectorPtr<Index_> indices_ptr,
        const Options& opt)
    const {
        return dense_internal<true>(row, std::move(oracle), std::move(indices_ptr), opt);
    }
 
    /***********************
     *** Oracular sparse ***
     ***********************/
public:
    std::unique_ptr<OracularSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle,
        const Options& opt)
    const {
        return sparse_internal<true>(row, std::move(oracle), opt);
    }
 
    std::unique_ptr<OracularSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle,
        const Index_ block_start,
        const Index_ block_length,
        const Options& opt)
    const {
        return sparse_internal<true>(row, std::move(oracle), block_start, block_length, opt);
    }
 
    std::unique_ptr<OracularSparseExtractor<OutputValue_, Index_> > sparse(
        const bool row,
        std::shared_ptr<const Oracle<Index_> > oracle, 
        VectorPtr<Index_> indices_ptr,
        const Options& opt) 
    const {
        return sparse_internal<true>(row, std::move(oracle), std::move(indices_ptr), opt);
    }
};
 
// Back-compatibility only.
template<typename OutputValue_ = double, typename InputValue_, typename Index_, class Helper_>
std::shared_ptr<Matrix<OutputValue_, Index_> > make_DelayedBinaryIsometricOperation(
    std::shared_ptr<const Matrix<InputValue_, Index_> > left,
    std::shared_ptr<const Matrix<InputValue_, Index_> > right,
    std::shared_ptr<const Helper_> op)
{
    return std::make_shared<DelayedBinaryIsometricOperation<OutputValue_, InputValue_, Index_, Helper_> >(std::move(left), std::move(right), std::move(op));
}
 
template<typename OutputValue_ = double, typename InputValue_, typename Index_, class Helper_>
std::shared_ptr<Matrix<OutputValue_, Index_> > make_DelayedBinaryIsometricOperation(
    std::shared_ptr<Matrix<InputValue_, Index_> > left,
    std::shared_ptr<Matrix<InputValue_, Index_> > right,
    std::shared_ptr<Helper_> op)
{
    return std::make_shared<DelayedBinaryIsometricOperation<OutputValue_, InputValue_, Index_, Helper_> >(std::move(left), std::move(right), std::move(op));
}
}
 
#endif