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.1 and later
PLAXIS 3D 2023.1 and later
Date created May 25, 2022
Date modified Oct 29, 2024

This page gives an overview of Material property changes between PLAXIS CONNECT Edition V21.01 to PLAXIS 2024.2.

For all the changes between versions check the full overview in the PDF attached in Downloads section.

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:

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 2024.2 the following items have changes:

Last update: Oct 29, 2024

Quick list

Soil - General

V21.01 2024.2 Comment
.MaterialName .Identification  
.ninit .nInit  
.einit .eInit  

Soil - Groundwater

V21.01 2024.2 Comment
.perm_primary_horizontal_axis .PermHorizontalPrimary  
.perm_vertical_axis .PermVertical  

Soil - Interface

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

Soil - Initial stresses

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

Soil - Mohr-Coulomb

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

Soil - Hardening Soil/HS Small

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

Soil - Soft Soil/Soft Soil Creep

V21.01 2024.2 Comment
.MuModified .muModified  
.Cc .CC Alternative parameters for stiffness
.Cs .CS Alternative parameters for stiffness
.Ca .CAlpha Alternative parameters for stiffness
.nu .nuUR  
.cref .cRef  
.K0nc .K0NC  

Soil - NGI-ADP

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

Rock - Hoek-Brown

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

User Defined Soil Model

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

Plates (2D)

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

Plates (3D)

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

Geogrids

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

Beams (3D)

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

Embedded beams

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

Cables

V21.01 2024.2 Comment
- .NpTens Following the CamelCase formatting
- .NpComp Following the CamelCase formatting
- cable() Removed the word bolt from the command. PLAXIS 2D only
- cablemat() Removed the word bolt from the command. PLAXIS 2D only

Anchors

V21.01 2024.2 Comment
.MaterialName .Identification  
.Elasticity .MaterialType Material Type needs to be set explicitly
.Lspacing .LSpacing * only for PLAXIS 2D
.FMaxTens .FMaxTens * only used when .MaterialType is set to Elastoplastic
.FMaxComp .FMaxComp * only used when .MaterialType is set to Elastoplastic
.FResidualTens .FResTens * only used when .MaterialType is set to Elastoplastic with residual strength
.FResidualComp .FResComp * only used when .MaterialType is set to Elastoplastic with residual strength
.FMaxTensPerLength x Removed in favor of .FMaxTens. PLAXIS 2D only
.FMaxCompPerLength x Removed in favor of .FMaxTens. PLAXIS 2D only

Downloads

See also