Changes for page 5. Diagrams Development Manual
Last modified by Iaroslav Platonov on 2026/06/08 10:32
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 3 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -588,7 +588,7 @@ 588 588 589 589 Figure 4.35. Viewing a diagram with manual input objects 590 590 591 -Fig. 4.35 shows two examples with the manual input objects. To manage the values of the real-time parameters, right-click or left-click in the rendered areas. After clicking, an icon [[image:Screenshot 2025-12-04 at 13.34.21.png||height="27" width="26"]]appears on the right. When clicked, the value is entered manually, as well as an icon [[image:Screenshot 2025-12-04 at 13.34.45.png||height="30" width="33"]] for manual input before data is received. This manual input value is to be reset automatically after data is received. To reset the values entered manually, click on [[image:Screenshot 2025-12-04 at 13.35.12.png||height="28" width="27"]]. 591 +Fig. 4.35 shows two examples with the manual input objects. To manage the values of the real-time parameters, right-click or left-click in the rendered areas. After clicking, an icon [[image:Screenshot 2025-12-04 at 13.34.21.png||height="27" width="26"]]appears on the right. When clicked, the value is entered manually, as well as an icon [[image:Screenshot 2025-12-04 at 13.34.45.png||height="30" width="33"]] for manual input before data is received. This manual input value is to be reset automatically after data is received. To reset the values entered manually, click on [[image:Screenshot 2025-12-04 at 13.35.12.png||height="28" width="27"]]. 592 592 593 593 == 4.12. Input of fixed manual entry values == 594 594 ... ... @@ -758,8 +758,220 @@ 758 758 * **Polling frequency (s)** is the time interval for updating data in the table, in seconds. 759 759 * **Interval **is for selection of the data interval (applies to the entire table). 760 760 * **Function** is data aggregation applied to the entire table. 761 -* **ID** specifies the metering channel, which can be entered manually or selected from a drop-down list [[image:Screenshot 2025-12-04 at 14.07.38.png]] 761 +* **ID** specifies the metering channel, which can be entered manually or selected from a drop-down list [[image:Screenshot 2025-12-04 at 14.07.38.png||height="26" width="27"]] 762 +* **Name **is the column name corresponding to the metering channel. 763 +* **Width **is the column width. 764 +* **Change time **is a system field used to display the time of the metering channel's value change. 762 762 766 +Rows in this table can be moved [[image:Screenshot 2025-12-04 at 14.08.30.png]], deleted [[image:Screenshot 2025-12-04 at 14.09.56.png||height="32" width="33"]], and added [[image:Screenshot 2025-12-04 at 14.10.25.png||height="31" width="89"]]. 767 + 768 +[[image:Screenshot 2025-12-04 at 14.10.47.png]] 769 + 770 +Figure 4.55. Display of metering channel data 771 + 772 +Fig. 4.55 shows the table in the diagram viewer using the settings from Fig. 4.54. Line formatting for the data is applied according to the table header. 773 + 774 +== 4.19. Heatmaps == 775 + 776 +Heatmap functionality is accessible only with an active license for the corresponding module. 777 + 778 +The graphic element templates contain the **Sensor** element (see Fig. 4.56), which is responsible for filling areas of the diagram depending on any tag values. 779 + 780 +[[image:Screenshot 2025-12-04 at 14.11.51.png||height="72" width="83"]] 781 + 782 +Figure 4.56. Sensor graphic element 783 + 784 +On the objects of the diagram, place such images and, in the window with the bindings of the rules [[image:Screenshot 2025-12-04 at 14.12.20.png||height="22" width="26"]]in the actions, specify the ID of the tag, which changes the color (for example, see Fig. 4.57). 785 + 786 +Images need to be placed on the diagram objects, and in the **Component visual settings** window [[image:Screenshot 2025-12-04 at 14.12.20.png||height="22" width="26"]], the tag ID should be specified in the actions, which triggers the color change upon tag value modification (see example in Fig. 4.57). 787 + 788 +[[image:Screenshot 2025-12-04 at 14.13.22.png]] 789 + 790 +Figure 4.57. Binding to the tag ID 791 + 792 +After arranging and binding such sensors, select those elements (might be selected together with other graphic objects), the area inside which changes colors according to changes in the linked tags in the rules. Then click **Create heatmap** (see Fig. 4.58). 793 + 794 +[[image:Screenshot 2025-12-04 at 14.13.52.png]] 795 + 796 +Figure 4.58. Create heatmap 797 + 798 +The created heatmap can be edited by right-clicking on the **Heatmap properties** (see Fig. 4.56). The modal window specifies the high and low limits, the normal value, the gamma (the range of colors for building a heatmap), the power parameter (the temperature for building transitions between temperatures), and the ability to display only those points that exceed the temperature in normal mode, see Fig. 4.60. 799 + 800 +[[image:Screenshot 2025-12-04 at 14.14.27.png]] 801 + 802 +Figure 4.59. Editing heatmap properties 803 + 804 +[[image:Screenshot 2025-12-04 at 14.14.52.png]] 805 + 806 +Figure 4.60. Heatmap 807 + 808 +== 4.20. Layers == 809 + 810 +In editing mode, to optimize work with large diagrams, individual sections of the diagram can be placed in layers that do not affect operation in viewing mode. 811 + 812 +To switch to the layer mode, go to the View > Layers in the upper horizontal menu (Ctrl+Shift+L). 813 + 814 +[[image:Screenshot 2025-12-04 at 14.15.37.png]] 815 + 816 +Figure 4.61. Layers menu 817 + 818 +Fig. 4.61 shows an example of a list of layers where: 819 + 820 +1. Add layer is used to add a part of the diagram to the layer with the name. 821 +1. Duplicating the selected layer in the list. 822 +1. It is used to move diagram elements from one layer to another. 823 +1. The layer removal button. 824 +1. To disable or enable the parts of the diagram included in a specific layer. Moreover, disabling the layer does not affect the display in viewing mode, but only speeds up editing. 825 +1. Blocking changes to a layer from the list. 826 +1. Foreground/background of the layer. 827 + 828 +== 4.21. Active SVG elements == 829 + 830 +The diagram editor allows importing graphic element templates in SVG format from various sources. Developed animated images from external sources help optimize work in both view and edit modes of the diagram (see Section 4.22.1). They also enable monitoring technological processes with the ability to view moving and rotating objects on the diagram (see Section 4.22.2). 831 + 832 +=== 4.21.1. Active SVG elements to speed up the opening and editing of the diagram === 833 + 834 +In editing mode, to optimize work with large diagrams, active elements in SVG format can be loaded. Such elements are created by software developers. The approach is in using a ready-made template for the active element specifying in the rules only the tag/attribute that is responsible for a particular action. Any graphic elements can be modified using a program that supports the SVG format, or directly by editing the file’s code. 835 + 836 +The loading of items is in the **Extras** menu item (see Fig. 4.62). 837 + 838 +[[image:Screenshot 2025-12-04 at 14.17.19.png]] 839 + 840 +Figure 4.62. Import animated SVGs 841 + 842 +Ready-made templates should be uploaded to the **Import animated SVG**s menu (see Fig. 4.63). 843 + 844 +[[image:Screenshot 2025-12-04 at 14.17.47.png]] 845 + 846 +Figure 4.63. Import animated SVGs 847 + 848 +The template uploaded in Fig. 4.64 replaces drawing of many graphic elements created in the diagram editor. 849 + 850 +[[image:Screenshot 2025-12-04 at 14.18.12.png]] 851 + 852 +Figure 4.64. Animated SVG 853 + 854 +For example, it is necessary to display the status of a discrete signal (switch position), as shown in Fig. 4.65. In case of developing diagrams in the editor, it is necessary to draw all the sticks and text forms separately (see Fig. 4.66) and describe each state in the rules. 855 + 856 +[[image:Screenshot 2025-12-04 at 14.18.44.png]] 857 + 858 +Figure 4.65. Legend for the position of the switch 859 + 860 +[[image:Screenshot 2025-12-04 at 14.19.10.png]] 861 + 862 +Figure 4.66. Graphic elements 863 + 864 +In case of using an .svg file, these states are written inside the code and after importing them into the editor, the user cannot visually track them in any way. After importing the file, configure the rules in the actions of which the **Status** field appears (see Fig. 4.67) with the selection of a specific state, depending on the conditions described in the rule. 865 + 866 +[[image:Screenshot 2025-12-04 at 14.19.47.png]] 867 + 868 +Figure 4.67. Rules for animated SVG 869 + 870 +The code of the animated element is shown below: 871 + 763 763 ---- 764 764 874 +<svg xmlns="http:~/~/www.w3.org/2000/svg" viewBox="0 0 80 80" width="80" height="80" 875 + 876 +data-states='{"On":{"~-~-background":"#d50404","~-~-border":"var(~-~-main)"}, 877 + 878 +"Off":{"~-~-background":"#0f0","~-~-border":"var(~-~-main)"}, 879 + 880 +"Error/Intermediate":{"~-~-background":"#fff","~-~-border":"var(~-~-main)"}, 881 + 882 +"WE are exhausted":{"~-~-background":"#00f","~-~-border":"var(~-~-main)"}, 883 + 884 +"n/a":{"~-~-background":"transparent","~-~-border":"#000"}}'> 885 + 886 +<rect style="fill:var(~-~-background,transparent);stroke:var(~-~-border,var(~-~-main,#000));stroke-width:6;" height="80" width="80" /> 887 + 888 +</svg> 889 + 890 +---- 891 + 892 +=== 4.21.2. Animated SVG === 893 + 894 +If proficiency in CSS or SVG code is available, an animated SVG template can be independently developed based on the example provided in Section 4.21.1, along with the application of various animations for technological processes. 895 + 896 +Fig. 4.68 shows an example of graphic elements with various animated styles configured through an SVG file. This animation is imported into the menu, as shown in Fig. 4.62, and in the mnemonic diagram editor, it appears as an image where only the size can be adjusted; all other edits are made within the template from the external source (such as Inkscape, Figma, etc.). 897 + 898 +[[image:Screenshot 2025-12-04 at 14.21.36.png]] 899 + 900 +Figure 4.68. Animated Image 901 + 902 +Each element created, for example, Inkscape has a group, and each group has its own animation settings. 903 + 904 +For example, in Fig. 4.68, a grouped element is rendered, which needs to be moved up or down. The animation code for it would look as follows: 905 + 906 +---- 907 + 908 +<animateTransform 909 + 910 + attributeName="transform" 911 + 912 + attributeType="XML" 913 + 914 + type="rotate" 915 + 916 + values="360 85 83; 310 85 83; 360 85 83" 917 + 918 +keySplines="1 .9 .1 0 ; 0 .1 .9 1" 919 + 920 + dur="4s" 921 + 922 + repeatCount="indefinite" /> 923 + 924 +---- 925 + 926 +If the object needs to rotate around an axis (see Fig. 4.68), the example code for rotating counterclockwise would look like this: 927 + 928 +---- 929 + 930 +<animateTransform 931 + 932 + attributeName="transform" 933 + 934 + attributeType="XML" 935 + 936 + type="rotate" 937 + 938 +values="0 117.36 311.98; 360 117.36 311.98" 939 + 940 +begin = "-3.1s" 941 + 942 + dur="4s" 943 + 944 + repeatCount="indefinite" /> 945 + 946 +---- 947 + 948 +For clockwise rotation, the example code would look like this: 949 + 950 +---- 951 + 952 +<animateTransform 953 + 954 + attributeName="transform" 955 + 956 + attributeType="XML" 957 + 958 + 959 + type="rotate" 960 + 961 + from="0 112.36 251.98" 962 + 963 + to="360 112.36 251.98" 964 + 965 + dur="3s" 966 + 967 + repeatCount="indefinite" /> 968 + 969 +---- 970 + 971 +The coordinates values/from/to depend on the initial position of the graphic element. The smaller the time value (dur), the more frequently the graphic element moves. 972 + 973 +Thus, by knowing the SVG and CSS code, any animations can be imported into the diagram editor. 974 + 975 +---- 976 + 765 765
- Screenshot 2025-12-04 at 14.19.10.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Lana - Size
-
... ... @@ -1,0 +1,1 @@ 1 +24.0 KB - Content
- Screenshot 2025-12-04 at 14.19.47.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Lana - Size
-
... ... @@ -1,0 +1,1 @@ 1 +141.5 KB - Content
- Screenshot 2025-12-04 at 14.21.36.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Lana - Size
-
... ... @@ -1,0 +1,1 @@ 1 +220.8 KB - Content