# 7.16.1.33. Ic Read_File

Syntax

  Ic Read_File dof ([{of} SpeciesName] | [{in} MaterialPhaseName]) {=} FileVariable [ At Time Value ]

Summary

  This IC command will initialize the chosen Aria DOF with values from the field with the name given by a variable selected from the input mesh database. Only initialization of nodal variables with nodal variables from another file is currently supported.

Description

  This IC command will initialize the field DOF in the current analysis with values from the input mesh database FileVariable. For example, if the mesh database as specified in the FINITE ELEMENT MODEL command block contains a vector field named U then one could use the file to initialize a velocity field by setting DOF to VELOCITY and the FileVariable argument to U.

  In cases where the field DOF has a several components (i.e. DOF is a vector field) and the input mesh database contains the vector components defined as scalar fields, the command must be called once for each component. Here the DOF is specified as DOF_component.

  A typical usage example would be initialize a transient calculation from a previously performed steady-state calculation in the following way. The steady-state calculation would be performed and its output variables saved to some output file. In most cases one might employ a copy of the output file to be used as a mesh file for the transient calculation. Finally, one would use the file IC command line to tie the variable named “FileVariable” in the mesh file to the variable named DOF in the current simulation.

  When the mesh database file contains multiple timesteps and the TIME option is not supplied, the default behavior will be to extract the requested field from the last time plane in the file. The TIME option must be used if the initial condition is to be extracted from any specific database time plane other than the last time plane. In using the TIME option the database time step nearest to the specified time value will be used for the assignment. For an initial condition taken from a steady-state results file, the optional TIME parameter should be omitted.

  Steady solution results are sometimes written to file in two steps. When this command is used to initialize values from a steady solution one must select the solution file step according to the content of the steady solution file results. If the file contains two solution steps then one should employ the time option and select the time corresponding to the second step.

  CAVEAT: Current framework services do not allow restricting this initialization by mesh subsets. e. g. If one wishes to initialize the temperature, then all nodes in the mesh will be initialized.

  NOTE: Those wishing to perform initializations as part of a formal restart are referred to RESTART DATA services.

Parameter | Value | Default
--- | --- | ---
dof | string | –
{of} | {of | species} | –
SpeciesName | string | –
{in} | {in | material_phase} | –
MaterialPhaseName | string | –
{=} | {= | are | is} | –
FileVariable | string | –