UECHEMECDDISS

User subroutine to define the electrode dissolution aging current to be used for elements that utilize porous electrode theory in an electrochemical analysis.

User subroutine UECHEMECDDISS:

  • is called for each material integration point for each iteration;
  • is called for each microscale particle that is defined at the active electrodes during an electrochemical analysis;
  • can be used to define the dissolution current to model aging in batteries (see Cathode Dissolution); and
  • can be used only in procedures that support electrochemical analyses (see Electrochemical Analysis).

This page discusses:

Products Abaqus/Standard

User Subroutine Interface

 subroutine uechemecddiss(
     *     ecddiss,         
     *     dEcddiss_dCSurfNorm, dEcddiss_dT, dEcddiss_dSol,dEcddiss_dPress,
     *     overpoteta_diss, epsS_diss,
     *     ocpDiss,chargeDischarge,
     *     jmac,jMatyp,matlayo,laccFlag,
     *     cmname, cParticleName,
     *     kstep,lFlags, kinc, time, dtime, noel, npt, 
     *     ntens, ndi, nshr, props, nprops,
     *     predef, dpredef, npredef,
     *     statev, statevOld, nstatev,
     *     Temp, dTemp, Press, coords,
     *     solutionvar, dsolutionvar, nSolutionVar,
     *     cSurfNorm, cAvgNorm, ecdTotalOld,
     *     i_array,niarray,r_array,nrarray,c_array,ncarray)     
C
      include 'aba_param.inc'
c Include below file to access property and parameter table.
      include 'aba_tcs_param.inc' 
c Include below file to access universal constants
      include 'aba_phcon_param.inc'
c Include below file for parametrized location of various solution variables.
      include 'aba_solutionvarloc.inc'
C
      dimension i_array(*), r_array(*), jmatyp(*),jmac(*), lFlags(*)
      dimension time(2), props(nprops), predef(npredef), dpredef(npredef),
     *     statev(nstatev), statevold(nstatev), coords(*),
     *     solutionvar(nsolutionvar), dsolutionvar(nsolutionvar),
     *     dEcdDiss_dSol(*)
      character*80   cmname, c_array(NCARRAY), cParticleName

      user coding

      return
      end

Variables to Be Defined

ecddiss
Value of the electrode dissolution current density.
dEcddiss_dCSurfNorm
Variation of the dissolution current density ecddiss with respect to normalized particle surface concentration CSurfNorm.
dEcddiss_dT
Variation of the dissolution current density ecddiss with respect to temperature temp.
dEcddiss_dSol
Variation of the dissolution current density ecddiss with respect to the different solution variables solutionvar.
dEcddiss_dPress
Variation of the dissolution current density ecddiss with respect to the macroscale hydrostatic pressure press.
overpoteta_diss
Overpotential for dissolution current computation.

Variables That Can Be Updated

ocpDiss
Open circuit potential for dissolution.

Variables Passed in for Information

chargeDischarge

This variable will have a value that you can use to identify whether the current step is a charging step or a discharging step. The value that is passed in is defined in the property table ABQ_EChemPET_Electrolyte_ChargeDischarge.

jMac

Variable that must be passed into utility routine GETVRM. The calling user subroutine provides this variable.

jMatyp

Variable that must be passed into utility routine GETVRM. The calling user subroutine provides this variable.

matlayo

Variable that must be passed into utility routine GETVRM. The calling user subroutine provides this variable.

lAccFlag

Variable that must be passed into utility routine GETVRM. The calling user subroutine provides this variable.

cmName

User-defined material name, left justified. Some internal material models are given names starting with the “ABQ_” character string. To avoid conflict, you should not use “ABQ_” as the leading string for CMNAME.

cParticleName

User-defined particle name, left justified.

kstep

Current step number.

lFlags

An array containing the flags that define the current solution procedure and analysis type.

lFlags(1) Defines the procedure type. See Results File for the key used for each procedure.
lFlags(2)=0 Small-displacement analysis.
lFlags(2)=1 Large-displacement analysis (nonlinear geometric effects included in the step). See General and Perturbation Procedures.
kinc

Current increment number.

time(1)

Current value of step time.

time(2)

Current value of total time.

dtime

Time increment.

noel

User-assigned element number.

npt

Integration point number.

ntens

Size of the stress or strain component array.

ndi

Number of direct stress components at this point.

nshr

Number of engineering shear stress components at this point.

props

User-specified array of material constants associated with this user material.

npros

User-defined number of material constants associated with this user material.

predef

Array of interpolated values of predefined field variables at this point at the start of the increment, based on the values read in at the nodes.

dpredef

Array of increments of predefined field variables.

npredef

Number of predefined field variables.

statev

Current value of the solution-dependent variables.

statevold

Array containing the user-defined solution-dependent state variables at the end of the previous increment.

nstatev

Number of solution-dependent state variables that are associated with this material type (defined as described in Allocating Space for Solution-Dependent State Variables).

Temp

Current temperature.

dTemp

Incremental temperature.

press

Current hydrostatic pressure.

coords

An array containing the current coordinates of this integration point.

solutionVar

Current value of the solution variables.

solutionVar(i_sol_phiS) Current value of the electric potential.
solutionVar(i_sol_phiE) Current value of the electric potential in the electrolyte.
solutionVar(i_sol_Ce) Current value of the ionic concentration in the electrolyte.
solutionVar(i_sol_porP) Current value of the pore pressure.
dsolutionVar

Incremental value of the solution variables.

dsolutionVar(i_sol_phiS) Incremental value of the electric potential.
dsolutionVar(i_sol_phiE) Incremental value of the electric potential in the electrolyte.
dsolutionVar(i_sol_Ce) Incremental value of the ionic concentration in the electrolyte.
dsolutionVar(i_sol_porP) Incremental value of the pore pressure.
nsolutionVar

Number of solution variables.

cSurfNorm

Current normalized concentration on the surface of the particle.

cAvgNorm

Current average normalized concentration in the particle.

ecdTotalOld

Value of the total electrical current density at the end of the previous increment.

i_array

Not used.

niarray

Size of array i_array.

r_array

Not used.

nrarray

Size of array r_array.

c_array

Not used.

ncarray

Size of array c_array.