Mesh FromPartShape: Difference between revisions

From FreeCAD Documentation
m (wording)
(ordinate <!--T:xx-->)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:18-->
<!--T:1-->
{{Docnav|[[Mesh Export|Export Mesh]]|[[Mesh CurvaturePlot|Curvature Plot]]|[[Mesh_Workbench|Mesh]]|IconL=Mesh_ExportMesh.png|IconC=Workbench_Mesh.svg|IconR=Mesh_CurvaturePlot.png}}
{{Docnav|[[Mesh Export|Export Mesh]]|[[Mesh CurvaturePlot|Curvature Plot]]|[[Mesh_Workbench|Mesh]]|IconL=Mesh_ExportMesh.png|IconC=Workbench_Mesh.svg|IconR=Mesh_CurvaturePlot.png}}


Line 12: Line 12:
==Usage== <!--T:4-->
==Usage== <!--T:4-->


<!--T:19-->
<!--T:5-->
There are two methods:
There are two methods:
# Either select the shape object, then choose {{KEY| Meshes}} → {{KEY|[[Image:Mesh_Mesh_from_Shape.svg|32px]] Create Mesh from shape...}} from the top menu.
# Either select the shape object, then choose {{KEY| Meshes}} → {{KEY|[[Image:Mesh_Mesh_from_Shape.svg|32px]] Create Mesh from shape...}} from the top menu.
# Just selecting {{KEY| Meshes}} → {{KEY|[[Image:Mesh_Mesh_from_Shape.svg|32px]] Create Mesh from shape...}} will give you an additional menu to choose your shape to mesh.
# Just selecting {{KEY| Meshes}} → {{KEY|[[Image:Mesh_Mesh_from_Shape.svg|32px]] Create Mesh from shape...}} will give you an additional menu to choose your shape to mesh.


<!--T:18-->
<!--T:6-->
In both cases you get a menu that asks for the mesher program to use and its settings.<br/>
In both cases you get a menu that asks for the mesher program to use and its settings.<br/>
The settings you make there will be stored and used as default for the next time you create a mesh from a shape. {{Version|0.19}}.
The settings you make there will be stored and used as default for the next time you create a mesh from a shape. {{Version|0.19}}.


==Mesher program== <!--T:16-->
==Mesher program== <!--T:7-->


<!--T:17-->
<!--T:8-->
You can choose one of these 3 mesher programs:
You can choose one of these 3 mesher programs:


===Standard Mesher=== <!--T:13-->
===Standard Mesher=== <!--T:9-->


<!--T:7-->
<!--T:10-->
[[Image:Mesh_Mesher_Standard.jpg]]
[[Image:Mesh_Mesher_Standard.jpg]]


<!--T:8-->
<!--T:11-->
You can change these settings:
You can change these settings:
* {{MenuCommand|Surface deviation}}: Maximal [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 linear deflection] of a mesh section from the surface of the object
* {{MenuCommand|Surface deviation}}: Maximal [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 linear deflection] of a mesh section from the surface of the object
Line 39: Line 39:
* {{MenuCommand|Define segments by face colors}}: If checked, mesh segments will be grouped according to the color of the object faces. These groups will be exported for mesh output formats supporting this feature (e.g. the format [https://en.wikipedia.org/wiki/Wavefront_.obj_file OBJ]).
* {{MenuCommand|Define segments by face colors}}: If checked, mesh segments will be grouped according to the color of the object faces. These groups will be exported for mesh output formats supporting this feature (e.g. the format [https://en.wikipedia.org/wiki/Wavefront_.obj_file OBJ]).


===Mefisto Mesher=== <!--T:14-->
===Mefisto Mesher=== <!--T:12-->


<!--T:9-->
<!--T:13-->
[[Image:Mesh_Mesher_Mefisto.jpg]]
[[Image:Mesh_Mesher_Mefisto.jpg]]


<!--T:10-->
<!--T:14-->
The only setting is:
The only setting is:
*{{MenuCommand|Maximum edge length}}: If this number is smaller the mesh becomes finer. The smallest value is 0.
*{{MenuCommand|Maximum edge length}}: If this number is smaller the mesh becomes finer. The smallest value is 0.
Line 50: Line 50:
===Netgen Mesher=== <!--T:15-->
===Netgen Mesher=== <!--T:15-->


<!--T:11-->
<!--T:16-->
[[Image:Mesh_Mesher_Netgen.jpg]]
[[Image:Mesh_Mesher_Netgen.jpg]]


<!--T:12-->
<!--T:17-->
You can choose between mesh {{MenuCommand|Fineness }} being:
You can choose between mesh {{MenuCommand|Fineness }} being:
*{{MenuCommand|Very coarse}}
*{{MenuCommand|Very coarse}}
Line 66: Line 66:
:{{MenuCommand|Element per curvature radius}}: If this parameter is larger, the mesh becomes finer. A value in the range of 0.2-10.
:{{MenuCommand|Element per curvature radius}}: If this parameter is larger, the mesh becomes finer. A value in the range of 0.2-10.


<!--T:22-->
<!--T:18-->
For every {{MenuCommand|Fineness}} you can also choose:
For every {{MenuCommand|Fineness}} you can also choose:
*{{MenuCommand|Optimize surface}}: Whether an optimization of surface shape will be done.
*{{MenuCommand|Optimize surface}}: Whether an optimization of surface shape will be done.
Line 72: Line 72:
*{{MenuCommand|Quad dominated}}: Whether meshes will be arranged preferably using [https://en.wikipedia.org/wiki/Types_of_mesh#Two-dimensional quadrilateral faces].
*{{MenuCommand|Quad dominated}}: Whether meshes will be arranged preferably using [https://en.wikipedia.org/wiki/Types_of_mesh#Two-dimensional quadrilateral faces].


== Scripting == <!--T:5-->
== Scripting == <!--T:19-->


<!--T:16-->
<!--T:20-->
This tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
This tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
</translate>
</translate>
Line 82: Line 82:
<translate>
<translate>


<!--T:17-->
<!--T:21-->
Example:
Example:
</translate>
</translate>
Line 101: Line 101:
<translate>
<translate>


==Notes== <!--T:6-->
==Notes== <!--T:22-->
* Tutorial: [[Export_to_STL_or_OBJ|Export_to_STL_or_OBJ]]
* Tutorial: [[Export_to_STL_or_OBJ|Export_to_STL_or_OBJ]]


<!--T:19-->
<!--T:23-->
{{Docnav|[[Mesh Export|Export Mesh]]|[[Mesh CurvaturePlot|Curvature Plot]]|[[Mesh_Workbench|Mesh]]|IconL=Mesh_ExportMesh.png|IconC=Workbench_Mesh.svg|IconR=Mesh_CurvaturePlot.png}}
{{Docnav|[[Mesh Export|Export Mesh]]|[[Mesh CurvaturePlot|Curvature Plot]]|[[Mesh_Workbench|Mesh]]|IconL=Mesh_ExportMesh.png|IconC=Workbench_Mesh.svg|IconR=Mesh_CurvaturePlot.png}}


<!--T:20-->
<!--T:24-->
{{Mesh Tools navi}}
{{Mesh Tools navi}}


<!--T:21-->
<!--T:25-->
{{Userdocnavi}}
{{Userdocnavi}}



Revision as of 20:45, 6 August 2019

Mesh MeshFromShape‏‎

Menu location
Meshes → Create Mesh from Shape
Workbenches
Mesh
Default shortcut
None
Introduced in version
-
See also
None

Introduction

This command creates a mesh from a shape object.

Usage

There are two methods:

  1. Either select the shape object, then choose Meshes Create Mesh from shape... from the top menu.
  2. Just selecting Meshes Create Mesh from shape... will give you an additional menu to choose your shape to mesh.

In both cases you get a menu that asks for the mesher program to use and its settings.
The settings you make there will be stored and used as default for the next time you create a mesh from a shape. introduced in version 0.19.

Mesher program

You can choose one of these 3 mesher programs:

Standard Mesher

You can change these settings:

  • Surface deviation: Maximal linear deflection of a mesh section from the surface of the object
  • Angular deviation: Maximal angular deflection from one mesh section to the next section
  • Relative surface deviation: If checked, the maximal linear deviation of a mesh segment will be the specified Surface deviation multiplied by the length of the current mesh segment (edge)
  • Apply face colors to mesh: If checked, the mesh will get the face colors of the object
  • Define segments by face colors: If checked, mesh segments will be grouped according to the color of the object faces. These groups will be exported for mesh output formats supporting this feature (e.g. the format OBJ).

Mefisto Mesher

The only setting is:

  • Maximum edge length: If this number is smaller the mesh becomes finer. The smallest value is 0.

Netgen Mesher

You can choose between mesh Fineness being:

  • Very coarse
  • Coarse
  • Moderate
  • Fine
  • Very fine
  • User defined
For this you can set these values:
Mesh size grading: If this parameter is smaller, the mesh becomes finer. A value in the range of 0.1-1.
Element per edge: If this parameter is larger, the mesh becomes finer. A value in the range of 0.2-10.
Element per curvature radius: If this parameter is larger, the mesh becomes finer. A value in the range of 0.2-10.

For every Fineness you can also choose:

  • Optimize surface: Whether an optimization of surface shape will be done.
  • Second order elements: Whether second order elements will be generated.
  • Quad dominated: Whether meshes will be arranged preferably using quadrilateral faces.

Scripting

This tool can be used in macros and from the Python console by using the following function:

MeshPart.meshFromShape(Shape=Shape, MaxLength=520)

Example:

import FreeCAD, Draft, Arch, Mesh, MeshPart

Line = Draft.makeWire([FreeCAD.Vector(0, 0, 0),FreeCAD.Vector(2000, 2000, 0)])
Wall = Arch.makeWall(Line, width=150, height=3000)
FreeCAD.ActiveDocument.recompute()

Shape = Wall.Shape.copy(False)
Shape.Placement = Wall.getGlobalPlacement()

mesh_obj = FreeCAD.ActiveDocument.addObject("Mesh::Feature", "Mesh")
mesh_obj.Mesh = MeshPart.meshFromShape(Shape=Shape, MaxLength=520)
mesh_obj.ViewObject.DisplayMode = "Flat Lines"

Notes