###################################
Workshop Connections in viiaPackage
###################################

====================
Connections in DIANA
====================

You can find the theory of connections in DIANA here: :ref:`ConnectionsDIANA-label`.

==========================
Connections in viiaPackage
==========================

The workflow of connections in viiaPackage can be found here: :ref:`ConnectionsWorkflow-label`.

You can find the theory of connections in viiaPackage here: :ref:`ConnectionsInVIIA-label`.

.. note:: viia_create_interface is no longer supported.

.. figure:: _static/Example_axes_connections.png
   :align: center

Figure 2.1 - Example local axis of connections in DIANA.

General connection modelling workflow
-------------------------------------

General approach of connections in your model for VIIA is:

.. figure:: _static/Connections_workflow.png
   :align: center

Figure 2.2 - General workflow for applying connections in your model.

What it is:

* Fast way to bulk apply standard connections in the model;
* Give more time for engineer to focus on complicated connections;
* Allows models to be more flexible and less rigid as time constraint is no longer present.

What it isn’t:

* The functions do not produce final detailing for the models;
* Connections created by the algorithm are not governing; final connections should follow what is present in the
  building and what is described in UPR.

You can find the explanation how to apply automatic connections here: :ref:`ConnectionsAutomatic-label`.

Currently supported connections are: Supported connections:

* Hinges
* D2.01
* D2.01A
* D2.01B
* D2.03
* D2.07
* D4.02
* UNITE-L
* UNITE-P
* NOCON-L

The recording of the instruction on the theory of connections can be found here:

.. figure:: _static/recording_connections01.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/0daad5c4-e52b-4afd-ba11-707587c88ca8

Figure 2.3 - Instructions on theory of connections in DIANA and viiaPackage.

Exercise 1 - Override auto connections
---------------------------------------

1. Apply D5.01B between one of the roof parts and one of the N3 walls.
2. Check the axes and perform corrections if necessary.

.. figure:: _static/Excersice1AutoConnections.png
   :align: center

Figure 2.4 - Override the auto connection function.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections02.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/d994ea60-75eb-4b20-9fce-fb11cc6104df

Figure 2.5 - Instructions on exercise 1.

**Solution**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections03.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/327810f6-293e-4cc3-bd57-0990b8f7bcc7

Figure 2.6 - Instructions on solution of exercise 1.

>>> walls = [wall13, wall14, wall15, wall16] 
>>> roofs = [roof21, roof22, roof23, roof24] 
>>> overrides = [[wall.name, roof.name,'D5.01B'] for wall, roof in
        zip(walls,roofs)] project.viia_auto_interfaces(override_connections=overrides)

Exercise 2 - Disabling connections
-----------------------------------

1. Disable connection between steel beam and timber floor.
2. Create a line hinge between steel beam and timber floor in DIANA itself.
3. Place DIANA code back into the mainscript.

.. figure:: _static/DisablingConnections.png
   :align: center

Figure 2.7 - Disabling auto generated connections.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections04.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/ae132ee7-a56d-49f0-801c-30cab3fd434f

Figure 2.8 - Instructions on exercise 2.

**Solution**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections05.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/97a7aa76-4b12-4b95-854c-0ff93aa2ca7d

Figure 2.9 - Instructions on solution of exercise 2.

>>> project.viia_auto_interfaces(disable_connections=[[beam4.name,floor1.name],])

Exercise 3 - Replace interfaces
--------------------------------
Replace all D2.01 interfaces for non-linear (default) to linear without setting other interfaces to linear.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections06.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/d7913322-3146-41b9-970b-698d7089f9c5

Figure 2.10 - Instructions on exercise 3.

**Solutions**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections07.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/94f0f53d-cda9-4950-9393-00ba922f9550

Figure 2.11 - Instructions on solution of exercise 3.

>>> replace = {'D2.01':['D2.01',{'is_linear': True}]}
>>> project.viia_auto_interfaces(replace_interfaces= replace)

Exercise 4 - Override hinges
-----------------------------
Change hinge of timber column so that rotations around z axis is locked.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections08.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/229f61d3-5f56-4d75-9e9d-6664d41b5cca

Figure 2.12 - Instructions on exercise 4.

**Solutions**

.. figure:: _static/Excersice4AutoConnections.png
   :align: center

Figure 2.13 - Make changes to auto generated connections.

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections09.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/7ae67657-9841-4e01-ba1a-d4d9c90aea91

Figure 2.14 - Instructions on solution of exercise 4.

>>> override = [['N1-KOLOMEN-LIN-HOUT-200x200-1','N1-WANDEN-MW-KLEI<1945-350-5','H_RRF']]
>>> project.viia_auto_hinges(override_hinges= override)

Exercise 5 - Disable hinges for whole nodes
--------------------------------------------
Disable hinges that are created at the node at the top of the roof where two steel beams connect.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections10.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/f2cd6909-abc2-4f03-935b-e9c5f79ab08e

Figure 2.15 - Instructions on exercise 5.

**Solutions**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections11.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/648ab016-3324-4229-a5c8-8ba710e71bdb

Figure 2.16 - Instructions on solution of exercise 5.

>>> disable = [project.find_node(point=[4.30750,2.87250,9.67500])]
>>> project.viia_auto_hinges(disable_nodes = disable)

Exercise 6 - Override auto connections
---------------------------------------

1. Apply D5.01B between one of the roof parts and one of the N3 walls.
2. Check the axes and perform necessary corrections.

.. figure:: _static/Excersice6OevrrideAutoConnections.png
   :align: center

Figure 2.17 - Override auto generated connections.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections12.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/12990f1c-e87e-49a2-8d1d-97357862d57c

Figure 2.18 - Instructions on exercise 6.

**Solutions**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections13.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/3b05bde1-3d42-4cda-aa78-98488da5550b

Figure 2.19 - Instructions on solution of exercise 6.

>>> walls = [wall13, wall14, wall15, wall16]
>>> roofs = [roof21, roof22, roof23, roof24]
>>> for wall in walls:
        for roof in roofs:
            connecting_shapes = wall.get_connecting_shapes()
            if roof in connecting_shapes:
                project.viia_create_connection(detail='D5.01B', source_name=wall, target_name=roof)


Exercise 7 - Override and adjust auto connections
--------------------------------------------------

1. Apply D1.01 between N2-WANDEN-MW-KLEI<1945-350-1 and N3-VLOEREN-LIN-BETON-100-1.
2. Check the axes and perform necessary corrections.

.. figure:: _static/OverrideAndAdjustConnections.png
   :align: center

Figure 2.20 - Override and adjust auto generated connections.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections14.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/0390a8e1-bc82-483d-a321-ceeb6d7541eb

Figure 2.21 - Instructions on exercise 7.

**Solutions**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections15.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/34ed9a29-3203-4e84-b2c4-f1cd54f7d94f

Figure 2.22 - Instructions on solution of exercise 7.

.. figure:: _static/Excersice7Connections.png
   :align: center

Figure 2.23 - Switching and flipping the interface.

Solution 1: (best)

>>> project.viia_create_connection(detail='D1.01', source_name=floor20, target_name=wall10, switch=True)

Solution 2: (Not strictly correct in UPR, but okay otherwise)

>>> project.viia_create_connection(detail='D1.01', source_name=floor20, target_name=wall12, flip=True)

Exercise 8 - Override and adjust auto connections
--------------------------------------------------

1. Apply D5.01B between one of the roof parts and one of the N3 walls.
2. Adjust the local y-axis of the interface to point into the plane of the roof.

The following recording shows the explanation of the exercise:

.. figure:: _static/recording_connections16.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/974f0540-bdf7-491b-aeb6-06146bd5a945

Figure 2.24 - Instructions on exercise 8.

.. figure:: _static/Excersice8Connections.png
   :align: center

Figure 2.25 - Override auto generated connections.

**Solutions**

The following recording shows the solution of the exercise:

.. figure:: _static/recording_connections17.png
   :width: 400px
   :align: center
   :target: https://web.microsoftstream.com/video/6d9323ef-1973-45d7-a608-271773516775

Figure 2.26 - Instructions on solution of exercise 8.

>>> local_y_axis = fem_unit_vector_2_points([4.3075, 0.105, 7.29], [4.3075, 2.8725, 9.675])
>>> project.viia_create_connection(detail='D5.01B', source_name=wall14, target_name=roof21, local_y_axis=local_y_axis)

.. note:: We hope you enjoyed this workshop. Let us know if you have any question or suggestion.