FEM PostPipelineFromResult: Difference between revisions

From FreeCAD Documentation
(→‎Property Editor: finis the description)
mNo edit summary
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu{{#translation:}}}}
<translate>
<translate>


Line 16: Line 15:
{{GuiCommand
{{GuiCommand
|Name=FEM PostPipelineFromResult
|Name=FEM PostPipelineFromResult
|MenuLocation= Results → Post pipeline from result
|MenuLocation=Results → Post pipeline from result
|Workbenches=[[FEM_Workbench|FEM]]
|Workbenches=[[FEM_Workbench|FEM]]
|Version=0.17
|Version=0.17
|SeeAlso=[[FEM_tutorial|FEM tutorial]]
|SeeAlso=[[FEM_ResultShow|FEM Result object]], [[FEM_tutorial|FEM tutorial]]
}}
}}

<!--T:14-->
'''* You need a valid result object in the {{KEY|[[Image:FEM_Analysis.svg|24px]] [[FEM_Analysis|Analysis container]]}}, such as {{KEY|CalculiX static results}}.'''


==Description== <!--T:12-->
==Description== <!--T:12-->


<!--T:2-->
<!--T:2-->
Pipeline is a result object, which creates a new graphical representation of FEM analysis results on the analysed part. It adds color scale and more display options.
Pipeline is a result object, which creates a new graphical representation of FEM analysis results on the analyzed part. It adds a color scale and display options.


==Usage== <!--T:13-->
==Usage== <!--T:13-->


<!--T:4-->
<!--T:4-->
# Select a result object
# Select a result object.
# Click [[Image:FEM_PostPipelineFromResult.svg|24px]] button, or click on menu {{MenuCommand|Results → Post Pipeline from result}}. A new object called "Pipeline" will be added to your analysis.
# Click the {{Button|[[Image:FEM_PostPipelineFromResult.svg|16px]] '''Post pipeline from result'''}} button, or select the {{MenuCommand|Results → [[Image:FEM_PostPipelineFromResult.svg|16px]] Post pipeline from result}} option from the menu.
# A new object called "Pipeline" is added to your analysis.
# Double-click the new Pipeline object in the [[tree view]] and select a display mode and the result field. For example for the mode ''Surface'' and the field ''Von Mises stress'' the pipeline will look like this:
# Double-click the new Pipeline object in the [[Tree_view|Tree view]] and select a display mode and the result field. For example for the mode {{Value|Surface}} and the field {{Value|Von Mises stress}} the pipeline will look like this:
[[File:Pipeline.PNG]]
[[File:Pipeline.PNG|500px]]


<!--T:15-->
If you see no model in the graphical area, go to and enable {{MenuCommand|Edit → Preferences → Display → 3D View → Rendering → Backlight color}}.
If you see no model in the graphical area, go to and enable {{MenuCommand|Edit → Preferences → Display → 3D View → Rendering → Backlight color}}.


<!--T:16-->
==Properties==
If you use a [https://en.wikipedia.org/wiki/International_System_of_Units SI]-derived FreeCAD [[Preferences_Editor#Units|unit system]], the values in the output scale are based on SI units as well. This means the displacement is in meter, the stress is in Pascal and the temperature is in Kelvin.


==Properties== <!--T:17-->
===Dialog===

This pipeline dialog has the following settings:
===Dialog box=== <!--T:24-->

<!--T:18-->
This pipeline dialog box has the following settings:
* '''Mode''': How to draw the results. The possible modes are
* '''Mode''': How to draw the results. The possible modes are
** '''Outline''': The outline of the result mesh. In fact is displays no results but only the borders of the mesh
** '''Outline''': The outline of the result mesh. In fact, it displays no results but only the borders of the mesh.
** '''Nodes''': The result mesh nodes
** '''Nodes''': The result mesh nodes.
** '''Surface''': This is the default and displays the surface of the result mesh.
** '''Surface''': This is the default and displays the surface of the result mesh.
** '''Surface with Edges''': Like '''Surface''' but with the mesh outline edges and the surface mesh node connection lines.
** '''Surface with Edges''': Like '''Surface''' but with the mesh outline edges and the surface mesh node connection lines.
* '''Field''': Which result property to draw
* '''Field''': Which result property to draw.
* '''Vector''': Is only active if the '''Field''' is a vector. You can select whether to display the vector ''Magnitude'' or its X, Y, Z components.
* '''Vector''': Is only active if the '''Field''' is a vector. You can select whether to display the vector ''Magnitude'' or its X, Y, Z components.


===Scale===
===Scale=== <!--T:25-->
If you double-click on the scale, you get this settings dialog:


<!--T:19-->
If you double-click on the scale, you get this settings dialog box:

<!--T:20-->
[[File:SIMTUT 05.PNG]]
[[File:SIMTUT 05.PNG]]


<!--T:21-->
and can modify these properties:
and you can modify these properties:
* '''Gradient''': You can select reversed order of the default color gradient, ''Red-White-Blue'', ''Black-White'' or ''White-Black''.
* '''Gradient''': You can select reversed order of the default color gradient, ''Red-White-Blue'', ''Black-White'' or ''White-Black''.
* '''Style''': The default option ''Flow'' uses the full color gradient range. The option ''Zero'' uses only the color gradient range starting form the color that would display the mean value to the maximum. Note that ''Zero'' fails in combination with ''Red-White-Blue''.
* '''Style''': The default option ''Flow'' uses the full color gradient range. The option ''Zero'' uses only the color gradient range starting form the color that would display the mean value to the maximum.
* '''Visibility''': The option ''Out grayed'' will color all mesh nodes whose values are outside the set minimum/maximum range in gray. The option ''Out transparent'' will make these mesh nodes transparent.
* '''Parameter range''': Minimum and maximum values are filled-in automatically. You can modify them, however make sure you know what you are doing. You can also change the number of displayed decimal places and the number of labels distributed over the parameter range.
* '''Parameter range''': Minimum and maximum values are filled-in automatically. You can modify them, however make sure you know what you are doing. You can also change the number of displayed decimal places and the number of labels distributed over the parameter range.


===Property Editor===
===Property Editor=== <!--T:22-->


<!--T:23-->
In the [[property editor]] you can set in the ''View'' tab the settings from the dialog. In the ''Data'' tab you can additionally set this:
In the [[Property_editor|property editor]] you can set in the ''View'' tab the settings from the dialog box. In the ''Data'' tab you can additionally set this:
* {{PropertyData|Mode}}: How the filters used in the pipeline will be treated. These modes are possible:
* {{PropertyData|Mode}}: How the filters used in the pipeline will be treated. These modes are possible:
** '''Serial''': In this mode every filter takes the previous filter as input. The order is hereby the order of creation. The first created filter takes the pipeline as input. Its '''Input''' property is therefore empty.
** '''Serial''': In this mode every filter takes the previous filter as input. The order is hereby the order of creation. The first created filter takes the pipeline as input. Its '''Input''' property is therefore empty.
** '''Parallel''': In this mode all filters take the pipeline as input.
** '''Parallel''': In this mode all filters take the pipeline as input.
** '''Custom''': {{Version|0.20}} This is the default and keeps the input of the filters as they are. Therefore it allows to have e.g. two filters that take the pipeline as input, and a third filter that takes one of the two filters as input.
** '''Custom''': {{Version|0.20}} This is the default and keeps the input of the filters as they are. Therefore it allows to have e.g. two filters that take the pipeline as input, and a third filter that takes one of the two filters as input.

==Limitations== <!--T:5-->

<!--T:6-->
Note that the Pipeline representation of the results (called VTK) on the displayed part is different from the color gradient results which are visible when you finish solution. Values in the gradient scale cannot be applied to the solution result object.




Line 89: Line 93:
{{FEM Tools navi{{#translation:}}}}
{{FEM Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 20:35, 22 November 2023

FEM PostPipelineFromResult

Menu location
Results → Post pipeline from result
Workbenches
FEM
Default shortcut
None
Introduced in version
0.17
See also
FEM Result object, FEM tutorial

Description

Pipeline is a result object, which creates a new graphical representation of FEM analysis results on the analyzed part. It adds a color scale and display options.

Usage

  1. Select a result object.
  2. Click the Post pipeline from result button, or select the Results → Post pipeline from result option from the menu.
  3. A new object called "Pipeline" is added to your analysis.
  4. Double-click the new Pipeline object in the Tree view and select a display mode and the result field. For example for the mode Surface and the field Von Mises stress the pipeline will look like this:

If you see no model in the graphical area, go to and enable Edit → Preferences → Display → 3D View → Rendering → Backlight color.

If you use a SI-derived FreeCAD unit system, the values in the output scale are based on SI units as well. This means the displacement is in meter, the stress is in Pascal and the temperature is in Kelvin.

Properties

Dialog box

This pipeline dialog box has the following settings:

  • Mode: How to draw the results. The possible modes are
    • Outline: The outline of the result mesh. In fact, it displays no results but only the borders of the mesh.
    • Nodes: The result mesh nodes.
    • Surface: This is the default and displays the surface of the result mesh.
    • Surface with Edges: Like Surface but with the mesh outline edges and the surface mesh node connection lines.
  • Field: Which result property to draw.
  • Vector: Is only active if the Field is a vector. You can select whether to display the vector Magnitude or its X, Y, Z components.

Scale

If you double-click on the scale, you get this settings dialog box:

and you can modify these properties:

  • Gradient: You can select reversed order of the default color gradient, Red-White-Blue, Black-White or White-Black.
  • Style: The default option Flow uses the full color gradient range. The option Zero uses only the color gradient range starting form the color that would display the mean value to the maximum.
  • Visibility: The option Out grayed will color all mesh nodes whose values are outside the set minimum/maximum range in gray. The option Out transparent will make these mesh nodes transparent.
  • Parameter range: Minimum and maximum values are filled-in automatically. You can modify them, however make sure you know what you are doing. You can also change the number of displayed decimal places and the number of labels distributed over the parameter range.

Property Editor

In the property editor you can set in the View tab the settings from the dialog box. In the Data tab you can additionally set this:

  • DataMode: How the filters used in the pipeline will be treated. These modes are possible:
    • Serial: In this mode every filter takes the previous filter as input. The order is hereby the order of creation. The first created filter takes the pipeline as input. Its Input property is therefore empty.
    • Parallel: In this mode all filters take the pipeline as input.
    • Custom: introduced in version 0.20 This is the default and keeps the input of the filters as they are. Therefore it allows to have e.g. two filters that take the pipeline as input, and a third filter that takes one of the two filters as input.