Difference between revisions of "Controlling FEA Output"

From OSUPDOCS
Jump to navigation Jump to search
 
(31 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 ==  


The <tt>Output</tt> command is used to determine what FEA calculation results are in the output file. The format is
The <tt>Output</tt> command is used to determine what FEA calculation results are in the output file. The format is
  <pre>Output #1,#2,&lt;#3,#4&gt;,&lt;#5,#6&gt;,...</pre>
  <pre>Output (prop1),(out1),<(prop2)>,<(out2)>,...</pre>
where the arguments are given in pairs: (#1,#2), (#3,#4), <i>etc</i>.; the first number 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> - output nodal displacements.
#<tt>forces</tt> - output nodal forces calculated in each element.
#<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> - output average stresses at the nodal points.
#<tt>reactivities</tt> - output reaction forces at all nodes with fixed boundary conditions.
#<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:


# <tt>&quot;displacements&quot;</tt> to output nodal displacements.
* <tt>yes</tt> - fully output the preceding option. Fully output means to output all nodal results and all element results.
#<tt>&quot;forces&quot;</tt> to output nodal forces calculated in each element.
* <tt>no</tt> - completely omit the preceding option.
#<tt>&quot;elementstresses&quot;</tt> to output all components of stress calculated in each element and surface tractions in each <a href="imperfect.html">interface</a> elements.
* <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').
#<tt>&quot;nodalstresses&quot;</tt> to output average stresses at the nodal points.
#<tt>&quot;reactivities&quot;</tt> to output reaction forces at all nodes with fixed boundary conditions.
#<tt>&quot;energy&quot;</tt> to output strain energy of each element and the total strain energy.


Each output option is followed by an option that determines what is included in the option file. These options are:
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.


* <tt>&quot;yes&quot;</tt> means fully output the preceding option. Fully option means to output all nodal results are all element results.
=== Selecting Nodes ===
* <tt>&quot;no&quot;</tt> means to completely omit the preceding option.
* <tt>&quot;selected&quot;</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.


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


You can select nodes for any output option using the <tt>&quot;selected&quot;</tt> style with the following commands:
; SelectLine command
: The <tt>SelectLine</tt> command is used to select all nodes near a line and it is available in two versions:
: <pre>SelectLine (x1),(y1),(x2),(y2),<(tolerance)></pre>
: or
: <pre>SelectLine (id)</pre>
: where
:* (<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 [[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]].
; SelectPoint command
: The <tt>SelectPoint</tt> command is used to select a single node and it is available in two versions:
: <pre>SelectPoint (x),(y)</pre>
: or
: <pre>SelectPoint (id)</pre>
: where
:* (<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.
; Select command
: 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 ==


The <tt>Output</tt> and <tt>Select</tt> commands are used to determine what FEA calculation results are in the output file. The format within the [[FEA Input Files#Main Header|main header]] is:
The <tt>Output</tt> and <tt>Select</tt> commands are used to determine what FEA calculation results are in the output file. The format within the [[FEA Input Files#Header|header]] is:


  <pre><Output>YYYYNY</Output>
  <pre><Output>YYYYNY</Output>
Line 34: Line 56:
<Select node='23'></pre>
<Select node='23'></pre>


The text of the <tt>Output</tt> command has 1 to 6 letters, each of which must be 'Y', 'C', or 'N' &emdash; 'Y' means that result is fully included in the file; 'C' means that result is conditionally included only if it is relevant to one of a set of preselected nodes; 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#Main Header|main header]] using its <tt>node</tt> attribute to specify the node by number.
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 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]].

Latest revision as of 09: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.