Optimize Action

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">

This section is used to describe some of the functions used to optimize entities in a finite element model.

The optimization process will renumber the nodes or elements of a model in such a way that the stiffness matrix assembled in a finite element analysis can be solved by using a minimum of CPU time, memory, and disk space.

fem_optimize	(object, method, criterion, starting_id, bandwidth, profile, maximum_wavefront, average_wavefront, rms_wavefront)

Description:
This function will renumber the nodes or elements in the model to minimize the time required to find a finite element solution.
Input:
STRING	object[8]	This value specifies the type of entity to optimize. This argument can have the following values: “Nodes” or “Elements”.
STRING	method[]	This value specifies the type of optimization method used. This argument can have the following values: “C” = “Cuthill-McKee” method, “G” = “Gibbs-Poole-Stockmeyer”, or “B” = both methods.
STRING	criterion[]	This value specifies the minimization criterion used by the optimization process. This argument can have the following values: “RMS Wavefront”, ” Bandwidth”, “Max Wavefront”, or “Profile”.
INTEGER	starting_id	This value specifies the id at which to start the renumbering process.
Output:
INTEGER	bandwidth(4)	This value returns the bandwidth calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.
INTEGER	profile(4)	This value returns the profile calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.
INTEGER	maximum_wavefront(4)
		This value returns the maximum wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.
REAL	avgerage_wavefront(4)
		This value returns the minimum wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.
REAL	rms_wavefront(4)	This value returns the root mean squared wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.

Description:

This function will renumber the nodes or elements in the model to minimize the time required to find a finite element solution.

Input:

STRING

object[8]

This value specifies the type of entity to optimize. This argument can have the following values: “Nodes” or “Elements”.

STRING

method[]

This value specifies the type of optimization method used. This argument can have the following values: “C” = “Cuthill-McKee” method, “G” = “Gibbs-Poole-Stockmeyer”, or “B” = both methods.

STRING

criterion[]

This value specifies the minimization criterion used by the optimization process. This argument can have the following values: “RMS Wavefront”, ” Bandwidth”, “Max Wavefront”, or “Profile”.

INTEGER

starting_id

This value specifies the id at which to start the renumbering process.

Output:

INTEGER

bandwidth(4)

This value returns the bandwidth calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.

INTEGER

profile(4)

This value returns the profile calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.

INTEGER

maximum_wavefront(4)

This value returns the maximum wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.

REAL

avgerage_wavefront(4)

This value returns the minimum wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.

REAL

rms_wavefront(4)

This value returns the root mean squared wavefront value calculated both before and after the optimization process is done. See the remarks listed below for a description of the use of each offset.

INTEGER

This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.

Error Conditions:

See the Status Messages for information on any error values returned by this function.

The offsets in the returned values bandwidth, profile, maximum_wavefront, average_wavefront, and rms_wavefront have the following uses:

Offset	Method	Description

1	Cuthill-McKee	This offset will list the value calculated when the Cuthill-McKee method is selected but before the optimization process takes place.
2	Cuthill-McKee	This offset will list the value calculated when the Cuthill-McKee method is selected but after the optimization process takes place.
1	Gibbs-Poole-Stockmeyer	This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but before the optimization process takes place.
2	Gibbs-Poole-Stockmeyer	This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but after the optimization process takes place.
1	Both	This offset will list the value calculated when the Cuthill-McKee method is selected but before the optimization process takes place.
2	Both	This offset will list the value calculated when the Cuthill-McKee method is selected but after the optimization process takes place.
3	Both	This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but before the optimization process takes place.
4	Both	This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but after the optimization process takes place.

Offset

Method

Description

Cuthill-McKee

This offset will list the value calculated when the Cuthill-McKee method is selected but before the optimization process takes place.

Cuthill-McKee

This offset will list the value calculated when the Cuthill-McKee method is selected but after the optimization process takes place.

Gibbs-Poole-Stockmeyer

This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but before the optimization process takes place.

Gibbs-Poole-Stockmeyer

This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but after the optimization process takes place.

Both

This offset will list the value calculated when the Cuthill-McKee method is selected but before the optimization process takes place.

Both

This offset will list the value calculated when the Cuthill-McKee method is selected but after the optimization process takes place.

Both

This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but before the optimization process takes place.

Both

This offset will list the value calculated when the Gibbs-Poole-Stockmeyer method is selected but after the optimization process takes place.

This function will update the current viewport to reflect the renumbering of the optimized nodes and elements.