compas-cem 0.7.0__tar.gz → 0.8.2__tar.gz

compas_cem-0.8.2/AUTHORS.rst

@@ -0,0 +1,41 @@
+********************************************************************************
+Citing
+********************************************************************************
+
+If you use **COMPAS CEM** for a project or research, please consider citing our journal paper:
+
+.. code-block:: latex
+
+    @article{pastrana_constrainedformfinding_2022,
+             title = {Constrained {Form}-{Finding} of {Tension}–{Compression} {Structures} using {Automatic} {Differentiation}},
+             author = {Pastrana, Rafael and Ohlbrock, Patrick Ole and Oberbichler, Thomas and D’Acunto, Pierluigi and Parascho, Stefana},
+             journal = {Computer-Aided Design},
+             doi = {10.1016/j.cad.2022.103435},
+             volume = {155},
+             issn = {0010-4485},
+             url = {https://www.sciencedirect.com/science/article/pii/S0010448522001683},
+             month = feb,
+             year = {2022}}
+
+And the code repository:
+
+.. code-block:: latex
+
+    @software{compas_cem,
+        title={{COMPAS~CEM}: The {Combinatorial Equilibrium Modeling} framework for {COMPAS}},
+        author={Pastrana, Rafael and
+                Ohlbrock, Patrick Ole and
+                D'Acunto, Pierluigi and
+                Parascho, Stefana},
+        year={2021},
+        doi={10.5281/zenodo.5705740},
+        url={https://arpastrana.github.io/compas\_cem}}
+
+
+Authors
+=======
+
+* Rafael Pastrana <arpastrana@princeton> `@arpastrana <https://github.com/arpastrana>`_
+* Ole Ohlbrock <ohlbrock@arch.ethz.ch> `@OleOhlbrock <https://github.com/OleOhlbrock>`_
+* Pierluigi D'Acunto <pierluigidacunto@tum.de> `@pierluigidacunto <https://github.com/pierluigidacunto>`_
+* Stefana Parascho <stefana.parascho@epfl.ch> `@stefanaparascho <https://github.com/stefanaparascho>`_

{compas_cem-0.7.0 → compas_cem-0.8.2}/CHANGELOG.rst

@@ -6,6 +6,65 @@ All notable changes to this project will be documented in this file.
 The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_
 and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`_.
 
+0.8.2
+----------
+
+**Added**
+
+**Changed**
+
+**Fixed**
+
+**Deprecated**
+
+**Removed**
+
+0.8.1
+----------
+
+**Added**
+
+- Added set conversion in `TopologyDiagram.is_auxiliary_trail_edge()`.
+
+**Changed**
+
+- Pinned dependency to `numpy==1.26.3`.
+- Pinned dependency to `compas==1.17.10`.
+- Updated installation instructions in docs website.
+- Set minimum supported python version to `3.8`.
+- Bumped to docs action to `docs@.2.21`.
+- Pinned `sphinx, `pytest`, and `pytest-lazy-fixture` dependencies in `requirements_dev.txt`.
+- Set `crazy-max/ghaction-github-pages@v3.1.0` in `docs` action.
+- Set `compas-actions.docs@v2.2.1` in `docs` action.
+- Updated grashopper components in examples.
+
+**Fixed**
+
+**Deprecated**
+
+**Removed**
+
+- Removed `compas_singular` dependency.
+
+0.8.0
+----------
+
+**Added**
+
+- Added `PolylineConstraint` component to grasshopper plugin.
+- Implemented `constraints.PolylineConstraint`.
+- Added `EdgeDirectionConstraint` component to grasshopper plugin.
+- Implemented `constraints.EdgeDirectionConstraint`.
+- Added `Diagram.edge_plane` to query the projection plane of an edge.
+
+**Changed**
+
+**Fixed**
+
+**Deprecated**
+
+**Removed**
+
 0.7.0
 ----------
 

compas_cem-0.8.2/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.1
+Name: compas_cem
+Version: 0.8.2
+Summary: The Combinatorial Equilibrium Modeling framework for COMPAS
+Home-page: https://github.com/arpastrana/compas_cem
+Author: Rafael Pastrana
+Author-email: arpj@princeton.edu
+License: MIT license
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Unix
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.rst
+
+********************************************************************************
+COMPAS CEM
+********************************************************************************
+
+.. start-badges
+
+.. image:: https://github.com/arpastrana/compas_cem/workflows/build/badge.svg
+    :target: https://github.com/arpastrana/compas_cem/actions
+    :alt: Github Actions Build Status
+
+.. image:: https://img.shields.io/github/license/arpastrana/compas_cem.svg
+    :target: https://github.com/arpastrana/compas_cem/blob/main/LICENSE
+    :alt: License
+
+.. image:: https://img.shields.io/pypi/v/compas-cem.svg
+    :target: https://pypi.python.org/pypi/compas-cem
+    :alt: PyPI Package latest release
+
+.. image:: https://img.shields.io/pypi/pyversions/compas-cem
+   :target: https://pypi.org/project/compas-cem
+   :alt: Python versions
+
+.. image:: https://img.shields.io/badge/arXiv-2111.02607-b31b1b.svg
+   :target: https://arxiv.org/abs/2111.02607
+   :alt: ArXiv paper
+
+.. image:: https://zenodo.org/badge/278780552.svg
+   :target: https://zenodo.org/badge/latestdoi/278780552
+   :alt: Zenodo DOI
+
+.. end-badges
+
+.. _COMPAS: https://compas.dev/
+.. _COMPAS CEM Docs: https://arpastrana.github.io/compas_cem/latest/index.html
+.. _CEM Framework: https://doi.org/10.1016/j.cad.2022.103435
+.. _Rafael Pastrana: https://pastrana.xyz/
+.. _Princeton: https://soa.princeton.edu/
+.. _Ole Ohlbrock: https://schwartz.arch.ethz.ch/Team/patrickoleohlbrock.php?lan=en
+.. _Pierluigi D'Acunto: https://www.professoren.tum.de/en/dacunto-pierluigi
+.. _Stefana Parascho: https://people.epfl.ch/stefana.parascho?lang=en
+.. _Anaconda: https://www.anaconda.com/
+.. _Rhino: https://www.rhino3d.com/
+.. _Blender: https://www.blender.org/
+.. _Grasshopper: https://grasshopper3d.com/
+.. _metaverse: https://apnews.com/article/meta-facebook-explaining-the-metaverse-f57e01cd5739840945e89fd668b0fa27
+
+
+.. figure:: ./docs/images/staircase_24_fps_128_colors.gif
+    :figclass: figure
+    :class: figure-img img-fluid
+
+
+The `Combinatorial Equilibrium Modeling (CEM) <https://doi.org/10.1016/j.cad.2022.103435>`_ framework for `COMPAS`_.
+
+The `CEM framework`_ is a numerical form-finding approach to generate forms in static equilibrium for spatial bar structures subjected to combinations of tension-compression forces and design constraints.
+**COMPAS CEM** encapsulates the `CEM framework`_ into an open-source structural design tool that enables the formulation and the solution of constrained form-finding problems in plain and simple `Python <https://www.python.org/>`_ code.
+
+
+Main features
+=============
+
+* **Mix tension and compression forces:** Explore a wider spectrum of structural typologies by combining internal tension and compression forces in the same structure. Design space frames, bridges, tensegrities, and staircases and go beyond the conventional catalog of compression-only shells and cable-nets!
+
+* **Solve constrained form-finding problems efficiently via automatic differentiation:** Generate forms in static equilibrium that simultaneously meet a priori design constraints such as best-fitting a global target shape, restraining bar lengths, and controlling the reaction forces at the supports of a structure.
+
+* **Usable across different 3D modeling software and operating systems:** COMPAS CEM runs on Windows, MacOS and Linux (perhaps one day in the `metaverse`_) and it does not depend on any CAD software to work. However, it provides the necessary interfaces to be seamlessly used inside popular design environments like `Rhino`_, `Blender`_, and `Grasshopper`_. As a `COMPAS`_ extension, COMPAS CEM offers native integration and data exchange with other extensions and plugins in the COMPAS ecosystem.
+
+* **Move those sliders with the Grasshopper plugin:** Are you a `Grasshopper`_ person? Worry not. COMPAS CEM is also shipped as a precooked Grasshopper plugin to readily integrate our constrained form-finding engine into your next spaghetti pipeline 🍝.
+
+
+Installation
+============
+
+
+These are succint instructions to install **COMPAS CEM** and its `Grasshopper`_ plugin.
+For detailed guidance, please refer to the `COMPAS CEM Docs`_.
+
+Install **COMPAS CEM** in a dedicated `Anaconda`_ environment via ``pip``:
+
+::
+
+   pip install compas-cem
+
+To double-check that everything is up and running, type the following in the
+command line and hit enter:
+
+::
+
+    python -c "import compas_cem"
+
+If no errors show up, celebrate 🎉! You have a working installation of **COMPAS CEM**.
+
+
+Grasshopper plugin
+------------------
+
+**Warning**: Note that `Grasshopper`_ plugin of **COMPAS CEM** is only supported in **Rhino 6** and **Rhino 7**.
+
+Once **COMPAS CEM** was installed from the comment line, we can additionally link it to `Rhino`_ and use it as `Grasshopper`_ plugin:
+
+::
+
+    python -m compas_rhino.install -v 7.0
+
+The flag ``-v 7.0`` indicates that we will be installing **COMPAS CEM** and company in Rhino 7. If you are working with Rhino 6, replace that last bit with ``-v 6.0``.
+
+
+First steps
+===========
+
+* `COMPAS CEM Docs`_
+* `COMPAS CEM Examples <https://arpastrana.github.io/compas_cem/latest/examples.html>`_
+* `COMPAS CEM API Reference <https://arpastrana.github.io/compas_cem/latest/api.html>`_
+* `COMPAS Tutorials <https://compas.dev/compas/latest/tutorial.html>`_
+* `COMPAS API Reference <https://compas.dev/compas/latest/api.html>`_
+
+
+Are you a bug hunter?
+=====================
+
+If you find a bug or want to suggest a potential enhancement,
+please help us tackle it by filing a `report <https://github.com/arpastrana/compas_cem/issues>`_.
+
+
+Questions and feedback
+======================
+
+We encourage the use of the `COMPAS framework forum <https://forum.compas-framework.org/>`_ for questions and discussions.
+
+
+Contributing
+============
+
+Pull requests are warmly welcome! Check the `Contributor's Guide <https://github.com/arpastrana/compas_cem/blob/main/CONTRIBUTING.md>`_
+for more details.
+
+
+Citing
+======
+
+If you use **COMPAS CEM** for a project or research, please cite us using these `references <https://arpastrana.github.io/compas_cem/latest/citing.html>`_.
+
+
+Acknowledgements
+================
+
+This work has been supported in part by the U.S. National Science Foundation under grant OAC-2118201 and the `NSF Institute for Data Driven Dynamical Design <https://www.mines.edu/id4>`_.
+
+
+License
+=======
+
+MIT

{compas_cem-0.7.0 → compas_cem-0.8.2}/README.rst

@@ -28,20 +28,16 @@ COMPAS CEM
    :target: https://zenodo.org/badge/latestdoi/278780552
    :alt: Zenodo DOI
 
-.. image:: https://img.shields.io/twitter/follow/compas_dev?style=social
-   :target: https://twitter.com/compas_dev
-   :alt: Twitter follow
-
 .. end-badges
 
 .. _COMPAS: https://compas.dev/
 .. _COMPAS CEM Docs: https://arpastrana.github.io/compas_cem/latest/index.html
-.. _CEM Framework: https://arxiv.org/abs/2111.02607
+.. _CEM Framework: https://doi.org/10.1016/j.cad.2022.103435
 .. _Rafael Pastrana: https://pastrana.xyz/
 .. _Princeton: https://soa.princeton.edu/
 .. _Ole Ohlbrock: https://schwartz.arch.ethz.ch/Team/patrickoleohlbrock.php?lan=en
 .. _Pierluigi D'Acunto: https://www.professoren.tum.de/en/dacunto-pierluigi
-.. _Stefana Parascho: https://soa.princeton.edu/content/stefana-parascho
+.. _Stefana Parascho: https://people.epfl.ch/stefana.parascho?lang=en
 .. _Anaconda: https://www.anaconda.com/
 .. _Rhino: https://www.rhino3d.com/
 .. _Blender: https://www.blender.org/
@@ -49,13 +45,12 @@ COMPAS CEM
 .. _metaverse: https://apnews.com/article/meta-facebook-explaining-the-metaverse-f57e01cd5739840945e89fd668b0fa27
 
 
-
 .. figure:: ./docs/images/staircase_24_fps_128_colors.gif
     :figclass: figure
     :class: figure-img img-fluid
 
 
-The `Combinatorial Equilibrium Modeling (CEM) <https://arxiv.org/abs/2111.02607>`_ framework for `COMPAS`_.
+The `Combinatorial Equilibrium Modeling (CEM) <https://doi.org/10.1016/j.cad.2022.103435>`_ framework for `COMPAS`_.
 
 The `CEM framework`_ is a numerical form-finding approach to generate forms in static equilibrium for spatial bar structures subjected to combinations of tension-compression forces and design constraints.
 **COMPAS CEM** encapsulates the `CEM framework`_ into an open-source structural design tool that enables the formulation and the solution of constrained form-finding problems in plain and simple `Python <https://www.python.org/>`_ code.
@@ -99,6 +94,8 @@ If no errors show up, celebrate 🎉! You have a working installation of **COMPA
 Grasshopper plugin
 ------------------
 
+**Warning**: Note that `Grasshopper`_ plugin of **COMPAS CEM** is only supported in **Rhino 6** and **Rhino 7**.
+
 Once **COMPAS CEM** was installed from the comment line, we can additionally link it to `Rhino`_ and use it as `Grasshopper`_ plugin:
 
 ::

compas_cem-0.8.2/requirements.txt

@@ -0,0 +1,5 @@
+numpy==1.26.3
+compas==1.17.10
+trimesh==3.20.0
+autograd==1.5
+nlopt

{compas_cem-0.7.0 → compas_cem-0.8.2}/setup.py

@@ -28,7 +28,7 @@ optional_requirements = {}
 
 setup(
     name="compas_cem",
-    version="0.7.0",
+    version="0.8.2",
     description="The Combinatorial Equilibrium Modeling framework for COMPAS",
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -46,8 +46,6 @@ setup(
         "Operating System :: Microsoft :: Windows",
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.6",
-        "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: Implementation :: CPython",
@@ -61,7 +59,7 @@ setup(
     include_package_data=True,
     zip_safe=False,
     install_requires=requirements,
-    python_requires=">=3.6",
+    python_requires=">=3.8",
     extras_require=optional_requirements,
     entry_points={
         "console_scripts": [],

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/__init__.py

@@ -27,7 +27,7 @@ __author__ = ["Rafael Pastrana"]
 __copyright__ = "Copyright 2020 - Princeton University"
 __license__ = "MIT License"
 __email__ = "arpj@princeton.edu"
-__version__ = "0.7.0"
+__version__ = "0.8.2"
 
 
 # Directories

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/diagrams/diagram.py

@@ -255,6 +255,22 @@ class Diagram(Data, NodeMixins, EdgeMixins, Network):
         """
         return self.edge_attribute(key=edge, name="length")
 
+    def edge_plane(self, edge):
+        """
+        Gets the projection plane at an edge.
+
+        Parameters
+        ----------
+        edge : ``tuple``
+            The u, v edge key.
+
+        Return
+        ------
+        plane : ``tuple``
+            The projection plane of the edge.
+        """
+        return self.edge_attribute(key=edge, name="plane")
+
 # ==============================================================================
 # Magic methods
 # ==============================================================================

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/diagrams/topology/topology.py

@@ -737,7 +737,8 @@ class TopologyDiagram(Diagram, MeshMixins):
         flag : ``bool``
             ``True``if the edge is in an auxiliary trail. ``False`` otherwise.
         """
-        if edge in set(self.auxiliary_trails()):
+        aux_trails = set([tuple(edge) for edge in self.auxiliary_trails()])
+        if edge in set(aux_trails):
             return True
         return False
 
@@ -910,7 +911,7 @@ class TopologyDiagram(Diagram, MeshMixins):
 
     def trail_sequences(self, key):
         """
-        Create a mapping between the sequences in the diagram and the nodes in the trail.
+        Create a mapping between topological sequences and the nodes in a trail.
 
         Parameters
         ----------
@@ -930,7 +931,9 @@ class TopologyDiagram(Diagram, MeshMixins):
 
     def trails_sequences(self):
         """
-        Creates a mapping between the nodes in all the trails and the available sequences.
+        Creates a mapping of mappings between the nodes of the trails and the sequences.
+
+        The mapping has the form ``{trail_key: {sequence: node}}``.
 
         Returns
         -------

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/equilibrium/__init__.py

@@ -29,4 +29,5 @@ import compas
 if not compas.IPY:
     from .force_numpy import *  # noqa F403
 
+
 __all__ = [name for name in dir() if not name.startswith('_')]

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/equilibrium/force.py

@@ -69,6 +69,7 @@ def equilibrium_state(topology, kmax=None, tmax=100, eta=1e-6, verbose=False, ca
     # create data containers that describe equilibrium state
     reaction_forces = {}
     trail_forces = {}
+    trail_directions = {}
     residual_vectors = {node: topology.reaction_force(node) for node in topology.nodes()}
     node_xyz = {node: topology.node_coordinates(node) for node in topology.nodes()}
 
@@ -84,7 +85,7 @@ def equilibrium_state(topology, kmax=None, tmax=100, eta=1e-6, verbose=False, ca
         # store last positions for residual
         last_xyz = {k: v for k, v in node_xyz.items()}
 
-        for k in range(klast + 1):  # sequences
+        for k in range(topology.number_of_sequences()):  # sequences
 
             for key, trail in topology.trails(keys=True):
 
@@ -144,12 +145,16 @@ def equilibrium_state(topology, kmax=None, tmax=100, eta=1e-6, verbose=False, ca
                         length = plength
 
                 # store next node position
-                next_pos = add_vectors(pos, scale_vector(normalize_vector(rvec), length))
+                nrvec = normalize_vector(rvec)
+                next_pos = add_vectors(pos, scale_vector(nrvec, length))
                 node_xyz[next_node] = next_pos
 
                 # store trail force
                 trail_forces[edge] = copysign(length_vector(rvec), length)
 
+                # store trail direction
+                trail_directions[edge] = nrvec
+
                 # store residual vector
                 residual_vectors[next_node] = rvec
 
@@ -185,11 +190,12 @@ def equilibrium_state(topology, kmax=None, tmax=100, eta=1e-6, verbose=False, ca
     eq_state["node_xyz"] = node_xyz
     eq_state["trail_forces"] = trail_forces
     eq_state["reaction_forces"] = reaction_forces
+    eq_state["trail_directions"] = trail_directions
 
     return eq_state
 
 
-def form_update(form, node_xyz, trail_forces, reaction_forces):
+def form_update(form, node_xyz, trail_forces, reaction_forces, **kwargs):
     """
     Update the node and edge attributes of a form after equilibrating it.
     """

{compas_cem-0.7.0 → compas_cem-0.8.2}/src/compas_cem/equilibrium/force_numpy.py

@@ -57,7 +57,7 @@ def equilibrium_state_numpy(topology, tmax=100, eta=1e-6, verbose=False, callbac
 
     # output, mutable
     edge_forces = {e: np.array(topology.edge_force(e)) for e in topology.edges()}
-    edge_lengths = {e: np.array(topology.edge_attribute(e, "length")) for e in topology.edges()}
+    edge_lengths = {e: np.array(topology.edge_length_2(e)) for e in topology.edges()}
 
     # input, immutable
     # numpy
@@ -70,7 +70,7 @@ def equilibrium_state_numpy(topology, tmax=100, eta=1e-6, verbose=False, callbac
     # edge planes
     edge_planes = {}
     for edge in topology.trail_edges():
-        plane = topology.edge_attribute(edge, "plane")
+        plane = topology.edge_plane(edge)
         if not plane:
             continue
         plane = [np.array(vector) for vector in plane]
@@ -82,6 +82,7 @@ def equilibrium_state_numpy(topology, tmax=100, eta=1e-6, verbose=False, callbac
     # output
     reaction_forces = {}
     trail_forces = {}
+    trail_directions = {}
 
     for t in range(tmax):  # max iterations
 
@@ -152,11 +153,15 @@ def equilibrium_state_numpy(topology, tmax=100, eta=1e-6, verbose=False, callbac
                 # compute trail force
                 trail_force = length_vector_numpy(rvec)  # always positive
 
+                # compute trail direction by normalizing residual vector
                 # NOTE: to avoid NaNs, do not normalize residual vector if it is zero length
                 nrvec = rvec / trail_force
                 if np.isnan(length_vector_numpy(nrvec)):
                     nrvec = rvec
 
+                # store trail direction
+                trail_directions[edge] = nrvec
+
                 # store next node position
                 next_pos = pos + length * nrvec
                 node_xyz[next_node] = next_pos
@@ -203,13 +208,14 @@ def equilibrium_state_numpy(topology, tmax=100, eta=1e-6, verbose=False, callbac
     eq_state = {}
     eq_state["node_xyz"] = node_xyz
     eq_state["trail_forces"] = trail_forces
+    eq_state["trail_directions"] = trail_directions
     eq_state["reaction_forces"] = reaction_forces
 
     # return node_xyz, trail_forces, reaction_forces
     return eq_state
 
 
-def form_update(form, node_xyz, trail_forces, reaction_forces):
+def form_update(form, node_xyz, trail_forces, reaction_forces, **kwargs):
     """
     Update the node and edge attributes of a form after equilibrating it.
     """

compas_cem-0.8.2/src/compas_cem/ghpython/components/CompasCem_ConstraintEdgeDirection/code.py

@@ -0,0 +1,17 @@
+"""
+Align the direction of a trail or a deviation edge with a target vector.
+"""
+
+from ghpythonlib.componentbase import executingcomponent as component
+
+from compas_cem.optimization import EdgeDirectionConstraint
+from compas_rhino.geometry import RhinoVector
+
+
+class EdgeDirectionConstraintComponent(component):
+    def RunScript(self, edge_key, vector, weight):
+        weight = weight or 1.0
+        if not edge_key or not vector:
+            return
+        vector = RhinoVector.from_geometry(vector).to_compas()
+        return EdgeDirectionConstraint(edge_key, vector, weight)

compas_cem-0.8.2/src/compas_cem/ghpython/components/CompasCem_ConstraintEdgeDirection/metadata.json

@@ -0,0 +1,35 @@
+{
+    "name": "Edge Direction Constraint",
+    "nickname": "EdgeDirectionConstraint",
+    "category": "COMPAS CEM",
+    "subcategory": "06_Optimization",
+    "description": "Align the direction of a trail or a deviation edge with a target vector.",
+    "exposure": 4,
+
+    "ghpython": {
+        "isAdvancedMode": true,
+        "inputParameters": [
+            {
+                "name": "edge_key",
+                "description": "The key of a COMPAS CEM trail or deviation edge."
+            },
+            {
+                "name": "vector",
+                "description": "The target vector.",
+                "typeHintID": "vector"
+            },
+            {
+                "name": "weight",
+                "description": "The weight of the constraint in the optimization problem. Defaults to one.",
+                "typeHintID": "float"
+            }
+        ],
+        "outputParameters": [
+            {
+                "name": "constraint",
+                "description": "A COMPAS CEM edge direction constraint.",
+                "optional": false
+            }
+        ]
+    }
+}

compas_cem-0.8.2/src/compas_cem/ghpython/components/CompasCem_ConstraintNodePolyline/code.py

@@ -0,0 +1,16 @@
+"""
+Pull the position of a node to a target polyline.
+"""
+from ghpythonlib.componentbase import executingcomponent as component
+
+from compas_cem.optimization import PolylineConstraint
+from compas_rhino.geometry import RhinoPolyline
+
+
+class PolylineConstraintComponent(component):
+    def RunScript(self, node_key, polyline, weight):
+        weight = weight or 1.0
+        if node_key is None or not polyline:
+            return
+        polyline = RhinoPolyline.from_geometry(polyline).to_compas()
+        return PolylineConstraint(node_key, polyline, weight)

compas_cem-0.8.2/src/compas_cem/ghpython/components/CompasCem_ConstraintNodePolyline/metadata.json

@@ -0,0 +1,36 @@
+{
+    "name": "Polyline Constraint",
+    "nickname": "PolylineConstraint",
+    "category": "COMPAS CEM",
+    "subcategory": "06_Optimization",
+    "description": "Pull the position of a node to a target polyline.",
+    "exposure": 4,
+
+    "ghpython": {
+        "isAdvancedMode": true,
+        "inputParameters": [
+            {
+                "name": "node_key",
+                "description": "The key of a COMPAS CEM node.",
+                "typeHintID": "int"
+            },
+            {
+                "name": "polyline",
+                "description": "The target polyline.",
+                "typeHintID": "polyline"
+            },
+            {
+                "name": "weight",
+                "description": "The weight of the constraint in the optimization problem. Defaults to one.",
+                "typeHintID": "float"
+            }
+        ],
+        "outputParameters": [
+            {
+                "name": "constraint",
+                "description": "A COMPAS CEM node polyline constraint.",
+                "optional": false
+            }
+        ]
+    }
+}