correct

correct — Data correction

Synopsis




void        gwy_data_field_correct_laplace_iteration
                                            (GwyDataField *data_field,
                                             GwyDataField *mask_field,
                                             GwyDataField *buffer_field,
                                             gdouble *error,
                                             gdouble *corfactor);
void        gwy_data_field_correct_average  (GwyDataField *data_field,
                                             GwyDataField *mask_field);
void        gwy_data_field_mask_outliers    (GwyDataField *data_field,
                                             GwyDataField *mask_field,
                                             gdouble thresh);

Description

Details

gwy_data_field_correct_laplace_iteration ()

void        gwy_data_field_correct_laplace_iteration
                                            (GwyDataField *data_field,
                                             GwyDataField *mask_field,
                                             GwyDataField *buffer_field,
                                             gdouble *error,
                                             gdouble *corfactor);

Tries to remove all the points in mask off the data by using iterative method similar to solving heat flux equation. Use this function repeatedly until reasonable error is reached.

data_field : data field to be corrected
mask_field : mask of places to be corrected
buffer_field : initialized to same size aa mask and data
error : maximum change within last step
corfactor : correction factor within step.

gwy_data_field_correct_average ()

void        gwy_data_field_correct_average  (GwyDataField *data_field,
                                             GwyDataField *mask_field);

Function simply puts average value of all the data_field into points in data_field lying under points where mask_field values are nonzero.

data_field : data field
mask_field : mask to be used for changes

gwy_data_field_mask_outliers ()

void        gwy_data_field_mask_outliers    (GwyDataField *data_field,
                                             GwyDataField *mask_field,
                                             gdouble thresh);

Creates mask of data that are above or below thresh*sigma from average height. Sigma denotes root-mean square deviation of heights. This criterium corresponds to usual Gaussian distribution outliers detection for thresh = 3.

data_field : data field
mask_field : mask to be changed
thresh : threshold value