doc/modification.rst

   1
   2 .. _modification:
   3
   4 Modification of a schema
   5 ========================
   6
   7 Create an object
   8 ----------------
   9 YACS GUI uses the following approach for creation of all kinds of YACS objects:
  10
  11 #. Optionally, the user selects some item (or items) in the Tree View or in the 2D Viewer that acts as input parameter(s) for creation.
  12 #. Then the user activates corresponding GUI command to create an object of required type.
  13 #. The new object appears in the Tree View and 2D Viewer of a schema. In order to show Input Panel with the property page of a new
  14    created object the user should select a new created object in the Tree View or 2D Viewer of a schema. After that the user can modify
  15    properties of a new created object via the corresponding property page on the Input Panel.
  16
  17 More detailed information about the creation of certain objects types is given in sections below.
  18
  19 .. _create_new_schema:
  20
  21 Create a new schema
  22 ~~~~~~~~~~~~~~~~~~~
  23 The YACS module provides the user with capabilities not only for modification, but also for creation of the graphs. The user can
  24 create a new schema by calling **YACS -> New Schema** command from :ref:`file` or from the corresponding toolbar button on the :ref:`schema`.
  25
  26 .. image:: images/functionality_list_9.jpg
  27   :align: center
  28
  29 As a result of this operation, YACS module creates an empty instance of a schema object, new schema object is shown in the Object
  30 Browser and the Tree View is created for a new empty schema. The schema object is shown as a root of Tree View structure. Schema root
  31 object of the Tree View will be used as a parent for the schema sub-trees and all new objects added to the schema will appear under
  32 these sub-trees.
  33
  34 .. image:: images/functionality_list_10.jpg
  35   :align: center
  36
  37 .. centered::
  38   **New created schema**
  39
  40 New schema object becomes the active one. In order to display Input Panel with schemas' property page containing properties of the
  41 schema the user should select schema root object in the Tree View. The property page of a schema allows the user to modify
  42 schemas' properties (see :ref:`pp_for_schema` section).
  43
  44 .. _create_container_definition:
  45
  46 Create a container definition
  47 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48 To create a container use the command **Create container** from the context menu of the folder **Containers** in the Tree View.
  49
  50 .. image:: images/functionality_list_11.jpg
  51   :align: center
  52
  53 On this command call a SALOME container with a default name and default machine parameters is created.
  54
  55 As a result of container creation, YACS module creates a new container definition object and shows it in the Tree View under 'Containers' folder.
  56 It is used as a parent item for all component instances created in this container.
  57
  58 .. image:: images/functionality_list_12.jpg
  59   :align: center
  60
  61 As soon as user selects a container object in the Tree View, Input Panel containing property page of the selected container is shown
  62 (for the sample of the property page see :ref:`pp_for_container` section) and allows the user to modify its properties. In the container
  63 property page the user can specify parameters of a created container object, such as the name of the container and machine parameters.
  64
  65 .. _create_component_instance_definition:
  66
  67 Create a component instance definition
  68 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  69 At the current moment YACS module does not provide a functionality to create directly component instance.
  70 The component instances are created indirectly when nodes are created (see :ref:`create_node`).
  71
  72 When a component instance is created (following the creation of a node), a new SALOME component instance definition is shown in
  73 the Tree View under its container object.
  74
  75 .. image:: images/functionality_list_16.jpg
  76   :align: center
  77
  78 As soon as user selects a component instance definition in the Tree View, Input Panel containing property page of the component instance
  79 definition object is shown (for the sample of the property page see :ref:`pp_for_component_instance_definition` section).
  80
  81 .. _create_node:
  82
  83 Create a node
  84 ~~~~~~~~~~~~~
  85 YACS module provides the user with a specific GUI command for creation of each type of node.
  86
  87 At the current moment in the frames of the YACS module the user can create nodes of the following types:
  88
  89 .. _inline_function:
  90
  91 Inline function
  92 ''''''''''''''''''
  93
  94 The node object can be created with help of **Create Node --> Inline Function Node** command from the Tree View context menu
  95
  96 .. image:: images/functionality_list_19a.jpg
  97   :align: center
  98
  99 or from the 2D Viewer context menu. The context menu must be activated on the chosen parent node.
 100
 101 .. image:: images/functionality_list_19.jpg
 102   :align: center
 103
 104 as a result:
 105
 106 .. image:: images/functionality_list_18.jpg
 107   :align: center
 108
 109 .. centered::
 110   **Example of inline function node with ports**
 111
 112 Now, if you want to modify the settings of this node, use the associated panel :ref:`pp_for_inline_node`.
 113
 114 .. _inline_script:
 115
 116 Inline script
 117 ''''''''''''''''''
 118
 119 The node object can be created with help of **Create Node --> Inline Script Node** command from the Tree View context menu or
 120 from the 2D Viewer context menu. The context menu must be activated on the chosen parent node.
 121
 122 .. image:: images/functionality_list_21.jpg
 123   :align: center
 124
 125 as a result:
 126
 127 .. image:: images/functionality_list_20.jpg
 128   :align: center
 129
 130 .. centered::
 131   **Example of inline script node with ports**
 132
 133 Now, if you want to modify the settings of this node, use the associated panel :ref:`pp_for_inline_node`.
 134
 135 .. _salome_service:
 136
 137 SALOME service
 138 ''''''''''''''''''
 139
 140 This type of node can be created with help of **Create Node -> Node from Catalog** command from the Tree View context menu
 141 or from the 2D Viewer context menu.
 142
 143 The type of service node is chosen from the catalog of services available in the list of imported catalog, in the :ref:`catalogs_tree_view`.
 144
 145 .. image:: images/functionality_list_23.jpg
 146   :align: center
 147
 148 As a result of this command call the Input Panel with catalogs' properties is displayed. The displayed property page provides a user
 149 with the possibility to choose firstly a catalog type: **Current Session**, **Built In** or other imported catalog (i.e. to fill catalog
 150 with types of nodes belonging to a predefined schema), and secondly - the type of node from the catalog to add it into the active schema. The
 151 **Current Session** catalog contains all SALOME components with its services.
 152
 153 .. note::
 154
 155    To add a node from catalog to the schema, drag and drop it. Multiple selection is possible in the Catalog, so you can add several
 156    nodes to the schema with one drag and drop.
 157
 158 .. image:: images/functionality_list_24.jpg
 159   :align: center
 160
 161 .. centered::
 162   **Create a node from current session catalog**
 163
 164 .. image:: images/functionality_list_25.jpg
 165   :align: center
 166
 167 .. centered::
 168   **Create a node from a user catalog**
 169
 170
 171 .. image:: images/functionality_list_22.jpg
 172   :align: center
 173
 174 .. centered::
 175   **Example of service node**
 176
 177 As a result of SALOME service node creation from **Current Session** catalog, the content of schema Tree View is enlarged with data types
 178 used by the new node, a new node object under **newSchema_1** folder, the corresponding SALOME component instance definition and a
 179 reference to a new created service node under it.
 180
 181 .. image:: images/functionality_list_27.jpg
 182   :align: center
 183
 184 .. centered::
 185   **Tree View after SALOME service node creation**
 186
 187 Now, if you want to modify the settings of this node, use the associated panel :ref:`pp_for_salome_node`.
 188
 189 .. _block_node:
 190
 191 Block
 192 ''''''''''''''''''
 193
 194 The node object can be created with help of **Create Node --> bloc Node** command from the Tree View context menu or from
 195 the 2D Viewer context menu.
 196
 197 .. image:: images/functionality_list_31.jpg
 198   :align: center
 199
 200 as a result:
 201
 202 .. image:: images/functionality_list_30.jpg
 203   :align: center
 204
 205 .. centered::
 206   **Empty Block node**
 207
 208 Child nodes of a block node can be created with help of sub-items of **Create Node** command from block node context popup menu in the
 209 Tree View or in the 2D Viewer.
 210
 211 .. image:: images/functionality_list_32.jpg
 212   :align: center
 213
 214 as a result:
 215
 216 .. image:: images/functionality_list_33.jpg
 217   :align: center
 218
 219 .. centered::
 220   **Example of Block node with inline function node as a child node**
 221
 222 .. _forloop_node:
 223
 224 For Loop
 225 ''''''''''''''''''
 226
 227 The node object can be created with help of **Create Node --> For Loop Node** command   from the Tree View context menu or from the 2D Viewer context menu.
 228
 229 .. image:: images/functionality_list_35.jpg
 230   :align: center
 231
 232 as a result:
 233
 234 .. image:: images/functionality_list_34.jpg
 235   :align: center
 236
 237 .. centered::
 238   **For Loop node without a body (i.e. newly created)**
 239
 240 Body node of a For Loop node can be created with help of sub-items of **Create Node** command from For Loop node context popup menu in the
 241 Tree View or in the 2D Viewer.
 242
 243 .. image:: images/functionality_list_36.jpg
 244   :align: center
 245
 246 as a result:
 247
 248 .. image:: images/functionality_list_37.jpg
 249   :align: center
 250
 251 .. centered::
 252   **For Loop node with inline script node as a body**
 253
 254 .. _foreachloop_node:
 255
 256 ForEachLoop
 257 ''''''''''''''''''
 258
 259 The node object can be created with help of sub-items of **Create Node --> ForEachLoop** command from the Tree View context menu
 260 or from the 2D Viewer context menu. There is one sub-item for each data type known in the schema object. If you need another data type,
 261 you'll have to import it in the schema. In this case we use a double data type as the main type of the loop.
 262
 263 .. image:: images/functionality_list_39.jpg
 264   :align: center
 265
 266 as a result:
 267
 268 .. image:: images/functionality_list_38.jpg
 269   :align: center
 270
 271 .. centered::
 272   **ForEachLoop (double) node without a body (i.e. new created)**
 273
 274 Body node of a ForEachLoop node can be created with help of sub-items of **Create Node** command from ForEachLoop node context popup menu in the
 275 Tree View or in the 2D Viewer.
 276
 277 .. image:: images/functionality_list_40.jpg
 278   :align: center
 279
 280 as a result:
 281
 282 .. image:: images/functionality_list_41.jpg
 283   :align: center
 284
 285
 286 .. centered::
 287   **ForEachLoop node with SALOME service node as a body**
 288
 289 .. _whileloop_node:
 290
 291 While loop
 292 ''''''''''''''''''
 293
 294 The node object can be created with help of **Create Node --> While Loop Node** command from the Tree View context menu
 295 or from the 2D Viewer context menu.
 296
 297 .. image:: images/functionality_list_43.jpg
 298   :align: center
 299
 300
 301 .. image:: images/functionality_list_42.jpg
 302   :align: center
 303
 304 .. centered::
 305   **While loop node without a body (i.e. new created)**
 306
 307 Body node of a While Loop node can be created with help of sub-items of **Create Node** command from While Loop node context popup menu in the
 308 Tree View or in the 2D Viewer.
 309
 310 .. image:: images/functionality_list_44.jpg
 311   :align: center
 312
 313
 314 .. image:: images/functionality_list_45.jpg
 315   :align: center
 316
 317
 318 .. centered::
 319   **While Loop node with Block node as a body**
 320
 321 .. _switch_node:
 322
 323 Switch
 324 ''''''''''''''''''
 325
 326 The node object can be created with help of **Create Node --> Switch Node** command from the Tree View context menu
 327 or from the 2D Viewer context menu.
 328
 329 .. image:: images/functionality_list_47.jpg
 330   :align: center
 331
 332 .. image:: images/functionality_list_46.jpg
 333   :align: center
 334
 335 .. centered::
 336   **Switch node without any cases (i.e. new created)**
 337
 338 Body node of a Switch node can be created with help of sub-items of **Create Node** command from Switch node context popup menu in the
 339 Tree View or in the 2D Viewer.
 340
 341 .. image:: images/functionality_list_48.jpg
 342   :align: center
 343
 344
 345 .. image:: images/functionality_list_49.jpg
 346   :align: center
 347
 348 .. centered::
 349   **Switch node with three cases**
 350
 351 The number of Switch node cases can be changed with help of functionality provided by the property page of Switch node (for the sample
 352 of the property page see :ref:`Property page for Switch node <pp_for_switch_node>` section).
 353
 354 .. _optimizerloop_node:
 355
 356 OptimizerLoop
 357 ''''''''''''''''''
 358
 359 The node object can be created with help of **Create Node --> Optimizer Loop** command from the Tree View context menu
 360 or from the 2D Viewer context menu.
 361
 362 .. image:: images/functionality_list_47a.jpg
 363   :align: center
 364
 365 Body node of an Optimizer Loop node can be created with help of sub-items of **Create Node** command from Optimizer Loop node context popup menu in the
 366 Tree View or in the 2D Viewer.
 367
 368 .. image:: images/functionality_list_47b.jpg
 369   :align: center
 370
 371 .. image:: images/functionality_list_47c.jpg
 372   :align: center
 373
 374 .. centered::
 375   **Optimizer Loop with one internal python node**
 376
 377 The parameters of the Optimizer Loop can then be modified with help of the functionality provided by the property page of Optimizer Loop node
 378 (see :ref:`Property page for Optimizer Loop <pp_for_optimizer_node>` section).
 379
 380 .. _datain_node:
 381
 382 Input data node
 383 ''''''''''''''''''
 384 The node object can be created with help of **Create Node --> Input Data Node** command from the Tree View context menu
 385 or from the 2D Viewer context menu.
 386
 387 .. image:: images/functionality_list_51.jpg
 388   :align: center
 389
 390
 391 .. image:: images/functionality_list_50.jpg
 392   :align: center
 393
 394 .. centered::
 395   **Input data node with sample ports**
 396
 397 .. _dataout_node:
 398
 399 Output data node
 400 ''''''''''''''''''
 401
 402 The node object can be created with help of **Create Node --> Output Data Node** command from the Tree View context menu
 403 or from the 2D Viewer context menu.
 404
 405 .. image:: images/functionality_list_53.jpg
 406   :align: center
 407
 408
 409 .. image:: images/functionality_list_52.jpg
 410   :align: center
 411
 412 .. centered::
 413   **Output data node with sample ports**
 414
 415 .. _studyin_node:
 416
 417 Input study node
 418 ''''''''''''''''''
 419
 420 The node object can be created with help of **Create Node --> Input Study Node** command from the Tree View context menu
 421 or from the 2D Viewer context menu.
 422
 423 .. image:: images/functionality_list_55.jpg
 424   :align: center
 425
 426
 427 .. image:: images/functionality_list_54.jpg
 428   :align: center
 429
 430 .. centered::
 431   **Input study node with sample ports**
 432
 433 .. _studyout_node:
 434
 435 Output study node
 436 ''''''''''''''''''
 437
 438 The node object can be created with help of **Create Node --> Output Study Node** command from the Tree View context menu
 439 or from the 2D Viewer context menu.
 440
 441 .. image:: images/functionality_list_57.jpg
 442   :align: center
 443
 444 .. image:: images/functionality_list_56.jpg
 445   :align: center
 446
 447 .. centered::
 448   **Output study node with sample ports**
 449
 450 As a result of node creation, YACS module creates a new node object with a default name and shows it in the Tree View (under the proper
 451 parent item) and in 2D Viewer. For service nodes the reference to the created service node is also published under the corresponding
 452 component instance definition in the Tree View. For any node object type, the default name has a form of "node_subtypeNNN", where
 453 NNN is the smallest integer that produces a unique node name not yet in use.
 454
 455 The user can delete the created node by choosing **Delete** command from node context popup menu in the Tree View or in the 2D Viewer
 456 (see :ref:`delete_object` section).
 457
 458 .. image:: images/functionality_list_58.jpg
 459   :align: center
 460
 461 Create a link
 462 ~~~~~~~~~~~~~
 463 Connecting nodes ports by links means transferring data from output port to input port of a next node. So, in general, only output and input
 464 ports of different nodes can be connected by a link.
 465
 466 There are three types of links to connect nodes with each other in YACS GUI:
 467
 468 + data flow link (between data ports),
 469
 470 + data stream link (between stream ports),
 471
 472 + control link (between gate ports).
 473
 474 The color code of data links differs from the same one of stream links and is taken from the user preferences (see :ref:`set_user_preferences` section).
 475
 476 The link creation can be performed only between nodes included into the same schema object. Therefore, in such a case the schema should
 477 contain at least two nodes.
 478
 479 The user can create a link by dragging the output port to connect and dropping it onto the input port. The action is the same
 480 for data flow, data stream and control link. The action of drag-and-drop can be done in the Tree View or in the 2D Viewer.
 481
 482 The input port is considered as the end of the newly created link. The output port is the beginning of the newly created link.
 483
 484 .. image:: images/functionality_list_59.jpg
 485   :align: center
 486
 487 .. centered::
 488   **Drag-and-drop between Add16.z output port and Add17.x input port**
 489
 490 It's worth mentioning that there are two possibilities for the user to create data links with Drag-and-Drop:
 491
 492 #. **Add dataflow link** : standard Drag-and-Drop creates a data link and adds a control link between concerned nodes simultaneously
 493
 494 #. **Add data link** Drag-and-Drop with control key pressed creates a data link **without adding a control link**. This functionality is
 495    needed inside loop nodes. An example of such a data link is shown on the figure below.
 496
 497 .. image:: images/functionality_list_60.jpg
 498   :align: center
 499
 500 .. centered::
 501   **Trying to create a dataflow link between Add21.z and Add20.x with a loop**
 502
 503 In such a case it is needed to separate the flow of data from the flow of control.
 504
 505 .. image:: images/functionality_list_60a.jpg
 506   :align: center
 507
 508 .. centered::
 509   **Create a simple data link with control key pressed**
 510
 511
 512
 513 To create a control link the user should use Drag-and-Drop between output gate port and input gate port. The output gate port is considered
 514 as the beginning of the newly created control link, and the input gate port as the end of the link.
 515
 516 As a result of link creation, a valid link between ports is created. The link object is published in the Tree View in the **Links** folder
 517 under the corresponding schema object. The presentation of a new link is shown in the 2D Viewer and colored with the color code according
 518 to links' type.
 519
 520 A new link object has a default name, which contains names of "from" and "to" nodes and ports and cannot be changed by the user
 521 (see :ref:`description of link objects in the Tree View <description_of_link_objects>`).
 522
 523 Each link has an associated property page that, in most cases, shows the link name. For datastream links (CALCIUM links), a properties
 524 editor allows to set and modify link properties (see :ref:`datastreamlinks`).
 525
 526 .. image:: images/functionality_list_60b.jpg
 527   :align: center
 528
 529 .. centered::
 530   datastream link properties editor
 531
 532 The user can delete a link by choosing **Delete** command from link context popup menu in the Tree View or in the
 533 2D Viewer (see :ref:`delete_object` section).
 534
 535 .. _edit_object:
 536
 537 Edit an object
 538 --------------
 539 The edition of an object is one of basic points of modification operations as the creation or deletion. The YACS GUI proposes the edition
 540 of an object with help of the :ref:`input_panel`. For this purpose the user should select the object, which properties he wants to edit, in
 541 the Tree View or in the 2D Viewer.
 542
 543 As a result of this operation, Input Panel is updated and the property page of the selected object (and objects dependable from this one)
 544 is opened. Within the property page(s) the user can modify objects' parameters by typing in corresponding input fields or selecting an item
 545 in combo box input fields.
 546
 547 The user confirm the modifications by pressing **Apply** button on the Input Panel.
 548 The **Cancel Edition** button can be used to cancel modifications that have not been already applied.
 549
 550 If the user finishes the edition process, YACS module updates (if it is necessary) Tree View and/or 2D representation of the modified object.
 551
 552 It's worth mentioning that if the user selects something in the Tree View or 2D Viewer before applying the changes in the Input Panel,
 553 the object background color is changed to yellow to remind applying the changes.
 554
 555 .. _pp_for_container:
 556
 557 Property page for container
 558 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 559 The property page for container definition is shown on the figure below.
 560
 561 .. image:: images/functionality_list_61.jpg
 562   :align: center
 563
 564 .. centered::
 565   **Container property page**
 566
 567 .. image:: images/functionality_list_61a.jpg
 568   :align: center
 569
 570 .. centered::
 571   **Container property page with advanced parameters shown**
 572
 573 The property page for container allows to modify the name and a set of machine parameters of the selected container object.
 574 At the beginning, machine parameters are initialized with the default values.
 575 For most parameters, the default values can be used. The user can select a resource from a list obtained with help of SALOME resource manager
 576 or use the **automatic** option to let SALOME selects computers. The user can only modify resource parameters (Resource tab)
 577 when the **automatic** option has been choosen. In that case, resource parameters are constraints used by the resource manager
 578 to select the best resource for the container. In the other case (specific resource selected), the resource parameters come
 579 from the resource manager, are the effective ones and are only displayed.
 580
 581 The user can apply modifications to the selected container object by pressing **Apply** button. In such a case YACS module changes
 582 properties of the selected container definition according to new values from the Input Panel and updates the Tree View if it is needed.
 583 The **Cancel Edition** button can be used to cancel modifications that have not been already applied.
 584
 585 .. _pp_for_component_instance_definition:
 586
 587 Property page for component instance definition
 588 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 589 The property page for SALOME components is shown on the figure below.
 590
 591 .. image:: images/functionality_list_62.jpg
 592   :align: center
 593
 594 .. centered::
 595   **Property page for SALOME component instance definition**
 596
 597 In the Input Panel for SALOME component instances the user can see the name of the selected component object.
 598 This field is not editable and use only to provide information about component name.
 599 It is also possible to change the associated container (container: combobox) and to add properties to the component instance.
 600 These properties are converted to environment variables when the schema is executed.
 601
 602 .. _pp_for_schema:
 603
 604 Property page for schema
 605 ~~~~~~~~~~~~~~~~~~~~~~~~
 606 The schema property page allows the user to specify the name of the schema.
 607
 608 The property page for schema is shown on the figure below.
 609
 610 .. image:: images/functionality_list_64.jpg
 611   :align: center
 612
 613 .. centered::
 614   **Property page for schema**
 615
 616 It is possible to add properties to the schema.
 617 These are properties for all the nodes defined in the schema.
 618
 619 .. _pp_for_node:
 620
 621 Property page for node
 622 ~~~~~~~~~~~~~~~~~~~~~~
 623 The content of the property page for node depends on the type of the node. Here are property page configurations for the different types of nodes.
 624
 625 .. _pp_for_inline_node:
 626
 627 Property page for inline nodes
 628 '''''''''''''''''''''''''''''''''
 629
 630 The property pages for **inline function** and **inline script** nodes are shown on the figures below.
 631
 632 .. image:: images/functionality_list_65.jpg
 633   :align: center
 634
 635 .. centered::
 636   **Property page for inline script nodes**
 637
 638 .. image:: images/functionality_list_65a.jpg
 639   :align: center
 640
 641 .. centered::
 642   **Property page for inline function nodes**
 643
 644 The pages allow the user to:
 645
 646 + specify the name of the node,
 647
 648 + read the full name of the node (this field is read only and updated if the user changes the node name),
 649
 650 + change the list of input and output ports (it is possible to set port name, choose port type and value type from the corresponding
 651   combo boxes, set input values for input port, if it is not linked),
 652
 653 + change the name of the Python function ("Function Name" entry) to execute for Python function node only,
 654
 655 + enter or modify a source code of Python function or script in the built-in Python code editor (syntax highlighting, text selection,
 656   cut/copy/paste mechanism).
 657
 658 + generate a template of the python function with the **Template** button when all ports are defined and the function name is set.
 659
 660 + edit the python code with an external editor (**External Editor** button, if set in :ref:`user preferences <set_user_preferences>`).
 661
 662 An inline node can be executed in a remote container by setting its execution mode to **Remote** and selecting a container
 663 in the containers list.
 664
 665 .. image:: images/functionality_list_65b.jpg
 666   :align: center
 667
 668 .. _pp_for_salome_node:
 669
 670 Property page for SALOME service
 671 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 672 The property page for **SALOME service** nodes is shown on the figure below.
 673
 674 .. image:: images/functionality_list_66.jpg
 675   :align: center
 676
 677 .. centered::
 678   **Property page for SALOME service nodes**
 679
 680 The page allows the user to:
 681
 682 + change the name of the node,
 683
 684 + read the full name of the node (this field is read only and updated if the user changes the node name) and its type,
 685
 686 + read the name of the associated component instance,
 687
 688 + change the associated component instance by selecting it in the list of available component instance definitions in the
 689   current schema,
 690
 691 + change the associated container with help of built-in property page for component instance definition. The user selects it in
 692   the list of available container definitions in the current schema,
 693
 694 + change properties of the associated container (e.g. host name) with help of built-in property page for container,
 695
 696 + read the name of the method from the associated component, which will be executed by the node,
 697
 698 + change values of input ports, if it is not linked,
 699
 700 + change or add properties
 701
 702 Property page for Block node
 703 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 704 The property page for **Block** node is shown on the figure below.
 705
 706 .. image:: images/functionality_list_71.jpg
 707   :align: center
 708
 709 .. centered::
 710   **Property page for Block node**
 711
 712 The page allows the user to :
 713
 714 + change the name of the node,
 715
 716 + read the full name of the node (this field is read only and updated if the user changes the node name),
 717
 718 + change or add properties. These are properties for all the nodes defined in the Block.
 719
 720 Property page for For Loop node
 721 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 722 The property page for **For Loop** node is shown on the figure below.
 723
 724 .. image:: images/functionality_list_68.jpg
 725   :align: center
 726
 727 .. centered::
 728   **Property page for For Loop node**
 729
 730 The page allows the user to:
 731
 732 + change the name of the node,
 733
 734 + read the full name of the node (this field is read only and updated if the user changes the node name),
 735
 736 + specify the value of the "nsteps" input port if it is not connected with a link,
 737
 738 Property page for ForEachLoop node
 739 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 740 The property page for **ForEachLoop** node is shown on the figure below.
 741
 742 .. image:: images/functionality_list_69.jpg
 743   :align: center
 744
 745 .. centered::
 746   **Property page for ForEachLoop node**
 747
 748 The page allows the user to:
 749
 750 + change the name of the node,
 751
 752 + read the full name of the node (this field is read only and updated if the user changes the node name),
 753
 754 + read the input type of the loop (read only field),
 755
 756 + specify the value of the "nbBranches" input port if it is not connected with a link,
 757
 758 + specify the Sequence value of the "SmplsCollection" input port if it is not connected with a link,
 759
 760 Property page for While Loop node
 761 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 762 The property page for **While Loop** node is shown on the figure below.
 763
 764 .. image:: images/functionality_list_67.jpg
 765   :align: center
 766
 767 .. centered::
 768   **Property page for While Loop node**
 769
 770 The page allows the user to:
 771
 772 + change the name of the node,
 773
 774 + read the full name of the node (this field is read only and updated if the user changes the node name),
 775
 776 + specify the Boolean value of the "condition" input port if it is not connected with a link,
 777
 778 Property page for Switch node
 779 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 780 The property page for **Switch** node is shown on the figure below.
 781
 782 .. _pp_for_switch_node:
 783
 784 .. image:: images/functionality_list_70.jpg
 785   :align: center
 786
 787 .. centered::
 788   **Property page for Switch node**
 789
 790 The page allows the user to:
 791
 792 + change the name of the node,
 793
 794 + read the full name of the node (this field is read only and updated if the user changes the node name),
 795
 796 + specify the value of the "select" input port if it is not connected with a link,
 797
 798 + change the case value (integer or "default") associated with child nodes.
 799
 800 .. _pp_for_optimizer_node:
 801
 802 Property page for Optimizer Loop node
 803 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 804 The property page for **Optimizer Loop** node is shown on the figure below.
 805
 806 .. image:: images/functionality_list_47d.jpg
 807   :align: center
 808
 809 .. centered::
 810   **Property page for Optimizer Loop**
 811
 812 The page allows the user to:
 813
 814 - change the name of the node,
 815 - read the full name of the node (this field is read only and updated if the user changes the node name),
 816 - read the input data type (this field is read only and updated if the user changes the plugin),
 817 - change the number of branches
 818 - change the plugin : parameters lib and entry
 819 - change the initialization file : parameter FileNameInitAlg
 820
 821 Property page for Input Data node
 822 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 823 The property page for **Input Data** node is shown on the figure below.
 824
 825 .. image:: images/functionality_list_72.jpg
 826   :align: center
 827
 828 .. centered::
 829   **Property page for Input Data node**
 830
 831 The page allows the user to:
 832
 833 + change the name of the node,
 834
 835 + read the full name of the node (this field is read only and updated if the user changes the node name) and its type,
 836
 837 + change the list of output ports (it is possible to set port name, choose port data type from the corresponding
 838   combo boxes, set values for output ports).
 839
 840 Property page for Output Data node
 841 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 842 The property page for **Output Data** node is shown on the figure below.
 843
 844 .. image:: images/functionality_list_73.jpg
 845   :align: center
 846
 847 .. centered::
 848   **Property page for Output Data node**
 849
 850 The page allows the user to:
 851
 852 + change the name of the node,
 853
 854 + read the full name of the node (this field is read only and updated if the user changes the node name) and its type,
 855
 856 + change the list of input ports (it is possible to set port name, choose port data type from the corresponding combo boxes).
 857
 858 Property page for Input Study node
 859 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 860 The property page for **Input Study** node is shown on the figure below.
 861
 862 .. image:: images/functionality_list_74.jpg
 863   :align: center
 864
 865 .. centered::
 866   **Property page for Input Study node**
 867
 868 The page allows the user to:
 869
 870 + change the name of the node,
 871
 872 + read the full name of the node (this field is read only and updated if the user changes the node name) and its type,
 873
 874 + change the list of output ports. It is possible to set port name, choose port data type from the corresponding combo boxes, set
 875   values for output ports. The values must be SALOME study paths.
 876
 877 Property page for Output Study node
 878 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 879 The property page for **Output Study** node is shown on the figure below.
 880
 881 .. image:: images/functionality_list_75.jpg
 882   :align: center
 883
 884 .. centered::
 885   **Property page for Output Study node**
 886
 887 The page allows the user to:
 888
 889 + change the name of the node,
 890
 891 + read the full name of the node (this field is read only and updated if the user changes the node name) and its type,
 892
 893 + change the list of input ports. It is possible to set port name, choose port data type from the corresponding combo boxes and
 894   set values that must be SALOME study paths.
 895
 896
 897 .. _delete_object:
 898
 899 Delete an object
 900 ----------------
 901 The user can remove one or several objects from the current study.
 902
 903 To perform this operation the user should select object to be deleted in the Tree View or in the 2D Viewer and activates **Delete** item
 904 from its context popup menu.
 905
 906 With help of context popup menu the user can delete the following objects:
 907
 908 + node,
 909
 910 + link.
 911
 912 .. image:: images/functionality_list_76.jpg
 913   :align: center
 914
 915 .. centered::
 916   **An example of link deletion using link context popup menu in the 2D Viewer**
 917
 918 YACS module deletes the selected object with all sub-objects.
 919
 920 As the result of delete operation, the tree structure of the active schema in the Tree View and its representation in 2D Viewer
 921 are updated to reflect deletion of objects.
 922
 923 Input/output ports of inline nodes can also be deleted by the user with help of the Input Panel for this type of
 924 nodes (see the corresponding paragraph from :ref:`pp_for_node` section).
 925