Skip to content

Variography🍋

plot_semivariogram(variograms, model=None, model_angles=None, display_npairs=False, method=VariographyMethod.SEMIVARIOGRAM, kwargs) 🍋

Return semi variograms and associated models.

Parameters:

Name Type Description Default
variograms List

A pandas DataFrame with at least "vario" column in it.

required
model Optional[Union[Covariance, CovarianceElem]]

Covariance model to be applied. Defaults to None.

None
model_angles Optional[List[Dict]]

Display variogram model along other orientations. {azi: float, dip: float, pitch: float, label: str}. Defaults to None.

None
display_npairs Optional[bool]

Display number of pairs if True when hovered. Defaults to False.

False
method VariographyMethod

"COVARIOGRAM" or "SEMIVARIOGRAM". Defaults to None.

VariographyMethod.SEMIVARIOGRAM

Returns:

Type Description
Figure

1D plot of variograms and models.

vario_contour(geo_object, attribute, region, lags, tol, n_az, atol, dip=0, pitch=0, user_azimuth=None, c_step=None, save_file=None) 🍋

Plot Azimuth VarioContour as Pie Chart. Angle of slice equals angular tolerance and slice radius equals lag distance.

Parameters:

Name Type Description Default
geo_object GeoRefObject

Geo-ref Object.

required
attribute str

Object attribute to compute variography on.

required
region Optional[str]

Object region or condition to select data from.

required
lags Vector

List of lags (in the same unit as the object, e.g. meters).

required
tol float

Lag tolerance (in percent).

required
n_az int

Number of azimuth to compute variogram.

required
atol float

Angular tolerance for variogram computation.

required
user_azimuth Optional[float]

Azimuth value to be displayed. Defaults to None.

None
c_step Optional[int]

Number of discretization steps of iso-values. Defaults to None.

None
save_file str

Filename of saved figure. Defaults to None.

None

Returns:

Type Description
None

Plot Azimuth variocontour.

vario_contour_dip(geo_object, attribute, region, lags, tol, azimuth, n_dip, atol, user_dip=None, c_step=None, save_file=None) 🍋

Plot VarioContour for a given azimuth as a semi Pie Chart. Angle of slice equals angular tolerance and slice radius equals lag distance.

Parameters:

Name Type Description Default
geo_object GeoRefObject

Geo-ref Object.

required
attribute str

Object attribute to compute variography on.

required
region Optional[str]

Object region or condition to select data from.

required
lags Vector

List of lags (in the same unit as the object, e.g. meters).

required
tol float

Lag tolerance (in percent).

required
azimuth float

Azimuth value along which dip is searched.

required
n_dip int

Number of dip to compute variogram.

required
atol float

Angular tolerance for variogram computation.

required
user_dip Optional[float]

Dip value to be displayed. Defaults to None.

None
c_step Optional[int]

Number of discretization steps of iso-values. Defaults to None.

None
save_file str

Filename of saved figure. Defaults to None.

None

Returns:

Type Description
None

2D plot of dip variomap along a given azimuth.

vario_contour_pitch(geo_object, attribute, region, lags, tol, azimuth, dip, n_pitch, atol, user_pitch=None, c_step=None, save_file=None) 🍋

Plot VarioContour for given azimuth and pitch as a semi Pie Chart. Angle of slice equals angular tolerance and slice radius equals lag distance.

Parameters:

Name Type Description Default
geo_object GeoRefObject

Geo-ref Object.

required
attribute str

Object attribute to compute variography on.

required
region Optional[str]

Object region or condition to select data from.

required
lags Vector

List of lags (in the same unit as the object, e.g. meters).

required
tol float

Lag tolerance (in percent).

required
azimuth float

Azimuth along which pitch is searched.

required
dip float

Dip along which pitch is searched.

required
n_pitch int

Number of dip to compute variogram.

required
atol float

Angular tolerance for variogram computation.

required
user_pitch Optional[float]

Pitch value to be displayed. Defaults to None.

None
c_step Optional[int]

Number of discretization steps of iso-values. Defaults to None.

None
save_file str

Filename of saved figure. Defaults to None.

None

Returns:

Type Description
None

2D plot of pitch variomap along given azimuth and dip.

vario_map(geo_object, attribute, region, lags, tol, n_az, atol, dip=0, pitch=0, user_azimuth=None) 🍋

Plot Azimuth VarioMap as Pie Chart. Angle of slice equals angular tolerance and slice radius equals lag distance.

Parameters:

Name Type Description Default
geo_object GeoRefObject

Geo-ref Object.

required
attribute str

Object attribute to compute variography on.

required
region Optional[str]

Object region or condition to select data from.

required
lags Vector

List of lags (in the same unit as the object, e.g. meters).

required
tol float

Lag tolerance (in percent).

required
n_az int

Number of azimuth to compute variogram.

required
atol float

Angular tolerance for variogram computation.

required
dip float

Dip value along which dip is searched.

0
pitch float

Pitch value along which dip is searched.

0
user_azimuth Optional[float]

Azimuth value to be displayed. Defaults to None.

None

Returns:

Type Description
Figure

Plot Azimuth variomap.

vario_map_summary(geo_object, attribute, region, lags, tol, azimuth, dip, pitch, n_step, atol, c_step=None, save_file=None) 🍋

Plot VarioContour for a given azimuth, dip and pitch as Pie Charts. Angle of slice equals angular tolerance and slice radius equals lag distance.

Parameters:

Name Type Description Default
geo_object GeoRefObject

Geo-ref Object.

required
attribute str

Object attribute to compute variography on.

required
region Optional[str]

Object region or condition to select data from.

required
lags Vector

List of lags (in the same unit as the object, e.g. meters).

required
tol float

Lag tolerance (in percent).

required
azimuth float

Azimuth value along which dip is searched.

required
dip float

Dip value along which dip is searched.

required
pitch float

Pitch value along which dip is searched.

required
n_step int

Number of step to compute variogram.

required
atol float

Angular tolerance for variogram computation.

required
c_step Optional[int]

Number of discretization steps of iso-values. Defaults to None.

None
save_file str

Filename of saved figure. Defaults to None.

None

Returns:

Type Description
None

Summary of 3 2D subplots variomaps of azimuth, dip and pitch.