Chapter 3. The Sequence Manager

Table of Contents

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.

About 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:

  1. Click on Managers in the top left SeqWeb frame to display the icons for the SeqWeb Managers in the lower left frame.

  2. Click on the Sequences icon in the lower left frame and the Sequence Manager window displays.

The Sequence Manager window lists the sequences associated with the currently selected project.

Selecting Sequences

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.


Adding Sequences

[Previous | Top | Next]

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.


Adding Sequences Using the Clipboard

[Previous | Top | Next]

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:

  1. From the Sequence Manager List menu, click Add From 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.

  2. Type or copy and paste information into the following fields:

    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.

    To copy and paste on a PC or Macintosh:
    1. In a separate window, display the sequence of interest.

    2. Click and drag over the text of interest to highlight it.

    3. From the window's Edit menu, select Copy.

    4. Bring your SeqWeb window to the front and click in the text area where you want to paste the text.

    5. Click and hold your right mouse button to display a menu of commands.

    6. Select Paste and the text is pasted into the area.

    To copy and paste on UNIX:
    1. In a separate window, display the sequence of interest.

    2. Click and drag over the text of interest to highlight it.

    3. Bring your SeqWeb window to the front.

    4. Click your middle mouse button in the appropriate text area and the text is pasted into the area.

  3. In the Add from Clipboard window, click OK.

    Note: After adding sequences from within a program, you may have to select Refresh to see the added sequences in your list.


Adding a Local Sequence File

[Previous | Top | Next]

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:

  1. From the Sequence Manager List menu, click Add From Local File...

    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.

  2. Choose from the following:

  3. In the Add Local File window, click OK.

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.


Adding Sequences from a Database

[Previous | Top | Next]

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.

  1. From the Sequence Manager List menu, click Add From Database...

    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.

  2. Select the appropriate database from the Database selection list.

    If you do not see the database you are looking for in the list, see GCG-Provided Databases or contact your SeqWeb Administrator.

  3. In the Sequence name or accession number text box, type the entry name (for example eg15_caeel) or its accession number (for example Q10656). You can also use the * wildcard to find multiple sequences, for example eg15_ca*.

    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.

  4. Click OK and SeqWeb displays sequence(s) with matching name(s).

  5. To select sequences, choose from the following:

  6. Click Add Selected and the sequences are added to the sequence list.

    Note: After adding sequences from within a program, you may have to select Refresh to see the added sequences in your list.


Managing Sequences

[Previous | Top | Next]

Using the Sequence Manager, you can:

Reminder SeqWeb and the Sequence Manager display only the sequences associated with the currently selected project.


Viewing Sequences

[Previous | Top | Next]

The Sequence Manager provides several ways to view sequence information, depending on how much detail you want to see.

To view a sequence:

  1. Select a sequence from the list.

    A brief description of that sequence displays in the Description line at the bottom of the Sequence Manager window.

  2. For more information, click Sequence Info in the Sequence Manager View menu.

    A Sequence Info window appears.

  3. To view the full sequence description, including reference and residues, select Sequence in the Sequence Manager View menu.

    A View Sequence window appears.

Note: You cannot edit any of these views. To edit a sequence or its description, use the Sequence Editor.


Copying Sequences

[Previous | Top | Next]

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:

  1. Select one or more sequences from the list.

    The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager Edit menu, click Copy....

    The Copy window appears.

  3. Select the name of the project to which you want to copy the sequence(s).

  4. Enter a name in the File field.

    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.

  5. Click OK.

    The newly copied sequence appears in the sequence list for the specified project.


Moving Sequences

[Previous | Top | Next]

You can use the Move function to move a sequence from one project to another.

To move sequences:

  1. Select one or more sequences from the list.

    The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager Edit menu, click Move....

    The Move window appears.

  3. Select the name of the project to which you want to move the sequence(s).

  4. Click OK.

    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.


Renaming Sequences

[Previous | Top | Next]

You can also use the Move function to rename a sequence.

To rename a sequence:

  1. Select a single sequence from the list.

    The description of the sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager Edit menu, click Move....

    The Move window appears.

  3. Type in a new name for the sequence and make sure the appropriate project is selected.

  4. Click OK.

    The renamed sequence appears in the sequence list for the specified project.


Deleting Sequences

[Previous | Top | Next]

To delete a sequence:

  1. Select one or more sequences from the list.

    The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager Edit menu, click Delete....

    The Delete window appears.

  3. Click OK to delete the selected sequence(s) from the specified project.


Flagging Sequences

[Previous | Top | Next]

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:

  1. Select the sequences from the list.

    A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. Click Protect On in the Sequence Manager Flags menu.

    The selected sequences are protected.

To turn off protection on one or more sequences:

  1. Select the sequences from the list.

    A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. Click Protect Off in the Sequence Manager Flags menu.

    The selected sequences are no longer protected.

To flag one or more sequences for review:

  1. Select the sequences from the list.

    A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. Click Review On in the Sequence Manager Flags menu.

    The selected sequences are flagged for review.

To turn off the review flag on one or more sequences:

  1. Select the sequences from the list.

    A brief description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. Click Review Off in the Sequence Manager Flags menu.

    The selected sequences are no longer flagged for review.


Changing Sequence Type

[Previous | Top | Next]

From the Sequence Manager, you can change the sequence type from nucleotide to protein, or protein to nucleotide.

To change the sequence type:

  1. Select one or more sequences from the list. The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager Edit menu, click Sequence Type.

  3. Then, click the button indicating the desired type. SeqWeb will change the type of all selected sequences and refresh the sequence list.


Saving Sequences

[Previous | Top | Next]

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:

  1. Select one or more sequences from the list. The description of the last sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. In the Sequence Manager List menu, click Save to Local File....

  3. Then follow the steps for the web browser you are using:

    The file(s) are saved to the specified directory.

The Sequence Editor also provides ways to save sequences. See Saving Sequence Edits below.


Editing Sequences

[Previous | Top | Next]

From the Sequence Manager, you can also access the Sequence Editor to:

To open the Sequence Editor:

  1. From the Sequence Manager window, select a single sequence from the list.

    The description of the sequence selected displays in the Description line at the bottom of the Sequence Manager window.

  2. Then do one of the following:

    The Sequence Editor window appears.

  3. Edit or modify the sequence using the menu commands as explained below.

About the Sequence Editor

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:

  1. In the Sequence Editor View menu, click Font Size and a submenu displays.

  2. Click the desired size (small, medium or large).

    The font size changes in the text view only.

To change a sequence's characters to uppercase or lowercase:

  1. Select the part of the sequence you want to be upper or lower case.

    If nothing is selected, this command applies to the whole sequence.

  2. In the Sequence Editor Edit menu, click Change to Upper Case or Change to Lower Case, depending on what you want to do.

    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.


Editing a Description

[Previous | Top | Next]

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:

  1. Select a sequence.

  2. In the Sequence Editor Edit menu, click Edit Description.

    The Edit Description window appears.

  3. Type in the new description.

  4. Then do one of the following:

The new description is not saved until you close the Sequence Editor and click Save .


Navigating Within Sequences

[Previous | Top | Next]

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:

  1. In the Sequence Editor View menu, click Go To.

    The Go To window appears.

  2. Enter the numeric value for the sequence location.

  3. Click OK and the cursor moves to that location in the text view.

To find a specific string of residues in a sequence:

  1. In the Sequence Editor Edit menu, click Find.

    The Find window appears.

  2. Enter the residue string you are looking for in the sequence.

    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.

  3. Click OK and the search begins from the current cursor location.

    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.


Selecting a Range

[Previous | Top | Next]

You can run a SeqWeb program using a selected range as the input sequence. To select a range from within the Sequence Editor:

  1. Click at one end of the range in the text view.

  2. Drag to the other end of the desired range.

OR

  1. In the Sequence Editor Edit menu, click Select Range.

    The Select Range window appears.

  2. Enter the start and end positions for the range.

  3. Click one of the following, depending on what you want to do:

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.


Cutting, Copying or Pasting a Range

[Previous | Top | Next]

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:

  1. Select a sequence range.

  2. In the Sequence Editor Edit menu, click Cut to remove or move a range, or Copy to copy a range, depending on what you want to do.

  3. To paste the cut or copied selection, move your cursor to the destination in the range.

  4. In the Sequence Editor Edit menu, click Paste.

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


Performing Functions Specific to Nucleic Acid Sequences

[Previous | Top | Next]

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:

  1. Select the range you want to assemble.

  2. In the Sequence Editor Functions menu, click Assemble.

    The Assemble Selected Regions window appears, showing the selected sequence range concatenated into a single continuous sequence.

  3. Specify a name and (optionally) a description for the newly assembled sequence.

  4. Then do one of the following:

Translate

To translate a nucleic acid sequence:

  1. Select the range you want to translate.

  2. In the Sequence Editor Functions menu, click Translate.

    The Translate Selected Sequence window appears, showing the selected sequence range concatenated into a single continuous range, with the DNA translated to protein.

  3. Specify a name and (optionally) a description for the translated sequence.

  4. Then do one of the following:

Reverse Complement

To reverse complement a range:

  1. Select the range you want to reverse complement.

  2. In the Sequence Editor Functions menu, click Reverse Complement.

    The Reverse Complement Sequence window appears. This window shows the reverse complement of the selected sequence string.

  3. Specify a name and (optionally) a description for the new sequence.

  4. Then do one of the following:


Working with Sequence Features

[Previous | Top | Next]

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:

  1. Select a range.

  2. In the Sequence Editor Feature menu, click Add Feature.

    The Add Feature window appears.

  3. Type in the name for the feature.

  4. Select the shape, color, and fill attributes for the feature.

  5. Enter a comment, if desired.

  6. Then do one of the following:

To delete a feature:

  1. Select a feature by clicking on it in the graphic view.

  2. In the Sequence Editor Feature menu, click Delete Feature.

    A confirmation window appears.

  3. Then do one of the following:

To edit a feature:

  1. Select a single feature by clicking on it in the graphic view.

    If you have more than one feature selected, the edit command is not available.

  2. In the Sequence Editor Feature menu, click Edit Feature.

    The Edit Feature window appears.

  3. Modify the name, comment, shape, color, or fill attributes by editing the appropriate fields.

    Note that you cannot edit the range. You must delete the feature and add a new one with the desired range.

  4. Then do one of the following:

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:

  1. Click on the ORF button below the graphic view.

    (The ORF button does not display if the view contains a protein sequence.)

  2. To apply the cutoff size to ORFs, adjust the size by clicking on the left or right arrows.

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.


Saving Sequence Edits

[Previous | Top | Next]

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:

  1. In the Sequence Editor File menu, click Save.

    The file is saved in its current state on the server.

To save the edits to the sequence with a new filename:

  1. In the Sequence Editor File menu, click Save As.

    The New window appears.

  2. Select the appropriate project for this sequence. (The default is the current project.)

  3. Enter a new filename for the sequence.

  4. Click OK.

    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:

  1. Adjust the view using the zoom icons to display the image you want to save or print.

  2. In the Sequence Editor File menu, click Save As 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.)

  3. Then do one or both of the following:


Managing Projects

[Previous | Top | Next]

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.


Selecting a Project

[Previous | Top | Next]

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:

  1. Click the down arrow next to the project field.

    (The project field is part of the Sequence Manager and Results Manager windows, and all SeqWeb program input forms.)

  2. Scroll through the project list to find the desired project.

    If only the default project displays, your account may not support additional projects or you are not associated with any other projects.

  3. Click on the desired project to select it.

    The sequence list for the newly selected project displays.


Creating a New Project

[Previous | Top | Next]

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:

  1. In the Sequence Manager Project menu, click Create. (If this option is not available to you, your account does not allow for additional projects.)

    The Create Project window displays.

  2. Complete the following fields:

    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.

  3. Click OK.

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.


Modifying a Project

[Previous | Top | Next]

Any project member can add or delete sequences, but only a moderator can modify the description and membership.

To modify a project:

  1. Select the project in the project list.

  2. In the Sequence Manager Project menu, click Modify.

    (This option is not available to you unless you are a moderator of the project.)

    The Modify Project window displays.

  3. Edit the following fields as desired:

    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.

  4. Click OK.

    SeqWeb modifies the selected project as indicated.


Assigning Moderators to a Project

[Previous | Top | Next]

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:

  1. Select the project in the project list.

  2. In the Sequence Manager Project menu, click Assign Moderators.

    (This option is not available to you unless you are already a moderator of the project.)

    The Assign Project Moderators window displays.

  3. Select the members that you want to assign as moderators. Deselect members to remove them as moderators of the project (they remain as project members).

  4. Click OK.

    The moderators are reassigned as indicated.


E-mailing All Members of a Project

[Previous | Top | Next]

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:

  1. Select the project in the project list.

  2. In the Sequence Manager Project menu, click Send E-mail.

    The Send E-mail to Project Members window displays.

  3. Type the desired text in the Subject and Message fields.

  4. Select the project members who are to receive the e-mail.

  5. Click OK to send the e-mail, or Cancel to close the window and cancel the request.

    SeqWeb sends the e-mail message to the specified project members.


Deleting a Project

[Previous | Top]

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:

  1. Select the project in the project list.

  2. In the Sequence Manager Project menu, click Delete.

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

  3. Click OK to delete the project, or Cancel to close the window and cancel the request.

    SeqWeb deletes the selected project.