source: branches/sina/HELP_SOURCE/source/species_configs.hlp

Last change on this file was 19731, checked in by westram, 3 months ago
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 3.8 KB
Line 
1#       main topics:
2UP      arb.hlp
3UP      glossary.hlp
4
5#       sub topics:
6SUB     e4.hlp
7SUB     mark.hlp
8
9# format described in ../help.readme
10
11
12TITLE           Species selections admin
13
14OCCURRENCE      ARB/Species/Selections
15                ARB/<number marked button>
16                ARB_MERGE/Transfer selections/Edit selection
17                ARB_MERGE/Transfer species/<number marked buttons>
18
19DESCRIPTION     Species selections basically are sets of species.
20
21                Technically the terms "species selections" and "editor configurations"
22                (or simply "configurations") are synonymic. For a detailed description
23                what is stored in an editor configuration see LINK{species_configs_saveload.hlp}.
24
25                You may use species selections to
26
27                    * save/restore which species are currently marked (see LINK{mark.hlp}).
28                      Available operations are decribed below.
29                    * start the sequence editor on a defined set of species (see LINK{arb_edit4.hlp})
30                    * highlight multiple species selections in the tree display
31                      using the 'Highlight in tree' button (see LINK{species_configs_highlight.hlp}).
32                      Note: this button is not available when called from mergetool.
33
34                This window provides several operations on species selections:
35
36                        - STORE (save a (new) species selection)
37                        - EXTRACT (= unmark all, then mark the species stored in the selected species selection)
38                        - MARK/UNMARK/INVERT (mix currently marked species with those marked in the selected species selection)
39                        - COMBINE (unmarks all that are not in the selected species selection. This generates an intersection
40                          between the currently marked species and those from the selected species selection)
41                        - DELETE (delete a species selection)
42                        - RENAME (rename a species selection)
43
44                Each species selection has a comment which may be changed by
45                editing the 'Comment' textfield. The 'Clear' button will remove
46                the comment in two steps:
47                  * first all dated log entries (1st click)
48                  * then the rest of the comment (2nd click)
49
50NOTES           The species selection window is also available via the buttons, that show the number
51                of marked species, located in the top area of the main arb window
52                and in the LINK{mg_species.hlp} window (<number marked button>).
53
54                The number behind the species selections in the list informs about the
55                number of species stored in each selection.
56
57                To test whether a selection contains the currently marked set of species,
58                first check whether the number of marked species (displayed on the button in the
59                main window) equals the number behind the selection in the list.
60
61                If so, use the INVERT button and check the number of marked species again:
62                * if there was a warning about unknown species, the selection differs,
63                * if there are no marked species (=button is empty), the selection is equal,
64                * otherwise it differs.
65
66                In any case click INVERT again to restore the previously marked set of species.
67
68EXAMPLES            None
69
70WARNINGS        Unfortunately we use the term 'configuration' for two things:
71                  * configurations of settings/properties (as described in LINK{prop_configs.hlp})
72                  * species-selections aka editor-configurations (as described here)
73
74                Please do not mix them up.
75
76                Also note that "Species selections" have nothing todo with the LINK{selected.hlp}.
77
78BUGS                No bugs known
79
Note: See TracBrowser for help on using the repository browser.