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

::

	Initialize = {char_string} <integer> <float>       [units vary]

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

This optional card provides a mechanism to set one of the field variables to a constant
value across the *whole* domain. 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. Examples include, but are not limited to, the following
    (note the shorthand notation for components):

    ``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).``

    *For a more comprehensive list, see Technical discussion below.*

<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 = VELOCITY1 0 0.

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

This card provides the means to globally set (i.e., the entire problem domain) initial
values for any of the field variables. 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 in a particular material only, a similar *Initialize*
capability is provided within each material block. Please check in the Material Files
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**
representing the various Species Types, is the variables used in Goma input or mat
files for this input record. Multiple species are initialized by combining one of these
variable types with the second parameter (<integer>) on this card.

The comprehensive list of keyword variable names can be found in *mm_input_util.c*, if
you have access to GOMA source code. Search for the function *variable_string_to_int*.
A snapshot of the initialize-able variables in that routine is shown here:

::

    var = VELOCITY1;
    var = VELOCITY2;
    var = VELOCITY3;
    var = TEMPERATURE;
    var = MASS_FRACTION;
    var = MESH_DISPLACEMENT1;
    var = MESH_DISPLACEMENT2;
    var = MESH_DISPLACEMENT3;
    var = PRESSURE;
    var = POLYMER_STRESS11;
    var = POLYMER_STRESS12;
    var = POLYMER_STRESS13;
    var = POLYMER_STRESS22;
    var = POLYMER_STRESS23;
    var = POLYMER_STRESS33;
    var = SOLID_DISPLACEMENT1;
    var = SOLID_DISPLACEMENT2;
    var = SOLID_DISPLACEMENT3;
    var = VELOCITY_GRADIENT11;
    var = VELOCITY_GRADIENT12;
    var = VELOCITY_GRADIENT13;
    var = VELOCITY_GRADIENT21;
    var = VELOCITY_GRADIENT22;
    var = VELOCITY_GRADIENT23;
    var = VELOCITY_GRADIENT31;
    var = VELOCITY_GRADIENT32;
    var = VELOCITY_GRADIENT33;
    var = VOLTAGE;
    var = FILL;
    var = SHEAR_RATE;
    var = PVELOCITY1;
    var = PVELOCITY2;
    var = PVELOCITY3;
    var = POLYMER_STRESS11_1;
    var = POLYMER_STRESS12_1;
    var = POLYMER_STRESS22_1;
    var = POLYMER_STRESS13_1;
    var = POLYMER_STRESS23_1;
    var = POLYMER_STRESS33_1;
    var = POLYMER_STRESS11_2;
    var = POLYMER_STRESS12_2;
    var = POLYMER_STRESS22_2;
    var = POLYMER_STRESS13_2;
    var = POLYMER_STRESS23_2;
    var = POLYMER_STRESS33_2;
    var = POLYMER_STRESS11_3;
    var = POLYMER_STRESS12_3;
    var = POLYMER_STRESS22_3;
    var = POLYMER_STRESS13_3;
    var = POLYMER_STRESS23_3;
    var = POLYMER_STRESS33_3;
    var = POLYMER_STRESS11_4;
    var = POLYMER_STRESS12_4;
    var = POLYMER_STRESS22_4;
    var = POLYMER_STRESS13_4;
    var = POLYMER_STRESS23_4;
    var = POLYMER_STRESS33_4;
    var = POLYMER_STRESS11_5;
    var = POLYMER_STRESS12_5;
    var = POLYMER_STRESS22_5;
    var = POLYMER_STRESS13_5;
    var = POLYMER_STRESS23_5;
    var = POLYMER_STRESS33_5;
    var = POLYMER_STRESS11_6;
    var = POLYMER_STRESS12_6;
    var = POLYMER_STRESS22_6;
    var = POLYMER_STRESS13_6;
    var = POLYMER_STRESS23_6;
    var = POLYMER_STRESS33_6;
    var = POLYMER_STRESS11_7;
    var = POLYMER_STRESS12_7;
    var = POLYMER_STRESS22_7;
    var = POLYMER_STRESS13_7;
    var = POLYMER_STRESS23_7;
    var = POLYMER_STRESS33_7;
    var = SPECIES_MASS_FRACTION;
    var = SPECIES_MOLE_FRACTION;
    var = SPECIES_VOL_FRACTION;
    var = SPECIES_DENSITY;
    var = SPECIES_CONCENTRATION;
    var = SPECIES_CAP_PRESSURE;
    var = SPECIES_UNDEFINED_FORM;
    var = POR_LIQ_PRES;
    var = POR_GAS_PRES;
    var = POR_POROSITY;
    var = POR_TEMP;
    var = POR_SATURATION;
    var = VORT_DIR1;
    var = VORT_DIR2;
    var = VORT_DIR3;
    var = CURVATURE;
    var = BOND_EVOLUTION;
    var = SURF_CHARGE;
    var = EXT_VELOCITY;
    var = EFIELD1;
    var = EFIELD2;
    var = EFIELD3;
    var = ENORM;
    var = NORMAL1;
    var = NORMAL2;
    var = NORMAL3;
    var = SHELL_CURVATURE;
    var = SHELL_TENSION;
    var = SHELL_X;
    var = SHELL_Y;
    var = SHELL_USER;
    var = PHASE1;
    var = PHASE2;
    var = PHASE3;
    var = PHASE4;
    var = PHASE5;
    var = SHELL_ANGLE1;
    var = SHELL_ANGLE2;
    var = SHELL_SURF_DIV_V;
    var = SHELL_SURF_CURV;
    var = N_DOT_CURL_V;
    var = GRAD_V_DOT_N1;
    var = GRAD_V_DOT_N2;
    var = GRAD_V_DOT_N3;
    var = ACOUS_PREAL;
    var = ACOUS_PIMAG;
    var = ACOUS_ENERGY;
    var = POR_SINK_MASS;
    var = VORT_DIR1
    var = VORT_DIR2
    var = VORT_DIR3
    var = VORT_LAMBDA
    var = CURVATURE
    var = LAGR_MULT1
    var = LAGR_MULT2
    var = LAGR_MULT3
    var = BOND_EVOLUTION
    var = SURF_CHARGE
    var = EXT_VELOCITY
    var = EFIELD1
    var = EFIELD2
    var = EFIELD3
    var = ENORM
    var = NORMAL1
    var = NORMAL2
    var = NORMAL3
    var = SHELL_CURVATURE
    var = SHELL_TENSION
    var = SHELL_X
    var = SHELL_Y
    var = SHELL_USER
    var = PHASE1
    var = PHASE2
    var = PHASE3
    var = PHASE4
    var = PHASE5
    var = SHELL_ANGLE1
    var = SHELL_ANGLE2
    var = SHELL_SURF_DIV_V
    var = SHELL_SURF_CURV
    var = N_DOT_CURL_V
    var = GRAD_S_V_DOT_N1
    var = GRAD_S_V_DOT_N2
    var = GRAD_S_V_DOT_N3
    var = ACOUS_PREAL
    var = ACOUS_PIMAG
    var = SHELL_DIFF_FLUX
    var = SHELL_DIFF_CURVATURE
    var = SHELL_NORMAL1
    var = SHELL_NORMAL2
    var = ACOUS_REYN_STRESS
    var = SHELL_BDYVELO
    var = SHELL_LUBP
    var = LUBP
    var = SHELL_FILMP
    var = SHELL_FILMH
    var = SHELL_PARTC
    var = SHELL_SAT_CLOSED
    var = SHELL_PRESS_OPEN
    var = SHELL_TEMPERATURE
    var = SHELL_DELTAH
    var = SHELL_LUB_CURV
    var = SHELL_SAT_GASN
    var = SHELL_SHEAR_TOP
    var = SHELL_SHEAR_BOT
    var = SHELL_CROSS_SHEAR
    var = MAX_STRAIN
    var = CUR_STRAIN
    var = LUBP_2
    var = SHELL_PRESS_OPEN_2
    var = SHELL_LUB_CURV_2