PartDesign AdditivePipe: Difference between revisions

From FreeCAD Documentation
m (Changed section to 'Usage')
No edit summary
(18 intermediate revisions by 7 users not shown)
Line 3: Line 3:
<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav
|[[PartDesign AdditiveLoft|Additive loft]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_CompPrimitiveAdditive|Create an additive primitive]]
|[[PartDesign_CompPrimitiveAdditive|Create an additive primitive]]
|[[PartDesign_Workbench|PartDesign]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign AdditiveLoft.png
|IconL=PartDesign_AdditiveLoft.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign_CompPrimitiveAdditive.png
|IconR=PartDesign_CompPrimitiveAdditive.png
|IconC=Workbench_PartDesign.svg
}}
}}


Line 14: Line 14:
{{GuiCommand
{{GuiCommand
|Name=PartDesign AdditivePipe
|Name=PartDesign AdditivePipe
|Workbenches=[[PartDesign Workbench|PartDesign]]
|MenuLocation=PartDesign → Additive pipe
|MenuLocation=PartDesign → Additive pipe
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|Version=0.17
|Version=0.17
|SeeAlso=[[PartDesign AdditiveLoft|PartDesign Additive Loft]]
|SeeAlso=[[PartDesign_AdditiveLoft|PartDesign Additive Loft]], [[PartDesign_SubtractivePipe|PartDesign Subtractive Pipe]]
}}
}}


Line 31: Line 31:
''On the left: cross-sections (A) and (B) to be swept along path (C); resulting Additive pipe on the right.''
''On the left: cross-sections (A) and (B) to be swept along path (C); resulting Additive pipe on the right.''


==Usage== <!--T:6-->
==Usage== <!--T:18-->

<!--T:6-->
The example image above shows two different cross-section shapes. The text below will describe the procedure with a single shape only. This will achieve a part with the same cross-section along the whole path.
The example image above shows two different cross-section shapes. The text below will describe the procedure with a single shape only. This will achieve a part with the same cross-section along the whole path.


Line 38: Line 40:
#* one for the path, e.g two lines connected by a curve as in the image above,
#* one for the path, e.g two lines connected by a curve as in the image above,
#* one for the cross-section shape, e.g. a circle as the first shape in the image above.
#* one for the cross-section shape, e.g. a circle as the first shape in the image above.
# '''Arrange''' the two shapes in 3D correctly. The origin of the cross-section sketch must be placed onto the line of the path. The two sketches must be '''orthogonal'''. This can be done with the 'Map Mode' function (make both sketches visible with {{KEY|Space}}. Select the cross-section sketch. Select Properties/DataTab/MapMode. Click the appearing {{KEY|...}} button at the right side. In the Attachment Dialog select a vertex of the path sketch and select the correct mode to get the two sketches aligned correctly).
# '''Arrange''' the two shapes in 3D correctly. It is recommended to place the origin of the cross-section onto the line of the path. The two sketches should in most cases be '''orthogonal'''. This can be done with the 'Map Mode' function (make both sketches visible with {{KEY|Space}}. Select the cross-section sketch. Select Properties/DataTab/MapMode. Click the appearing {{KEY|...}} button at the right side. In the Attachment Dialog select a vertex of the path sketch and select the correct mode to get the two sketches aligned correctly).
# Press the {{KEY|[[Image:PartDesign AdditivePipe.png|24px]] '''Additive pipe'''}} button.
# Press the {{Button|[[Image:PartDesign_AdditivePipe.svg|24px]] [[PartDesign_AdditivePipe|Additive pipe]]}} button.
# In the '''Select feature''' dialog, select a sketch to be used cross-section and click {{KEY|OK}}.
# In the '''Select feature''' dialog, select a sketch to be used cross-section and click {{KEY|OK}}.
#* Alternatively, the cross-section sketch can be selected prior to pressing the Additive pipe button. In that case you will not get a "Select feature' dialog.
#* Alternatively, the cross-section sketch can be selected prior to pressing the Additive pipe button. In that case you will not get a "Select feature' dialog.
Line 50: Line 52:


<!--T:17-->
<!--T:17-->
To use more than one cross-section, start with the first cross-section sketch as described above. Then under '''Section transformation''' set the Transform mode to ''Multisection''; press {{KEY|Add Section}} then select a sketch in the 3D view. Repeat for each additional cross-section.
To use more than one cross-section, start with the first cross-section sketch as described above. Then under '''Section transformation''' set the Transform mode to ''Multisection''; press {{KEY|Add Section}} then select a sketch in the [[3D view]]. Repeat for each additional cross-section.


==Options== <!--T:8-->
==Options== <!--T:8-->
Line 64: Line 66:
** Create minimum possible twisting of profile. For more info, see [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret Formulas]
** Create minimum possible twisting of profile. For more info, see [https://en.wikipedia.org/wiki/Frenet%E2%80%93Serret_formulas Frenet-Serret Formulas]
* Auxiliary
* Auxiliary
** Specify secondary path to guide pipe
** Specify secondary path to guide pipe.
** For each point {{Emphasis|P}} along the sweep path, there will be a corresponding point {{Emphasis|Q}} on the auxiliary path.
** As the profile is swept, it will be transformed such that the {{Emphasis|PQ}} line is the normal of the sweep path.
** If {{Emphasis|Curvilinear}} is set, then the {{Emphasis|Q}} points are scaled proportionally along the sweep path, regardless of it's length.
* Binormal
* Binormal
** Specify binormal vector in X, Y and Z
** Specify binormal vector in X, Y and Z
Line 90: Line 95:
<!--T:12-->
<!--T:12-->
* Sketches used for cross-sections must form closed profiles.
* Sketches used for cross-sections must form closed profiles.
* The path can only be a single line.
* The path can only be from a single sketch, feature or ShapeBinder. In case you want to sweep along several sketches, use a (green) SubShapeBinder.
* The path must not contain branches or T-junctions etc. Loops are fine.
* The path must not contain branches or T-junctions etc. Loops are fine.
* It is not possible to use a vertex as cross-section.
* It is not possible to use a vertex as cross-section.
* the cross-section must be set perpendicular to the path in 3D (some other CAD systems consider the origin of the cross-section as the path and do not require to place that sketch explicitly).
* It can lead to issues if the cross-section is not perpendicular to the path in 3D (some other CAD systems consider the origin of the cross-section as the path and do not require to place that sketch explicitly).
* A cross-section cannot lie on the same plane as the one immediately preceding it.
* A cross-section cannot lie on the same plane as the one immediately preceding it.
* To better control the shape of the pipe, it is recommended that all the cross-sections have the same number of segments. For example, for a pipe between a rectangle and a circle, the circle may be broken down into 4 connected arcs.
* To better control the shape of the pipe, it is recommended that all the cross-sections have the same number of segments. For example, for a pipe between a rectangle and a circle, the circle may be broken down into 4 connected arcs.
Line 100: Line 105:
<!--T:14-->
<!--T:14-->
{{Docnav
{{Docnav
|[[PartDesign AdditiveLoft|Additive loft]]
|[[PartDesign_AdditiveLoft|Additive loft]]
|[[PartDesign_CompPrimitiveAdditive|Create an additive primitive]]
|[[PartDesign_CompPrimitiveAdditive|Create an additive primitive]]
|[[PartDesign_Workbench|PartDesign]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign AdditiveLoft.png
|IconL=PartDesign_AdditiveLoft.svg
|IconR=PartDesign_CompPrimitiveAdditive.png
|IconC=Workbench_PartDesign.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign_CompPrimitiveAdditive.png
}}
}}

<!--T:15-->
{{PartDesign Tools navi}}

<!--T:16-->
{{Userdocnavi}}


</translate>
</translate>
{{PartDesign Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Revision as of 08:30, 18 January 2021

PartDesign AdditivePipe

Menu location
PartDesign → Additive pipe
Workbenches
PartDesign
Default shortcut
None
Introduced in version
0.17
See also
PartDesign Additive Loft, PartDesign Subtractive Pipe

Description

Additive Pipe creates a solid in the active Body by sweeping one or more sketches (also referred to as cross-sections) along an open or closed path. If the Body already contains features, the additive pipe will be merged to them.

On the left: cross-sections (A) and (B) to be swept along path (C); resulting Additive pipe on the right.

Usage

The example image above shows two different cross-section shapes. The text below will describe the procedure with a single shape only. This will achieve a part with the same cross-section along the whole path.

  1. Create two separate sketches;
    • one for the path, e.g two lines connected by a curve as in the image above,
    • one for the cross-section shape, e.g. a circle as the first shape in the image above.
  2. Arrange the two shapes in 3D correctly. It is recommended to place the origin of the cross-section onto the line of the path. The two sketches should in most cases be orthogonal. This can be done with the 'Map Mode' function (make both sketches visible with Space. Select the cross-section sketch. Select Properties/DataTab/MapMode. Click the appearing ... button at the right side. In the Attachment Dialog select a vertex of the path sketch and select the correct mode to get the two sketches aligned correctly).
  3. Press the Additive pipe button.
  4. In the Select feature dialog, select a sketch to be used cross-section and click OK.
    • Alternatively, the cross-section sketch can be selected prior to pressing the Additive pipe button. In that case you will not get a "Select feature' dialog.
  5. In the Pipe parameters under Path to sweep along, press the Object button.
  6. Select the sketch to be used as path in the 3D view. In this case the whole sketch will be used as path.
    • Alternatively, single edges of the sketch can be selected by pressing Add Edge and selecting edges in the 3D view. Note that you must press the Add Edge for each edge again. You must select a continous line with no branches.
  7. The other settings should work with the default settings in most cases.
  8. Click OK.


To use more than one cross-section, start with the first cross-section sketch as described above. Then under Section transformation set the Transform mode to Multisection; press Add Section then select a sketch in the 3D view. Repeat for each additional cross-section.

Options

Section Transformation:

  • Select Constant to use a single profile
  • Select Multisection to use multiple profiles

Section Orientation:

  • Standard
    This keeps the cross section shape perpendicular to the path. This is the default setting.
  • Fixed
    • Orientation set by first profile and constant throughout. This deactivates the alignment to the path normal vector. That means that the cross-section shape will not rotate with the path. Sweep along a circle to see the effect.
  • Frenet
  • Auxiliary
    • Specify secondary path to guide pipe.
    • For each point P along the sweep path, there will be a corresponding point Q on the auxiliary path.
    • As the profile is swept, it will be transformed such that the PQ line is the normal of the sweep path.
    • If Curvilinear is set, then the Q points are scaled proportionally along the sweep path, regardless of it's length.
  • Binormal
    • Specify binormal vector in X, Y and Z

Corner Transition

  • Transformed
  • Right
  • Rounded

Properties

  • DataLabel: name given to the operation, this name can be changed at convenience.
  • DataRefine: true or false. If set to true, cleans the solid from residual edges left by features. See Part RefineShape for more details.
  • DataSections: lists the sections used.
  • DataSpine Tangent: true or false (default). True extends the path to include tangent edges.
  • DataAuxiliary Spine Tangent: true or false (default). True extends the auxiliary path to include tangent edges.
  • DataAuxiliary Curvelinear: true or false (default). True calculates normal between equidistant points on both spines.
  • DataMode: profile mode. See Options.
  • DataBinormal: binormal vector for corresponding orientation mode.
  • DataTransition: transition mode. Options are Transformed, Right Corner or Round Corner.
  • DataTransformation: Constant uses a single cross-section. Multisection uses two or more cross-sections. Linear, S-shape and Interpolation are currently not functional.

Limitations

  • Sketches used for cross-sections must form closed profiles.
  • The path can only be from a single sketch, feature or ShapeBinder. In case you want to sweep along several sketches, use a (green) SubShapeBinder.
  • The path must not contain branches or T-junctions etc. Loops are fine.
  • It is not possible to use a vertex as cross-section.
  • It can lead to issues if the cross-section is not perpendicular to the path in 3D (some other CAD systems consider the origin of the cross-section as the path and do not require to place that sketch explicitly).
  • A cross-section cannot lie on the same plane as the one immediately preceding it.
  • To better control the shape of the pipe, it is recommended that all the cross-sections have the same number of segments. For example, for a pipe between a rectangle and a circle, the circle may be broken down into 4 connected arcs.