source: tags/ms_r16q4/HELP_SOURCE/oldhelp/props_nds.hlp

#Please insert up references in the next lines (line starts with keyword UP)
UP      arb.hlp
UP      glossary.hlp
UP      sp_info.hlp

#Please insert subtopic references  (line starts with keyword SUB)
#SUB    subtopic.hlp

# Hypertext links in helptext can be added like this: LINK{ref.hlp|http://add|bla@domain}

#************* Title of helpfile !! and start of real helpfile ********
TITLE           Node Display Setup (NDS)

OCCURRENCE      ARB_NT/Tree/NDS
                ARB_GENE_MAP/Properties/NDS

NOTES           Read this text carefully. You won't need this function, but
                it offers many many new possibilities.

DESCRIPTION     Extracts data from the database entries of every species and
                builds a user-readable string from that data.

                This string can be used in many different functions, especially
                to show the species information at the tips of the tree or
                to show gene information at the tips of the genes in the
                gene map.

                It allows you to show part of the sequences, the full_name,
                the accession numbers right in the tree. You may even
                generate tables with all kinds of useful information, like
                probe match results for a set of oligo probes.

                Choose the 'NDS' item from the 'ARB_NT/Tree' menu to
                display the 'NDS' window.

                Enable field extraction:

                        Press the 'LEAF' and/or 'GRP.' checkbox to activate the display of
                        the corresponding 'field' entry at leafs and/or groups
                        of the tree shown in the tree display area of the 'ARB_NT' window.

                Select 'FIELD':

                        The order of the data shown at the tree nodes
                        (from left to right) corresponds to that in the 'NDS'
                        window (top to bottom). To select a 'field' enter the field name
                        by hand or press the respective <S> button and select it
                        from the popup-list.

                        Press <RESCAN> there to display all fields, if fields have been deleted
                        from the list by 'Species Information/Delete hide fields'.

                Define number of characters:

                        Type the number of characters (including blanks) to be
                        displayed to the 'WIDTH' subwindow.

                Display SRT/ACI:

                        The 'Search and replace Tool (SRT)' and the 'ARB Command
                        Interpreter (ACI)' in combination with 'Nodes Display
                        Setup (NDS)' allows information to be extracted and/or modified
                        from the 'Field' entries, before being displayed at the tree nodes.

                        Press the corresponding <SRT> button to display the
                        'SRT_ACI_SELECT' window and select a predefined procedure
                        (see LINK{acisrt.hlp}).

                        The corresponding syntax (see LINK{srt.hlp}, LINK{aci.hlp} and
                        LINK{reg.hlp}) is displayed in the 'ACI SRT PROGRAM' subwindow.
                        The displayed strings can be modified by typing to the subwindows.

SECTION         Sets of entries

                NDS configuration is done using 10 visible entries. 
                Using the 'Entries XX - YY' button
                you can select which entry subset (of the overall 60 available entries) is shown in this window.
                
                For the resulting display information, you can use the next button to choose whether to

                        1. Use all entries (=default for backwards compatibility) or
                        2. Only use visible entries (recommended use)

                If you choose 1., any activated entry (out of 1-60) is used to create the resulting display information.
                Switching between entry subsets has no effect on result.

                If you choose 2., only the entries currently displayed in the NDS window are used to 
                create the resulting display information. You may use the 'Entries ...' button
                to quickly switch between different display setups.

NOTES           Strings generated using 'SRT' or 'ACI' and displayed at the
                nodes are not stored in the database. You can use
                the 'Modify fields of listed species'-menuentry in the
                'Search & Query' window to do this.

                The width of the output is limited to 4000 characters.

EXAMPLES        None

WARNINGS        The NDS setup is stored in the loaded ARB database.

                You can use the config-manager to store/restore the currently edited 10 entries
                into/from a named config. These configs will be stored in your account when
                you save properties.
                Such stored configs can be used to copy the NDS (e.g. from 'Entries 1-10' to 'Entries 11-20'
                or from one ARB database to another).

BUGS            None