-
da_status da_data_extract_selection_int(da_datastore store, const char *key, da_order order, da_int *data, da_int lddata)#
-
da_status da_data_extract_selection_real_s(da_datastore store, const char *key, da_order order, float *data, da_int lddata)#
-
da_status da_data_extract_selection_real_d(da_datastore store, const char *key, da_order order, double *data, da_int lddata)#
-
da_status da_data_extract_selection_uint8(da_datastore store, const char *key, da_order order, uint8_t *data, da_int lddata)#
Extract a selection labeled by
key. The last suffix of the function name marks the type of the data to be extracted.The data marked by the set of columns and rows in the selection
keyis extracted into a dense matrix of the corresponding type. The matrix is returned in column-major order, unless you have set the storage order option to row-major.- Parameters:
store – [in] main data structure.
key – [in] label of the selection.
order – [in] a da_order enumerated type. Specifies whether
datashould be returned in column-major or row-major order.data – [out] output matrix.
lddata – [in] leading dimension of the output data.
- Returns:
da_status. The function returns:
da_status_success the operation was successful.
da_status_invalid_input - some of the input data was not correct. Use da_handle_print_error_message to get more details.
da_status_invalid_pointer - the store was not correctly initialized.
da_status_missing_block - the store contains incomplete row blocks.
da_status_internal_error - an unexpected error occurred.
-
da_status da_data_extract_column_int(da_datastore store, da_int idx, da_int dim, da_int *col)#
-
da_status da_data_extract_column_real_s(da_datastore store, da_int idx, da_int dim, float *col)#
-
da_status da_data_extract_column_real_d(da_datastore store, da_int idx, da_int dim, double *col)#
-
da_status da_data_extract_column_uint8(da_datastore store, da_int idx, da_int dim, uint8_t *col)#
-
da_status da_data_extract_column_str(da_datastore store, da_int idx, da_int dim, char **col)#
Extract a column from a store into a pre-allocated array. The last suffix of the function name marks the type of the data to add.
dimis the size of the output array provided to the function and must be at least the number or rows in the store.- Parameters:
store – [in] main data structure.
idx – [in] index of the column to extract.
dim – [in] size of the vector provided.
col – [out] array the column will be exported to.
- Returns:
da_status. The function returns:
da_status_success - the operation was successful.
da_status_invalid_input - some of the input data was not correct. Use da_handle_print_error_message to get more details.
da_status_invalid_pointer - the store was not correctly initialized.
da_status_missing_block - the store contains incomplete row blocks.
da_status_internal_error - an unexpected error occurred.