Gwyddion – Free SPM (AFM, SNOM/NSOM, STM, MFM, …) data analysis software

stats uncertainty (HEAD)

stats uncertainty — Uncertainties of statistical functions

Functions

gdouble	gwy_data_field_get_max_uncertainty ()
gdouble	gwy_data_field_area_get_max_uncertainty ()
gdouble	gwy_data_field_get_min_uncertainty ()
gdouble	gwy_data_field_area_get_min_uncertainty ()
void	gwy_data_field_get_min_max_uncertainty ()
void	gwy_data_field_area_get_min_max_uncertainty ()
void	gwy_data_field_area_get_min_max_uncertainty_mask ()
gdouble	gwy_data_field_get_avg_uncertainty ()
gdouble	gwy_data_field_area_get_avg_uncertainty ()
gdouble	gwy_data_field_area_get_avg_uncertainty_mask ()
gdouble	gwy_data_field_get_rms_uncertainty ()
gdouble	gwy_data_field_area_get_rms_uncertainty ()
gdouble	gwy_data_field_area_get_rms_uncertainty_mask ()
void	gwy_data_field_get_stats_uncertainties ()
void	gwy_data_field_area_get_stats_uncertainties ()
void	gwy_data_field_area_get_stats_uncertainties_mask ()
void	gwy_data_field_area_acf_uncertainty ()
void	gwy_data_field_acf_uncertainty ()
void	gwy_data_field_area_hhcf_uncertainty ()
void	gwy_data_field_hhcf_uncertainty ()
gdouble	gwy_data_field_get_surface_area_uncertainty ()
gdouble	gwy_data_field_area_get_surface_area_uncertainty ()
gdouble	gwy_data_field_area_get_surface_area_mask_uncertainty ()
gdouble	gwy_data_field_area_get_median_uncertainty ()
gdouble	gwy_data_field_area_get_median_uncertainty_mask ()
gdouble	gwy_data_field_get_median_uncertainty ()
void	gwy_data_field_area_dh_uncertainty ()
void	gwy_data_field_dh_uncertainty ()
void	gwy_data_field_area_get_normal_coeffs_uncertainty ()
void	gwy_data_field_get_normal_coeffs_uncertainty ()
void	gwy_data_field_area_get_inclination_uncertainty ()
void	gwy_data_field_get_inclination_uncertainty ()
gdouble	gwy_data_field_area_get_projected_area_uncertainty ()
void	gwy_data_field_area_cdh_uncertainty ()
void	gwy_data_field_cdh_uncertainty ()
gdouble	gwy_data_field_get_xder_uncertainty ()
gdouble	gwy_data_field_get_yder_uncertainty ()
void	gwy_data_line_acf_uncertainty ()
void	gwy_data_line_cumulate_uncertainty ()
void	gwy_data_line_hhcf_uncertainty ()

Includes

#include <libprocess/gwyprocess.h>

Description

Functions

gwy_data_field_get_max_uncertainty ()

gdouble
gwy_data_field_get_max_uncertainty (GwyDataField *data_field,
                                    GwyDataField *uncz_field);

Finds the uncertainty of the maximum value of a data field.

Note that this is not the uncertainty arising from the calculation of the maximum. It is just the uncertainty of the single value that happens to be the data maximum. As such, the function is not very useful.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.

Returns

The uncertainty of the maximum value.

Since: 2.23

gwy_data_field_area_get_max_uncertainty ()

gdouble
gwy_data_field_area_get_max_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Finds the uncertainty of the maximum value in a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the maximum value. When the number of samples to calculate maximum of is zero, G_MAXDOUBLE is returned.

Since: 2.23

gwy_data_field_get_min_uncertainty ()

gdouble
gwy_data_field_get_min_uncertainty (GwyDataField *data_field,
                                    GwyDataField *uncz_field);

Finds the uncertainty of the minimum value of a data field.

Note that this is not the uncertainty arising from the calculation of the minimum. It is just the uncertainty of the single value that happens to be the data minimum. As such, the function is not very useful.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.

Returns

The uncertainty of the minimum value.

Since: 2.23

gwy_data_field_area_get_min_uncertainty ()

gdouble
gwy_data_field_area_get_min_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Finds the uncertainty of the minimum value in a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the minimum value. When the number of samples to calculate minimum of is zero, G_MAXDOUBLE is returned.

Since: 2.23

gwy_data_field_get_min_max_uncertainty ()

void
gwy_data_field_get_min_max_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                gdouble *min_unc,
                                gdouble *max_unc);

Finds minimum and maximum values of a data field.

Note that this is not the uncertainty arising from the calculation of the minimum and maximum. It is just the uncertainty of the two values that happen to be the data minimum and maximum. As such, the function is not very useful.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
min_unc	Location to store uncertainty of minimum to.
max_unc	Location to store uncertainty maximum to.

Since: 2.23

gwy_data_field_area_get_min_max_uncertainty ()

void
gwy_data_field_area_get_min_max_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *min_unc,
                                gdouble *max_unc);

Finds uncertainties of the minimum and maximum values in a rectangular part of a data field.

This function is equivalent to calling gwy_data_field_area_get_min_max_uncertainty_mask() with masking mode GWY_MASK_INCLUDE.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
min_unc	Location to store uncertainty of minimum to.
max_unc	Location to store uncertainty of maximum to.

Since: 2.23

gwy_data_field_area_get_min_max_uncertainty_mask ()

void
gwy_data_field_area_get_min_max_uncertainty_mask
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *min_unc,
                                gdouble *max_unc);

Finds the uncertainties of the minimum and maximum values in a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
min_unc	Location to store uncertainty of minimum to.
max_unc	Location to store uncertainty of maximum to.

Since: 2.23

gwy_data_field_get_avg_uncertainty ()

gdouble
gwy_data_field_get_avg_uncertainty (GwyDataField *data_field,
                                    GwyDataField *uncz_field);

Computes the uncertainty of the average value of a data field.

Parameters

data_field	A data field
uncz_field	The corresponding uncertainty data field

Returns

The uncertainty of the average value.

Since: 2.23

gwy_data_field_area_get_avg_uncertainty ()

gdouble
gwy_data_field_area_get_avg_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes the uncertainty of the average value of a rectangular part of a data field.

This function is equivalent to calling gwy_data_field_area_get_avg_uncertainty_mask() with masking mode GWY_MASK_INCLUDE.

Parameters

data_field	A data field
uncz_field	The corresponding uncertainty data field
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the average value.

Since: 2.23

gwy_data_field_area_get_avg_uncertainty_mask ()

gdouble
gwy_data_field_area_get_avg_uncertainty_mask
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes the uncertainty of the average value of a rectangular part of a data field.

Parameters

data_field	A data field
uncz_field	The corresponding uncertainty data field
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the average value.

Since: 2.23

gwy_data_field_get_rms_uncertainty ()

gdouble
gwy_data_field_get_rms_uncertainty (GwyDataField *data_field,
                                    GwyDataField *uncz_field);

Computes uncertainty of root mean square value of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.

Returns

The uncertainty of the root mean square value.

gwy_data_field_area_get_rms_uncertainty ()

gdouble
gwy_data_field_area_get_rms_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of root mean square value of a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of root mean square value.

This function is equivalent to calling gwy_data_field_area_get_rms_uncertainty_mask() with masking mode GWY_MASK_INCLUDE.

Since: 2.23

gwy_data_field_area_get_rms_uncertainty_mask ()

gdouble
gwy_data_field_area_get_rms_uncertainty_mask
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of root mean square value of deviations of a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of root mean square value of deviations from the mean value.

Since: 2.23

gwy_data_field_get_stats_uncertainties ()

void
gwy_data_field_get_stats_uncertainties
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                gdouble *avg_unc,
                                gdouble *ra_unc,
                                gdouble *rms_unc,
                                gdouble *skew_unc,
                                gdouble *kurtosis_unc);

Computes the uncertainties of the basic statistical quantities of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
avg_unc	Where uncertainty of average height value of the surface should be stored, or `NULL`.
ra_unc	Where uncertainty of average value of irregularities should be stored, or `NULL`.
rms_unc	Where uncertainty of root mean square value of irregularities (Rq) should be stored, or `NULL`.
skew_unc	Where uncertainty of skew (symmetry of height distribution) should be stored, or `NULL`.
kurtosis_unc	Where uncertainty of kurtosis (peakedness of height ditribution) should be stored, or `NULL`.

Since: 2.23

gwy_data_field_area_get_stats_uncertainties ()

void
gwy_data_field_area_get_stats_uncertainties
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *avg_unc,
                                gdouble *ra_unc,
                                gdouble *rms_unc,
                                gdouble *skew_unc,
                                gdouble *kurtosis_unc);

Computes the uncertainties of the basic statistical quantities of a rectangular part of a data field.

This function is equivalent to calling gwy_data_field_area_get_stats_uncertainties_mask() with masking mode GWY_MASK_INCLUDE.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
avg_unc	Where uncertainty of average height value of the surface should be stored, or `NULL`.
ra_unc	Where uncertainty of average value of irregularities should be stored, or `NULL`.
rms_unc	Where uncertainty of root mean square value of irregularities (Rq) should be stored, or `NULL`.
skew_unc	Where uncertainty of skew (symmetry of height distribution) should be stored, or `NULL`.
kurtosis_unc	Where uncertainty of kurtosis (peakedness of height ditribution) should be stored, or `NULL`.

Since: 2.23

gwy_data_field_area_get_stats_uncertainties_mask ()

void
gwy_data_field_area_get_stats_uncertainties_mask
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *avg_unc,
                                gdouble *ra_unc,
                                gdouble *rms_unc,
                                gdouble *skew_unc,
                                gdouble *kurtosis_unc);

Computes the uncertainties of the basic statistical quantities of a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
avg_unc	Where uncertainty of average height value of the surface should be stored, or `NULL`.
ra_unc	Where uncertainty of average value of irregularities should be stored, or `NULL`.
rms_unc	Where uncertainty of root mean square value of irregularities (Rq) should be stored, or `NULL`.
skew_unc	Where uncertainty of skew (symmetry of height distribution) should be stored, or `NULL`.
kurtosis_unc	Where uncertainty of kurtosis (peakedness of height ditribution) should be stored, or `NULL`.

Since: 2.23

gwy_data_field_area_acf_uncertainty ()

void
gwy_data_field_area_acf_uncertainty (GwyDataField *data_field,
                                     GwyDataField *uncz_field,
                                     GwyDataLine *target_line,
                                     gint col,
                                     gint row,
                                     gint width,
                                     gint height,
                                     GwyOrientation orientation,
                                     GwyInterpolationType interpolation,
                                     gint nstats);

Calculates the uncertainty of the one-dimensional autocorrelation function of a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
target_line	A data line to store the uncertainties of the distribution to.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
orientation	Orientation of lines (ACF is simply averaged over the other orientation).
interpolation	Interpolation to use when `nstats` is given and requires resampling.
nstats	The number of samples to take on the distribution function. If nonpositive, `width` (`height` ) is used.

Since: 2.23

gwy_data_field_acf_uncertainty ()

void
gwy_data_field_acf_uncertainty (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataLine *target_line,
                                GwyOrientation orientation,
                                GwyInterpolationType interpolation,
                                gint nstats);

Calculates uncertainty of one-dimensional autocorrelation function of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
target_line	A data line to store the uncertainties of the distribution to.
orientation	Orientation of lines (ACF is simply averaged over the other orientation).
interpolation	Interpolation to use when `nstats` is given and requires resampling.
nstats	The number of samples the resulting line should have.

Since: 2.23

gwy_data_field_area_hhcf_uncertainty ()

void
gwy_data_field_area_hhcf_uncertainty (GwyDataField *data_field,
                                      GwyDataField *uncz_field,
                                      GwyDataLine *target_line,
                                      gint col,
                                      gint row,
                                      gint width,
                                      gint height,
                                      GwyOrientation orientation,
                                      GwyInterpolationType interpolation,
                                      gint nstats);

Calculates uncertainty of the one-dimensional autocorrelation function of a rectangular part of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
target_line	A data line to store the distribution to. It will be resampled to requested width.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
orientation	Orientation of lines (HHCF is simply averaged over the other orientation).
interpolation	Interpolation to use when `nstats` is given and requires resampling.
nstats	The number of samples the resulting line should have.

Since: 2.23

gwy_data_field_hhcf_uncertainty ()

void
gwy_data_field_hhcf_uncertainty (GwyDataField *data_field,
                                 GwyDataField *uncz_field,
                                 GwyDataLine *target_line,
                                 GwyOrientation orientation,
                                 GwyInterpolationType interpolation,
                                 gint nstats);

Calculates uncertainty of one-dimensional autocorrelation function of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
target_line	A data line to store the distribution to. It will be resampled to requested width.
orientation	Orientation of lines (HHCF is simply averaged over the other orientation).
interpolation	Interpolation to use when `nstats` is given and requires resampling.
nstats	The number of samples the resulting line should have.

Since: 2.23

gwy_data_field_get_surface_area_uncertainty ()

gdouble
gwy_data_field_get_surface_area_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field);

Computes uncertainty of surface area of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
uncx_field	The uncertainty in the x direction.
uncy_field	The uncertainty in the y direction.

Returns

uncertainty of surface area

Since: 2.23

gwy_data_field_area_get_surface_area_uncertainty ()

gdouble
gwy_data_field_area_get_surface_area_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of surface area of a rectangular part of a data field.

This function is equivalent to calling gwy_data_field_area_get_surface_area_mask() with masking mode GWY_MASK_INCLUDE.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
uncx_field	The uncertainty in the x direction.
uncy_field	The uncertainty in the y direction.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of surface area.

Since: 2.23

gwy_data_field_area_get_surface_area_mask_uncertainty ()

gdouble
gwy_data_field_area_get_surface_area_mask_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of surface area of a rectangular part of a data field.

This quantity makes sense only if the lateral dimensions and values of data_field are the same physical quantities.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty data field.
uncx_field	The uncertainty in the x direction.
uncy_field	The uncertainty in the y direction.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the surface area.

Since: 2.23

gwy_data_field_area_get_median_uncertainty ()

gdouble
gwy_data_field_area_get_median_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of median value of a data field area.

This function is equivalent to calling gwy_data_field_area_get_median_uncertainty_mask() with masking mode GWY_MASK_INCLUDE.

Note that this is not the uncertainty arising from the calculation of the median. It is just the uncertainty of the single value that happens to be the data median. As such, the function is not very useful.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty field
mask	Mask specifying which values to take into account/exclude, or `NULL`.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the median value.

Since: 2.23

gwy_data_field_area_get_median_uncertainty_mask ()

gdouble
gwy_data_field_area_get_median_uncertainty_mask
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *mask,
                                GwyMaskingType mode,
                                gint col,
                                gint row,
                                gint width,
                                gint height);

Computes uncertainty of median value of a data field area.

Note that this is not the uncertainty arising from the calculation of the median. It is just the uncertainty of the single value that happens to be the data median.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty field
mask	Mask specifying which values to take into account/exclude, or `NULL`.
mode	Masking mode to use. See the introduction for description of masking modes.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).

Returns

The uncertainty of the median value.

Since: 2.23

gwy_data_field_get_median_uncertainty ()

gdouble
gwy_data_field_get_median_uncertainty (GwyDataField *data_field,
                                       GwyDataField *uncz_field);

Computes uncertainty of median value of a data field.

Parameters

data_field	A data field.
uncz_field	The corresponding uncertainty field

Returns

The uncertainty of the median value.

Since: 2.23

gwy_data_field_area_dh_uncertainty ()

void
gwy_data_field_area_dh_uncertainty (GwyDataField *data_field,
                                    GwyDataField *uncz_field,
                                    GwyDataField *mask,
                                    GwyDataLine *target_line,
                                    gint col,
                                    gint row,
                                    gint width,
                                    gint height,
                                    gint nstats);

Calculates uncertainty of distribution of heights in a rectangular part of data field.

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field
mask	Mask specifying which values to take into account/exclude, or `NULL`.
target_line	A data line to store the distribution to. It will be resampled to requested width.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
nstats	The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

Since: 2.23

gwy_data_field_dh_uncertainty ()

void
gwy_data_field_dh_uncertainty (GwyDataField *data_field,
                               GwyDataField *uncz_field,
                               GwyDataLine *target_line,
                               gint nstats);

Calculates uncertainty of distribution of heights in a data field.

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field
target_line	A data line to store the distribution to. It will be resampled to requested width.
nstats	The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

Since: 2.23

gwy_data_field_area_get_normal_coeffs_uncertainty ()

void
gwy_data_field_area_get_normal_coeffs_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *nx,
                                gdouble *ny,
                                gdouble *nz,
                                gdouble *ux,
                                gdouble *uy,
                                gdouble *uz);

Computes squared uncertainty of average normal vector of an area of a data field.

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field.
uncx_field	The uncertainty in the x direction.
uncy_field	The uncertainty in the y direction.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
nx	Where x-component of average normal vector should be stored, or `NULL`.
ny	Where y-component of average normal vector should be stored, or `NULL`.
nz	Where z-component of average normal vector should be stored, or `NULL`.
ux	Where uncertainty of x-component of average normal vector should be stored, or `NULL`.
uy	Where uncertainty of y-component of average normal vector should be stored, or `NULL`.
uz	Where uncertainty of z-component of average normal vector should be stored, or `NULL`.

Since: 2.23

gwy_data_field_get_normal_coeffs_uncertainty ()

void
gwy_data_field_get_normal_coeffs_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                gdouble *nx,
                                gdouble *ny,
                                gdouble *nz,
                                gdouble *ux,
                                gdouble *uy,
                                gdouble *uz);

Computes squared uncertainty of average normal vector of a data field.

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field.
uncx_field	Corresponding uncertainty field.
uncy_field	Corresponding uncertainty field.
nx	Where x-component of average normal vector should be stored, or `NULL`.
ny	Where y-component of average normal vector should be stored, or `NULL`.
nz	Where z-component of average normal vector should be stored, or `NULL`.
ux	Where x-component of uncertainty of the normal vector should be stored, or `NULL`.
uy	Where y-component of uncertainty of the normal vector should be stored, or `NULL`.
uz	Where z-component of uncertainty of the normal vector should be stored, or `NULL`.

Since: 2.23

gwy_data_field_area_get_inclination_uncertainty ()

void
gwy_data_field_area_get_inclination_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                gint col,
                                gint row,
                                gint width,
                                gint height,
                                gdouble *utheta,
                                gdouble *uphi);

Calculates the uncertainty of the inclination of the image (polar and azimuth angle).

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field.
uncx_field	Corresponding uncertainty field.
uncy_field	Corresponding uncertainty field.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
utheta	Where theta angle (in radians) should be stored, or `NULL`.
uphi	Where phi angle (in radians) should be stored, or `NULL`.

Since: 2.23

gwy_data_field_get_inclination_uncertainty ()

void
gwy_data_field_get_inclination_uncertainty
                               (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field,
                                gdouble *utheta,
                                gdouble *uphi);

Calculates the uncertainty of the inclination of the image (polar and azimuth angle).

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty field.
uncx_field	Corresponding uncertainty field.
uncy_field	Corresponding uncertainty field.
utheta	Where theta angle (in radians) should be stored, or `NULL`.
uphi	Where phi angle (in radians) should be stored, or `NULL`.

Since: 2.23

gwy_data_field_area_get_projected_area_uncertainty ()

gdouble
gwy_data_field_area_get_projected_area_uncertainty
                               (gint nn,
                                GwyDataField *uncx_field,
                                GwyDataField *uncy_field);

gwy_data_field_area_cdh_uncertainty ()

void
gwy_data_field_area_cdh_uncertainty (GwyDataField *data_field,
                                     GwyDataField *uncz_field,
                                     GwyDataField *mask,
                                     GwyDataLine *target_line,
                                     gint col,
                                     gint row,
                                     gint width,
                                     gint height,
                                     gint nstats);

Calculates uncertainty of the cumulative distribution of heights in a rectangular part of the data field.

Parameters

data_field	A data field.
mask	Mask specifying which values to take into account/exclude, or `NULL`.
uncz_field	Corresponding uncertainty data field.
target_line	A data line to store the distribution to. It will be resampled to requested width.
col	Upper-left column coordinate.
row	Upper-left row coordinate.
width	Area width (number of columns).
height	Area height (number of rows).
nstats	The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

Since: 2.23

gwy_data_field_cdh_uncertainty ()

void
gwy_data_field_cdh_uncertainty (GwyDataField *data_field,
                                GwyDataField *uncz_field,
                                GwyDataLine *target_line,
                                gint nstats);

Calculates uncertainty of the cumulative distribution of heights in a data field.

Parameters

data_field	A data field.
uncz_field	Corresponding uncertainty data field.
target_line	A data line to store the distribution to. It will be resampled to requested width.
nstats	The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

Since: 2.23

gwy_data_field_get_xder_uncertainty ()

gdouble
gwy_data_field_get_xder_uncertainty (GwyDataField *data_field,
                                     GwyDataField *uncz_field,
                                     GwyDataField *uncx_field,
                                     GwyDataField *uncy_field,
                                     gint col,
                                     gint row);

gwy_data_field_get_yder_uncertainty ()

gdouble
gwy_data_field_get_yder_uncertainty (GwyDataField *data_field,
                                     GwyDataField *uncz_field,
                                     GwyDataField *uncx_field,
                                     GwyDataField *uncy_field,
                                     gint col,
                                     gint row);

gwy_data_line_acf_uncertainty ()

void
gwy_data_line_acf_uncertainty (GwyDataLine *data_line,
                               GwyDataLine *uline,
                               GwyDataLine *target_line);

Computes squared uncertainty of autocorrelation function and stores the values in target_line

Parameters

data_line	A data line.
uline	A corresponding uncertainty line.
target_line	Data line to store the uncertainty of the autocorrelation function to. It will be resized to `data_line` size.

Since: 2.23

gwy_data_line_cumulate_uncertainty ()

void
gwy_data_line_cumulate_uncertainty (GwyDataLine *uncz_line);

Calculates the uncertainty of a cummulative distribution from the uncertainty of the original distribution.

Parameters

uncz_line

The uncertainty data line.

Since: 2.23

gwy_data_line_hhcf_uncertainty ()

void
gwy_data_line_hhcf_uncertainty (GwyDataLine *data_line,
                                GwyDataLine *uline,
                                GwyDataLine *target_line);

Computes uncertainty squared of the height-height correlation function and stores results in target_line .

Parameters

data_line	A data line.
uline	A corresponding uncertainty line.
target_line	Data line to store uncertainty of height-height function to. It will be resized to `data_line` size.

Since: 2.23