Part Sweep: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
 
(50 intermediate revisions by 3 users not shown)
Line 23: Line 23:


<!--T:2-->
<!--T:2-->
The [[Image:Part_Sweep.svg|24px]] [[Part Sweep|Part Sweep]] tool is used to create a face, a shell, or a solid shape from one or more profiles (cross-sections) projected along a path.
The [[Image:Part_Sweep.svg|24px]] [[Part_Sweep|Part Sweep]] command creates a face, a shell, or a solid shape from one or more profiles (cross-sections) distributed along a spine.


<!--T:3-->
<!--T:3-->
The Part Sweep tool is similar to [[Image:Part_Loft.svg|24px]] [[Part Loft|Part Loft]] with the addition of a path to define the projection between profiles.
The Part Sweep command is similar to [[Image:Part_Loft.svg|24px]] [[Part_Loft|Part Loft]] with the addition of a spine.


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


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


<!--T:16-->
<!--T:16-->
# There are several ways to invoke the command:
# Press the {{KEY|[[Image:Part_Sweep.svg|16px]] '''Sweep'''}} button. This opens the Sweep parameters in the [[Task_panel|Task panel]].
#* Press the {{Button|[[Image:Part_Sweep.svg|16px]] [[Part_Sweep|Sweep...]]}} button.
# In the ''Available Profiles'' left column (previously ''Vertex/Edge/Wire/Face'' in v0.16), click on the element to be used as sweep profile, then click on the right arrow to place it in the ''Selected profiles'' right column (previously ''Sweep'' in v0.16). Repeat if more than one profile is desired. Use the up and down arrows to reorder the selected profiles.
#* Select the {{MenuCommand|Part → [[Image:Part_Sweep.svg|16px]] Sweep...}} option from the menu.
# Click on the {{KEY|Sweep Path}} button, then choose either mode of selection:
# The Sweep [[Task_panel|task panel]] opens.
#* ''Single segment selection'': select one or more contiguous edges in the [[3D view]] (press {{KEY|CTRL}} for multiple selection) and click {{KEY|Done}}. The sweep will only be generated along the selected edges.
# 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.
#* ''Complete path selection'': switch to the Model tab, select the 2D object to be used as path in the tree, switch back to the [[Task_panel|Task panel]] and click {{KEY|Done}}. The sweep will be generated along all the contiguous edges found in the 2D object.
# Repeat if more than one profile is desired.
# 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:
#* ''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.
#* ''Complete path selection'': switch to the [[Tree_view|Tree view]], select the object to be used as spine, switch back to the task panel and click {{Button|Done}}. The sweep will be generated along all the contiguous edges found in the object.
# Define options [[#Solid|Solid]] and [[#Frenet|Frenet]].
# Define options [[#Solid|Solid]] and [[#Frenet|Frenet]].
# Click {{Button|OK}}
# Click {{Button|OK}}.


===Accepted geometry=== <!--T:23-->
===Accepted geometry=== <!--T:23-->


<!--T:4-->
<!--T:4-->
* '''Profiles''': can be a point (vertex), line (Edge), wire or face. Edges and wires may be either open or closed. There are various [[Part_Sweep#Profile limitations and complications|profile limitations and complications]], see below, however the profiles may come from the Part Workbench primitives, Draft Workbench features and Sketches.
* '''Profiles:''' can be a point (vertex), line (edge), wire or face. Edges and wires may be either open or closed. There are various [[#Limitations|Limitations]], see below.


<!--T:5-->
<!--T:5-->
* '''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.
* '''Path''': can be a line (Edge) or series of connecting lines, wire or various Part Workbench primitives, Draft Workbench features or a Sketch. The path is often selected directly from the main model window, however it can also be selected from the [[Tree_view|Tree view]] (Model Tab of [[Combo View]]). The path can either be an entire appropriate shape or an appropriate sub-component of a more advance shape (for example, an edge of a [[Image:Part_Box.svg|24px]] [[Part Box]] could be selected as the path). The path may be either open or closed and will thus create either an open or closed Sweep. A closed path such as a Part Circle will result in a closed Sweep. For example a Sweep of a smaller circle around a path of a larger circle will create a torus.


<!--T:30-->
* [[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-->


===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-->


</translate>
</translate>
Line 67: 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-->

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

<!--T:38-->
A vertex or point may only be used as the first and/or last profile.<br>
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=== <!--T:39-->

<!--T:48-->
In one Sweep, all profiles (lines wires etc.) must be either open or closed.<br>
For example:
* 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=== <!--T:42-->

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


==Profile limitations and complications== <!--T:28-->
===Part Workbench objects=== <!--T:44-->


<!--T:9-->
<!--T:45-->
A profile can be a Part object created with the [[Part_Primitives|Part Primitives]] command.<br>
*A vertex or point
The following objects can be valid profiles:
** vertex or point may only be used as the first and/or last profile in the list of profiles.
* Point (Vertex)
***For example
* Line (Edge)
****you can not Sweep from a circle to a point, to a ellipse.
* Helix, Spiral
****However you could Sweep from a point to a circle to an ellipse to another point.
* Circle, Ellipse
*Open or closed geometry profiles can not be mixed in one single Sweep
* Regular Polygon
**In one Sweep, all profiles (lines wires etc.) must be either open or closed.
* Plane (Face)
***For example
****FreeCAD can not Sweep between one Part Circle and one default Part Line.
*Draft Workbench features
**Draft Workbench features can be directly used as a profile in FreeCAD 0.14 or later.
***For example the following Draft features can be used as profiles in a Part Sweep
****Draft Polygon.
****Draft Point, Line, wire,
****Draft B-spline, Bezier Curve
****Draft Circle, Ellipse, Rectangle
*PartDesign 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
**the profile can be a valid Part geometric primitive which can be created with the [[Part_Primitives|Part Primitives tool]]
***For example the following Part geometric primitives can be a valid profile
****Point (Vertex), Line (Edge)
****Helix, Spiral
****Circle, Ellipse
****Regular Polygon
****Plane (Face)


==Links== <!--T:29-->
==Links== <!--T:29-->


<!--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

Other languages:

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


Part
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Part_Sweep&oldid=1310016"