Questions about this article, topic, or product? Click here. 

Material Property changes for Python scripting

Application PLAXIS 2D, PLAXIS 3D
Version PLAXIS 2D CONNECT Edition V22
PLAXIS 3D CONNECT Edition V22
PLAXIS 2D 2023
PLAXIS 3D 2023
Date created May 25, 2022
Date modified Aug 29, 2023

This page gives an overview of Material property changes between PLAXIS CONNECT Edition V21.01 to PLAXIS CONNECT Edition V22.00, PLAXIS CONNECT Edition V22.02, PLAXIS 2023.1 and PLAXIS 2023.2.

The Material object data structure has been updated to be more flexible for future developments.
Also, the naming convention has been made more consistent: any property name now follows CamelCase formatting, except where the first "word" and its casing represents a geotechnical meaning. Examples:

  • Soil model will be written as .SoilModel
  • initial void ratio einit will be written as .eInit
  • Mohr-Coulomb's stiffness Eref will be written as .ERef
  • Hardening Soil's oedometer stiffness Eoedref will be written as .EOedRef
  • Hardening Soil's stress dependency power m will be written as .PowerM

This page will highlight in green the changes to the most used parameters. For a full list of current .Property names, please check the Objects reference (available via the PLAXIS Help menu) or use the echo command targeting the material object.

Latest changes

With the release of PLAXIS 2023.2 the following items have changed:

Last update: Aug 29, 2023

Quick list

Soil - General

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.ninit .nInit .nInit .nInit .nInit
.einit .eInit .eInit .eInit .eInit

Soil - Groundwater

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.perm_primary_horizontal_axis .PermHorizontalPrimary .PermHorizontalPrimary .PermHorizontalPrimary .PermHorizontalPrimary
.perm_vertical_axis .PermVertical .PermVertical .PermVertical .PermVertical
.cK .Ck .cK .cK .cK

Soil - Interface

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.InterfaceStrength .InterfaceStrengthDetermination .InterfaceStrengthDetermination .InterfaceStrengthDetermination .InterfaceStrengthDetermination This was an implicit setting. It was made explicit in V22.00.
.Rinter .Rinter .Rinter .Rinter .Rinter It is required to first set .InterfaceStrengthDetermination to "Manual" or "Manual with residual strength"
.ConsiderGapClosure .GapClosure .GapClosure .GapClosure .GapClosure
.InterfaceStiffness .InterfaceStiffnessDetermination .InterfaceStiffnessDetermination .InterfaceStiffnessDetermination .InterfaceStiffnessDetermination Naming of options has been changed in V22.00
.InterfaceKn .knInter .knInter .knInter .knInter When Interface stiffness is set to Direct
.InterfaceKs .ksInter .ksInter .ksInter .ksInter When Interface stiffness is set to Direct
.EoedRef .EoedInter .EoedInter .EoedInter .EoedInter Used for UDSM and Modified Cam-Clay
.cref .CInter .CInter .CInter .CInter Used for UDSM and Modified Cam-Clay
.phi .PhiInter .PhiInter .PhiInter .PhiInter Used for UDSM and Modified Cam-Clay
.psi .PsiInter .PsiInter .PsiInter .PsiInter Used for UDSM and Modified Cam-Clay

Soil - Initial stresses

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
- .K0Determination .K0Determination .K0Determination .K0Determination This was an implicit setting. It was made explicit in V22.00.
.K0Primary .K0Primary .K0Primary .K0Primary .K0Primary It is required to first set .K0Determination to "Manual"
.K0Secondary .K0Secondary .K0Secondary .K0Secondary .K0Secondary It is required to first set .K0Determination to "Manual"
.K0PrimaryIsK0Secondary .K0PrimaryIsK0Secondary .K0PrimaryIsK0Secondary .K0PrimaryIsK0Secondary .K0PrimaryIsK0Secondary It is required to first set .K0Determination to "Manual"

Soil - Mohr-Coulomb

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.ERef .Eref .Eref .Eref .Eref
.Gref .GRef .GRef .GRef .GRef
.Eoed .EOed .EOed .EOed .EOed
.cref .cRef .cRef .cRef .cRef
.Einc .EInc .EInc .EInc .EInc
.verticalref .verticalRef .verticalRef .VerticalRef .VerticalRef Following the CamelCase formatting
- .EInc .EInc .EInc .EInc New since V22.00: in favor of Ginc
.Ginc x x x x Direct input of Einc in stead of Ginc
.cinc .cInc .cInc .cInc .cInc

Soil - Hardening Soil/HS Small

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.Gref x x x x Deprecated. Instead use .EURRef
.E50ref .E50Ref .E50Ref .E50Ref .E50Ref
.EoedRef .EOedRef .EOedRef .EOedRef .EOedRef
.EurRef .EURRef .EURRef .EURRef .EURRef
.powerm .PowerM .PowerM .PowerM .PowerM
.Pref .pRef .pRef .pRef .pRef
.Rf .RF .RF .RF .RF
.nu .nuUR .nuUR .nuUR .nuUR
.K0nc .K0NC .K0NC .K0NC .K0NC
.cref .cRef .cRef .cRef .cRef
.verticalref .verticalRef .verticalRef .VerticalRef .VerticalRef Following the CamelCase formatting
.cinc .cInc .cInc .cInc .cInc
.G0ref .G0Ref .G0Ref .G0Ref .G0Ref * only for HS small
.Cc .CC .CC .CC .CC Alternative parameters for stiffness
.Cs .CS .CS .CS .CS Alternative parameters for stiffness

Soil - Soft Soil/Soft Soil Creep

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MuModified .muModified .muModified .muModified .muModified
.Cc .CC .CC .CC .CC Alternative parameters for stiffness
.Cs .CS .CS .CS .CS Alternative parameters for stiffness
.Ca .CAlpha .CAlpha .CAlpha .CAlpha Alternative parameters for stiffness
.nu .nuUR .nuUR .nuUR .nuUR
.cref .cRef .cRef .cRef .cRef
.K0nc .K0NC .K0NC .K0NC .K0NC

Soil - NGI-ADP

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.UnloadingShearStiffness .GURsUARatio .GURsUARatio .GURsUARatio .GURsUARatio
.nu .nuU .nuU .nuU .nuU
.ReferenceShearStrength .sUARef .sUARef .sUARef .sUARef
.IncreaseOfShearStrengthWithVerticalRef .sUAInc .sUAInc .sUAInc .sUAInc
.RelativeTriaxialCompressiveShearStrength .sUCTxsUARatio .sUCTxsUARatio .sUCTxsUARatio .sUCTxsUARatio
.RelativePassiveStrength .sUPsUARatio .sUPsUARatio .sUPsUARatio .sUPsUARatio
.RelativeDirectShearStrength .sUDSSsUARatio .sUDSSsUARatio .sUDSSsUARatio .sUDSSsUARatio
.AxialFailureStrainTriaxialCompression .gammaFC .gammaFC .gammaFC .gammaFC
.AxialFailureStrainTriaxialExtension .gammaFE .gammaFE .gammaFE .gammaFE
.ShearFailureStrainDirectSimpleShear .gammaFDSS .gammaFDSS .gammaFDSS .gammaFDSS
.InitialMobilization .tau0sUARatio .tau0sUARatio .tau0sUARatio .tau0sUARatio
.verticalinc - .VerticalInclination .VerticalInclination .VerticalInclination

Rock - Hoek-Brown

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.Eref .Erm .Erm .Erm .Erm
.Gref .GRef .GRef .GRef .GRef New in V22.00: alternative input to Young's modulus
.UnconfinedCompressiveStrength .AbsSigmaCI .AbsSigmaCI .AbsSigmaCI .AbsSigmaCI
.HoekBrownParameter .mi .mi .mi .mi
.GeologicalStrengthIndex .GSI .GSI .GSI .GSI
.DisturbanceFactor .Disturbance .Disturbance .Disturbance .Disturbance
.mb .mb .mb .mb .mb Hoek-Brown mb
.s .s .s .s .s Hoek-Brown s
.a .alpha .alpha .alpha .alpha Hoek-Brown a
.sigt .SigmaT .SigmaT .SigmaT .SigmaT Rock mass parameter
.sigc .SigmaC .SigmaC .SigmaC .SigmaC Rock mass parameter
.MaximumDilitationAngle .psiMax .psiMax .psiMax .psiMax
.MinorPrincipalStress .sigmaPsi .sigmaPsi .sigmaPsi .sigmaPsi

User Defined Soil Model

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.UserDLLName .DllFile .DllFile .DllFile .DllFile New in V22.00: property is enumeration. Use string representation when setting the value
.UserModel .ModelInDll .ModelInDll .ModelInDll .ModelInDll New in V22.00: property is enumeration. Use string representation when setting the value

Plates (2D)

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.IsIsotropic .Isotropic .Isotropic .Isotropic .Isotropic
.EA .EA1 .EA1 .EA1 .EA1
.nu .StructNu .StructNu .StructNu .StructNu
.d .D2d .d .d .d Thinkness of the plate
.w .W .w .w .w
.Np .Np1 .Np1 .Np1 .Np1
.Mp .MP .MP .MP .MP
.Gref x x x x Deprecated. Instead use .EA1
.ElastoplasticMKTable .MkappaDiagram .MkappaDiagram .MkappaDiagram .MkappaDiagram * only used when .MaterialType is set to Elastoplastic (M-kappa)

Plates (3D)

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.w .Gamma .Gamma .Gamma .Gamma
.IsIsotropic .Isotropic .Isotropic .Isotropic .Isotropic
.d .D3d .d .d .d Thinkness of the plate
.Nu12 .StructNu12 .StructNu12 .StructNu12 .StructNu12
.sigy11 .YieldStress11 .YieldStress11 .YieldStress11 .YieldStress11 * only used when .MaterialType is set to Elastoplastic
.sigy22 .YieldStress22 .YieldStress22 .YieldStress22 .YieldStress22 * only used when .MaterialType is set to Elastoplastic
.W11 .W11 .W11 .W11 .W11 * only used when .MaterialType is set to Elastoplastic
.W22 .W22 .W22 .W22 .W22 * only used when .MaterialType is set to Elastoplastic

Geogrids

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.IsIsotropic .Isotropic .Isotropic .Isotropic .Isotropic
.N1Eps1Table .N1eps1 .N1eps1 .N1eps1 .N1eps1 * only used when .MaterialType is set to Elastoplastic (N-eps)
.N2Eps2Table .N2eps2 .N2eps2 .N2eps2 .N2eps2 * only used when .MaterialType is set to Elastoplastic (N-eps) and anisotropic

Beams (3D)

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.w .Gamma .Gamma .Gamma .Gamma
.BeamType .CrossSectionType .CrossSectionType .CrossSectionType .CrossSectionType
.PredefinedBeamType .PredefinedCrossSectionType .PredefinedCrossSectionType .PredefinedCrossSectionType .PredefinedCrossSectionType
.Iyy .I3 .I3 .I3 .I3
.Izz .I2 .I2 .I2 .I2
.sigy .YieldStress .YieldStress .YieldStress .YieldStress * only used when .MaterialType is set to Elastoplastic

Embedded beams

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
embeddedbeamrow() embeddedbeam() embeddedbeam() embeddedbeam() embeddedbeam() Removed the word row from the command. PLAXIS 2D only
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.Lspacing .LSpacing .LSpacing .LSpacing .LSpacing PLAXIS 2D only
.BeamType .CrossSectionType .CrossSectionType .CrossSectionType .CrossSectionType
.PredefinedBeamType .PredefinedCrossSectionType .PredefinedCrossSectionType .PredefinedCrossSectionType .PredefinedCrossSectionType
.w .Gamma .Gamma .Gamma .Gamma
.Iyy .I .I .I .I PLAXIS 2D only
.Iyy .I3 .I3 .I3 .I3 PLAXIS 3D only
.Izz .I2 .I2 .I2 .I2 PLAXIS 3D only
.SkinResistance .AxialSkinResistance .AxialSkinResistance .AxialSkinResistance .AxialSkinResistance
.Tstart .TSkinStartMax .TSkinStartMax .TSkinStartMax .TSkinStartMax
.Tend .TSkinEndMax .TSkinEndMax .TSkinEndMax .TSkinEndMax
.SkinResistanceTable .MultiLinearAxialSkinResistance .MultiLinearAxialSkinResistance .MultiLinearAxialSkinResistance .MultiLinearAxialSkinResistance * only used when .AxialSkinResistance is set to Mulit-linear
.Tmax .TMax .TMax .TMax .TMax * only used when .AxialSkinResistance is set to Layer dependent
.TLateralStart .TLatStartMax .TLatStartMax .TLatStartMax .TLatStartMax
.TLateralEnd .TLatEndMax .TLatEndMax .TLatEndMax .TLatEndMax
.Fmax .FMax .FMax .FMax .FMax
.DefaultStiffnessFactors .DefaultValues .DefaultValues .DefaultValues .DefaultValues PLAXIS 2D only
.AxialSkinStiffnessFactor .AxialStiffnessFactor .AxialStiffnessFactor .AxialStiffnessFactor .AxialStiffnessFactor PLAXIS 2D only
.LateralSkinStiffnessFactor .LateralStiffnessFactor .LateralStiffnessFactor .LateralStiffnessFactor .LateralStiffnessFactor PLAXIS 2D only
.PileBaseStiffnessFactor .BaseStiffnessFactor .BaseStiffnessFactor .BaseStiffnessFactor .BaseStiffnessFactor PLAXIS 2D only

Cables

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
- - cablebolt() cablebolt() cable() Removed the word bolt from the command. PLAXIS 2D only
- - cableboltmat() cableboltmat() cablemat() Removed the word bolt from the command. PLAXIS 2D only

Anchors

V21.01 V22.00 V22.02 2023.1 2023.2 Comment
.MaterialName .Identification .Identification .Identification .Identification
.Elasticity .MaterialType .MaterialType .MaterialType .MaterialType Material Type needs to be set explicitly
.Lspacing .LSpacing .LSpacing .LSpacing .LSpacing * only for PLAXIS 2D
.FMaxTens .FMaxTens .FMaxTens .FMaxTens .FMaxTens * only used when .MaterialType is set to Elastoplastic
.FMaxComp .FMaxComp .FMaxComp .FMaxComp .FMaxComp * only used when .MaterialType is set to Elastoplastic
.FResidualTens .FResTens .FResTens .FResTens .FResTens * only used when .MaterialType is set to Elastoplastic with residual strength
.FResidualComp .FResComp .FResComp .FResComp .FResComp * only used when .MaterialType is set to Elastoplastic with residual strength
.FMaxTensPerLength x x x x Removed in favor of .FMaxTens. PLAXIS 2D only
.FMaxCompPerLength x x x x Removed in favor of .FMaxTens. PLAXIS 2D only
Recommended
Related
Communities
Support and Services
Training and Learning
Social Media