Sketcher BSplineIncreaseKnotMultiplicity: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
No edit summary
 
(32 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:11-->
<!--T:11-->
{{Docnav
{{Docnav|[[Sketcher_BSplineIncreaseDegree|Increase degree]]|[[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_BSplineIncreaseDegree.svg|IconC=Workbench_Sketcher.svg|IconR=Sketcher_BSplineDecreaseKnotMultiplicity.svg}}
|[[Sketcher_BSplineDecreaseDegree|Decrease B-spline degree]]
|[[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_BSplineDecreaseDegree.svg
|IconR=Sketcher_BSplineDecreaseKnotMultiplicity.svg
|IconC=Workbench_Sketcher.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Sketcher BSplineIncreaseKnotMultiplicity
|Name=Sketcher BSplineIncreaseKnotMultiplicity
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher B-spline tools → Increase knot multiplicity
|MenuLocation=Sketch → Sketcher B-spline tools → Increase knot multiplicity
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Version=0.17
|Version=0.17
|SeeAlso=[[Sketcher_BSplineKnotMultiplicity|Sketcher Show/hide B-spline knot multiplicity]], [[Sketcher_BSplineDecreaseKnotMultiplicity|Sketcher Decrease knot multiplicity]]
|SeeAlso=[[Sketcher CompCreateBSpline|Create B-spline]]
}}
}}


Line 16: Line 24:


<!--T:9-->
<!--T:9-->
Increases the knot multiplicity of a B-spline curve knot (see [https://en.wikipedia.org/wiki/B-spline B-spline]).
Increases the multiplicity of a B-spline knot. (See [[B-Splines|this page]] for more info about B-splines).

<!--T:15-->
B-splines are basically a combination of [[B-Splines#B.C3.A9zier_curves|Bézier curves]] (nicely explained in [https://www.youtube.com/watch?v=bE1MrrqBAl8 this] and [https://www.youtube.com/watch?v=xXJylM2S72s this] video). The points where two Bézier pieces are connected are called knots. A knot on a spline with degree ''d'' and with the multiplicity ''m'' means that the curve left and right to the knot has at least an equal ''n'' order derivative (called ''C''<sup>''n''</sup> continuity) whereas <math>n=d-m</math>.<br/>
Here is a cubic spline (<math>d=3</math>) whose knots have the multiplicity 1. The multiplicity is indicated by the number in parentheses. The indication can be changed using the toolbar button {{Button|[[File:Sketcher_BSplineKnotMultiplicity.svg|24px]] [[Sketcher_BSplineKnotMultiplicity|Show/hide B-spline knot multiplicity]]}}:


</translate>
</translate>
[[File:Sketcher_KnotMultiplicity_multiplicity1.png|400px]]
[[File:sketcher_SampleBSplineIncreaseKnotMultiplicity.png]]
<translate>
<translate>
<!--T:10-->
<!--T:16-->
{{Caption|B-spline curve showing increasing knot multiplicity.}}
{{Caption|B-spline where both knots have the multiplicity 1.}}


==How to use== <!--T:5-->
<!--T:17-->
A multiplicity of 3 will change this spline so that even the first order derivatives are not equal (''C''<sup>0</sup> continuity). Here is the same spline where the left's knot multiplicity was increased to 3:
# Select a B-spline knot and apply.


</translate>
[[File:Sketcher_KnotMultiplicity_multiplicity3.png|400px]]
<translate>
<!--T:18-->
{{Caption|B-spline from above with knot multiplicity 3. A control point was moved to show that the knot has ''C''<sup>0</sup> continuity.}}


<!--T:8-->
<!--T:19-->
A consequence of a higher multiplicity is that for the price of loosing continuity you gain local control. This means the change of one control point only affects the spline locally to this changed point. This can be seen in this example, where the spline from the first image above was taken and its second control point from the right side was moved up:
{{Docnav|[[Sketcher_BSplineIncreaseDegree|Increase degree]]|[[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_BSplineIncreaseDegree.svg|IconC=Workbench_Sketcher.svg|IconR=Sketcher_BSplineDecreaseKnotMultiplicity.svg}}


</translate>
<!--T:12-->
[[File:Sketcher_KnotMultiplicity_locality.png|400px]]
{{Sketcher Tools navi}}
<translate>
<!--T:20-->
{{Caption|Effect of locality due to different multiplicity.}}


<!--T:13-->
<!--T:21-->
One can see that the spline with knot multiplicity 1 is completely changed while the one with multiplicity 2 kept its form at its left side.
{{Userdocnavi}}

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

<!--T:14-->
# Select a B-spline knot, either:
#* Press the button {{Button|[[File:Sketcher_BSplineIncreaseKnotMultiplicity.svg|16px]] [[Sketcher_BSplineIncreaseKnotMultiplicity|Increase knot multiplicity]]}}.
#* Use the menu {{MenuCommand|Sketch → Sketcher B-spline tools → [[File:Sketcher_BSplineIncreaseKnotMultiplicity.svg|16px]] Increase knot multiplicity}}.


<!--T:8-->
{{Docnav
|[[Sketcher_BSplineDecreaseDegree|Decrease B-spline degree]]
|[[Sketcher_BSplineDecreaseKnotMultiplicity|Decrease knot multiplicity]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_BSplineDecreaseDegree.svg
|IconR=Sketcher_BSplineDecreaseKnotMultiplicity.svg
|IconC=Workbench_Sketcher.svg
}}


</translate>
</translate>
{{Sketcher_Tools_navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 15:50, 16 January 2023

Sketcher BSplineIncreaseKnotMultiplicity

Menu location
Sketch → Sketcher B-spline tools → Increase knot multiplicity
Workbenches
Sketcher
Default shortcut
None
Introduced in version
0.17
See also
Sketcher Show/hide B-spline knot multiplicity, Sketcher Decrease knot multiplicity

Description

Increases the multiplicity of a B-spline knot. (See this page for more info about B-splines).

B-splines are basically a combination of Bézier curves (nicely explained in this and this video). The points where two Bézier pieces are connected are called knots. A knot on a spline with degree d and with the multiplicity m means that the curve left and right to the knot has at least an equal n order derivative (called Cn continuity) whereas .
Here is a cubic spline () whose knots have the multiplicity 1. The multiplicity is indicated by the number in parentheses. The indication can be changed using the toolbar button Show/hide B-spline knot multiplicity:

B-spline where both knots have the multiplicity 1.

A multiplicity of 3 will change this spline so that even the first order derivatives are not equal (C0 continuity). Here is the same spline where the left's knot multiplicity was increased to 3:

B-spline from above with knot multiplicity 3. A control point was moved to show that the knot has C0 continuity.

A consequence of a higher multiplicity is that for the price of loosing continuity you gain local control. This means the change of one control point only affects the spline locally to this changed point. This can be seen in this example, where the spline from the first image above was taken and its second control point from the right side was moved up:

Effect of locality due to different multiplicity.

One can see that the spline with knot multiplicity 1 is completely changed while the one with multiplicity 2 kept its form at its left side.

Usage

  1. Select a B-spline knot, either: