DVcell_data_labels


Synopsis

extract cell data labels for display in a UIradioBoxLabel


group DVcell_data_labels {
group+Iparam &in{
group+opt cell_set {
group+opt cell_data {
string+opt labels;
};
};
};
string+Oparam labels[];
int+Oparam ncomp => array_size(labels);
method+notify_val+notify_inst upd_cell_data_labels = "cell_data_labels";
};

Description

DVcell_data_labels extracts the cell data labels from all the Data_Arrays within a Cell_Data and stores them in a string array. If there are multiple cell_sets, labels are output for all. This string array (along with the ncomp value) can be used as inputs to a UIradioBoxLabel widget so that the user can pick which component, by label, he/she wants a downstream object to work on.

Input

&in

A reference to a field containing Cell_Data.

Output

labels[]

An string array object. The array is as long as: (ncell_sets * ncell_data) - duplicate_labels in the input field. It contains the labels strings from each component's Data_Array. If no label was present, the string value is empty (""). If duplicate labels are found, only one is output.

ncomp

An integer representing the size of the labels[] array.

Files

v/dv.v
modules/labels.c

Example

Libraries.Main.Filters.extract_component
Libraries.Main.Filters.threshold
Libraries.Main.Filters.clamp
Libraries.Main.Mappers.surf_plot
and many others

See also