Material properties

Material properties can be assessed through the Material class in PyGeoStudio. To select a material nammed Toe drain for example:

#geofile is a GeoStudioFile instance
geofile.showMaterials()
mat = geofile.getMaterialByName("Toe drain") #get material nammed "Toe drain" as a Material instance

This will return an instance of the Material class which handle all the material properties. List of available properties are described in the subsection below.

Material

Properties can be assessed with the [] operator and with the name of the property, for example:

seepmodel = mat["SeepModel"] #store seep model (SatOnly or SatUnsat) in a variable
mat["SeepModel"] = "SatUnsat" #change seep model to SatUnsat

List of properties:

class PyGeoStudio.Material(prop=None)
Parameters:

  • ID (int) – ID of the material in GeoStudio file. Do not change this property unless you know what your are doing

  • Name (str) – Name of the material in GeoStudio study.

  • Color (PyGeoStudio.Color) – RGB color (0 to 255) of the material in GeoStudio study.

  • SeepModel (str) – Hydraulic model in SEEP (“SatOnly” for saturated model only or “SatUnsat” for variably saturated model).

  • SlopeModel (str) – Geomechanical model in SLOPE (MohrCoulomb, …)

  • StressModel (str) – Geomechanical model in SIGMA (LinearElastric, …)

  • Hydraulic (MaterialHydraulicFunction object) – Hydraulic properties of the material. This is an instance of MaterialHydraulicFunction class.

  • StressStrain (MaterialStressStrain object) – Geotechnical properties of the material. This is an instance of MaterialStressStrain class.

  • Thermal (MaterialThermalFunction object) – Thermal properties of the material. This is an instance of MaterialThermalFunction class.

Hydraulic Properties

Accessed through the Hydraulic property of the Material class:

hydraulic_props = mat["Hydraulic"]

Example using and changing the saturated hydraulic conductivity:

KSat = hydraulic_props["KSat"] #get
geotech_props["KSat"] = 1e-6   #set

List of properties:

class PyGeoStudio.Material.MaterialHydraulicFunction(prop=None)
Parameters:

  • KSat (float) – Saturated hydraulic conductivity of the material.

  • VolWC (float) – Saturated volumic water content

  • Beta (float) – Compressibility

  • KFn (PyGeoStudio.Function objet) – Hydraulic conductivity function

  • VolWCFn (PyGeoStudio.Function objet) – Water retention curve function

  • KFnNum (int) – Index of hydraulic conductivity function in GeoStudio file (for SatUnsat material), do not change.

  • VolWCFnNum (int) – Index of water retention curve in GeoStudio file (for SatUnsat material), do not change.

Geotechnical properties

Accessed through the StressStrain property of the Material class:

geotech_props = mat["StressStrain"]

Example using and changing the unit weight:

mat_unit_weight = geotech_props["UnitWeight"] #get
geotech_props["UnitWeight"] = 20.3 #set

List of properties:

class PyGeoStudio.Material.MaterialStressStrain(prop=None)
Parameters:

  • ResidualWCPercent (float) –

  • GeologicalStrengthIndex (float) –

  • ResponseType (str) –

  • UnitWeight (float) –

  • CohesionPrime (float) –

  • PhiPrime (float) –

  • Rf (float) –

  • OCRatio (float) –

  • ConsolLambda (float) –

  • OCKappa (float) –

  • InitVoidRatio (float) –

  • YieldSurfaceShape (float) –

  • LimitOfAnisotropy (float) –

  • YoungsPrimeModulus (float) – Young modulus in SIGMA analysis

  • EffectivePoissonsRatio (float) – Poisson ratio in SIGMA analysis

  • JointEffectiveCohesion (float) –

  • IntactRockParam (float) –