**************
**Initialize**
**************

::

   Initialize = {char_string} <integer> <float> [varies]

-----------------------
**Description / Usage**
-----------------------

This optional card provides a mechanism to set one of the field variables to a constant
value within the current material block. Definitions of the input parameters are as
follows:

+--------------------------+-------------------------------------------------------------------------------------+
|<char_string>             |Permissible values for this input string are any variable names identified in source |
|                          |file rf_fem_const.h beginning at the section labeled Variable Names of unknowns,     |
|                          |though they should be active in this material block. Examples include, but are not   |
|                          |limited to, the following:                                                           |
|                          |                                                                                     |
|                          |**VELOCITY1, VELOCITY2, VELOCITY3 (V123),MESH_DISPLACEMENT (MD123),                  |
|                          |SOLID_DISPLACEMENT (SD123), MASS_FRACTION, TEMPERATURE, PRESSURE,VOLTAGE, FILL, LS,  |
|                          |POLYMER_STRESS (6 components, 8 modes), VELOCITY_GRADIENT (9 components), SHEAR_RATE,|
|                          |VOLF_PHASE (6 phases), POR_LIQ_PRES, POR_GAS_PRES, POR_POROSITY, POR_SATURATION,     |
|                          |POR_LAST, LAGR_MULT (LM123), SURF_CHARGE, EXT_VELOCITY, EFIELD(123), SHELL           |
|                          |(4 variables), SPECIES (7 variables).**                                              |
|                          |                                                                                     |
|                          |*Note: for a comprehensive list of initializable variables, consult Volume 1         |
|                          |“Initialize” card.*                                                                  |
+--------------------------+-------------------------------------------------------------------------------------+
|<integer>                 |Species number to be initialized if the value of {char_string} is one of the         |
|                          |**SPECIES** variables (see Technical Discussion); otherwise, set <integer> to zero.  |
+--------------------------+-------------------------------------------------------------------------------------+
|<float>                   |Value to which the variable should be initialized.                                   |
+--------------------------+-------------------------------------------------------------------------------------+

*Multiple applications of this card are valid; Goma automatically counts the number of Initialize cards.*

------------
**Examples**
------------

Following is a sample card:

::

   INITIALIZE = POLYMER_STRESS11 0 1.25E4

-------------------------
**Technical Discussion**
-------------------------

This card provides the means to set initial values for any of the field variables in the
element block for a particular material. Since the setting of variables initialized on this
card takes place after reading the initial guess (see function init_vec in file rf_util.c), it
can be used to override the value in the initial guess file.

In order to set a field to a specific value over the entire problem domain, a similar
*Initialize* capability is provided as a global variable in the *General Specifications*
section of the *Goma* input file. Please check in the Problem Description section of this
manual.

Note, the **SPECIES_UNK** variables are **NOT** used to initialize any of the species
variables. Rather, the special definition called **MASS_FRACTION**
is the variables used in Goma input or mat
files for this input record. Multiple species are initialized by combining 
**MASS_FRACTION** with the second parameter (<integer>) on this card. These cards are
particularly handy for mass transfer problems, where the initial conditions need to
specify different concentrations of the same species in different materials.

Note: for a comprehensive list of initializable variables, consult Volume 1 “Initialize”
card.