Part Sweep: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
 
(21 intermediate revisions by 2 users not shown)
Line 29: Line 29:


</translate>
</translate>
[[File:Part_Sweep_simple.png]]
[[File:Part_Sweep_simple.png|400px]]
<translate>
<translate>
<!--T:13-->
<!--T:47-->
{{Caption|A solid sweep generated from a single profile (A) distributed along a spine (B)}}
{{Caption|A solid sweep generated from a single profile (A) distributed along a spine (B)}}


Line 43: Line 43:
# In the ''Available Profiles'' list on the left select a profile and click on the right arrow to place it in the ''Selected profiles'' list on the right.
# In the ''Available Profiles'' list on the left select a profile and click on the right arrow to place it in the ''Selected profiles'' list on the right.
# Repeat if more than one profile is desired.
# Repeat if more than one profile is desired.
# The up and down arrows have no purpose, the profiles are used in the order in which they are positioned along the spine.
# The up and down arrows will reorder the list on the right. But this has no impact on the result. The position of the profiles along the spine determines in which order they are used.
# Click on the {{Button|Sweep Path}} button, then choose either mode of selection:
# Click on the {{Button|Sweep Path}} button, then choose either mode of selection:
#* ''Segment selection'': select one or more contiguous edges in the [[3D_view|3D view]] (press {{KEY|CTRL}} for multiple selection) and click {{Button|Done}}. The sweep will only be generated along the selected edges.
#* ''Segment selection'': select one or more contiguous edges in the [[3D_view|3D view]] (press {{KEY|CTRL}} for multiple selection) and click {{Button|Done}}. The sweep will only be generated along the selected edges.
Line 61: Line 61:
* [[App_Link|App Link]] objects linked to the appropriate object types and [[App_Part|App Part]] containers with the appropriate visible objects inside can also be used as profiles and paths. {{Version|0.20}}
* [[App_Link|App Link]] objects linked to the appropriate object types and [[App_Part|App Part]] containers with the appropriate visible objects inside can also be used as profiles and paths. {{Version|0.20}}


==Properties== <!--T:24-->
==Options== <!--T:46-->

See also: [[Property_editor|Property editor]].

A Part Sweep object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:

===Data===

{{TitleProperty|Sweep}}

* {{PropertyData|Sections|LinkList}}: lists the sections used.
* {{PropertyData|Spine|LinkSub}}: spine (path) to sweep along.
* {{PropertyData|Solid|Bool}}: true or false (default). True creates a Solid.
* {{PropertyData|Frenet|Bool}}: true or false (default). True uses Frenet algorithm.
* {{PropertyData|Transition|Enumeration}}: transition mode. Options are ''Transformed'', ''Right corner'' or ''Round corner''.


====Solid==== <!--T:25-->
====Solid==== <!--T:25-->


<!--T:7-->
<!--T:7-->
If "Solid" is set to "true", FreeCAD creates a solid, provided the profiles are of closed geometry; if set to "false", FreeCAD creates a face or (if more than one face) a shell for either open or closed profiles.
If "Solid" is set to "true", FreeCAD creates a solid, provided the profiles are closed; if set to "false", FreeCAD creates a face or a shell for either open or closed profiles.


====Frenet==== <!--T:26-->
====Frenet==== <!--T:26-->
Line 89: Line 75:


<!--T:8-->
<!--T:8-->
The "Frenet" property controls how the profile orientation changes as it follows along the sweep path. If "Frenet" is "false", the orientation of the profile is kept consistent from point to point. The resulting shape has the minimum possible twisting. Unintuitively, when a profile is swept along a helix, this results in the orientation of the profile slowly creep (rotate) as it follows the helix. Setting "Frenet" to true prevents such a creep.
The "Frenet" property controls how the profile orientation changes as it follows along the sweep path. If "Frenet" is "false", the orientation of the profile is kept consistent from point to point. The resulting shape has the minimum possible twisting. Unintuitively, when a profile is swept along a helix, this results in the orientation of the profile slowly creeping (rotating) as it follows the helix. Setting "Frenet" to true prevents this.


<!--T:14-->
<!--T:14-->
If "Frenet" is "true" the orientation of the profile is computed basing on local curvature and tangency vectors of the path. This keeps the orientation of the profile consistent when sweeping along a helix (because curvature vector of a straight helix is always pointing to its axis). However, when path is not a helix, the resulting shape can have strange looking twists sometimes. For more information, see [http://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet Serret formulas].
If "Frenet" is "true" the orientation of the profile is based on the local curvature and tangency vectors of the path. This keeps the orientation of the profile consistent when sweeping along a helix (because the curvature vector of a straight helix always points to its axis). However, when path is not a helix, the resulting shape can have strange looking twists sometimes. For more information, see [http://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet Serret formulas].


====Transition==== <!--T:27-->
====Transition==== <!--T:27-->


<!--T:6-->
<!--T:6-->
"Transition" sets the transition style of the Sweep at a joint in the path, if the path does not define the corner transition (for example where the path is a wire). The property is not exposed in the [[Task_panel|Task panel]] and can be found in properties after the Sweep has been created.
"Transition" sets the transition style of the Sweep at non-tangential joints in the path. The property is not exposed in the task panel and can be found in the [[Property_editor|properties]] after the Sweep has been created.


==Properties== <!--T:24-->
==Limitations==

<!--T:31-->
See also: [[Property_editor|Property editor]].

<!--T:32-->
A Part Sweep object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:

===Data=== <!--T:33-->

<!--T:34-->
{{TitleProperty|Sweep}}

<!--T:35-->
* {{PropertyData|Sections|LinkList}}: lists the sections used.
* {{PropertyData|Spine|LinkSub}}: spine (path) to sweep along.
* {{PropertyData|Solid|Bool}}: true or false (default). True creates a Solid.
* {{PropertyData|Frenet|Bool}}: true or false (default). True uses Frenet algorithm.
* {{PropertyData|Transition|Enumeration}}: transition mode. Options are ''Transformed'', ''Right corner'' or ''Round corner''.

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


===Vertex or point===
===Vertex or point=== <!--T:37-->


<!--T:38-->
A vertex or point may only be used as the first and/or last profile in the list of profiles.<br>
A vertex or point may only be used as the first and/or last profile.<br>
For example:
For example:
* You cannot Sweep from a circle to a point, to an ellipse.
* You cannot Sweep from a circle to a point, to an ellipse.
* You can however Sweep from a point to a circle to an ellipse to another point.
* You can however Sweep from a point to a circle to an ellipse to another point.


===Profiles===
===Profiles=== <!--T:39-->

<!--T:48-->
In one Sweep, all profiles (lines wires etc.) must be either open or closed.<br>
In one Sweep, all profiles (lines wires etc.) must be either open or closed.<br>
For example:
For example:
* FreeCAD cannot Sweep between one Part Circle and one Part Line.
* FreeCAD cannot Sweep between a Part Circle and a Part Line.

===Sketches=== <!--T:40-->

<!--T:41-->
* The profile may be created with a sketch. However only valid sketches will be available for selection in the task panel.
* The sketch must contain only one open or closed wire or line (can be multiple lines, if those lines are all connected as they are then a single wire).


===Draft Workbench objects===
===Draft Workbench objects=== <!--T:42-->


<!--T:43-->
Draft Workbench objects can be directly used as a profile.<br>
A profile can be a [[Draft_Workbench|Draft Workbench]] object.<br>
For example the following Draft objects can be used as profiles in a Part Sweep:
The following objects can be valid profiles:
* Point
* Point
* Line, Wire
* Line, Wire
* B-spline, Bezier Curve
* B-spline, Bézier Curve
* Circle, Ellipse
* Circle, Ellipse
* Rectangle, Polygon
* Rectangle, Polygon


===Part Workbench objects=== <!--T:44-->
===Sketches===

* The profile may be created with a sketch. However only a valid sketch will be shown in the list to be available for selection.
* The sketch must contain only one open or closed wire or line (can be multiple lines, if those lines are all connected as they are then a single wire).

===Part Workbench===


<!--T:45-->
The profile can be a valid Part geometric primitive which can be created with the [[Part_Primitives|Part Primitives]] command.<br>
A profile can be a Part object created with the [[Part_Primitives|Part Primitives]] command.<br>
For example the following Part geometric primitives can be a valid profile:
The following objects can be valid profiles:
* Point (Vertex)
* Point (Vertex)
* Line (Edge)
* Line (Edge)
Line 143: Line 154:


<!--T:15-->
<!--T:15-->
* Since Sweep is often used to create threads for screws, you should see [[Thread_for_Screw_Tutorial|Thread for Screw Tutorial]].
* A Sweep is often used to create threads for screws, see the [[Thread_for_Screw_Tutorial|Thread for Screw Tutorial]] for more information.





Latest revision as of 11:58, 8 October 2023

Part Sweep

Menu location
Part → Sweep...
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
Part Loft

Description

The Part Sweep command creates a face, a shell, or a solid shape from one or more profiles (cross-sections) distributed along a spine.

The Part Sweep command is similar to Part Loft with the addition of a spine.

A solid sweep generated from a single profile (A) distributed along a spine (B)

Usage

  1. There are several ways to invoke the command:
    • Press the Sweep... button.
    • Select the Part → Sweep... option from the menu.
  2. The Sweep task panel opens.
  3. In the Available Profiles list on the left select a profile and click on the right arrow to place it in the Selected profiles list on the right.
  4. Repeat if more than one profile is desired.
  5. The up and down arrows will reorder the list on the right. But this has no impact on the result. The position of the profiles along the spine determines in which order they are used.
  6. Click on the Sweep Path button, then choose either mode of selection:
    • Segment selection: select one or more contiguous edges in the 3D view (press CTRL for multiple selection) and click Done. The sweep will only be generated along the selected edges.
    • Complete path selection: switch to the Tree view, select the object to be used as spine, switch back to the task panel and click Done. The sweep will be generated along all the contiguous edges found in the object.
  7. Define options Solid and Frenet.
  8. Click OK.

Accepted geometry

  • Profiles: can be a point (vertex), line (edge), wire or face. Edges and wires may be either open or closed. There are various Limitations, see below.
  • Path: can be a line (edge) or a series of connected lines, a wire or various Part Workbench objects, Draft Workbench objects or a Sketch. The path may be either open or closed.

Options

Solid

If "Solid" is set to "true", FreeCAD creates a solid, provided the profiles are closed; if set to "false", FreeCAD creates a face or a shell for either open or closed profiles.

Frenet

The "Frenet" property controls how the profile orientation changes as it follows along the sweep path. If "Frenet" is "false", the orientation of the profile is kept consistent from point to point. The resulting shape has the minimum possible twisting. Unintuitively, when a profile is swept along a helix, this results in the orientation of the profile slowly creeping (rotating) as it follows the helix. Setting "Frenet" to true prevents this.

If "Frenet" is "true" the orientation of the profile is based on the local curvature and tangency vectors of the path. This keeps the orientation of the profile consistent when sweeping along a helix (because the curvature vector of a straight helix always points to its axis). However, when path is not a helix, the resulting shape can have strange looking twists sometimes. For more information, see Frenet Serret formulas.

Transition

"Transition" sets the transition style of the Sweep at non-tangential joints in the path. The property is not exposed in the task panel and can be found in the properties after the Sweep has been created.

Properties

See also: Property editor.

A Part Sweep object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

Sweep

  • DataSections (LinkList): lists the sections used.
  • DataSpine (LinkSub): spine (path) to sweep along.
  • DataSolid (Bool): true or false (default). True creates a Solid.
  • DataFrenet (Bool): true or false (default). True uses Frenet algorithm.
  • DataTransition (Enumeration): transition mode. Options are Transformed, Right corner or Round corner.

Limitations

Vertex or point

A vertex or point may only be used as the first and/or last profile.
For example:

  • You cannot Sweep from a circle to a point, to an ellipse.
  • You can however Sweep from a point to a circle to an ellipse to another point.

Profiles

In one Sweep, all profiles (lines wires etc.) must be either open or closed.
For example:

  • FreeCAD cannot Sweep between a Part Circle and a Part Line.

Sketches

  • The profile may be created with a sketch. However only valid sketches will be available for selection in the task panel.
  • The sketch must contain only one open or closed wire or line (can be multiple lines, if those lines are all connected as they are then a single wire).

Draft Workbench objects

A profile can be a Draft Workbench object.
The following objects can be valid profiles:

  • Point
  • Line, Wire
  • B-spline, Bézier Curve
  • Circle, Ellipse
  • Rectangle, Polygon

Part Workbench objects

A profile can be a Part object created with the Part Primitives command.
The following objects can be valid profiles:

  • Point (Vertex)
  • Line (Edge)
  • Helix, Spiral
  • Circle, Ellipse
  • Regular Polygon
  • Plane (Face)

Links