stats

stats — Two-dimensional statistical functions

Synopsis




gdouble     gwy_data_field_get_max          (GwyDataField *data_field);
gdouble     gwy_data_field_get_min          (GwyDataField *data_field);
gdouble     gwy_data_field_get_avg          (GwyDataField *data_field);
gdouble     gwy_data_field_get_rms          (GwyDataField *data_field);
gdouble     gwy_data_field_get_sum          (GwyDataField *data_field);
gdouble     gwy_data_field_get_median       (GwyDataField *data_field);
gdouble     gwy_data_field_get_surface_area (GwyDataField *data_field);
gdouble     gwy_data_field_area_get_max     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_min     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_avg     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_rms     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_sum     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_median  (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
gdouble     gwy_data_field_area_get_surface_area
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);
void        gwy_data_field_get_autorange    (GwyDataField *data_field,
                                             gdouble *from,
                                             gdouble *to);
void        gwy_data_field_get_stats        (GwyDataField *data_field,
                                             gdouble *avg,
                                             gdouble *ra,
                                             gdouble *rms,
                                             gdouble *skew,
                                             gdouble *kurtosis);
void        gwy_data_field_area_get_stats   (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *avg,
                                             gdouble *ra,
                                             gdouble *rms,
                                             gdouble *skew,
                                             gdouble *kurtosis);
void        gwy_data_field_area_dh          (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gint nstats);
void        gwy_data_field_dh               (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint nstats);
void        gwy_data_field_area_cdh         (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gint nstats);
void        gwy_data_field_cdh              (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint nstats);
void        gwy_data_field_area_da          (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             gint nstats);
void        gwy_data_field_da               (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             gint nstats);
void        gwy_data_field_area_cda         (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             gint nstats);
void        gwy_data_field_cda              (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             gint nstats);
void        gwy_data_field_area_acf         (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             gint nstats);
void        gwy_data_field_acf              (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             gint nstats);
void        gwy_data_field_area_hhcf        (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             gint nstats);
void        gwy_data_field_hhcf             (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             gint nstats);
void        gwy_data_field_area_psdf        (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             GwyWindowingType windowing,
                                             gint nstats);
void        gwy_data_field_psdf             (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             GwyWindowingType windowing,
                                             gint nstats);
void        gwy_data_field_area_minkowski_volume
                                            (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gint nstats);
void        gwy_data_field_minkowski_volume (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint nstats);
void        gwy_data_field_area_minkowski_boundary
                                            (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gint nstats);
void        gwy_data_field_minkowski_boundary
                                            (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint nstats);
void        gwy_data_field_area_minkowski_euler
                                            (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gint nstats);
void        gwy_data_field_minkowski_euler  (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint nstats);
void        gwy_data_field_slope_distribution
                                            (GwyDataField *data_field,
                                             GwyDataLine *derdist,
                                             gint kernel_size);
void        gwy_data_field_get_normal_coeffs
                                            (GwyDataField *data_field,
                                             gdouble *nx,
                                             gdouble *ny,
                                             gdouble *nz,
                                             gboolean normalize1);
void        gwy_data_field_area_get_normal_coeffs
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *nx,
                                             gdouble *ny,
                                             gdouble *nz,
                                             gboolean normalize1);
void        gwy_data_field_area_get_inclination
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *theta,
                                             gdouble *phi);
void        gwy_data_field_get_inclination  (GwyDataField *data_field,
                                             gdouble *theta,
                                             gdouble *phi);

Description

Details

gwy_data_field_get_max ()

gdouble     gwy_data_field_get_max          (GwyDataField *data_field);

Finds the maximum value of a data field.

This quantity is cached.

data_field : A data field.
Returns : The maximum value.

gwy_data_field_get_min ()

gdouble     gwy_data_field_get_min          (GwyDataField *data_field);

Finds the minimum value of a data field.

This quantity is cached.

data_field : A data field.
Returns : The minimum value.

gwy_data_field_get_avg ()

gdouble     gwy_data_field_get_avg          (GwyDataField *data_field);

Computes average value of a data field.

This quantity is cached.

data_field : A data field
Returns : The average value.

gwy_data_field_get_rms ()

gdouble     gwy_data_field_get_rms          (GwyDataField *data_field);

Computes root mean square value of a data field.

This quantity is cached.

data_field : A data field.
Returns : The root mean square value.

gwy_data_field_get_sum ()

gdouble     gwy_data_field_get_sum          (GwyDataField *data_field);

Sums all values in a data field.

This quantity is cached.

data_field : A data field.
Returns : The sum of all values.

gwy_data_field_get_median ()

gdouble     gwy_data_field_get_median       (GwyDataField *data_field);

Computes median value of a data field.

This quantity is cached.

data_field : A data field.
Returns : The median value.

gwy_data_field_get_surface_area ()

gdouble     gwy_data_field_get_surface_area (GwyDataField *data_field);

Computes surface area of a data field.

This quantity is cached.

data_field : A data field.
Returns : surface area

gwy_data_field_area_get_max ()

gdouble     gwy_data_field_area_get_max     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

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

data_field : A data field
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The maximum value.

gwy_data_field_area_get_min ()

gdouble     gwy_data_field_area_get_min     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

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

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The minimum value.

gwy_data_field_area_get_avg ()

gdouble     gwy_data_field_area_get_avg     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

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

data_field : A data field
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The average value.

gwy_data_field_area_get_rms ()

gdouble     gwy_data_field_area_get_rms     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

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

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The root mean square value.

gwy_data_field_area_get_sum ()

gdouble     gwy_data_field_area_get_sum     (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

Sums values of a rectangular part of a data field.

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The sum of all values inside area.

gwy_data_field_area_get_median ()

gdouble     gwy_data_field_area_get_median  (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

Computes median value of a data field area.

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The median value.

gwy_data_field_area_get_surface_area ()

gdouble     gwy_data_field_area_get_surface_area
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height);

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

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
Returns : The surface area.

gwy_data_field_get_autorange ()

void        gwy_data_field_get_autorange    (GwyDataField *data_field,
                                             gdouble *from,
                                             gdouble *to);

Computes value range with outliers cut-off.

The purpose of this function is to find a range is suitable for false color mapping. The precise method how it is calculated is unspecified and may be subject to changes.

However, it is guaranteed minimum <= from <= to <= maximum.

This quantity is cached.

data_field : A data field.
from : Location to store range start.
to : Location to store range end.

gwy_data_field_get_stats ()

void        gwy_data_field_get_stats        (GwyDataField *data_field,
                                             gdouble *avg,
                                             gdouble *ra,
                                             gdouble *rms,
                                             gdouble *skew,
                                             gdouble *kurtosis);

Computes basic statistical quantities of a data field.

data_field : A data field.
avg : Where average height value of the surface should be stored, or NULL.
ra : Where average value of irregularities should be stored, or NULL.
rms : Where root mean square value of irregularities (Rq) should be stored, or NULL.
skew : Where skew (symmetry of height distribution) should be stored, or NULL.
kurtosis : Where kurtosis (peakedness of height ditribution) should be stored, or NULL.

gwy_data_field_area_get_stats ()

void        gwy_data_field_area_get_stats   (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *avg,
                                             gdouble *ra,
                                             gdouble *rms,
                                             gdouble *skew,
                                             gdouble *kurtosis);

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

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
avg : Where average height value of the surface should be stored, or NULL.
ra : Where average value of irregularities should be stored, or NULL.
rms : Where root mean square value of irregularities (Rq) should be stored, or NULL.
skew : Where skew (symmetry of height distribution) should be stored, or NULL.
kurtosis : Where kurtosis (peakedness of height ditribution) should be stored, or NULL.

gwy_data_field_area_dh ()

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

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

data_field : A 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.

gwy_data_field_dh ()

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

Calculates distribution of heights in a data field.

data_field : A 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.

gwy_data_field_area_cdh ()

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

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

data_field : A 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.

gwy_data_field_cdh ()

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

Calculates cumulative distribution of heights in a data field.

data_field : A 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.

gwy_data_field_area_da ()

void        gwy_data_field_area_da          (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             gint nstats);

Calculates distribution of slopes in a rectangular part of data field.

data_field : A 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 to compute the slope distribution in.
nstats : The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

gwy_data_field_da ()

void        gwy_data_field_da               (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             gint nstats);

Calculates distribution of slopes in a data field.

data_field : A data field.
target_line : A data line to store the distribution to. It will be resampled to requested width.
orientation : Orientation to compute the slope distribution in.
nstats : The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

gwy_data_field_area_cda ()

void        gwy_data_field_area_cda         (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             GwyOrientation orientation,
                                             gint nstats);

Calculates cumulative distribution of slopes in a rectangular part of data field.

data_field : A 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 to compute the slope distribution in.
nstats : The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

gwy_data_field_cda ()

void        gwy_data_field_cda              (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             gint nstats);

Calculates cumulative distribution of slopes in a data field.

data_field : A data field.
target_line : A data line to store the distribution to. It will be resampled to requested width.
orientation : Orientation to compute the slope distribution in.
nstats : The number of samples to take on the distribution function. If nonpositive, a suitable resolution is determined automatically.

gwy_data_field_area_acf ()

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

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

data_field : A 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 (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.

gwy_data_field_acf ()

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

Calculates one-dimensional autocorrelation function of a data field.

data_field : A data field.
target_line : A data line to store the distribution to. It will be resampled to requested width.
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, data field width (height) is used.

gwy_data_field_area_hhcf ()

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

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

data_field : A 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 to take on the distribution function. If nonpositive, width (height) is used.

gwy_data_field_hhcf ()

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

Calculates one-dimensional autocorrelation function of a data field.

data_field : A 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 to take on the distribution function. If nonpositive, data field width (height) is used.

gwy_data_field_area_psdf ()

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

Calculates one-dimensional power spectrum density function of a rectangular part of a data field.

data_field : A 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 (PSDF is simply averaged over the other orientation).
interpolation : Interpolation to use when nstats is given and requires resampling (and possibly in FFT too).
windowing : Windowing type to use.
nstats : The number of samples to take on the distribution function. If nonpositive, data field width (height) is used.

gwy_data_field_psdf ()

void        gwy_data_field_psdf             (GwyDataField *data_field,
                                             GwyDataLine *target_line,
                                             GwyOrientation orientation,
                                             GwyInterpolationType interpolation,
                                             GwyWindowingType windowing,
                                             gint nstats);

Calculates one-dimensional power spectrum density function of a rectangular part of a data field.

data_field : A data field.
target_line : A data line to store the distribution to. It will be resampled to requested width.
orientation : Orientation of lines (PSDF is simply averaged over the other orientation).
interpolation : Interpolation to use when nstats is given and requires resampling (and possibly in FFT too).
windowing : Windowing type to use.
nstats : The number of samples to take on the distribution function. If nonpositive, data field width (height) is used.

gwy_data_field_area_minkowski_volume ()

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

Calculates Minkowski volume functional of a rectangular part of a data field.

Volume functional is calculated as the number of values above each threshold value (,white pixels`) divided by the total number of samples in the area. Is it's equivalent to 1-CDH.

data_field : A 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.

gwy_data_field_minkowski_volume ()

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

Calculates Minkowski volume functional of a data field.

See gwy_data_field_area_minkowski_volume() for details.

data_field : A 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.

gwy_data_field_area_minkowski_boundary ()

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

Calculates Minkowski boundary functional of a rectangular part of a data field.

Boundary functional is calculated as the number of boundaries for each threshold value (the number of pixel sides where of neighouring pixels is ,white` and the other ,black`) divided by the total number of samples in the area.

data_field : A 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.

gwy_data_field_minkowski_boundary ()

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

Calculates Minkowski boundary functional of a data field.

See gwy_data_field_area_minkowski_boundary() for details.

data_field : A 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.

gwy_data_field_area_minkowski_euler ()

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

Calculates Minkowski connectivity functional (Euler characteristics) of a rectangular part of a data field.

Connectivity functional is calculated as the number connected areas of pixels above threhsold (,white`) minus the number of connected areas of pixels below threhsold (,black`) for each threshold value, divided by the total number of samples in the area.

data_field : A 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.

gwy_data_field_minkowski_euler ()

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

Calculates Minkowski connectivity functional (Euler characteristics) of a data field.

See gwy_data_field_area_minkowski_euler() for details.

data_field : A 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.

gwy_data_field_slope_distribution ()

void        gwy_data_field_slope_distribution
                                            (GwyDataField *data_field,
                                             GwyDataLine *derdist,
                                             gint kernel_size);

Computes angular slope distribution.

data_field : A data field.
derdist : A data line to fill with angular slope distribution. Its resolution determines resolution of the distribution.
kernel_size : If positive, local plane fitting will be used for slope computation; if nonpositive, plain central derivations will be used.

gwy_data_field_get_normal_coeffs ()

void        gwy_data_field_get_normal_coeffs
                                            (GwyDataField *data_field,
                                             gdouble *nx,
                                             gdouble *ny,
                                             gdouble *nz,
                                             gboolean normalize1);

Computes average normal vector of a data field.

data_field : A data 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.
normalize1 : true to normalize the normal vector to 1, false to normalize the vector so that z-component is 1.

gwy_data_field_area_get_normal_coeffs ()

void        gwy_data_field_area_get_normal_coeffs
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *nx,
                                             gdouble *ny,
                                             gdouble *nz,
                                             gboolean normalize1);

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

data_field : A data field.
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.
normalize1 : true to normalize the normal vector to 1, false to normalize the vector so that z-component is 1.

gwy_data_field_area_get_inclination ()

void        gwy_data_field_area_get_inclination
                                            (GwyDataField *data_field,
                                             gint col,
                                             gint row,
                                             gint width,
                                             gint height,
                                             gdouble *theta,
                                             gdouble *phi);

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

data_field : A data field.
col : Upper-left column coordinate.
row : Upper-left row coordinate.
width : Area width (number of columns).
height : Area height (number of rows).
theta : Where theta angle (in radians) should be stored, or NULL.
phi : Where phi angle (in radians) should be stored, or NULL.

gwy_data_field_get_inclination ()

void        gwy_data_field_get_inclination  (GwyDataField *data_field,
                                             gdouble *theta,
                                             gdouble *phi);

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

data_field : A data field.
theta : Where theta angle (in radians) should be stored, or NULL.
phi : Where phi angle (in radians) should be stored, or NULL.