Chapter 3. The Sequence Manager | |
This chapter explains how to use the Sequence Manager to add, edit, and manage sequence data. It also describes the project management functions, which are available from the Sequence Manager.
The Sequence Manager provides an easy way to manage and manipulate sequences in SeqWeb. You can view, add, create, edit and document, copy, delete, and save sequences using the Sequence Manager. The Sequence Manager also provides access to project management functions to help you organize your work. To open the Sequence Manager:
The Sequence Manager window lists the sequences associated with the currently selected project.
To select a sequence, just click on it. The description for the selected sequence displays in the status line at the bottom of the window. You can select multiple sequences by clicking on them, and they do not have to be contiguous in the list. If you select multiple sequences, the status line displays only the description for the last sequence selected. To deselect a sequence, click on it again. To easily select or deselect all sequences, use the Edit menu. If you double-click on a sequence, the Sequence Editor displays, containing the selected sequence.
|
There are three ways to get sequences into SeqWeb. You can add them using the clipboard, which is the easiest and most often used method, or you can add them from a local file or a database. All of these methods are available from either the Sequence Manager or from the input form of any SeqWeb program.
You can add sequences into SeqWeb by using the clipboard and either typing or copying and pasting text.
To add a sequence using the clipboard:
Or, from within a program, click on the Add From Clipboard... button located at the bottom of the Input Sequence area.
The Add from Clipboard window appears.
Name: (required) The sequence name.
Description Line: (optional) A brief description of the sequence. This description will appear in the status bar at the bottom of the browser window when you select a sequence in SeqWeb.
Reference: (optional) Additional sequence comments and reference information.
Sequence Data: (required) The sequence residues. This field may contain the following characters:
A B C D E F G H I K L M N P Q R S T U V W X Y Z (not J or O)
a b c d e f g h i k l m n p q r s t u v w x y z (not j or o)
. (period) ~ (tilde) * (asterisk)
The Sequence Data field may also contain spaces.
Note: After adding sequences from within a program, you may have to select Refresh to see the added sequences in your list.
You can add a local sequence file into SeqWeb from the Sequence Manager or from within a program. However, to add a local sequence file, it must first reside on the computer from which you are running the web browser and it must be in a recognized file format. If you are unsure of the file format, use the clipboard method to add sequence data.
SeqWeb accepts most GCG sequence file formats, including:
Note: SeqWeb reformats MSF and RSF files and creates single sequences files out of the multiple sequences they contain. Note that SeqWeb does not accept list file format.
SeqWeb also accepts the following non-GCG sequence formats:
Note: If you have sequence files you used in SeqLab or the command-line version of the Wisconsin Package, and you want to use them with SeqWeb, see Transferring Sequences for Use in SeqWeb or contact your SeqWeb Administrator.
To add a local sequence file into SeqWeb:
Or, from within a program, click on the Add From Local File... button located at the bottom of the Input Sequence area.
The Add Local File window appears.
The File Upload dialog box (Netscape) or Choose file dialog box (Internet Explorer) appears.
You can refine the list of files displayed using wildcards. For example, *.seq would display only those files in the current directory with an extension of ".seq".
The dialog box disappears and the selected filename and its directory specification display in the text box.
Local files created using a text editor are converted when loaded as a SeqWeb file, and sometimes require minor clean up. If so, use the Sequence Editor to delete the unwanted characters.
Note: After adding sequences from within a program, you may have to select Refresh to see the added sequences in your list.
You can add sequences from databases into SeqWeb, either from within the Sequence Manager or from any program's input area. For more information about the databases available, see GCG-Provided Databases or contact your SeqWeb Administrator.
Note: To use this method of adding sequences, you must have either the entry name or accession number for that entry in the database. If you do not know that information, you can use either the LookUp or StringSearch program to find a database entry.
Or, from within a program, click on the Add From Database... button located at the bottom of the Input Sequence area.
The Add from Database window appears.
If you do not see the database you are looking for in the list, see GCG-Provided Databases or contact your SeqWeb Administrator.
Note: Using a wildcard only works for entry names, not accession numbers. However, this can be confusing because entry names can include or be the same as accession numbers, especially when newly entered into a database.
If the results contain multiple pages, you must load each separate page and click Select All.
Note: After adding sequences from within a program, you may have to select Refresh to see the added sequences in your list.
Using the Sequence Manager, you can:
Reminder SeqWeb and the Sequence Manager display only the sequences associated with the currently selected project.
The Sequence Manager provides several ways to view sequence information, depending on how much detail you want to see.
To view a sequence:
A brief description of that sequence displays in the Description line at the bottom of the Sequence Manager window.
A Sequence Info window appears.
A View Sequence window appears.
Note: You cannot edit any of these views. To edit a sequence or its description, use the Sequence Editor.
You can use the Copy function to create another version of a sequence or to copy a sequence from one project to another.
To copy sequences:
The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The Copy window appears.
If you are copying sequences to another project, you can keep the same sequence names.
If you are creating another version of a sequence in the same project, enter a new name for the sequence copy.
Note: If you have multiple sequences selected, the File field will be blank and you will not be able to enter anything. If you want to copy multiple sequences and rename them at the same time, you must do so one at a time.
The newly copied sequence appears in the sequence list for the specified project.
You can use the Move function to move a sequence from one project to another.
To move sequences:
The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The Move window appears.
The moved sequence(s) will appear in the sequence list for the specified project. You will need to select the other project in the Sequence Manager list to see the change.
You can also use the Move function to rename a sequence.
To rename a sequence:
The description of the sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The Move window appears.
The renamed sequence appears in the sequence list for the specified project.
To delete a sequence:
The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The Delete window appears.
With the Sequence Manager, you can flag sequences to protect them from being modified by other project members. You can also flag them for review by other project members.
To protect one or more sequences:
A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The selected sequences are protected.
To turn off protection on one or more sequences:
A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The selected sequences are no longer protected.
To flag one or more sequences for review:
A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The selected sequences are flagged for review.
To turn off the review flag on one or more sequences:
A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The selected sequences are no longer flagged for review.
From the Sequence Manager, you can change the sequence type from nucleotide to protein, or protein to nucleotide.
To change the sequence type:
From SeqWeb, you can save sequences of interest to your local computer or to a SeqStore database (if your configuration includes SeqStore).
Save as Local File
You can save sequences of interest to your local computer for further manipulation and analysis. The sequences saved as local files are saved as GCG-formatted text files.
To save a sequence as a local file:
SeqWeb displays an Unknown File Type dialog box and a Save As... dialog box for each sequence you selected.
The file(s) are saved to the specified directory.
The Sequence Editor also provides ways to save sequences. See Saving Sequence Edits below.
From the Sequence Manager, you can also access the Sequence Editor to:
To open the Sequence Editor:
The description of the sequence selected displays in the Description line at the bottom of the Sequence Manager window.
The Sequence Editor window appears.
Note that the Sequence Editor window has two frames, an upper frame that contains a graphic view of the sequence and its features, and a lower frame that contains a text or character view. You can adjust the proportions of the two frames by dragging the gray bar in the middle.
You can zoom in and out of the graphic view by clicking on the bars on the sides of the graphic display.
The text view displays either the sequence's characters or comment. To toggle between the characters and comment, click Sequence or Comment in the Sequence Editor View menu.
You can also specify the font size for the text display, and change the case of all or some of the characters.
To change the text view's font size:
The font size changes in the text view only.
To change a sequence's characters to uppercase or lowercase:
If nothing is selected, this command applies to the whole sequence.
The selected string (or, if nothing was selected, the whole sequence) changes to the case specified.
Note that this command applies only to the sequence's characters, not the sequence comment.
To prevent editing sequence data by mistake, you can also disable the editing function. To enable or disable editing, click on either Enable Edit or Disable Edit in the Sequence Editor Edit menu to toggle between the two modes. If editing is disabled, you will not be able to edit the sequence data in the text view. In addition, if another member has protected the sequence you will not be able to edit the sequence.
The Sequence Editor also provides a multiple-step Undo command when adding or deleting sequence data. To Undo the last command, click on Undo in the Sequence Editor Edit menu, or use its keyboard shortcut (Ctrl+Z). If you Undo again, it will continue to step back through the commands within the current Sequence Editor session.
A sequence description displays when you click on a sequence in the Sequence Manager list, or from a program input area.
To edit a sequence description:
The Edit Description window appears.
The new description is not saved until you close the Sequence Editor and click Save .
The Sequence Editor provides two ways to navigate within sequences. You can either go to a specific location by number, or search for a specific residue string.
To go to a specific location in a sequence:
The Go To window appears.
To find a specific string of residues in a sequence:
The Find window appears.
Note that you can also click the Match Case checkbox if you want to restrict the search to upper or lower case, as you've entered it.
If a match is found, the text view cursor moves to the end of the matching characters.
If no match is found, a message displays indicating that the residue string was not found. Click OK to close the message window.
You can run a SeqWeb program using a selected range as the input sequence. To select a range from within the Sequence Editor:
OR
The Select Range window appears.
The selected range is highlighted in both the graphic and text views.
Note: Clicking anywhere in the text view while a range is highlighted clears the range selection.
To quickly select the entire sequence, click Select All in the Sequence Editor Edit menu.
Note: You can also select a range from within a SeqWeb program by double-clicking on any sequence listed in the input form. This displays a Range Selector function, which allows you to select a range just for that program run, and works similar to the process described above for selecting ranges. The Range Selector also offers quick access to some of the other Sequence Editor functions from within SeqWeb programs.
Note: A sequence's selected range remains active for additional program runs, for that user and within the designated project, until the range setting is changed.
The Sequence Editor's cut, copy, and paste commands work the same as they do in many other desktop applications. However, you can only cut, copy, and paste from or to other Sequence Editor windows.
To cut or copy and paste a range:
The selected range is pasted at that location in the range.
Note that each of these commands also has a keyboard shortcut identified on the menu (e.g., Cut = Ctrl+X).
The Sequence Editor allows you to easily perform several functions specific to nucleic acid sequences, including:
After performing one of these functions, you can also save the selected range as a feature of the sequence. See Working With Features for more information.
Assemble
To assemble a new sequence from a selected range:
The Assemble Selected Regions window appears, showing the selected sequence range concatenated into a single continuous sequence.
Translate
To translate a nucleic acid sequence:
The Translate Selected Sequence window appears, showing the selected sequence range concatenated into a single continuous range, with the DNA translated to protein.
Reverse Complement
To reverse complement a range:
The Reverse Complement Sequence window appears. This window shows the reverse complement of the selected sequence string.
The Sequence Editor allows you to view features, as well as easily add, delete, or edit sequence features. Features made up of multiple ranges are identified to the right of the graphic view with the start of the first range and end of the last range, separated by an ellipsis (...). Within the feature viewer portion of the Sequence Editor window, you can also view the ranges of open reading frames (ORFs).
To manually add a feature:
The Add Feature window appears.
To delete a feature:
A confirmation window appears.
To edit a feature:
If you have more than one feature selected, the edit command is not available.
The Edit Feature window appears.
Note that you cannot edit the range. You must delete the feature and add a new one with the desired range.
Viewing ORFs
You can set the feature view portion of the Sequence Editor window to display the ranges of open reading frames (ORFs) of nucleic acid sequences.
To view ORFs:
(The ORF button does not display if the view contains a protein sequence.)
Note that you can click on an individual ORF to highlight it in the text view, and zoom in or out by clicking on the side bars, just as you can in the feature view.
The Sequence Editor provides three ways to save a sequence. You can save the current sequence with the same filename, save it with a different filename, or you can take a snapshot of it and save it as a figure for printing or including in another application.
To save the edits to the sequence, keeping the same filename:
The file is saved in its current state on the server.
To save the edits to the sequence with a new filename:
The New window appears.
A new file containing this sequence is created on the server.
To take a snapshot of the edited sequence and save it as a figure:
A new browser window displays showing the graphic view as a GIF or PNG image and the sequence content as characters. (The browser window and GIF or PNG image have the same name as the sequence file, with ".htm" and ".gif" or ".png" extensions added respectively.)
You must save the browser window (for the text) and the image separately, using your browser's "Save" and "Save Image As" commands respectively.
The file(s) are saved to the directory you specify.
SeqWeb organizes your sequence data and analysis results according to projects. Each project has a textual description, sequence data, analysis results, and team members associated with it. Your SeqWeb Administrator provides you with a "Default" project to get you started. You may also have the ability to create additional projects. If so, SeqWeb allows you to organize and maintain your sequence data and analysis results according to those projects. (For more information about whether or not your account allows for multiple projects, contact your SeqWeb Administrator.)
The selected project will determine which sequences and/or results are available to you. When running a program, only the sequences associated with the currently selected project appear in the program's Input Sequence list. When using the Results Manager, only the results associated with the currently selected project appear in the Results list.
If you are restricted to a single default project, the only project-related functions available to you are:
If your account allows for multiple projects, you may also be able to:
Only those SeqWeb users who have been defined as members of a project have access to the sequences within that project. Any member of a project can view the info associated with that project, as well as add, modify, or delete sequences from a project, as long as the sequences are not protected or in use by another member of the project.
Only a project moderator can modify the description, add or remove members, assign other moderators, or delete a project. You are the moderator of any new projects you create.
The name of the currently selected project displays at the top of the Sequence Manager window, and above each of the SeqWeb programs' input areas. When you run an analysis on a sequence, the results of that analysis are also associated with the currently selected project.
To select a project:
(The project field is part of the Sequence Manager and Results Manager windows, and all SeqWeb program input forms.)
If only the default project displays, your account may not support additional projects or you are not associated with any other projects.
The sequence list for the newly selected project displays.
If your account allows for additional projects, you can create a new project. Contact your SeqWeb Administrator to see if your account allows for additional projects.
To create a new project:
The Create Project window displays.
Project Name: (required) Type a unique name for your project. Note that you can view the existing project names by clicking on the View Project Names button.
Description: (optional) Type a description of your project.
Members: (optional) Select the people who will have access to your project. As the person creating the project, you are automatically a member and the moderator of the newly created project.
SeqWeb creates a new project and adds it to the list of available projects. You must then select the newly created project if that is the one you want to work with.
Any project member can add or delete sequences, but only a moderator can modify the description and membership.
To modify a project:
(This option is not available to you unless you are a moderator of the project.)
The Modify Project window displays.
Description: (optional) Edit or retype your project description.
Members: (optional) Deselect people to remove them as members of the project, or select new members to give them access to your project.
SeqWeb modifies the selected project as indicated.
The creator of a project is, by default, the moderator. You can also assign other moderators if you choose to do so. A moderator of a project has additional privileges, including the ability to:
To assign moderators to a project:
(This option is not available to you unless you are already a moderator of the project.)
The Assign Project Moderators window displays.
The moderators are reassigned as indicated.
SeqWeb provides a quick and easy way to e-mail the members of a project.
To send e-mail to all members of a project:
The Send E-mail to Project Members window displays.
SeqWeb sends the e-mail message to the specified project members.
You can only delete a project if you are a moderator of that project. However, you cannot delete your default project.
To delete a project:
(This option is not available to you unless you are a moderator of the project.)
The Delete Project window displays, showing the description and member list.
SeqWeb deletes the selected project.