Documentation Wiki rss-feed

Keeping your setup tidy

Most EigenD setups contain many agents and thousands of connections. Workbench provides hooks and trunks to enable these wires to be routed in a comprehensible way.

Hooks

To create a hook, select the hook tool

image:toolbar_hook.jpg

and click on the Workbench diagram at the point where you would like the hook to be. You can adjust the position of the hook afterwards with the move tool if you want to. You can route a wire over a hook in one of two ways. When creating a new connection (as described in Connecting agents above) you can drag the wire over the hook on your way to the pin you are connecting to.

image:connection_hook.jpg

The other way to route a wire over a hook is to make the connection first and then, with the move tool, grab the wire, drag it and drop it on the hook. To unhook a wire from a hook, select the wire close to the right hand side of the hook with the move tool. Drag the wire upwards and it will come off the hook. Alternatively, if you don't need the hook anymore, you can simply delete the hook using the delete tool.

In Workbench wires generally hang down from hooks (and the other connection points) in a natural catenary curve.

image:catenary_hooks.jpg

Sometimes, however, the setup can be easier to follow if wires run in a straight line from hook to hook. This effect can be achieved by making the hooks at each end of a section of wire "sticky". To turn a hook into a sticky hook click on the hook with the hook tool. The central part of the hook becomes square rather than circular. Clicking again turns it back into a normal hook. Remember that the hooks at both ends of a section of wire have to be sticky if the wire is to run in a straight path between them.

image:sticky_hooks.jpg

Trunks

The trunk is a kind of cable guide through which many wires can be routed to simplify the wiring layout. To create a trunk, select the trunk tool,

image:toolbar_trunk.jpg

click on the diagram where you want the trunk to start and drag the mouse horizontally or vertically. To create a bend in the trunk change the direction of the drag. Existing trunks can be extended or shrunk using the trunk tool later.

As with hooks, there are two ways to add a wire to a trunk. Firstly, you can drag the wire via the trunk on the way between the two agents you are connecting. Secondly you can use the move tool to grab a wire which is already connected and drag it into the trunk. The points at which the wire enters and leaves the trunk can be dragged along the trunk using the move tool. When the mouse button is released they will jump to the nearest entry point. If you have several wires entering or leaving the trunk at the same position, you can choose the one you want to move by clicking the mouse with the move tool selected on the point where they enter (or leave) the trunk.

image:connection_trunk.jpg

To remove a wire from a trunk you can use the delete tool and click on the trunk input or trunk output (the little dots where the wires enter and leave the trunk), or move the trunk input to the same position as the trunk output.

(Tip: To quickly remove a wire from all the trunks and hooks that it passes through you can select the delete tool, move the mouse cursor over the wire in question and click whilst holding down the cmd key on MacOS or the ctrl key on windows)

Back to Workbench

Next: Making sense of your setup