The iteration

The variables are described in The iteration.

Methods of the class homard

 
GetIteration(iter_name)

Returns an instance of the class iteration known by its name

  • iter_name: the name of the iteration
GetAllIterationsName()
Returns the liste of the name of all the existing iterations

Methods of both classes cas and iteration ************************************” See also in The case.

 
NextIteration(iter_name)

Returns an instance of the class iteration after its creation. It is the next iteration after:

  • for a case: the very first one that corresponds to the first mesh of the case
  • for an iteration: the current iteration

Default: the produced mesh has got the same name as the iteration

  • iter_name: the name of this next iteration
LastIteration()

Returns an instance of the class iteration that is the last iteration into the descendants of:

  • for a case: the very first one that corresponds to the first mesh of the case
  • for an iteration: the current iteration

It is the one that has got no child. There is an error if more than one branch exists into the descendants.

Methods of the class iteration

General methods

 
Compute(option1, option2)

Computes the mesh produced by the iteration

  • option1: an integer to decide what to do with existing files, if any

    • 0: stop with error
    • 1: the old files are removed
  • option2: an integer to decide what to do with the results

    • 1: no specific action
    • 2: publication into the module SMESH
Returns an integer:
  • 0: successful adaptation
  • other value: problem
GetName()
Returns the name of the iteration
GetNumber()

Returns the number of the iteration.

The iteration #0 is the one associated to the initial mesh. Then, an iteration with number #N comes from the adaptation of an iteration with number #(N-1).

GetIterParent()
Returns the iteration parent
AssociateHypo(hypo_name)

Associate a hypothesis with the iteration

  • hypo_name: the name of the hypothesis
GetHypoName()
Returns the name of the associated hypothesis
GetCaseName()
Returns the name of the associated case
GetState()

Returns the state of the iteration

  • 2: computed iteration
  • 1: non computed iteration
  • <=0: initial iteration not to be computed, with a number equal to the absolute valure of the state
GetLogFile()
Returns the name of the file with the messages all along the running of HOMARD
GetFileInfo()
Returns the name of the file with the analysis of the mesh
GetDirName()
Returns the name of the directory that contains the results of the iteration
Delete(option)

Deletes the iteration and all its children

  • option: an integer to define what to do with the MED file of the associated meshes

    • 0: the files are kept
    • 1: the files are removed
Returns an integer:
  • 0: the destruction is done
  • other value: problem

Information about the meshes

 
SetMeshName(mesh_name)

Defines the name of the produced mesh

  • mesh_name: the name of the produced mesh
GetMeshName()
Returns the name of the produced mesh
SetMeshFile(mesh_file)

Defines the name of the MED file of the produced mesh

  • mesh_file: the name of the MED file of the produced mesh
GetMeshFile()
Returns the name of the MED file of the produced mesh
MeshInfo(Qual, Diam, Conn, Tail, Inte)

Gives information about the current mesh. For every option, the choice #0 corresponds to ‘no action’, while the choice #1 launches the option.

  • Qual: quality of the elements
  • Diam: diametre of the elements
  • Conn: connexity of the domain; a single block, how many holes, etc.
  • Tail: size of the parts of the domain, group by group
  • Inte: staggered elements, by dimension

Information about the field

The file of the fields

 
SetFieldFile(field_file)

Defines the MED file of the fields

  • field_file: the name of the MED file of the fields: the driving field for the adaptation, or the fields to be interpolated
GetFieldFileName()
Returns the name of the MED file of the fields

The time step for the driving field

If no time step is defined for the field or if a single time step is defined for the field, the definition of a time step is useless. That will be the default choice.

 
SetTimeStep(TimeStep)

Defines the time step for the driving field for the adaptation. The rank will be ignored.

  • TimeStep: the selected time step
SetTimeStepRank(TimeStep, Rank)

Defines the time step and the rank for the driving field for the adaptation

  • TimeStep: the selected time step
  • Rank: the selected rank
SetTimeStepRankLast()
The last time step will be used for the driving field for the adaptation, whatever its value
GetTimeStep()
Returns the selected time step for the driving field
GetRank()
Returns the selected rank for the driving field

The time steps for the fields to interpolate

The choice of the fields to interpolated are defined in the hypothesis (see The hypothesis). For a given field, if nothing is declared, every single time step will be considered. If some time steps are wanted, they must be defined as follows.

 
SetFieldInterpTimeStep(FieldName, TimeStep)

Defines the time step for the interpolation of the field. The rank will be ignored.

  • FieldName: the name of the field to interpolate
  • TimeStep: the selected time step
SetFieldInterpTimeStepRank(FieldName, TimeStep)

Defines the time step and the rank for the interpolation of the field.

  • FieldName: the name of the field to interpolate
  • TimeStep: the selected time step
  • Rank: the selected rank
GetFieldInterpsTimeStepRank()

Returns the information (name of the field, time step, rank)

Warning: the time step and the rank are stored as strings in the list and not as integers.

Example: [‘DEPL’, ‘1’, ‘1’, ‘DEPL’, ‘2’, ‘1’, ‘Mass’, ‘2’, ‘0’, ‘Mass’, ‘3’, ‘0’]

Miscellenaous

 
SetInfoCompute(MessInfo)

Defines options to track the computation of the iteration

  • MessInfo: integer that drives prints, as a multiple of 2, 3 and 5

    • 1 : nothing (default)
    • 2x : computational time
    • 3x : MED files
    • 5x : memory
GetInfoCompute()
Returns the options to track the computation

Example

To create the first iteration, the starting point is the iteration associated to the initial mesh. It is the one that defines the case.

iter_name = "Iteration_1"
iter_1 = case_1.NextIteration(iter_name)
iter_1.SetField(field_file)
iter_1.SetTimeStepRank( 0, 0)
iter_1.SetMeshName("maill_01")
iter_1.SetMeshFile("/local00/M.01.med")
iter_1.AssociateHypo("HypoField")
codret = iter_1.Compute(1, 2)

Then, the next iteration is created from the current iteration.

iter_name = "Iteration_2"
iter_2 = iter_1.NextIteration(iter_name)
iter_2.SetField(field_file)
iter_2.SetTimeStepRank( 1, 1)
iter_2.SetMeshName("maill_02")
iter_2.SetMeshFile("/local00/M.02.med")
iter_2.AssociateHypo("HypoField")
codret = iter_2.Compute(1, 2)

Similar graphical input

Look at The iteration