Difference between revisions of "Geopsy: Groups"

From GeopsyWiki
Jump to navigation Jump to search
Line 2: Line 2:
  
 
== Creating a new group ==  
 
== Creating a new group ==  
[[Image:CreatingGroups.png|thumb|right|200px|Dialog box to create groups]]
+
[[Image:CreatingGroups.png|thumb|right|250px|Dialog box to create groups]]
  
 
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.
 
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.
  
There must be an active [[Geopsy: Signal Viewer|viewer]]. Select item ''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]].
+
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]].
  
  
Line 15: Line 15:
  
 
=== 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 can be specified in the dialog box ''Name''. 
  
 +
'Return' variable must be defined in the expression between {}.
 +
 +
 +
 +
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.
  
 
<br style="clear: both"/>
 
<br style="clear: both"/>

Revision as of 13:36, 9 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 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.

There must be an active 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 : GroupList.png.


Note that:

  • 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.


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 can be specified in the dialog box Name.

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


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.


Viewing groups

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

From here: TODO

Organizing groups

Renaming a group

Select only one group (not the first one "All groups"). Click on the right mouse button. In the context menu select "Rename". Type the new name in the simple dialog box 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.

Moving a group

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.


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.