vsip_dmputattrib_p - Set Matrix Attributes

Core

This manual is preliminary and incomplete.
While our Core implementation implements all functions given in the standard we are still working on completing this documentation.

Please refer to the VSIPL standard for a complete function reference of the Core profile until we have completed work on this documentation.

[next] [prev] [prev-tail] [tail] [up]

1.4.14 vsip_dmputattrib_p - Set Matrix Attributes

typedef struct { 
    vsip_length row_length;   /* Number of rows */ 
    vsip_length col_length;   /* Number of columns */ 
    vsip_offset offset;       /* Offset into the block */ 
    vsip_stride row_stride;   /* Stride between rows */ 
    vsip_stride col_stride;   /* Stride between columns */ 
    vsip_block_f* block;      /* Pointer to the data block */ 
} vsip_mattr_f; 
/* same for the other dataypes with the respective vsip_dblock_p */ 
 
vsip_mview_f* vsip_mputattrib_f(vsip_mview_f* v, const vsip_mattr_f* attr); 
vsip_cmview_f* vsip_cmputattrib_f(vsip_cmview_f* v, const vsip_cmattr_f* attr);

Description

This function modifies the attributes of an existing matrix view according to the parameters specified in a vsip_dmattr_p structure. It allows you to change the view’s dimensions, memory layout, and binding to its data block in a single operation.

Parameters

vsip_dmview_p* v: Pointer to the matrix view to be modified.
const vsip_dmattr_p* attr: Pointer to the attribute structure containing the new attributes.

Return Value

On success, returns a pointer to the modified matrix view.
On error, returns NULL.

Example

vsip_mview_f *matrix; 
vsip_mattr_f attr; 
vsip_block_f *new_block; 
 
// Create a matrix 
matrix = vsip_mcreate_f(100, 100, VSIP_ROW, VSIP_MEM_NONE); 
 
// Get current attributes 
vsip_mgetattrib_f(matrix, &attr); 
printf("Original dimensions: %lu x %lu\n", attr.row_length, attr.col_length); 
 
// Modify the view to show only a submatrix 
attr.row_length = 50;      // Show only first 50 rows 
attr.col_length = 50;      // Show only first 50 columns 
attr.offset = 0;           // Start from beginning of block 
// Keep the same strides and block 
 
if (vsip_mputattrib_f(matrix, &attr) == NULL) { 
    // Handle error 
}

Notes

This function completely reconfigures the matrix view according to the provided attributes.
The new configuration must be valid (e.g., the block must be large enough to contain the view with the specified offset and strides).
The view’s dimensions can be changed, but must be compatible with the block size and strides.
The offset must be valid for the specified block.
Strides must be positive and compatible with the block size and view dimensions.

[next] [prev] [prev-tail] [front] [up]