report_energy_xml


Purpose

Generate spreadsheet XML of grid point kinetic and potential energy tables.

Syntax

results = report_energy_xml(ST[,TAM[,CT][,off_diag_level][,FILENAME][,'nofile'])

Description

REPORT_ENERGY_XML generates an XML file FILENAME containing grid point kinetic and potential energy tables. Tables are generated for individual TAM.aset DOF as well as for groups of imat_ctraces in CT. A worksheet containing orthogonality breakout for all off-diagonal orthogonality values above OFF_DIAG_LEVEL is also created.

REPORT_ENERGY takes test shapes, ST, the test analysis model TAM (TAM.aset, TAM.oset, and TAM.mass must be supplied), and groups of coordinate traces, CT, and generates grid point Kinetic and Potential Energy Tables based on TAM.aset DOF: KE_ASET and SE_ASET, as well as Kinetic and Strain Energy tables based on groups defined in CT: KE_GROUP, SE_GROUP.

REPORT_ENERGY also gives a term-by-term listing for all off-diagonals of the test orthogonality matrix, Ott (calculated from Ott=ortho(st,TAM.aset,TAM.mass) ) above OFF_DIAG_LEVEL.

Inputs:
ST

imat_shp (usually test shapes)

TAM

Pretest TAM matrices

TAM.aset = imat_ctrace containing test DOF. If not suppplied, assumed to be all of the DOF in ST, and TAM.mass = [I].

TAM.mass = mass matrix reduced to test DOF. If not supplied,TAM.mass = [I].
TAM.stiffness = stiffness matrix reduced to test DOF. If not supplied, SE_ASET and SE_GROUP will not be generated.

FILENAME Output filename
CT

Groups of DOF defined as coordinate traces.CT{i} contains the ith group of coordinate traces. If CT is not included, then KE_GROUP and SE_GROUP will not be generated.

OFF_DIAG_LEVEL Minimum value of ortho(st,TAM.aset,TAM.mass) for listing contribution to off-diagonals of orthogonality matrix. Default = 10%.
'nofile' Do not export results to a file

 

Outputs:
RESULTS.Ott

ST (TAM) self orthogonality (ortho(st,TAM.mass,TAM.aset))

RESULTS.KE_ASET Kinetic Energy Table for each mode broken down for each DOF.
KE_ASET(jth mode) = (TAM.mass * st(j){TAM.aset}).*st(j){TAM.aset}
RESULTS.SE_ASET

Strain Energy Table for each mode broken down for each DOF.
SE_ASET(jth mode) = (TAM.stiffness * st(j){TAM.aset}).*st(j){TAM.aset}

RESULTS.KE_GROUP

Kinetic Energy for each mode broken down into defined groups

RESULTS.SE_GROUP

Strain Energy for each mode broken down into defined groups

RESULTS.OB

Sorted term-by-term contribution of off-diagonal terms of Ott

OB.sort

Sorted values of off-diagonal terms

OB.aset Sorted imat_ctraces corresponding to OB.sort
OB.mode1

Vector containing mode number 1

OB.mode2 Vector containing mode number 2

 

Examples

>> results = report_energy_xml(st,TAM,ct,10,’test_energy_report.xml’)

See Also

ortho, comparison_table, imat_shp, report_test_xml, ortho_breakout, pe_breakout