DECURRENT

User subroutine to define electrical current density magnitude as a function of position, time, element number, field variables, etc. for coupled thermal-electrical, coupled temperature-displacement electrical, coupled thermal-electrochemical, and coupled temperature-displacement electrochemical analyses.

User subroutine DECURRENT:

  • can be used to define the current density value as a function of position, time, element number, field variables, etc. for coupled thermal-electrical, coupled temperature-displacement electrical, coupled thermal-electrochemical, and coupled temperature-displacement electrochemical analyses;
  • will be called at each load integration point for each element-based nonuniform volume or facet and for each surface-based current density definition; and
  • ignores any amplitude references that might appear with the associated step definition or current density load definition.

This page discusses:

Products Abaqus/Standard

User Subroutine Interface

      subroutine decurrent(
C        Write
     *   currentsource, dsourcedsol,
C        Read only
     *   solutionvar, dsolutionvar, nsolutionvar,
     *   predef, dpredef, npredef,
     *   coords, ncoords,
     *   i_array, niarray, 
     *   r_array, nrarray,
     *   c_array, ncarray)
C
include 'aba_param.inc'
C
      dimension dsourcedsol(*),solutionvar(*),dsolutionvar(*)
      dimension predef(*),dpredef(*),coords(*)
      dimension i_array(*),r_array(*)
      character*8 c_array(*)
C
      parameter (i_decurrent_jltyp   = 1,
     *           i_decurrent_kstep   = 2,
     *           i_decurrent_kinc    = 3,
     *           i_decurrent_noel    = 4,
     *           i_decurrent_npt     = 5,
     *           i_decurrent_proc    = 6)
C
      parameter (ir_decurrent_timestep = 1,
     *           ir_decurrent_timetotal = 2,
     *           ir_decurrent_dtime = 3)
C
       user coding to define currentsource and dsourcedsol

return
end
      

Variables to Be Defined

currentsource
The current density value. The units are CL−2T−1 for element facets or surfaces and CL−3T−1 for element volumes. The currentsource is passed into the routine as the value specified as part of the corresponding current density definition. If the value is not defined, currentsource is passed in as zero.
dsourcedsol(1)
The derivative of current density value with respect to electric potential. The value is passed in as zero.
dsourcedsol(2)
The derivative of current density value with respect to temperature. The value is passed in as zero. In general, the number of entries to be defined in the dsourcedsol array must be equal to the nsolutionvar parameter defined below.

Variables Passed in for Information

solutionvar (*)
An array containing the latest solution components’ values (solutionvar(1) for electric potential and solutionvar(2) for temperature) at the load integration point, based on interpolation from the values at the nodes.
dsolutionvar (*)
An array containing an increment in solution components from the previous time at the load integration point, based on interpolation from the values at the nodes.
nsolutionvar
The number of solution components.
predef(*)
An array containing the latest values of all the predefined field variables at the integration point, based on interpolation from the values at the nodes.
dpredef(*)
An array containing an increment in all the predefined field variables from the previous time at the load integration point, based on interpolation from the values at the nodes.
npredef
The number of predefined field variables.
coords(*)
An array containing the coordinates of the load integration point.
ncoords
The number of coordinates.
i_array(i_decurrent_jltyp)
Identifies the electric current type for which this call to the user subroutine is being made. The current type can be a body current, a surface-based current, or an element-based surface current. This information is useful when several different nonuniform distributed fluxes are being imposed on an element at the same time. See About the Element Library for element face identification. The key is as follows:
i_array(i_decurrent_jltyp) value Electric current type
17 CBFNU, element volume
27 CS1NU, element facet 1
28 CS2NU, element facet 2
29 CS3NU, element facet 3
30 CS4NU, element facet 4
31 CS5NU, element facet 5
32 CS6NU, element facet 6
33 CSNU, element facet 1 on surface
34 CSNU, element facet 2 on surface
35 CSNU, element facet 3 on surface
36 CSNU, element facet 4 on surface
37 CSNU, element facet 5 on surface
38 CSNU, element facet 6 on surface
i_array(i_decurrent_kstep)
Step number.
i_array(i_decurrent_kinc)
Increment number.
i_array(i_decurrent_noel)
Element number.
i_array(i_decurrent_npt)
Load integration point number.
i_array(i_decurrent_proc)
i_array(i_decurrent_proc) value Procedure
1 Coupled thermal-electrical steady-state
2 Coupled thermal-electrical transient
3 Coupled temperature-displacement electrical steady-state
4 Coupled temperature-displacement electrical transient
5 Coupled temperature-displacement electrochemical steady-state or coupled thermal-electrochemical steady-state
6 Coupled temperature-displacement electrochemical transient or coupled thermal-electrochemical transient
0 Other procedures
niarray
Size of array i_array. Currently equal to 6.
r_array(ir_decurrent_timestep)
The latest step time.
r_array(ir_decurrent_timetotal)
The latest total time.
r_array(ir_decurrent_dtime)
The time increment.
nrarray
Size of array r_array. Currently equal to 3.
c_array(1)
Surface name for surface-based current, blank otherwise.
ncarray
Size of array c_array. Currently equal to 1.