Release/2.0.0

.pre-commit-config.yaml

@@ -34,6 +34,7 @@ repos:
       types-requests==2.31.0,
       numpy==2.0.1,
       pytest==8.3.1,
+      websockets>=10.4,
       types-setuptools>=71.1.0.20240818
       ]
     args: [--config=pyproject.toml]

README.md

@@ -64,24 +64,59 @@ gantt
     title       diffCheck - general overview
     excludes    weekends
 
-    section Publication
-    Abstract edition                    :active, absed, 2024-03-01, 2024-03-15
-    Submission abstract ICSA            :milestone, icsaabs, 2024-03-15, 0d
-    Paper edition                       :paperd, 2024-10-01, 2024-10-30
-    Submission paper ICSA               :milestone, icsapap, 2024-10-30, 0d
-
-    section Code development
-    Backend development                 :backenddev, after icsaabs, 6w
-    Rhino/Grasshopper integration       :rhghinteg, after backenddev, 6w
-    Documentation & Interface           :docuint, after fabar, 3w
+    section Workshop
+    Workshop dryrun                         :milestone, crit, dryrun, 2025-09-15, 1d
+    Workshop in Boston                      :workshop, 2025-11-16, 2d
+
+    section Component development
+    Pose estimation                         :CD1, 2025-05-15, 1w
+    Communication w/ hardware               :CD2, after CD1, 3w
+    Pose comparison                         :CD3, after CD1, 3w
+    General PC manipulation                 :CD4, after CD1, 6w
+    Data analysis component                 :CD5, after CD3, 3w
+
+    section Workshop preparation
+    Workshop scenario                       :doc1, 2025-08-01, 1w
+    New compilation documentation           :doc2, after mac, 2w
+    New components documentation            :doc2, 2025-08-01, 4w
+    Development of special pipeline for data:doc3, after doc1, 3w
+
+    section Cross-platform
+    adaptation of CMake for mac compilation :mac, 2025-07-01, 3w
 
     section Prototype testing
-    Fabrication of AR Prototype         :crit, fabar, 2024-07-01, 2024-08-30
-    Fabrication of CNC Prototype        :crit, fabcnc, 2024-07-01, 2024-08-30
-    Fabrication of Robot Prototype      :crit, fabrob, 2024-07-01, 2024-08-30
-    Data collection and evaluation      :dataeval, after fabrob, 4w
+    Fabrication of iterative prototype      :fab, 2025-08-01, 2w
 ```
 
+
+
 ## How to contribute
 
 If you want to contribute to the project, please refer to the [contribution guidelines]([./CONTRIBUTING.md](https://diffcheckorg.github.io/diffCheck/contribute.html)).
+
+## Logic
+The logic of the workflow is currently as follows:
+
+```mermaid
+stateDiagram-v2
+    state "[breps to assemble]" as s1
+    state "scan of latest element placed" as s2
+    state "get pose of i-th brep" as s3
+    state "get pose of i-1-th brep" as s4
+    state "compute pose of i-1-th element from scan" as s5
+    state "compute pose difference" as s6
+    state "compute pose correction" as s7
+    state "assemble i-th-element" as s8
+    state "i += 1" as s9
+    [*]-->s2
+    s1-->s3
+    s1-->s4
+    s2-->s5
+    s5-->s6
+    s4-->s6
+    s6-->s7
+    s3-->s7
+    s7-->s8
+    s8-->s9
+    s9-->[*]
+```

src/gh/components/DF_http_listener/code.py

@@ -0,0 +1,136 @@
+#! python3
+
+from ghpythonlib.componentbase import executingcomponent as component
+import os
+import tempfile
+import requests
+import threading
+import Rhino
+import Rhino.Geometry as rg
+import scriptcontext as sc
+from diffCheck import df_gh_canvas_utils
+
+
+class DFHTTPListener(component):
+
+    def __init__(self):
+        try:
+            ghenv.Component.ExpireSolution(True)  # noqa: F821
+            ghenv.Component.Attributes.PerformLayout()  # noqa: F821
+        except NameError:
+            pass
+
+        df_gh_canvas_utils.add_button(ghenv.Component, "Load", 0, x_offset=60)  # noqa: F821
+        df_gh_canvas_utils.add_panel(ghenv.Component, "Ply_url", "https://github.com/diffCheckOrg/diffCheck/raw/refs/heads/main/tests/test_data/cube_mesh.ply", 1, 60, 20)  # noqa: F821
+
+    def RunScript(self,
+            i_load: bool,
+            i_ply_url: str):
+
+        prefix = 'http'
+
+        # initialize sticky variables
+        sc.sticky.setdefault(f'{prefix}_ply_url', None)  # last url processed
+        sc.sticky.setdefault(f'{prefix}_imported_geom', None)  # last geo imported from ply
+        sc.sticky.setdefault(f'{prefix}_status_message', "Waiting..")  # status message on component
+        sc.sticky.setdefault(f'{prefix}_prev_load', False)  # previous state of toggle
+        sc.sticky.setdefault(f'{prefix}_thread_running', False)  # is a background thread running?
+
+        def _import_job(url: str) -> None:
+
+            """
+            Downloads and imports a .ply file from a given URL in a background thread.
+            Background job:
+            - Downloads the .ply file from the URL
+            - Imports it into the active Rhino document
+            - Extracts the new geometry (point cloud or mesh)
+            - Cleans up the temporary file and document objects
+            - Updates sticky state and status message
+            - Signals to GH that it should re-solve
+
+            :param url: A string representing a direct URL to a .ply file (e.g. from GitHub or local server).
+                        The file must end with ".ply".
+            :returns: None
+            """
+
+            tmp = None
+            try:
+                if not url.lower().endswith('.ply'):
+                    raise ValueError("URL must end in .ply")
+
+                resp = requests.get(url, timeout=30)
+                resp.raise_for_status()
+                # save om temporary file
+                fn = os.path.basename(url)
+                tmp = os.path.join(tempfile.gettempdir(), fn)
+                with open(tmp, 'wb') as f:
+                    f.write(resp.content)
+
+                doc = Rhino.RhinoDoc.ActiveDoc
+                # recordd existing object IDs to detect new ones
+                before_ids = {o.Id for o in doc.Objects}
+
+                # import PLY using Rhino's API
+                opts = Rhino.FileIO.FilePlyReadOptions()
+                ok = Rhino.FileIO.FilePly.Read(tmp, doc, opts)
+                if not ok:
+                    raise RuntimeError("Rhino.FilePly.Read failed")
+
+                after_ids = {o.Id for o in doc.Objects}
+                new_ids = after_ids - before_ids
+                # get new pcd or mesh from document
+                geom = None
+                for guid in new_ids:
+                    g = doc.Objects.FindId(guid).Geometry
+                    if isinstance(g, rg.PointCloud):
+                        geom = g.Duplicate()
+                        break
+                    elif isinstance(g, rg.Mesh):
+                        geom = g.DuplicateMesh()
+                        break
+                # remove imported objects
+                for guid in new_ids:
+                    doc.Objects.Delete(guid, True)
+                doc.Views.Redraw()
+
+                # store new geometry
+                sc.sticky[f'{prefix}_imported_geom'] = geom
+                count = geom.Count if isinstance(geom, rg.PointCloud) else geom.Vertices.Count
+                if isinstance(geom, rg.PointCloud):
+                    sc.sticky[f'{prefix}_status_message'] = f"Loaded pcd with {count} pts"
+                else:
+                    sc.sticky[f'{prefix}_status_message'] = f"Loaded mesh wih {count} vertices"
+                ghenv.Component.Message = sc.sticky.get(f'{prefix}_status_message')  # noqa: F821
+
+            except Exception as e:
+                sc.sticky[f'{prefix}_imported_geom'] = None
+                sc.sticky[f'{prefix}_status_message'] = f"Error: {e}"
+            finally:
+                try:
+                    os.remove(tmp)
+                except Exception:
+                    pass
+                # mark thread as finished
+                sc.sticky[f'{prefix}_thread_running'] = False
+                ghenv.Component.ExpireSolution(True)  # noqa: F821
+
+        # check if the URL input has changed
+        if sc.sticky[f'{prefix}_ply_url'] != i_ply_url:
+            sc.sticky[f'{prefix}_ply_url'] = i_ply_url
+            sc.sticky[f'{prefix}_status_message'] = "URL changed. Press Load"
+            sc.sticky[f'{prefix}_thread_running'] = False
+            sc.sticky[f'{prefix}_prev_load'] = False
+
+        # start importing if Load toggle is pressed and import thread is not already running
+        if i_load and not sc.sticky[f'{prefix}_prev_load'] and not sc.sticky[f'{prefix}_thread_running']:
+            sc.sticky[f'{prefix}_status_message'] = "Loading..."
+            sc.sticky[f'{prefix}_thread_running'] = True
+            threading.Thread(target=_import_job, args=(i_ply_url,), daemon=True).start()
+
+        sc.sticky[f'{prefix}_prev_load'] = i_load
+        ghenv.Component.Message = sc.sticky.get(f'{prefix}_status_message', "")  # noqa: F821
+
+        # output
+        o_geometry = sc.sticky.get(f'{prefix}_imported_geom')
+
+        return [o_geometry]

src/gh/components/DF_http_listener/metadata.json

@@ -0,0 +1,52 @@
+{
+    "name": "DFHTTPListener",
+    "nickname": "HTTPIn",
+    "category": "diffCheck",
+    "subcategory": "IO",
+    "description": "This component reads a ply file from the internet.",
+    "exposure": 4,
+    "instanceGuid": "ca4b5c94-6c85-4bc5-87f0-132cc34c4536",
+    "ghpython": {
+        "hideOutput": true,
+        "hideInput": true,
+        "isAdvancedMode": true,
+        "marshalOutGuids": true,
+        "iconDisplay": 2,
+        "inputParameters": [
+            {
+                "name": "i_load",
+                "nickname": "i_load",
+                "description": "Button to import ply from url.",
+                "optional": true,
+                "allowTreeAccess": true,
+                "showTypeHints": true,
+                "scriptParamAccess": "item",
+                "wireDisplay": "default",
+                "sourceCount": 0,
+                "typeHintID": "bool"
+            },
+            {
+                "name": "i_ply_url",
+                "nickname": "i_ply_url",
+                "description": "The url where to get the pointcloud",
+                "optional": true,
+                "allowTreeAccess": true,
+                "showTypeHints": true,
+                "scriptParamAccess": "item",
+                "wireDisplay": "default",
+                "sourceCount": 0,
+                "typeHintID": "str"
+            }
+        ],
+        "outputParameters": [
+            {
+                "name": "o_geometry",
+                "nickname": "o_geo",
+                "description": "The mesh or pcd that was imported.",
+                "optional": false,
+                "sourceCount": 0,
+                "graft": false
+            }
+        ]
+    }
+}