Phase relations¶
- groundhog.siteinvestigation.classification.phaserelations.bulkunitweight(saturation, voidratio, specific_gravity=2.65, unitweight_water=10.0, **kwargs)[source]¶
Calculates the bulk unit weight from specific gravity, void ratio and saturation
- Parameters:
saturation – Saturation of the sample, ratio of volume of water to volume of voids (\(S\)) [\(-\)] - Suggested range: 0.0 <= saturation <= 1.0
voidratio – Void ratio, ratio of volume of voids to volume of solids (\(e\)) [\(-\)] - Suggested range: 0.0 <= voidratio <= 4.0
specific_gravity – Specific gravity of solid particles (\(G_s\)) [\(-\)] - Suggested range: 1.0 <= specific_gravity <= 3.0 (optional, default= 2.65)
unitweight_water – Unit weight of water (\(\gamma_w\)) [\(kN/m3\)] - Suggested range: 9.0 <= unitweight_water <= 11.0 (optional, default= 10.0)
\[\gamma = \frac{W}{V} = \left( \frac{G_s + S \cdot e}{1+e} \right) \cdot \gamma_w\]- Returns:
Dictionary with the following keys:
’bulk unit weight [kN/m3]’: Bulk unit weight of the material (\(\gamma\)) [\(kN/m3\)]
’effective unit weight [kN/m3]’: Effective unit weight of the material (\(\gamma^{\prime}\)) [\(kN/m3\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.bulkunitweight_dryunitweight(dryunitweight, watercontent, unitweight_water=10.0, **kwargs)[source]¶
Calculates the bulk unit weight from the dry unit weight and the water content
- Parameters:
dryunitweight – Dry unit weight, ratio of weight of solids to total volume (\(\gamma_d\)) [\(kN/m3\)] - Suggested range: 1.0 <= dryunitweight <= 15.0
watercontent – Water content, ratio of weight of water to weight of solids (\(w\)) [\(-\)] - Suggested range: 0.0 <= watercontent <= 4.0
unitweight_water – Unit weight of water (\(\gamma_w\)) [\(kN/m3\)] - Suggested range: 9.0 <= unitweight_water <= 11.0 (optional, default= 10.0)
\[\gamma = (1+w) \cdot \gamma_d\]- Returns:
Dictionary with the following keys:
’bulk unit weight [kN/m3]’: Bulk unit weight (\(\gamma\)) [\(kN/m3\)]
’effective unit weight [kN/m3]’: Effective unit weight (\(\gamma^{\prime}\)) [\(kN/m3\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.dryunitweight_watercontent(watercontent, bulkunitweight, **kwargs)[source]¶
Calculates the dry unit weight of the sample from the water content and the bulk unit weight
- Parameters:
watercontent – Water content of the sample, ratio of weight of water to weight of solids (\(w\)) [\(-\)] - Suggested range: 0.0 <= watercontent <= 4.0
bulkunitweight – Bulk unit weight of the sample (\(\gamma\)) [\(kN/m3\)] - Suggested range: 10.0 <= bulkunitweight <= 25.0
\[\gamma_d = \frac{W_s}{V} = \left( \frac{G_s}{1+e} \right) \cdot \gamma_w = \frac{\gamma}{1 + w}\]- Returns:
Dictionary with the following keys:
’dry unit weight [kN/m3]’: Dry unit weight, ratio of weight of solids to total volume (\(\gamma_d\)) [\(kN/m3\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.porosity_voidratio(voidratio, **kwargs)[source]¶
Calculates the porosity of sample from the void ratio
- Parameters:
voidratio – Void ratio defined as the ratio of volume of voids to volume of solids (\(e\)) [\(-\)] - Suggested range: 0.0 <= voidratio <= 5.0
\[n = \frac{e}{e+1}\]- Returns:
Dictionary with the following keys:
’porosity [-]’: Porosity defined as the ratio of the volume of voids to the total volume (\(n\)) [\(-\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.relative_density(void_ratio, e_min, e_max, **kwargs)[source]¶
Calculates the relative density for a cohesionless sample from the measured void ratio, comparing it to the void ratio at minimum and maximum density.
- Parameters:
void_ratio – Void ratio of the sample (\(e\)) [\(-\)] - Suggested range: 0.0 <= void_ratio <= 5.0
e_min – Void ratio at the minimum density (\(e_{min}\)) [\(-\)] - Suggested range: 0.0 <= e_min <= 5.0
e_max – Void ratio at the maximum density (\(e_{max}\)) [\(-\)] - Suggested range: 0.0 <= e_max <= 5.0
\[D_r = \frac{e - e_{min}}{e_{max} - e_{min}}\]- Returns:
Dictionary with the following keys:
’Dr [-]’: Relative density (\(D_r\)) [\(-\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.saturation_watercontent(water_content, voidratio, specific_gravity=2.65, **kwargs)[source]¶
Calculates the saturation of a sample from the water content, the specific gravity and the void ratio
- Parameters:
water_content – Water content of the soil defined as the ratio of weight of water to weight of solids (\(w\)) [\(-\)] - Suggested range: 0.0 <= water_content <= 4.0
voidratio – Ratio of volume of voids to volume of solids (\(e\)) [\(-\)] - Suggested range: 0.0 <= voidratio <= 4.0
specific_gravity – Specific gravity of the soil grains (\(G_s\)) [\(-\)] - Suggested range: 1.0 <= specific_gravity <= 3.0 (optional, default= 2.65)
\[S = \frac{V_{water}}{V_{voids}} = \frac{w \cdot G_s}{e}\]- Returns:
Dictionary with the following keys:
’saturation [-]’: Saturation of the sample defined as the ratio of volume of water to volume of voids (\(S\)) [\(-\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.unitweight_watercontent_saturated(water_content, specific_gravity=2.65, gamma_w=10.0, **kwargs)[source]¶
Calculates the bulk unit weight from water content for a saturated soil. A specific gravity needs to be assumed or derived from pycnometer test results.
- Parameters:
water_content – Water content of the sample (\(w\)) [\(-\)] - Suggested range: 0.0 <= water_content <= 2.0
specific_gravity – Specific gravity of the soil (\(G_s\)) [\(-\)] - Suggested range: 2.5 <= specific_gravity <= 2.8 (optional, default= 2.65)
gamma_w – Unit weight of water (\(\gamma_w\)) [\(kN/m3\)] - Suggested range: 9.5 <= gamma_w <= 10.5 (optional, default= 10.0)
\[ \begin{align}\begin{aligned}S \cdot e = w \cdot G_s\\\gamma = \left( \frac{G_s + S \cdot e}{1 + e} \right) \cdot \gamma_w\\\gamma = \left( \frac{G_s \cdot (1 + w)}{1 + w \cdot G_s} \right) \cdot \gamma_w\end{aligned}\end{align} \]- Returns:
Dictionary with the following keys:
’gamma [kN/m3]’: Bulk unit weight of the saturated sample (\(\gamma\)) [\(kN/m3\)]
Reference - UGent In-house practice
- groundhog.siteinvestigation.classification.phaserelations.voidratio_bulkunitweight(bulkunitweight, saturation=1.0, specific_gravity=2.65, unitweight_water=10.0, **kwargs)[source]¶
Calculates the void ratio from the bulk unit weight for a soil with varying saturation.
Since unit weight is generally better known or measured than void ratio, this conversion can be useful to derive the in-situ void ratio in a soil profile.
The default behaviour of this function assumes saturated soil but the saturation can be changed for dry or partially saturated soil.
The water content is also returned.
- Parameters:
bulkunitweight – The bulk unit weight of the soil (ratio of weight of water and solids to volume) (\(\gamma\)) [\(kN/m3\)] - Suggested range: 10.0 <= bulkunitweight <= 25.0
saturation – Saturation of the soil as a number between 0 (dry) and fully saturated (1) (\(S\)) [\(-\)] - Suggested range: 0.0 <= saturation <= 1.0 (optional, default= 1.0)
specific_gravity – Specific gravity or the ratio of the weight of soil solids to the weight of an equal volume of water (\(G_s\)) [\(-\)] - Suggested range: 2.4 <= specific_gravity <= 2.9 (optional, default= 2.65)
unitweight_water – Unit weight of water (\(\gamma_w\)) [\(kN/m3\)] - Suggested range: 9.0 <= unitweight_water <= 11.0 (optional, default= 10.0)
\[ \begin{align}\begin{aligned}\gamma = \left( \frac{G_s + S e}{1 + e} \right) \gamma_w\\\implies e = \frac{\gamma_w G_s - \gamma}{\gamma - S \gamma_w}\\w = \frac{S e}{G_s}\end{aligned}\end{align} \]- Returns:
Dictionary with the following keys:
’e [-]’: Void ratio of the soil (\(e\)) [\(-\)]
’w [-]’: Water content of the soil (\(w\)) [\(-\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering
- groundhog.siteinvestigation.classification.phaserelations.voidratio_porosity(porosity, **kwargs)[source]¶
Converts a void ratio into a porosity
- Parameters:
porosity – Porosity of the sample defined as the ratio of volume of voids to total volume (\(n\)) [\(-\)] - Suggested range: 0.0 <= porosity <= 1.0
\[ \begin{align}\begin{aligned}e = \frac{V_{voids}}{V_{solids}}\\n = \frac{V_{voids}}{V_{total}}\\e = \frac{n}{1-n}\end{aligned}\end{align} \]- Returns:
Dictionary with the following keys:
’voidratio [-]’: Void ratio defined as the ratio of volume of voids to volume of solids (\(e\)) [\(-\)]
Reference - Budhu (2011). Soil mechanics and foundation engineering