Difference between revisions of "Controlling FEA Output"

From OSUPDOCS
Jump to navigation Jump to search
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
If FEA files, the <tt>Output</tt> command defines which results are written to the output text file. Some of the output options can be restricted to selected nodes.
If FEA files, the <tt>Output</tt> command defines which results are written to the output text file. Some of the output options can be restricted to selected nodes.
 
__TOC__
== Scripted Input Files ==  
== Scripted Input Files ==  


Line 9: Line 9:
where the arguments are given in pairs: (<tt>(prop1)</tt>,<tt>(out1)</tt>), (<tt>(prop2)</tt>,<tt>(out2)</tt>), <i>etc</i>.; each <tt>(prop)</tt> value gives a calculation result. The options are:
where the arguments are given in pairs: (<tt>(prop1)</tt>,<tt>(out1)</tt>), (<tt>(prop2)</tt>,<tt>(out2)</tt>), <i>etc</i>.; each <tt>(prop)</tt> value gives a calculation result. The options are:


# <tt>displacements</tt> to output nodal displacements.
# <tt>displacements</tt> - output nodal displacements.
#<tt>forces</tt> to output nodal forces calculated in each element.
#<tt>forces</tt> - output nodal forces calculated in each element.
#<tt>elementstresses</tt> to output all components of stress calculated in each element and surface tractions in each <a href="imperfect.html">interface</a> elements.
#<tt>elementstresses</tt> - output all components of stress calculated in each element and surface tractions in each [[FEA Elements#Interface Elements|interface element]].
#<tt>nodalstresses</tt> to output average stresses at the nodal points.
#<tt>nodalstresses</tt> - output average stresses at the nodal points.
#<tt>reactivities</tt> to output reaction forces at all nodes with fixed boundary conditions.
#<tt>reactivities</tt> - output reaction forces at all nodes with fixed boundary conditions.
#<tt>energy</tt> to output strain energy of each element and the total strain energy.
#<tt>energy</tt> - output strain energy of each element and the total strain energy.


Each <tt>(prop)</tt> option is followed by an <tt>(out)</tt> option that determines what is included in the output file. The options are:
Each <tt>(prop)</tt> option is followed by an <tt>(out)</tt> option that determines what is included in the output file. The options are:


* <tt>yes</tt> means fully output the preceding option. Fully output means to output all nodal results and all element results.
* <tt>yes</tt> - fully output the preceding option. Fully output means to output all nodal results and all element results.
* <tt>no</tt> means to completely omit the preceding option.
* <tt>no</tt> - completely omit the preceding option.
* <tt>selected</tt> means to only output result relevant to selected nodes, which are selected as described [[#Selecting Nodes|below]]. If no nodes are selected, this mode will result in no output for that option.
* <tt>selected</tt> - only output result relevant to selected nodes, which are selected as described [[#Selecting Nodes|below]]. If no nodes are selected, this mode will result in no output for that option. The <tt>&quot;reactivities&quot;</tt> and <tt>&quot;energy&quot;</tt> options can only be &quot;yes&quot; (or 'Y')  or &quot;no&quot; (or 'N'); if &quot;selected&quot; (or 'C') is used it will be treated as &quot;yes&quot; (or 'Y').
 
The default output settings will be &quot;yes&quot; (or 'Y') for all options except <tt>&quot;reactivities&quot;</tt>, which will be &quot;no&quot; (or 'N'). If you use an <tt>Output</tt> command, it only needs to enter those options you want to change from these default settings.


==== Selecting Nodes ====
=== Selecting Nodes ===


You can select nodes for any output option using the <tt>&quot;selected&quot;</tt> style with the following commands:
You can select nodes for any output option that uses the <tt>&quot;selected&quot;</tt> style with the following methods:


; SelectLine command
; SelectLine command
Line 32: Line 34:
: <pre>SelectLine (id)</pre>
: <pre>SelectLine (id)</pre>
: where
: where
:* (<tt>x1,y1</tt>)  and (<tt>x2,y2</tt>) give the coordinates (in mm) for the points at the beginning and end of the line (or <tt>(R,Z)</tt> coordinates if axisymmetric).
:* (<tt>x1,y1</tt>)  and (<tt>x2,y2</tt>) give the coordinates (in [[ConsistentUnits Command#Legacy and Consistent Units|length units]]) for the points at the beginning and end of the line (or (<tt>R,Z</tt>) coordinates if axisymmetric).
:* <tt>(tolerance)</tt> is an optional tolerance (in mm) to include nodes within that distance of the line. If omitted, a tolerance will set based on small fraction of the smallest element size in the mesh.
:* <tt>(tolerance)</tt> is an optional tolerance (in [[ConsistentUnits Command#Legacy and Consistent Units|length units]]) to include nodes within that distance of the line. If omitted, a tolerance will set based on small fraction of the smallest element size in the mesh.
:* <tt>(id)</tt> is the <tt>id</tt> of a previously defined [[Path Command|path]].
:* <tt>(id)</tt> is the <tt>id</tt> of a previously defined [[Path Command|path]].
; SelectPoint command
; SelectPoint command
Line 41: Line 43:
: <pre>SelectPoint (id)</pre>
: <pre>SelectPoint (id)</pre>
: where
: where
:* (<tt>x,y</tt>) gives the coordinates (in mm) for a point (or <tt>(R,Z)</tt> coordinates if axisymmetric). The node closest to that point will be selected.
:* (<tt>x,y</tt>) gives the coordinates (in [[ConsistentUnits Command#Legacy and Consistent Units|length units]]) for a point (or (<tt>R,Z</tt>) coordinates if axisymmetric). The node closest to that point will be selected.
:* <tt>(id)</tt> is a previously defined [[Keypoint Command|key point]]. The node at that key point will be selected.
:* <tt>(id)</tt> is a previously defined [[Keypoint Command|key point]]. The node at that key point will be selected.
; Select command
; Select command
: The <tt>Select</tt> command (on a line by itself with no arguments) can be used within a [[FixLine Command]] to select all nodes on the defined line or within a [[FixPoint Command]] to select a single node.
: A [[FEA Boundary Conditions#Selecting Nodes|<tt>Select</tt> command]] (on a line by itself with no arguments) can be used within [[FEA Boundary Conditions|FixLine or FixPoint Commands]] to select all nodes on the defined line or the single node at the defined point.


== XML Input Files ==
== XML Input Files ==
Line 56: Line 58:
The text of the <tt>Output</tt> command has 1 to 6 letters, each of which must be 'Y', 'C', or 'N' &mdash; 'Y' means that result is fully included in the file; 'C' means that result is conditionally included only if it is relevant to a preselected node; and 'N' means that result is not included in the file. The six output options are listed [[#Scripted Input Files|above]].
The text of the <tt>Output</tt> command has 1 to 6 letters, each of which must be 'Y', 'C', or 'N' &mdash; 'Y' means that result is fully included in the file; 'C' means that result is conditionally included only if it is relevant to a preselected node; and 'N' means that result is not included in the file. The six output options are listed [[#Scripted Input Files|above]].


To preselect nodes for the 'C' option, include one or mode <tt>Select</tt> commands in the [[FEA Input Files#Header|header]] using its <tt>node</tt> attribute to specify the node by number. This method, however, is typically not very useful. A better way to select nodes in <tt>XML</tt> files is to select them using [[BCLine Command|BCLine]] or [[BCPt Command|BCPt]] commands.
To preselect nodes for the 'C' option, include one or mode <tt>Select</tt> commands in the [[FEA Input Files#Header|header]] using its <tt>node</tt> attribute to specify the node by number. This method, however, is typically not very useful. A better way to select nodes in <tt>XML</tt> files is to select them using a [[FEA Boundary Conditions#Selecting Nodes|<tt>select='1'</tt> attribute]] on [[FEA Boundary Conditions#XML Input Files|BCLine or BCPt Commands]] used for create [[FEA Boundary Conditions|boundary conditions]].
 
== Notes ==
 
# If no <tt>Output</tt> command is used, the default output will be &quot;yes&quot; (or 'Y') for all options except <tt>&quot;reactivities&quot;</tt>, which will be &quot;no&quot; (or 'N'). If you use an <tt>Output</tt> command, it only needs to enter those options you want to change for these default settings.
# The <tt>&quot;reactivities&quot;</tt> and <tt>&quot;energy&quot;</tt> options can only be &quot;yes&quot; (or 'Y')  or &quot;no&quot; (or 'N'); if &quot;selected&quot; (or 'C') is used it will be treated as &quot;yes&quot; (or 'Y').

Latest revision as of 08:04, 27 November 2015

If FEA files, the Output command defines which results are written to the output text file. Some of the output options can be restricted to selected nodes.

Scripted Input Files

The Output command is used to determine what FEA calculation results are in the output file. The format is

Output (prop1),(out1),<(prop2)>,<(out2)>,...

where the arguments are given in pairs: ((prop1),(out1)), ((prop2),(out2)), etc.; each (prop) value gives a calculation result. The options are:

  1. displacements - output nodal displacements.
  2. forces - output nodal forces calculated in each element.
  3. elementstresses - output all components of stress calculated in each element and surface tractions in each interface element.
  4. nodalstresses - output average stresses at the nodal points.
  5. reactivities - output reaction forces at all nodes with fixed boundary conditions.
  6. energy - output strain energy of each element and the total strain energy.

Each (prop) option is followed by an (out) option that determines what is included in the output file. The options are:

  • yes - fully output the preceding option. Fully output means to output all nodal results and all element results.
  • no - completely omit the preceding option.
  • selected - only output result relevant to selected nodes, which are selected as described below. If no nodes are selected, this mode will result in no output for that option. The "reactivities" and "energy" options can only be "yes" (or 'Y') or "no" (or 'N'); if "selected" (or 'C') is used it will be treated as "yes" (or 'Y').

The default output settings will be "yes" (or 'Y') for all options except "reactivities", which will be "no" (or 'N'). If you use an Output command, it only needs to enter those options you want to change from these default settings.

Selecting Nodes

You can select nodes for any output option that uses the "selected" style with the following methods:

SelectLine command
The SelectLine command is used to select all nodes near a line and it is available in two versions:
SelectLine (x1),(y1),(x2),(y2),<(tolerance)>
or
SelectLine (id)
where
  • (x1,y1) and (x2,y2) give the coordinates (in length units) for the points at the beginning and end of the line (or (R,Z) coordinates if axisymmetric).
  • (tolerance) is an optional tolerance (in length units) to include nodes within that distance of the line. If omitted, a tolerance will set based on small fraction of the smallest element size in the mesh.
  • (id) is the id of a previously defined path.
SelectPoint command
The SelectPoint command is used to select a single node and it is available in two versions:
SelectPoint (x),(y)
or
SelectPoint (id)
where
  • (x,y) gives the coordinates (in length units) for a point (or (R,Z) coordinates if axisymmetric). The node closest to that point will be selected.
  • (id) is a previously defined key point. The node at that key point will be selected.
Select command
A Select command (on a line by itself with no arguments) can be used within FixLine or FixPoint Commands to select all nodes on the defined line or the single node at the defined point.

XML Input Files

The Output and Select commands are used to determine what FEA calculation results are in the output file. The format within the header is:

<Output>YYYYNY</Output>
<Select node='1'/>
<Select node='23'>

The text of the Output command has 1 to 6 letters, each of which must be 'Y', 'C', or 'N' — 'Y' means that result is fully included in the file; 'C' means that result is conditionally included only if it is relevant to a preselected node; and 'N' means that result is not included in the file. The six output options are listed above.

To preselect nodes for the 'C' option, include one or mode Select commands in the header using its node attribute to specify the node by number. This method, however, is typically not very useful. A better way to select nodes in XML files is to select them using a select='1' attribute on BCLine or BCPt Commands used for create boundary conditions.