| ## EMBOSS: mse

# Program mse

## Function

Conversion of William A. Gilbert's ( Whitehead Insitutute ) MSE.

## Description

A Multiple Sequence Screen Editor for Biological Sequences.

## Usage

This is an interactive program and it is similar to many other multiple sequence editors, in that you run it, using a file of existing sequences, as:

% mse file.seq

...you will then see a screen looking like this:

    MSE V3.0                                                                    WIBR

         tgactgatcgttgctgattgatgctgactg
         tgactgatcgt-gctgactgatgctgactg
         tgactgatcgtagctgactgatgctgactg
    ....|.........|.........|.........|.........|.........|.........|.........|....
        0        10        20        30        40        50        60        70

          |......|......|......|......|......|......|......|......|......|......|
          0     10     20     30     40     50     60     70     80     90     100

    003  M +-----#------------>
    002    +------------------>
    001    +------------------>
    Press "?" for help

Pressing the cursor keys will move the cursor around, left and right, up and down. Moving the cursor in the sequences will also move the '#' character in the "bird's eye view" in the lower screen - this is an overview of where you currently are in the full-length set of sequences.

If you press a key that is a valid nucleotide or residue code, then the appropriate sequence in the "bird's eye view" will be marked with a 'M' indicating that it has been modified.

Pressing '?' at any time will display the help:

                              Screen Mode Commands,
                 ([n] is an optional numeric (keyboard) parameter)

    [n]s            - Inserts symbol "s" [n] times
    [n]<delete>     - Delete [n] sequence character(s)
    [n]<space bar>  - Move the sequence(s) to the right [n] spaces
    [n]<backspace>  - Move the sequence(s) to the left [n] spaces, VT200's
                       use F12 key or Control-H

    [n]<arrow>      - Go forward, backward, up or down [n] positions or lines
    [n]<return>     - Go to position [n], also use keypad ENTER key
       *            - Go to end of current sequence (Also Control-E)
    [n]<            - Go [n]x50 back, VT200's also use PREV SCREEN key
    [n]>            - Go [n]x50 ahead, VT200's also use NEXT SCREEN key

       /string<rtn> - Find "string", VT200's also use FIND key
    [n]?            - Display help starting at page [n], VT200's also use HELP key
       !            - Display status of current sequence, same as "SEQ" command
       Control-W    - Redraw the screen (also Control-R)
       Control-Z    - Switch to Command Mode

         [Help page 1 of 10.  Press RETURN for more help. SPACE to quit.]

See below for the full display of these commands.

As you can see in the help-screen above, you type in Control-Z to switch from moving around the sequences and editing the sequences to the mode in which you can type in text commands.

When you have typed Control-Z, the prompt Command: appears at the bottom of the screen waiting for you to either type in a text command, or to simply press the RETURN key to return to editing the sequences.

To get help when in command-mode, type help and press RETURN.

To exit from the editor and write out your changed sequences to file, give the text command exit.

## Command line arguments

       Mandatory qualifiers:
      [-msf]               seqset     File containing a sequence alignment

       Optional qualifiers: (none)
       Advanced qualifiers:
       -tmpdir             string     temp directory

Mandatory qualifiers | Allowed values | Default
--- | --- | ---
[-msf] (Parameter 1) | File containing a sequence alignment | Readable sequences | Required
Optional qualifiers | Allowed values | Default
(none)
Advanced qualifiers | Allowed values | Default
-tmpdir | temp directory | Any string is accepted | /tmp

## Commands

                              Screen Mode Commands
                 ([n] is an optional numeric (keyboard) parameter)

       Control-Z    - Switch to Command Mode

    [n]s            - Inserts symbol "s" [n] times
    [n]<delete>     - Delete [n] sequence character(s)
    [n]<space bar>  - Move the sequence(s) to the right [n] spaces
    [n]<backspace>  - Move the sequence(s) to the left [n] spaces, VT200's
                       use F12 key or Control-H

    [n]<arrow>      - Go forward, backward, up or down [n] positions or lines
    [n]<return>     - Go to position [n], also use keypad ENTER key
       *            - Go to end of current sequence (Also Control-E)
    [n]<            - Go [n]x50 back, VT200's also use PREV SCREEN key
    [n]>            - Go [n]x50 ahead, VT200's also use NEXT SCREEN key

       /string<rtn> - Find "string", VT200's also use FIND key
    [n]?            - Display help starting at page [n], VT200's also use HELP key
       !            - Display status of current sequence, same as "SEQ" command
       Control-W    - Redraw the screen (also Control-R)

    Commands end with <ret>, [ ] indicates an optional parameter.
    "s" and "f" are line numbers for to and from or start and finish.
    Only the capitalized part of the command is necessary

          EDIt [SeqSpec(s)] - edit another sequence(s) or indirect FOSS file

          FInd string       - find the next occurrence of "string"

          [s,f] DELete      - delete a range of symbols or answer prompts
                              for a range, default will be: current to *

          [n]               - go to position [n], same as raw mode [n]

          [s] HELp          - display help starting at page [s]

          REDraw            - redraw the screen

          MATches [attr]    - Display matches with plurality sequence

          DIFferences [attr]- Display differences with plurality sequence

          NEIther           - Turn off plurality sequence calculation
                               Saves CPU time!!

          ALNED [filename]  - Read in an alignment file from the NBRF/PIR program
                               ALNED (A multiple sequence alignment program).

          [s,f] MOVe        - Move from line [s] to line [f].
                               Default is from current to next available line.

          [s,f] ELIminate   - Delete lines [s] to [f]. Default is current line.

          [s,f] ANChor      - Force lines [s] to [f] to move as one unit.
                               Default is to add the current strand to the anchored
                               group. PF4 key toggles anchoring.

          NOAnchor          - Turn off anchoring. Default is the current strand.
                               PF4 toggles anchoring

          [s,f] SORt [dir]  - Sort lines [s] to [f] according to their "Offsets".
                               Default is from current to highest numbered line.
                               If "dir" is DEScending, the sort is reversed.

          [s,f] DEGap       - Remove gaps from lines [s] to [f].

          Open              - Open up a new line by moving all the line above the current
                               line up by one

          [s,f] Lock        - Lock lines "s" to "f" such that you cannot add or delete
                               sequence symbols. You may still shift and/or reverse lines.
                               You may also add/delete gap characters "-".  Default is the
                               current line.

          [s,f] Unlock      - Unlocks locked lines.

          [s] Offset        - Set the Offset of the current line to position [s].
                               Default is set the Offset of the current line to the
                               current line position. Also works with anchored groups.

          [s] REVerse       - Reverse/complement line "s".  The current line is the defualt
                               If the reversed line is part of an anchored group then the
                               entire group is reversed.

          SEQ               - Show current position. Same as "!" in raw mode.

       NAMe [code=filename] - Change the code and/or filename.

       TItle [New Title]    - Change the sequence title.
       TYpe [type]          - Change the sequence type, values for TYPE:

                                 DNA     PROTEIN     RNA
                                rRNA    tRNA        uRNA        mRNA

       FORmat [New format]  - Change the sequence format, for FORMAT:

                              GCG PIR FASTA SWISS NCBI etc..

       [s,f] SELect         - Mark a range [s] to [f] to be selected, or start
                               selection at current cursor position.
                               VT200's also use SELECT key.

        REMove              - Remove a selected, (Reverse video), region. Does not
                               include current cursor position.
                               VT200's also use REMOVE key.

        [s] INSert          - Insert cut region at [s] or current cursor position.
                               VT200's also use INSERT HERE key.

          CANcel            - Cancel SELECT function. Clears PASTE buffer.

          GelAlign          - Will take all of the strands currently loaded into MSE
                               and produce the best alignment based on exact matches.
                               GelAlign does not add gaps but it will get the strands
                               started for you

       [s,f] Meld [seqname] - Merges strands "s" to "f" to create a new entry
                               named "seqname".  If the current strand is part of an
                               anchored group then that group will be melded.  You
                               will be prompted to continue if undetermined postitions
                               are found in the melded sequence.

    [s,f] HARdcopy [filename] - write [a part of] aligned sequences to a file.

    [s,f] WRIte [seqname]     - write [a part of] the sequence to a file. You
                                 may rename it to "seqname" in the process

          EXIt  [FOSSname]    - write any modified sequences, a new FOSS file,
                                 and then quit.

          QUIt                - quit the editor, do not write sequences.

## Data files

## Notes

Multiple sequences sets not implemented yet!.

## References

## Warnings

## Diagnostics

## Exit status

## Known bugs

## See also

## Author(s)

William A. Gilbert, Whitehead Insitutute.

This application was modified for inclusion in EMBOSS by Ian Longden (il@sanger.ac.uk) Informatics Division, The Sanger Centre, Wellcome Trust Genome Campus, Hinxton, Cambridge, CB10 1SA, UK.

## Priority

## Target users

## Comments