> For the complete documentation index, see [llms.txt](https://alpaca4d.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alpaca4d.gitbook.io/docs/basics/constraints/equal-dof.md).

# Equal DOF

An **Equal DOF** constraint ties selected degrees of freedom of one node to another node so that they always share the same displacement and rotation values.\
This is useful to model connections that behave as if they were rigid in one or more directions, without merging the nodes into a single point.

In Alpaca4d this behaviour is provided by the `EqualDOF` constraint class and its corresponding Grasshopper component, which creates an `Alpaca4d.Constraints.EqualDOF` object.

## Concept

Given a **master node** and a **slave node**, the Equal DOF constraint enforces:

* ( u\_\text{master} = u\_\text{slave} ) for selected translational DOFs (X, Y, Z), and/or
* ( \theta\_\text{master} = \theta\_\text{slave} ) for selected rotational DOFs (XX, YY, ZZ).

This allows you to:

* Couple two nodes on different elements so they move together in one direction but remain independent in others.
* Represent rigid links, stiff connections or symmetry conditions with a light constraint instead of extra elements.

## Typical inputs

Although the exact Grasshopper interface may vary, the Equal DOF constraint conceptually requires:

* **Master point**: Reference node that drives the motion.
* **Slave point**: Node that follows the master in the selected DOFs.
* **DOF flags**: Boolean options for each degree of freedom
  * `Dof_x`, `Dof_y`, `Dof_z`: translational DOFs.
  * `Dof_xx`, `Dof_yy`, `Dof_zz`: rotational DOFs.

## Usage notes

* Use Equal DOF when you need **pairwise coupling** between nodes, e.g. to join beams with offsets or to enforce identical displacements at two locations.
* For floor‑type constraints involving many nodes, a **rigid diaphragm** is usually more convenient than many individual Equal DOF constraints.
* Be careful not to over‑constrain the system (e.g. closing rigid loops with conflicting constraints), which can lead to singular matrices.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://alpaca4d.gitbook.io/docs/basics/constraints/equal-dof.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.