xieandleo2004

Class summary

XieAndLeo2004(qu, qp, H, Hw, kv0, mvl, e00, Gs) Large strain analytical one-dimensional consolidation

Function summary

xie_and_leo_2004_figure_4([ax]) Reproduce figure 4 from article by Xie and Leo 2004
xie_and_leo_2004_figure_5([ax]) Reproduce fig 5 from article by Xie and Leo 2004
xie_and_leo_2004_figure_6([ax]) Reproduce fig 6 from article by Xie and Leo 2004

Module listing

Xie and Leo (2004) “Analytical solutions of one-dimensional large strain consolidation of saturated and homogeneous clays”.

class geotecha.consolidation.xieandleo2004.XieAndLeo2004(qu, qp, H, Hw, kv0, mvl, e00, Gs, gamw=10, drn=0, nterms=100)[source]

Bases: object

Large strain analytical one-dimensional consolidation

Implementation of Xie and Leo (2004)[R7edef33a7c4d-1]_.

Features:

  • Single layer, vertical flow.
  • Large strain.
  • Instant applied load uniform with depth
  • Vert permeability kv = (1+e)**2/(1+e0)**2
  • Large strain volume compressibility is constant over time
Parameters:
qp : float

Existing load.

qp : float

Instant applied load.

H : float

Initial thickness of clay layer.

Hw : float

Height of water surface above initial surface.

kv0 : float

Coefficient of vertical permeability.

mvl : float

Coefficient of volume compressibility.

e00 : float

Initial void ratio at surface.

Gs : float

Specific gravity of solids.

gamw : float, optional

Unit weight of water. Default gamw=10

drn : [0,1]

Drainage condition. drn=0 is PTPB, drn=1 is PTIB, default=0.

nterms : int, optional

Number of summation terms. Default nterms=100.

See also

xie_and_leo2004_figure_4
example of use.
xie_and_leo2004_figure_5
example of use.
xie_and_leo2004_figure_6
example of use.

Notes

Basically initialize the XieAndLeo2004 object, then use individual methods of the data to extract data at particualr depths and times.

The most common error is if input data is not numpy arrays.

References

[1]Xie, K. H., and C. J. Leo. “Analytical Solutions of One-Dimensional Large Strain Consolidation of Saturated and Homogeneous Clays”. Computers and Geotechnics 31, no. 4 (June 2004): 301-14. doi:10.1016/j.compgeo.2004.02.006.

Methods

Tv(t) Calculate vertical time factor
Up_PTIB(t) Average degree of consolidation from p.press for PTIB drainage
Up_PTPB(t) Average degree of consolidation from p.press for PTPB drainage
Us_PTIB(t) Average degree of consolidation from settlement for PTIB drainage
Us_PTPB(t) Average degree of consolidation from settlement for PTPB drainage
e0(a) Initial void ratio at depth
e_PTIB(a, t) Void ration for PTIB drainage
e_PTPB(a, t) Void ration for PTPB drainage
effective_stress_PTIB(a, t) Effective stress for PTIB drainage
effective_stress_PTPB(a, t) Effective stress for PTPB drainage
efinal(a) Final void ration ratio at depth
initial_effective_stress(a) Initial effective stress
plot_all([a, t, figsize]) produce generic plots of all analysis variables
settlement_PTIB(a, t) Settlement for PTIB drainage
settlement_PTPB(a, t) Settlement for PTPB drainage
settlement_final() Final settlement of clay layer
t_from_Us_PTIB(Us) Back calc t from specified settlement doc for PTIB
t_from_Us_PTPB(Us) Back calc t from specified settlement doc for PTPB
total_pore_pressure_PTIB(a, t) Total pore pressure for PTIB drainage
total_pore_pressure_PTPB(a, t) Total pore pressure for PTPB drainage
total_stress_PTIB(a, t) Total stress for PTIB drainage
total_stress_PTPB(a, t) Total stress for PTPB drainage
u_PTIB(a, t) Pore pressure for PTIB drainage
u_PTPB(a, t) Pore pressure for PTPB drainage
vs_PTIB(a, t) Velocity of soil particles for PTIB drainage
vs_PTPB(a, t) Velocity of soil particles for PTPB drainage
vw_PTIB(a, t) Velocity of fluid for PTIB drainage
vw_PTPB(a, t) Velocity of fluid for PTPB drainage
xi_PTIB(a, t) Convectove cordinate from Lagrange coordinate
xi_PTPB(a, t) Convectove cordinate from lagrange coordinate
Tv(t)[source]

Calculate vertical time factor

Parameters:
t : array-like of float

Time(s).
Returns:
Tv : float

Time factor
Up_PTIB(t)[source]

Average degree of consolidation from p.press for PTIB drainage

Parameters:
t : array like of float

Time coord.
Returns:
Up : array of float of size len(t)

Pore pressure average degree of consolidation at time t/
Up_PTPB(t)[source]

Average degree of consolidation from p.press for PTPB drainage

Parameters:
t : array like of float

Time coord.
Returns:
Up : array of float of size len(t)

Pore pressure average degree of consolidation at time t.
Us_PTIB(t)[source]

Average degree of consolidation from settlement for PTIB drainage

Parameters:
t : array like of float

Time coord.
Returns:
Us : array of float of size len(t)

Settlement degree of consolidation at time t
Us_PTPB(t)[source]

Average degree of consolidation from settlement for PTPB drainage

Parameters:
t : array like of float

Time coord.
Returns:
Us : array of float of size len(t)

Settlement degree of consolidation at time t.
e0(a)[source]

Initial void ratio at depth

Parameters:
a : array like of float

Depth coord.
Returns:
e0 : float

Initial void ratio at depth a.
e_PTIB(a, t)[source]

Void ration for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
e : float of size (len(a), len(t))

Void ration at depth a, time t.
e_PTPB(a, t)[source]

Void ration for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
e : float of size (len(a), len(t))

Void ration at depth a, time t.
effective_stress_PTIB(a, t)[source]

Effective stress for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
effective_stress : float of size (len(a), len(t))

Effective stress at depth a, time t.
effective_stress_PTPB(a, t)[source]

Effective stress for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
effective_stress : float of size (len(a), len(t))

Effective stress at depth a, time t.
efinal(a)[source]

Final void ration ratio at depth

Parameters:
a : array like of float

Depth coord.
Returns:
efinal : float

Final void ratio at depth a.
initial_effective_stress(a)[source]

Initial effective stress

Parameters:
a : array like of float

Depth coord
Returns:
eff0 : float

Initial effective stress at depth a
plot_all(a=None, t=None, figsize=(15, 10))[source]

produce generic plots of all analysis variables

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.

figsize : 2-element tuple, optional

Width and height of figure in inches. Default figsize=(15, 10)
Returns:
fig : matplotlib.Figure

figure with all properties.
settlement_PTIB(a, t)[source]

Settlement for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
settlement : float of size (len(a), len(t))

Settlement at depth a, time t.
settlement_PTPB(a, t)[source]

Settlement for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
settlement : float of size (len(a), len(t))

Settlement at depth a, time t.
settlement_final()[source]

Final settlement of clay layer

t_from_Us_PTIB(Us)[source]

Back calc t from specified settlement doc for PTIB

Parameters:
Us : 1d array

Values of degree of consolidation by settlement to calc the t at.
Returns:
t : 1d array

Times coresponding to Us.
t_from_Us_PTPB(Us)[source]

Back calc t from specified settlement doc for PTPB

Parameters:
Us : 1d array

Values of degree of consolidation by settlement to calc the t at.
Returns:
t : 1d array

Times coresponding to Us.
total_pore_pressure_PTIB(a, t)[source]

Total pore pressure for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
total_pore_pressure : float of size (len(a), len(t))

Total pore pressure at depth a, time t.
total_pore_pressure_PTPB(a, t)[source]

Total pore pressure for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
total_pore_pressure : float of size (len(a), len(t))

Total pore pressure at depth a, time t.
total_stress_PTIB(a, t)[source]

Total stress for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
total_stress : float of size (len(a), len(t))

Total stress at depth a, time t.
total_stress_PTPB(a, t)[source]

Total stress for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
total_stress : float of size (len(a), len(t))

Total stress at depth a, time t.
u_PTIB(a, t)[source]

Pore pressure for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
u : float of size (len(a), len(t))

Excess pore pressure at depth a, time t.
u_PTPB(a, t)[source]

Pore pressure for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
u : float of size (len(a), len(t))

Excess pore pressure at depth a, time t.
vs_PTIB(a, t)[source]

Velocity of soil particles for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
vs : float of size (len(a), len(t))

Velocity of soil particles at depth a, time t.
vs_PTPB(a, t)[source]

Velocity of soil particles for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
vs : float of size (len(a), len(t))

Velocity of soil particles at depth a, time t.
vw_PTIB(a, t)[source]

Velocity of fluid for PTIB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
vw : float of size (len(a), len(t))

Velocity of fluid at depth a, time t.
vw_PTPB(a, t)[source]

Velocity of fluid for PTPB drainage

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
vw : float of size (len(a), len(t))

Velocity of fluid at depth a, time t.
xi_PTIB(a, t)[source]

Convectove cordinate from Lagrange coordinate

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
xi : float of size (len(a), len(t))

Convective coordinate at depth a, time t.
xi_PTPB(a, t)[source]

Convectove cordinate from lagrange coordinate

Parameters:
a : array like of float

Depth coord.

t : array like of float

Time coord.
Returns:
xi : float of size (len(a), len(t))

Convective coordinate at depth a, time t.
geotecha.consolidation.xieandleo2004.xie_and_leo_2004_figure_4(ax=None)[source]

Reproduce figure 4 from article by Xie and Leo 2004

Pore pressure vs xi plot for various degrees of consolidation PTIB

Parameters:
ax : matplotlib.Axes

Axes object to plot on. If ax=None. plt.gca() will be used.
geotecha.consolidation.xieandleo2004.xie_and_leo_2004_figure_5(ax=None)[source]

Reproduce fig 5 from article by Xie and Leo 2004

Pore pressure vs xi plot for various degrees of consolidation PTPB.

Parameters:
ax : matplotlib.Axes

Axes object to plot on. If ax=None. plt.gca() will be used.
geotecha.consolidation.xieandleo2004.xie_and_leo_2004_figure_6(ax=None)[source]

Reproduce fig 6 from article by Xie and Leo 2004

Settlement vs time and degree of consolidation vs time.

Parameters:
ax : matplotlib.Axes

Axes object to plot on. If ax=None. plt.gca() will be used.