add join and joined with example

Author: lottilotte

CHANGELOG.md

@@ -8,6 +8,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Unreleased
 
 ### Added
+* Added `compas_occ.geometry.NurbsCurve.join`.
+* Added `compas_occ.geometry.NurbsCurve.joined`.
 
 ### Changed
 

docs/_images/example_curve_joining_joined.png

@@ -0,0 +1,25 @@
+from compas.geometry import Point
+from compas.geometry import Polyline
+from compas_occ.geometry import OCCNurbsCurve
+from compas_view2.app import App
+
+points1 = [Point(0, 0, 0), Point(1, 1, 0), Point(3, 0, 0)]
+points2 = [Point(3, 0, 0), Point(4, -2, 0), Point(5, 0, 0)]
+
+curve1 = OCCNurbsCurve.from_interpolation(points1)
+curve2 = OCCNurbsCurve.from_interpolation(points2)
+
+joined = curve1.joined(curve2)
+curve1.join(curve2)
+
+# ==============================================================================
+# Visualisation
+# ==============================================================================
+
+view = App()
+
+view.add(Polyline(curve1.locus()), linewidth=3, linecolor=(1, 0, 0))
+view.add(Polyline(curve2.locus()), linewidth=3, linecolor=(0, 1, 0))
+view.add(Polyline(joined.locus()), linewidth=3, linecolor=(0, 0, 1))
+
+view.run()

docs/_images/example_curve_joining_separate.png

@@ -0,0 +1,14 @@
+********************************************************************************
+Curve Joining
+********************************************************************************
+
+.. figure:: /_images/example_curve_joining_separate.png
+    :figclass: figure
+    :class: figure-img img-fluid
+
+.. figure:: /_images/example_curve_joining_joined.png
+    :figclass: figure
+    :class: figure-img img-fluid
+
+.. literalinclude:: curve_joined.py
+    :language: python

docs/examples/curve_joining.py

@@ -19,6 +19,7 @@
 
 from OCC.Core.Geom import Geom_BSplineCurve
 from OCC.Core.GeomAPI import GeomAPI_Interpolate
+from OCC.Core.GeomConvert import GeomConvert_CompCurveToBSplineCurve
 
 from .curve import OCCCurve
 
@@ -493,3 +494,49 @@ def segmented(self, u, v, precision=1e-3):
         copy = self.copy()
         copy.segment(u, v, precision)
         return copy
+
+    def join(self, curve, precision=1e-4):
+        """Modifies this curve by joining it with another curve.
+
+        Parameters
+        ----------
+        curve : :class:`OCCNurbsCurve`
+            The curve to join.
+
+        precision : float, optional
+            Tolerance for continuity and multiplicity.
+
+        Returns
+        -------
+        None
+
+        """
+        converter = GeomConvert_CompCurveToBSplineCurve(self.occ_curve)
+        success = converter.Add(curve.occ_curve, precision)
+        if success:
+            self.occ_curve = converter.BSplineCurve()
+
+    def joined(self, curve, precision=1e-4):
+        """Returns a copy of joining this curve with another curve.
+
+        Parameters
+        ----------
+        curve : :class:`OCCNurbsCurve`
+            The curve to join.
+
+        precision : float, optional
+            Tolerance for continuity and multiplicity.
+
+        Returns
+        -------
+        :class:`OCCNurbsCurve`
+
+        """
+        copy = self.copy()
+        converter = GeomConvert_CompCurveToBSplineCurve(self.occ_curve)
+        success = converter.Add(curve.occ_curve, precision)
+        if success:
+            copy.occ_curve = converter.BSplineCurve()
+            return copy
+        else:
+            return None