#include "tensorstore/index_space/index_transform_builder.h"
IndexTransformBuilder&
tensorstore::IndexTransformBuilder<InputRank, OutputRank>::
    
output_single_input_dimension(DimensionIndex output_dim,
                                  
Index offset,
                                  
Index stride,
                                  
DimensionIndex input_dim);
IndexTransformBuilder&
tensorstore::IndexTransformBuilder<InputRank, OutputRank>::
    
output_single_input_dimension(DimensionIndex output_dim,
                                  
DimensionIndex input_dim);

Sets the output index map for output dimension output_dim to a OutputIndexMethod::single_input_dimension map with the specified offset, stride, and input_dim.

Specifically, specifies the mapping:

output[output_dim] = offset + stride * input[input_dim].

If offset and stride are omitted, defaults to an identity map output[output_dim] = input[input_dim] (offset = 0, stride = 1).

Parameters:
DimensionIndex output_dim

The output dimension for which to set the output index map.

Index offset

The offset value.

Index stride

The stride value by which to multiply the input index.

DimensionIndex input_dim

The input dimension on which the index for output_dim depends. If input_dim<0 || input_dim> = input_rank(), this output index map is considered invalid (resulting in Finalize returning an error).

Pre:

valid() == true

Checks:

0 <= output_dim && output_dim < output_rank().

Note

This method overrides any output index map for output_dim specified by a previous output_*(output_dim, ...) call.