FEM PostPipelineFromResult: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
 
(45 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu{{#translation:}}}}
<translate>
<translate>

<!--T:8-->
<!--T:8-->
{{Docnav
{{Docnav|[[FEM_PostApplyChanges|Post Apply changes]]|[[FEM_PostCreateWarpVectorFilter|Post Create warp vector filter]]|[[FEM_Module|FEM]]|IconL=FEM_PostApplyChanges.png|IconC=Workbench_FEM.svg|IconR=FEM_PostCreateWarpVectorFilter.png}}
|[[FEM_PostApplyChanges|Apply changes to pipeline]]
|[[FEM_PostFilterWarp|Warp filter]]
|[[FEM_Workbench|FEM]]
|IconL=FEM_PostApplyChanges.svg
|IconR=FEM_PostFilterWarp.svg
|IconC=Workbench_FEM.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=FEM PostPipelineFromResult|MenuLocation= Results → post pipeline from result||Workbenches=[[Fem Workbench|FEM]]|Shortcut=|SeeAlso=[[FEM_tutorial|FEM tutorial]]}}
|Name=FEM PostPipelineFromResult
|MenuLocation=Results → Post pipeline from result
|Workbenches=[[FEM_Workbench|FEM]]
|Version=0.17
|SeeAlso=[[FEM_ResultShow|FEM Result object]], [[FEM_tutorial|FEM tutorial]]
}}

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

<!--T:2-->
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-->

<!--T:4-->
# Select a result object.
# 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|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|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}}.

<!--T:16-->
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 box=== <!--T:24-->

<!--T:18-->
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=== <!--T:25-->


==Description== <!--T:2-->
<!--T:19-->
If you double-click on the scale, you get this settings dialog box:
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.


==Usage== <!--T:4-->
<!--T:20-->
* You need a valid result object in the {{KEY|[[Image:FEM_Analysis.png|24px]] [[FEM_Analysis|Analysis container]]}}, such as {{KEY|CalculiX_static_results}}.
* Select the result object
* Click [[Image:FEM_PostPipelineFromResult.png|24px]] button, or click on menu {{KEY|Results}} and item {{KEY|Post Pipeline from results}}. A new object called "Pipeline" will be added to your document; note if will appear outside of the Analysis container.
* Double click the new Pipeline object in the Model tree and select type of properties to display. Typical settings are: Mode: Select {{KEY|Surface}}, Field: I.e. {{KEY|Von Mises stress}} [[File:Pipeline.PNG]]
** Mode: How to draw the results
** Field: Which result property to draw
** Vector: If a property is a vector, you might restrict the data to an axis (X, Y, Z) or select Magnitude to use the vector value.
* If you see no model in the graphical area, go to {{KEY|Edit}}{{KEY|Preferences}}, select {{KEY|Display}} category and check a checkbox {{KEY|Enagle backlight color}}
* If you double-click the scale, you can modify display properties.
[[File:SIMTUT 05.PNG]]
[[File:SIMTUT 05.PNG]]
**Gradient: You can select reversed order of the default color gradient or either Black-White or White-Black.
**Parameter range: Minimum and maximum values are filled-in automatically, when you select a property to evaluate on the {{KEY|Pipeline}} object; you can modify them, however make sure you know what you are doing. You can also amend number of displayed labels and number of decimal places to be displayed.


==Limitations== <!--T:5-->
<!--T:21-->
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.


<!--T:6-->
===Property Editor=== <!--T:22-->
Once again, 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.


<!--T:7-->
<!--T:23-->
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:
This tool is {{Version|0.17}}
* {{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.
** '''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.


<!--T:3-->
<br />


<!--T:9-->
<!--T:9-->
{{Docnav
{{Docnav|[[FEM_PostApplyChanges|Post Apply changes]]|[[FEM_PostCreateWarpVectorFilter|Post Create warp vector filter]]|[[FEM_Module|FEM]]|IconL=FEM_PostApplyChanges.png|IconC=Workbench_FEM.svg|IconR=FEM_PostCreateWarpVectorFilter.png}}
|[[FEM_PostApplyChanges|Apply changes to pipeline]]
|[[FEM_PostFilterWarp|Warp filter]]
|[[FEM_Workbench|FEM]]
|IconL=FEM_PostApplyChanges.svg
|IconR=FEM_PostFilterWarp.svg
|IconC=Workbench_FEM.svg
}}


</translate>
</translate>
{{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.