Difference between revisions of "Geopsy: Groups"

From GeopsyWiki
Jump to navigation Jump to search
 
(22 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
[[Image:CreatingGroups.png|thumb|right|250px|Dialog box to create groups]]
 
[[Image:CreatingGroups.png|thumb|right|250px|Dialog box to create groups]]
  
 +
First the signals must be displayed in an active [[Geopsy: Signal Viewer|viewer]]. To create a group, select ''New group'' from menu ''Edit''. A dialog box lets you enter a name for the group and its parent. All types of names are accepted (blanks, accents, ...). Provide all required information (name and parent folder) and hit ''OK''. The new group is added to the ''Groups'' list on the left panel of Geopsy and appears as follow :    [[Image:GroupList.png|text-top]].
  
First, the Group list must be displayed. If not, go to ''Windows menu'' / ''Tool bars'' and select Groups, the Group list is now displayed on the left panel.
+
If the  the Group list is not displayed, go to menu ''Windows '' / ''Tool bars'' and select Groups, the Group list is now displayed on the left panel.
  
There must be an active [[Geopsy: Signal Viewer|viewer]]. Select ''New group'' from menu ''Edit''. A dialog box lets you enter a name for the group and its parent. All types of names are accepted (blanks, accents, ...). Provide all required information (name and parent folder) and hit ''OK''. The new group is added to the ''Groups'' list and appears as follow :    [[Image:GroupList.png|160px|text-top]].
 
  
 +
Note that:
 +
* Two groups can share the same name and same parent but it is confusing for the user
 +
* It is not recommended to create groups with temporary signals. It is stongly recommended to save the temporary signals in the database and then create the groups with the saved signal files
 +
* Saving the database is mandatory to keep the group permanently
 +
<br style="clear: both"/>
  
Note that:
+
[[Image:Group.png|thumb|left|800px|Created group]]
* Two groups can share the same name and same parent but it is confusing for the user.  
 
* Saving the database is mandatory to keep the group permanently.
 
 
<br style="clear: both"/>
 
<br style="clear: both"/>
  
Line 19: Line 22:
 
[[Image:CreatingSeveralGroups.png|thumb|right|400px|Creating several groups]]
 
[[Image:CreatingSeveralGroups.png|thumb|right|400px|Creating several groups]]
  
It is possible to create several groups automatically. The current viewer is browsed and a new group is created every time the ''Key'' value change. A base name containing formulas (see [[Geopsy:_Table|Set Headers]]) can be specified in the dialog box ''Name''.
+
It is possible to create several groups automatically. The current viewer is browsed and a new group is created every time the ''Key'' value change. A base name containing formulas (see [[Geopsy: Edit menu#Set headers|Set Headers]]) can be specified in the dialog box ''Name''. The parent folder can be also specified as described above.
  
 
The properties of the first signal in the newly created group are taken in account to build the group name. Signal are not sorted before splitting in groups. It is the user responsibility to sort the signals with the correct keys.
 
The properties of the first signal in the newly created group are taken in account to build the group name. Signal are not sorted before splitting in groups. It is the user responsibility to sort the signals with the correct keys.
Line 25: Line 28:
  
 
A code:
 
A code:
  Sensor {fn=right(Name,5);Return=fn;}
+
  Sensor {Return=right(Name,5);}
  
 
Will produce group names:  
 
Will produce group names:  
Line 39: Line 42:
  
 
'Return' variable must be defined in the expression between {}.
 
'Return' variable must be defined in the expression between {}.
 
  
 
== Viewing groups ==
 
== Viewing groups ==
  
Groups are manipulated in the same way as files with the [[Geopsy:Signal drag&drop|drag and drop mechanism]].
+
Groups are manipulated in the same way as files with the [[Geopsy: Signal drag&drop|drag and drop mechanism]].
 
 
  
 
== Modifying a group ==
 
== Modifying a group ==
Line 53: Line 54:
 
== Organizing groups ==
 
== Organizing groups ==
  
=== Renaming a group ===
+
=== Renaming groups ===
 
 
Select only one group (not the first one "All groups"). Click on the right mouse button. In the context menu select ''Properties''. Type the new name in the dialog box ''Name'' [[Image:GroupChangeName.png|300px|top-text]] and hit ''OK''.
 
  
The ".group" file corresponding to the group is directly renamed, but the ".grouplist" file is not affected. Do not forget to save the database to avoid any loss of the ID list belonging to this group. This situation may be repaired by renaming manually the ".group" file to its original name.
+
Select only one group (not the first one "All groups"). Click on the right mouse button. In the context menu select ''Properties''. Type the new name in the dialog box ''Name'' [[Image:GroupChangeName.png|top-text]] and hit ''OK''.
  
 
+
=== Creating folders ===
=== Group trees ===
 
 
[[Image:GroupTree.png|thumb|right|400px|Groups tree]]
 
[[Image:GroupTree.png|thumb|right|400px|Groups tree]]
  
Groups can be organizing in tree using folders. To create a folder click right in the ''Group list'' tool bar and select ''New Folder''. An empty folder called ''New Folder'' is created.
+
To create a folder click right in the ''Group list'' tool bar and select ''New Folder''. An empty folder called ''New Folder'' is created. The name of the folder can be modified following the instruction ''Renaming a group''.
 
 
 
 
 
 
=== Moving a group ===
 
  
 +
=== Moving groups ===
 +
Groups are organized in a tree, hence a group has always one parent ('/' for root groups). It is always possible to modify the parent folder. To do this, click right on the group name (in the ''Group list'' tool bar), select ''Properties''. In the dialog box ''Parent folder'', drag & drop the name of the parent folder to the right position  [[Image:GroupMoving.png|text-top]]
  
 
=== Deleting groups ===
 
=== Deleting groups ===
  
Select one of more groups and choose "Remove" from the context menu (after a right click in the "Groups" list"). ".group" files are directly removed from the database directory, hence this action cannot be cancelled. Saving the database is mandatory if you do not want to pollute the "Groups" list with empty defunct groups.
+
Select one of more groups and choose ''Remove'' from the context menu (after a right click in the "Group list"). Saving the database is mandatory if you want to save the modifications [[Image:GroupRemove.png|text-top]]

Latest revision as of 09:14, 11 March 2010

This section explains how to create and to use groups of signals. Groups are ordered lists of signals referenced by their unique signal ID. Groups are organized in a tree, hence a group has always one parent ('/' for root groups). A group with children does not own signals on its own, but owns all the signals of its children and and their descendants.

Creating a new group

Dialog box to create groups

First the signals must be displayed in an active viewer. To create a group, select New group from menu Edit. A dialog box lets you enter a name for the group and its parent. All types of names are accepted (blanks, accents, ...). Provide all required information (name and parent folder) and hit OK. The new group is added to the Groups list on the left panel of Geopsy and appears as follow : GroupList.png.

If the the Group list is not displayed, go to menu Windows / Tool bars and select Groups, the Group list is now displayed on the left panel.


Note that:

  • Two groups can share the same name and same parent but it is confusing for the user
  • It is not recommended to create groups with temporary signals. It is stongly recommended to save the temporary signals in the database and then create the groups with the saved signal files
  • Saving the database is mandatory to keep the group permanently


Created group



Creating several groups

Creating several groups

It is possible to create several groups automatically. The current viewer is browsed and a new group is created every time the Key value change. A base name containing formulas (see Set Headers) can be specified in the dialog box Name. The parent folder can be also specified as described above.

The properties of the first signal in the newly created group are taken in account to build the group name. Signal are not sorted before splitting in groups. It is the user responsibility to sort the signals with the correct keys.

A code:

Sensor {Return=right(Name,5);}

Will produce group names:

Sensor WAU01 
Sensor WAU02 
Sensor WAU03
Sensor WAU04 
Sensor WAU05 
Sensor WAU06
Sensor WAU07 
Sensor WAU08


'Return' variable must be defined in the expression between {}.

Viewing groups

Groups are manipulated in the same way as files with the drag and drop mechanism.

Modifying a group

Create a viewer (e.g. a Table) with the group. Modify its content (sorting, adding new signals, ...). Select New group in menu Edit and enter the name of the existing group. The original group will be overwritten. Saving the database in this case is not necessary but strongly advised to avoid confusions with the other actions.


Organizing groups

Renaming groups

Select only one group (not the first one "All groups"). Click on the right mouse button. In the context menu select Properties. Type the new name in the dialog box Name top-text and hit OK.

Creating folders

Groups tree

To create a folder click right in the Group list tool bar and select New Folder. An empty folder called New Folder is created. The name of the folder can be modified following the instruction Renaming a group.

Moving groups

Groups are organized in a tree, hence a group has always one parent ('/' for root groups). It is always possible to modify the parent folder. To do this, click right on the group name (in the Group list tool bar), select Properties. In the dialog box Parent folder, drag & drop the name of the parent folder to the right position GroupMoving.png

Deleting groups

Select one of more groups and choose Remove from the context menu (after a right click in the "Group list"). Saving the database is mandatory if you want to save the modifications GroupRemove.png