prenergy

Results.prenergy(energytype='', cname1='', cname2='', cname3='', cname4='', cname5='', cname6='', **kwargs)

Prints the total energies of a model or the energies of the specified components.

Mechanical APDL Command: PRENERGY

Parameters:

energytypestr

Type of energies to be printed:

• ALL - All energies are printed: potential, kinetic, artificial hourglass/drill stiffness, contact stabilization energy, and artificial stabilization energy when applicable. This is the default.

• SENE - Potential energy (stiffness energy).

• KENE - Kinetic energy.

• DENE - Damping energy.

• WEXT - Work done by external loads.

cname1str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

cname2str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

cname3str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

cname4str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

cname5str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

cname6str

Component names for energies of the components printout.

If Cname1 is blank, the total energies are listed.

If Cname1 = ALL, the energies are listed for all selected components.

If Cname1 is neither blank nor ALL, it is the name of an existing component. The energies are listed for up to 6 selected components named in Cname1 to Cname6.

Returns

——-

str

Str object with the command console output.

This object also has the extra methods:

to_list(),

to_array() (only on listing commands) and

to_dataframe() (only if Pandas is installed).

NOTE: If you use these methods, you might

obtain a lower precision than using Mesh methods.

For more information visit Postprocessing.

Notes

The prenergy command prints out either the total energies of the entire model or the energies of the components depending on the Cname1 specification.

Only existing components based on elements (defined with the cm command) are supported when component energies are listed.

Damping energy (DENE) and work done by external loads (WEXT) are available only if the following were set prior to the analysis solution: EngCalc = YES on the trnopt, hrout or mxpand command; and Item = VENG, ESOL, or ALL on the outres command.

If EngCalc = YES on the hrout or mxpand command, average, amplitude, and peak values are returned for potential (SENE) and kinetic (KENE) energies.

The energy values can be retrieved using the get command with Entity = PRENERGY.

This command applies to structural elements only.