group links menu documentation
[jalview.git] / help / html / menus / popupMenu.html
1 <html>
2 <head>
3 <title>Popup Menu</title>
4 </head>
5
6 <body>
7 <p><strong>Popup Menu</strong><br>
8 <em>This menu is visible when right clicking either within a
9 selected region on the alignment or on a selected sequence name. It may
10 not be accessible when in 'Cursor Mode' (toggled with the F2 key).</em></p>
11 <ul>
12   <li><strong>Selection</strong> 
13     <ul>
14       <li><strong>Edit </strong> 
15         <ul>
16           <li><strong>Copy</strong><br>
17             <em>Copys the selected region. In the applet version, the copied sequences 
18             are not available to the system clipboard.</em></li>
19           <li><strong>Cut<br>
20             </strong><em>Cuts the selected region from the alignment. In the applet 
21             version, the copied sequences are not available to the system clipboard.</em></li>
22           <li><strong>Edit Sequence</strong><br>
23             <em>Edit the selected sequence(s) directly. Spaces will be converted 
24             to the current gap character.</em></li>
25           <li><strong>To Upper Case</strong><em><strong><br>
26             </strong><em>Changes the case of selected region to lower case.</em> 
27             </em></li>
28           <li><strong>To Lower Case<br>
29             </strong><em>Changes the case of selected region to upper case.</em><strong> 
30             </strong></li>
31           <li><strong>Toggle Case</strong><br>
32             <em>Switches the case of all residues within the selected region.</em></li>
33         </ul>
34       </li>
35       <li><strong>Output to Textbox<br>
36         </strong><em>The selection area will be output to a a text window in the 
37         selected alignment format. </em></li>
38       <li><strong><a href="../features/creatinFeatures.html">Create Sequence Feature...</a></strong><br>
39         <em>Opens the dialog box for creating sequence features over the currently 
40         selected region on each selected sequence.</em></li>
41       <li><strong>Group</strong><br>
42         <em>Group Operations</em> 
43         <ul>
44           <li><strong>Group</strong><em>This is the first entry in the
45           menu, and will display the currently selected group's
46           name. Selecting it displays a window allowing the name and
47           description for this group to be edited. Click OK to set the
48           new name and decription, and cancel to leave the existing
49           name and description unchanged.</em></li>
50           <li><strong>Remove Group<br>
51             </strong><em>This will undefine the selected group. </em><strong> 
52             </strong></li>
53           <li><strong>Group Colour<br>
54             </strong><em>Sets the <a href="../colourSchemes/index.html">colour</a> 
55             of the group.</em><strong> </strong></li>
56           <li><strong>Boxes<br>
57             </strong><em>If selected the background of a residue within the selected 
58             group will be coloured according to the assigned colour scheme.</em><strong> 
59             </strong></li>
60           <li><strong>Text<br>
61             </strong><em>If selected the selected group will display text. </em></li>
62           <li><strong>Colour Text<br>
63             </strong><em>If selected the selected group will display text in a 
64             colour slightly darker than the background colour of that residue.</em></li>
65           <li><strong>Border Colour <br>
66             </strong><em>Selecting this will display a &quot;Colour Chooser&quot; 
67             window. Select a colour than press OK to set the border colour of 
68             a group.</em></li>
69         <li><strong>Show Unconserved<br>
70           </strong><em>When this is selected, all symbols in the group matching the consensus sequence at that column will be rendered as a '.', highlighting mutations in the group area.
71         </em></li>
72                     </ul>
73       </li>
74       <li><strong>Group Links<br>
75     </strong><em>This menu is only visible if there are group links available for the current selection.
76     </em> 
77     <ul>
78     <li><em>ID links</em> allow you to send IDs associated with the current selection to a web server.</li>
79     <li><em>Sequence links</em> allow you to send the sequences in the currently selected region to a web server.</li>
80     <li><em>Sequence and ID links</em> allow you to send sets of IDs and sequences associated with the current selection to a web server.</li>
81     </ul>
82     <em>Group Links were added in Jalview 2.4.1</em></li>
83     </ul>
84   </li>
85   <li><strong>Sequence Id<br>
86     </strong><em>This menu is only visible if you right-click on a sequence name. 
87     </em> 
88     <ul>
89       <li><strong>Edit Name/Description<br>
90         </strong><em>You may edit the name and description of each sequence. A 
91         window will be displayed asking for a new sequence name and sequence description 
92         to be entered. Press OK to accept your edit. To save sequence descriptions, 
93         you must save in Fasta, PIR or Jalview File format.</em></li>
94       <li><em> </em></li>
95       <li><strong>Represent Group With (Sequence Id)</strong><br>
96         <em>All sequences in the current selection group will be hidden, apart 
97         from (Sequence Id). Any edits performed on the visible representative 
98         sequence will be propagated to the hidden sequences. </em></li>
99       <li><a name="sqid.popup"><strong>Link</strong><br>
100         <em>This menu item lists all links which have been set up in the <a href="../features/preferences.html">Preferences</a> 
101         Connections tab.<br>
102         Since Jalview 2.4, links will also be made for database cross 
103         references (where the database name exactly matches the link name set up in <a href="../features/preferences.html">Preferences</a>).
104         <br>Since Jalview 2.4.1, links are also shown for non-positional sequence features attached to 
105         the sequence, and any regular-expression based URL links that 
106         matched the description line.
107         </em><strong><br>
108         </strong></li>
109     </ul>
110   </li>
111   <li><strong>Structure</strong> 
112     </strong><em>This menu is only visible if you right-click on a sequence name. 
113     </em> 
114     <ul>
115       <li><strong>Associate Structure with Sequence</strong> 
116         <ul>
117           <li><strong>From File<br>
118             </strong><em>Load a PDB file from local disk which will be associated 
119             with this sequence. This file will be used if the user subsequently 
120             clicks on &quot;View PDB Structure&quot; menu item.</em></li>
121           <li><strong>Enter PDB id<br>
122             </strong><em>Enter the PDB id from an input window. This PDB id will 
123             be used by the service WSDBFetch, provided by the EBI, to fetch the 
124             PDB file if the user subsequently clicks on &quot;View PDB Structure&quot; 
125             menu item. </em></li>
126           <li><strong>Discover PDB ids<br>
127             </strong><em>This will use the service WSDBFetch, provided by the 
128             EBI, to retrieve all PDB ids associated with the sequences in the 
129             alignment if the sequences have valid Uniprot names or accession ids. 
130             </em></li>
131         </ul>
132       </li>
133       <li><strong>View Structure<br>
134         </strong><em> If the sequence has an associated PDB file added by one 
135         of the methods described above, Jalview will display a 3D interactive 
136         viewer of the file.<br>
137         These entries will only be present if the sequence has <a
138                         href="../features/viewingpdbs.html">associated PDB structures</a>.</em><br>
139       </li>
140     </ul>
141   </li>
142   <li><strong>Hide Sequences</strong><br>
143     <em>Hides the currently selected sequences in this alignment view.</em><strong><br>
144     <br>
145     </strong></li>
146 </ul>
147 </body>
148 </html>