.. _fta_diagram: Fault Tree Diagram ================================ This is the workspace where the Fault Trees are developed and the user can interact with them. .. image:: img/diagram/fault_tree_diagram.png :width: 696.47pt \ Diagram Actions -------------------------------- \ **Select a Fault Tree to be displayed in the diagram** In the top-left dropdown, the user can change between the different Fault Trees of the system. .. image:: img/diagram/select_fault_trees.png :width: 696.47pt \ **Search a node in the diagram** In the top-right text-box the user can search a node in the different Fault Trees of the system. Write the name of the node and click on ``Search``. .. note:: While the user writes the name of the node, a list with the nodes which contain the written characters will appear. .. image:: img/diagram/search_nodes.png :width: 696.47pt \ **Maximize the diagram** To maximize the diagram and make it easier to read, press ``CTRL+M``. To return, press ``CTRL+M`` again. .. image:: img/diagram/maximized_diagram.png :width: 696.47pt \ **Add New Top Gate** The Top Gate is the gate where the breakdown analysis starts to develop. It gives the Unavailability of the system analyzed. To add a new Top Gate, click on ``+ Top Gate > AND Gate`` or ``+ Top Gate > OR Gate`` to insert it as an AND or an OR gate. .. image:: img/diagram/top_gate.PNG :width: 696.47pt \ After clicking on the button, a new Top Gate will be created with a generic ID and Description. .. image:: img/diagram/new_top.PNG :width: 696.47pt \ **Center Top Gate in the diagram** Click the icon and the top gate will be centered in the diagram .. image:: img/diagram/center_ft_topgate.png :width: 696.47pt \ **Undo and Redo Functionality in the diagram** How to Use Undo and Redo Undo: To revert the most recent action, you can click on the undo icon in the toolbar. Alternatively, you can use the keyboard shortcut ``CTRL+Z``. Redo: To reapply an action that you've undone, click on the redo icon in the toolbar. The keyboard shortcut for this function is ``CTRL+Y``. An "action" refers to any modification made to the nodes within the diagram (i.e: add a child node, change a node parameter, delete a node, etc.) .. image:: img/diagram/undo_redo_icons.png :width: 696.47pt \ **Right-Click actions** .. image:: img/diagram/right_click_options.png :width: 696.47pt \ *A. Add Child* Nodes can be added directly with this right click option. Detailed explanation is in Node Actions section. Detailed information about add child is handled in the section Node Actions .. image:: img/diagram/add_child_right_click.png :width: 696.47pt \ *B. Switch On/Off* Switch Off: It changes the selected node and its children nodes in switch-off status Switch On: It changes the selected node and its children nodes in switch-on status .. image:: img/diagram/switch_off_nodes.png :width: 696.47pt \ *C. Comment* The user can add/edit/see/delete the comment of a node. It can be done through a modal directly or being redirected to another page where comments are handled Below image is showing the add comment modal .. image:: img/diagram/add_comment_modal.png :width: 696.47pt \ *D. Copy/Cut/Paste* Copy: When a user uses the "Copy" function, a duplicate of the selected node along with its child nodes is created. The original node and its child nodes remain unchanged in their original location. This is essentially a non-destructive operation that leaves the original structure intact. It can also be used by the keyboard shortcut ``CTRL+C`` Cut: When a user uses the "Cut" function, removes the selected node and its child nodes from their current location while storing them temporarily so they can be pasted elsewhere. This is a destructive operation that alters the original structure by removing the selected nodes. It can also be used by the keyboard shortcut ``CTRL+X`` Paste: It attaches the previously copied or cut nodes, along with their respective child nodes, to a different target node. This allows you to effortlessly move or duplicate complex node structures within the system, preserving their internal relationships. It can also be used by the keyboard shortcut ``CTRL+V`` *E. Delete* When a user deletes a node, a modal is displayed and need to choose the delete-option: 1. Delete from DB: The node is deleted both in the fault tree and in the database. 2. Delete: The node is deleted only from the tree and deleted node information can be used anytime. .. image:: img/diagram/delete_node_modal.png :width: 696.47pt \ *F. Move left/right* This function is used to change the position of the node among sibling nodes. It can also be used by the keyboard shortcut ``CTRL+Left/Right`` \ *G. Transfer Gate* Users can perform transfer gate related actions with right click. Detailed explanation about its functionality can be found in the section of Node Actions .. image:: img/diagram/transfer_gate_right_click.png :width: 696.47pt \ *H. Send as TG (New FT)* This option allows user to create a new Fault Tree with the selected node as top gate \ *I. See related parents* This option allows user to see related parent nodes information in a modal. .. image:: img/diagram/see_related_parents_modal.png :width: 696.47pt \ Node Actions -------------------------------- Clicking on a node will display the different actions available with that node. Different actions can be executed depending on the type of node. \ **AND/OR gate actions** For AND and OR Gates, the actions available to be performed are the following: .. image:: img/diagram/gate_options.PNG :width: 696.47pt \ - **Change information** By clicking ``Change information``, the ID and the Description of the gate can be changed. Click on ``Confirm changes`` to save the changes. .. image:: img/diagram/gate_info.PNG :width: 696.47pt \ - **Change to AND/OR gate** By clicking ``Change to AND gate`` or ``Change to OR gate``, the type of gate will be transformed from an AND gate to an OR gate and viceversa. \ - **Add a node** By clicking ``Add child``, a new node can be inserted as a child of the selected node. There are different types of nodes that can be added (AND, OR, Basic, Undeveloped, Transfer and Remark). .. image:: img/diagram/type_nodes.PNG :width: 696.47pt .. note:: For Basic, Undeveloped and Transfer gates, the user can select from a dropdown to insert an existing node inside the same project clicking on ``Select an existing node``. .. image:: img/diagram/existing_node.PNG :width: 696.47pt For AND/OR gates, if the ID of an existing gate in the same project is introduced, the fields are completed with the information of the gate and the complete branch including all its children gates will be inserted. .. image:: img/diagram/existing_node_2.PNG :width: 696.47pt Click ``Create node`` to add the node. See :ref:`computation` for more information about the parameters of the primary events. \ - **Show as transfer gate** The AND/OR gate branches can be broken into transfer gates to to facilitate the reading of the Fault Tree. By clicking ``Show as transfer``, the branch will be substituted by a transfer gate node. \ - **Send as a Top Gate (New FT)** By clicking ``Send as a Top Gate (New FT)``, the complete branch will be copy as a new Fault tree being the node the new top gate. \ - **Delete a node** By clicking ``Delete``, the node and all its children will be removed. \ **Transfer gate actions** For Transfer gates, the actions available to be performed are the following: .. image:: img/diagram/TF_options.PNG :width: 696.47pt \ - **Change Description/ID** By clicking ``Change Description/ID``, the ID and the Description of the gate can be changed. Click on ``Confirm changes`` to save the changes. .. image:: img/diagram/TF_info.PNG :width: 696.47pt \ - **Go inside the Transfer Gate** By clicking ``Go inside the Transfer Gate``, the branch of the transfer gate will be shown as a different Fault tree. This branch can be modified as a usual Fault Tree. In the top of the diagram, the button ``Go Back`` will appear to collapse the transfer gate diagram and return to the original Fault Tree. Also, the transfer gate diagram's top node will have this button available as an option. .. image:: img/diagram/TF_loaded.PNG :width: 696.47pt \ - **Undo transfer gate** By clicking ``Undo transfer gate``, the transfer gate will be replaced by the original branch. \ - **Send as a Top Gate (New FT)** By clicking ``Send as a Top Gate (New FT)``, the complete branch will be copy as a new Fault tree being the node the new top gate. \ - **Delete a node** By clicking ``Delete``, the node and all its children will be removed. \ **Basic/Undeveloped Events** For Basic and Undeveloped Events, the actions available to be performed are the following: .. image:: img/diagram/BE_options.PNG :width: 696.47pt \ - **Change Parameters** By clicking ``Change parameters``, the ID, the Description, the type of probability and the parameters related with the probability can be changed. Click on ``Confirm changes`` to save the changes. .. image:: img/diagram/BE_info.PNG :width: 696.47pt See :ref:`computation` for more information about the parameters of the primary events. \ - **Change to Basic/Undeveloped Event** By clicking ``Change to Basic Event`` or ``Change to Undeveloped Event``, the node will change from Basic to Undeveloped event or viceversa. \