FryObjective: Objective ellipse fitting to central void.

Description Usage Arguments Details Value Author(s) References See Also

View source: R/FryObjective.R

Description

Function selects nearest points to Fry plot origin in angular wedges and fits an ellipse to these points using a deterministic least squares method. The wedges are iteratively modified from the resultant ellipse to better define selection bins that are narrower near the apogee of the central void and wider near the perigee.

Usage

1
2
3
FryObjective(object.data, n.pass = 15, pie.step = 12,
expansion = 1.5, pie.pts = 1, section.name, ave.piepts = FALSE,
norm = TRUE)

Arguments

object.data

Data frame object returned from ParEx.

n.pass

Number of ellipse fitting iterations.

pie.step

Angular distance in degrees as a multiple of 360. This is initially used to divide the fry plot into n wedge shaped regions of distance pie.step where the closest n pie.pts to the origin within each wedge is saved. Used in initial ellipse fit.

expansion

An expansion factor to be multiplied to the central void diameter estimate in order to properly scale Fry plots.

pie.pts

The number of nearest points to the plot origin that are selected in each wedge bin.

section.name

The name of the sectional analysis.

ave.piepts

Logical, if TRUE, the coordinates of n pie.pts selected from each wedge bin are averaged prior to least squares ellipse fitting.

norm

Logical, if TRUE, a normalized Fry method is used.

Details

This function creates either a normalized or standard Fry plot data frame from the centroids of object traces and attempts to objectively fit an ellipse to the central void. This is done initially by determining the nearest n pie.pts to the origin within each angular bin of length pie.step in degrees. A deterministic least squares method of ellipse fitting (modified code written by Michael Bedward) is applied to these points in order to make an initial estimate of the central void. This initial estimate will likely underestimate the Rs ratio because a bias of more points near the perigees of the central void and fewer points near the apogees. The bins are modified based on the estimate ellipse so that so that a smaller angular distance is used near the apogees and a larger angular distance near the perigees. Points are selected from these bins are previously described and a new ellipse is fitted. This procedure is repeated n.pass times to return the parameters of the objectively fitted central void ellipse.

Value

Returns an object of class FRY.

Author(s)

Jeffrey R. Webber

References

Deterministic least squares method of ellipse fitting function is modified from code written by Michael Bedward.

Halir, Radim, and Jan Flusser. "Numerically stable direct least squares fitting of ellipses." Proc. 6th International Conference in Central Europe on Computer Graphics and Visualization. WSCG. Vol. 98. 1998.

Fry, N. (1979) Random point distributions and strain measurement in rocks.

Erslev, E. (1988) Normalized center-to-center strain analysis of packed aggregates.

See Also

RfPhi, FryData, FryNormData,FrySelect


RockFab documentation built on May 29, 2017, 10:33 p.m.