From 0b42f94b9782c2b90363eee525da2fd6dd1e4a01 Mon Sep 17 00:00:00 2001 From: Javad Esmaeelpour Date: Fri, 26 Jun 2026 00:00:06 -0400 Subject: [PATCH] Update TDConcrete family documentation - Add $ prefix to argument names in parameter tables - Restore function signature style to match rest of documentation --- .../user/manual/material/uniaxialMaterial.rst | 4 ++ .../material/uniaxialMaterials/TDConcrete.rst | 39 ++++++++++++++++ .../uniaxialMaterials/TDConcreteEXP.rst | 40 +++++++++++++++++ .../uniaxialMaterials/TDConcreteMC10.rst | 43 ++++++++++++++++++ .../uniaxialMaterials/TDConcreteMC10NL.rst | 45 +++++++++++++++++++ 5 files changed, 171 insertions(+) create mode 100644 source/user/manual/material/uniaxialMaterials/TDConcrete.rst create mode 100644 source/user/manual/material/uniaxialMaterials/TDConcreteEXP.rst create mode 100644 source/user/manual/material/uniaxialMaterials/TDConcreteMC10.rst create mode 100644 source/user/manual/material/uniaxialMaterials/TDConcreteMC10NL.rst diff --git a/source/user/manual/material/uniaxialMaterial.rst b/source/user/manual/material/uniaxialMaterial.rst index 98ec7f83..ec264dbc 100644 --- a/source/user/manual/material/uniaxialMaterial.rst +++ b/source/user/manual/material/uniaxialMaterial.rst @@ -48,6 +48,10 @@ The following subsections contain information about **$matType** uniaxialMaterials/ASDConcrete1D uniaxialMaterials/GMG_CyclicReinforcedConcrete uniaxialMaterials/Creep + uniaxialMaterials/TDConcrete + uniaxialMaterials/TDConcreteEXP + uniaxialMaterials/TDConcreteMC10 + uniaxialMaterials/TDConcreteMC10NL .. uniaxialMaterials/Concrete06 .. uniaxialMaterials/Concrete07 diff --git a/source/user/manual/material/uniaxialMaterials/TDConcrete.rst b/source/user/manual/material/uniaxialMaterials/TDConcrete.rst new file mode 100644 index 00000000..b24d50af --- /dev/null +++ b/source/user/manual/material/uniaxialMaterials/TDConcrete.rst @@ -0,0 +1,39 @@ +TDConcrete +^^^^^^^^^^ + +This command is used to construct a uniaxial time-dependent concrete material object with linear behavior in compression, nonlinear behavior in tension (REF: Tamai et al., 1988) and creep and shrinkage according to ACI 209R-92. + +.. function:: uniaxialMaterial TDConcrete $matTag $fc $fct $Ec $beta $tD $epsshu $psish $Tcr $phiu $psicr1 $psicr2 $tcast + +.. csv-table:: + :header: "Argument", "Type", "Description" + :widths: 6, 4, 40 + + "``$matTag``", integer, "integer tag identifying material" + "``$fc``", float, "concrete compressive strength (compression is negative)" + "``$fct``", float, "concrete tensile strength (tension is positive)" + "``$Ec``", float, "concrete modulus of elasticity" + "``$beta``", float, "tension softening parameter (tension softening exponent)" + "``$tD``", float, "analysis time at initiation of drying (in days)" + "``$epsshu``", float, "ultimate shrinkage strain as per ACI 209R-92 (shrinkage is negative)" + "``$psish``", float, "fitting parameter of the shrinkage time evolution function as per ACI 209R-92" + "``$Tcr``", float, "creep model age (in days)" + "``$phiu``", float, "ultimate creep coefficient as per ACI 209R-92" + "``$psicr1``", float, "fitting parameter of the creep time evolution function as per ACI 209R-92" + "``$psicr2``", float, "fitting parameter of the creep time evolution function as per ACI 209R-92" + "``$tcast``", float, "analysis time corresponding to concrete casting (in days; minimum value 2.0)" + +.. note:: + + #. Compressive concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + #. Shrinkage concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + + +.. seealso:: + + + `Detailed descriptions of the model and its implementation can be found in the following:` + `(1) Knaack, A.M., Kurama, Y.C. 2018. Modeling Time-Dependent Deformations: Application for Reinforced Concrete Beams with Recycled Concrete Aggregates. ACI Structural J. 115, 175-190. doi:10.14359/51701153` + `(2) Knaack, A.M., 2013. Sustainable concrete structures using recycled concrete aggregate: short-term and long-term behavior considering material variability. PhD Dissertation, Civil and Environmental Engineering and Earth Sciences, University of Notre Dame, Notre Dame, Indiana, USA, 680 pp` + `A manual describing the use of the model and sample files can be found at:` + ``_ diff --git a/source/user/manual/material/uniaxialMaterials/TDConcreteEXP.rst b/source/user/manual/material/uniaxialMaterials/TDConcreteEXP.rst new file mode 100644 index 00000000..7885b0a6 --- /dev/null +++ b/source/user/manual/material/uniaxialMaterials/TDConcreteEXP.rst @@ -0,0 +1,40 @@ +TDConcreteEXP +^^^^^^^^^^^^^ + +This command is used to construct a uniaxial time-dependent concrete material object with linear behavior in compression, nonlinear behavior in tension (REF: Tamai et al., 1988) and creep and shrinkage according to ACI 209R-92. + +.. function:: uniaxialMaterial TDConcreteEXP $matTag $fc $fct $Ec $beta $tD $epsshu $psish $Tcr $epscru $sigCr $psicr1 $psicr2 $tcast + +.. csv-table:: + :header: "Argument", "Type", "Description" + :widths: 6, 4, 40 + + "``$matTag``", integer, "integer tag identifying material" + "``$fc``", float, "concrete compressive strength (compression is negative)" + "``$fct``", float, "concrete tensile strength (tension is positive)" + "``$Ec``", float, "concrete modulus of elasticity" + "``$beta``", float, "tension softening parameter (tension softening exponent)" + "``$tD``", float, "analysis time at initiation of drying (in days)" + "``$epsshu``", float, "ultimate shrinkage strain as per ACI 209R-92 (shrinkage is negative)" + "``$psish``", float, "fitting parameter of the shrinkage time evolution function as per ACI 209R-92" + "``$Tcr``", float, "creep model age (in days)" + "``$epscru``", float, "ultimate creep strain (e.g., taken from experimental measurements)" + "``$sigCr``", float, "concrete compressive stress (input as negative) associated with $epscru (e.g., experimentally applied)" + "``$psicr1``", float, "fitting parameter of the creep time evolution function as per ACI 209R-92" + "``$psicr2``", float, "fitting parameter of the creep time evolution function as per ACI 209R-92" + "``$tcast``", float, "analysis time corresponding to concrete casting (in days; minimum value 2.0)" + +.. note:: + + #. Compressive concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + #. Shrinkage concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + + +.. seealso:: + + + `Detailed descriptions of the model and its implementation can be found in the following:` + `(1) Knaack, A.M., Kurama, Y.C. 2018. Modeling Time-Dependent Deformations: Application for Reinforced Concrete Beams with Recycled Concrete Aggregates. ACI Structural J. 115, 175-190. doi:10.14359/51701153` + `(2) Knaack, A.M., 2013. Sustainable concrete structures using recycled concrete aggregate: short-term and long-term behavior considering material variability. PhD Dissertation, Civil and Environmental Engineering and Earth Sciences, University of Notre Dame, Notre Dame, Indiana, USA, 680 pp` + `A manual describing the use of the model and sample files can be found at:` + ``_ diff --git a/source/user/manual/material/uniaxialMaterials/TDConcreteMC10.rst b/source/user/manual/material/uniaxialMaterials/TDConcreteMC10.rst new file mode 100644 index 00000000..95363d65 --- /dev/null +++ b/source/user/manual/material/uniaxialMaterials/TDConcreteMC10.rst @@ -0,0 +1,43 @@ +TDConcreteMC10 +^^^^^^^^^^^^^^ + +This command is used to construct a uniaxial time-dependent concrete material object with linear behavior in compression, nonlinear behavior in tension (REF: Tamai et al., 1988) and creep and shrinkage according to fib Model Code 2010. + +.. function:: uniaxialMaterial TDConcreteMC10 $matTag $fc $fct $Ec $Ecm $beta $tD $epsba $epsbb $epsda $epsdb $phiba $phibb $phida $phidb $tcast $cem + +.. csv-table:: + :header: "Argument", "Type", "Description" + :widths: 6, 4, 40 + + "``$matTag``", integer, "integer tag identifying material" + "``$fc``", float, "concrete compressive strength (compression is negative)" + "``$fct``", float, "concrete tensile strength (tension is positive)" + "``$Ec``", float, "concrete modulus of elasticity at loading age" + "``$Ecm``", float, "concrete modulus of elasticity at 28 days" + "``$beta``", float, "tension softening parameter (tension softening exponent)" + "``$tD``", float, "analysis time at initiation of drying (in days)" + "``$epsba``", float, "ultimate basic shrinkage strain (input as negative) as per fib Model Code 2010" + "``$epsbb``", float, "fitting parameter of the basic shrinkage time evolution function as per fib Model Code 2010" + "``$epsda``", float, "product of ultimate drying shrinkage strain and relative humidity function as per fib Model Code 2010" + "``$epsdb``", float, "fitting parameter of the basic shrinkage time evolution function as per fib Model Code 2010" + "``$phiba``", float, "parameter for the effect of compressive strength on basic creep as per fib Model Code 2010" + "``$phibb``", float, "fitting parameter of the basic creep time evolution function as per fib Model Code 2010" + "``$phida``", float, "product of the effect of compressive strength and relative humidity on drying creep as per fib Model Code 2010" + "``$phidb``", float, "fitting parameter of the drying creep time evolution function as per fib Model Code 2010" + "``$tcast``", float, "analysis time corresponding to concrete casting (in days; minimum value 2.0)" + "``$cem``", float, "coefficient dependent on the type of cement as per fib Model Code 2010" + +.. note:: + + #. Compressive concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + #. Shrinkage concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + + +.. seealso:: + + + `Detailed descriptions of the model and its implementation can be found in the following:` + `(1) Knaack, A.M., Kurama, Y.C. 2018. Modeling Time-Dependent Deformations: Application for Reinforced Concrete Beams with Recycled Concrete Aggregates. ACI Structural J. 115, 175-190. doi:10.14359/51701153` + `(2) Knaack, A.M., 2013. Sustainable concrete structures using recycled concrete aggregate: short-term and long-term behavior considering material variability. PhD Dissertation, Civil and Environmental Engineering and Earth Sciences, University of Notre Dame, Notre Dame, Indiana, USA, 680 pp` + `A manual describing the use of the model and sample files can be found at:` + ``_ diff --git a/source/user/manual/material/uniaxialMaterials/TDConcreteMC10NL.rst b/source/user/manual/material/uniaxialMaterials/TDConcreteMC10NL.rst new file mode 100644 index 00000000..a1b1f1ce --- /dev/null +++ b/source/user/manual/material/uniaxialMaterials/TDConcreteMC10NL.rst @@ -0,0 +1,45 @@ +TDConcreteMC10NL +^^^^^^^^^^^^^^^^ + +This command is used to construct a uniaxial time-dependent concrete material object with non-linear behavior in compression (REF: Concrete02), nonlinear behavior in tension (REF: Tamai et al., 1988) and creep and shrinkage according to fib Model Code 2010. + +.. function:: uniaxialMaterial TDConcreteMC10NL $matTag $fc $fcu $epscu $fct $Ec $Ecm $beta $tD $epsba $epsbb $epsda $epsdb $phiba $phibb $phida $phidb $tcast $cem + +.. csv-table:: + :header: "Argument", "Type", "Description" + :widths: 6, 4, 40 + + "``$matTag``", integer, "integer tag identifying material" + "``$fc``", float, "concrete compressive strength (compression is negative)" + "``$fcu``", float, "concrete crushing strength (compression is negative)" + "``$epscu``", float, "concrete strain at crushing strength (input as negative)" + "``$fct``", float, "concrete tensile strength (tension is positive)" + "``$Ec``", float, "concrete modulus of elasticity at loading age" + "``$Ecm``", float, "concrete modulus of elasticity at 28 days" + "``$beta``", float, "tension softening parameter (tension softening exponent)" + "``$tD``", float, "analysis time at initiation of drying (in days)" + "``$epsba``", float, "ultimate basic shrinkage strain (input as negative) as per fib Model Code 2010" + "``$epsbb``", float, "fitting parameter of the basic shrinkage time evolution function as per fib Model Code 2010" + "``$epsda``", float, "product of ultimate drying shrinkage strain and relative humidity function as per fib Model Code 2010" + "``$epsdb``", float, "fitting parameter of the basic shrinkage time evolution function as per fib Model Code 2010" + "``$phiba``", float, "parameter for the effect of compressive strength on basic creep as per fib Model Code 2010" + "``$phibb``", float, "fitting parameter of the basic creep time evolution function as per fib Model Code 2010" + "``$phida``", float, "product of the effect of compressive strength and relative humidity on drying creep as per fib Model Code 2010" + "``$phidb``", float, "fitting parameter of the drying creep time evolution function as per fib Model Code 2010" + "``$tcast``", float, "analysis time corresponding to concrete casting (in days; minimum value 2.0)" + "``$cem``", float, "coefficient dependent on the type of cement as per fib Model Code 2010" + +.. note:: + + #. Compressive concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + #. Shrinkage concrete parameters should be input as negative values (if input as positive, they will be converted to negative internally). + + +.. seealso:: + + + `Detailed descriptions of the model and its implementation can be found in the following:` + `(1) Knaack, A.M., Kurama, Y.C. 2018. Modeling Time-Dependent Deformations: Application for Reinforced Concrete Beams with Recycled Concrete Aggregates. ACI Structural J. 115, 175-190. doi:10.14359/51701153` + `(2) Knaack, A.M., 2013. Sustainable concrete structures using recycled concrete aggregate: short-term and long-term behavior considering material variability. PhD Dissertation, Civil and Environmental Engineering and Earth Sciences, University of Notre Dame, Notre Dame, Indiana, USA, 680 pp` + `A manual describing the use of the model and sample files can be found at:` + ``_