168 lines
7 KiB
Text
168 lines
7 KiB
Text
Trace Editor Help
|
|
-----------------
|
|
|
|
The ted trace editor is a prototype to allow the display and editing
|
|
of traces from sequencing machines, and the simple editing of plain
|
|
sequences. It runs under the X window system. It provides simultaneous
|
|
display of traces and bases. The editing allows individual bases to be
|
|
removed and new ones added, and also a range of bases at either end to
|
|
be cutoff. Currently, only ABI result files and plain sequences are
|
|
accepted.
|
|
|
|
Only one trace can be edited at a time.
|
|
|
|
|
|
Invocation
|
|
----------
|
|
|
|
ted can be run from the command line by simply typing:
|
|
|
|
ted
|
|
|
|
It will come up with no sequence initially displayed. If provided with
|
|
any arguments it does not understand, or invalid combinations of
|
|
arguments, ted will exit with a message indicating its intended usage.
|
|
ted accepts the standard X arguments allowing, for example, background
|
|
colour or geometry to be specified. ted can accept an argument
|
|
specifying an initial file to display. The key for this is the format
|
|
of the file, for example:
|
|
|
|
ted -ABI {ABI format filename}
|
|
ted -plain {plain format filename}
|
|
|
|
The file is then displayed at 50% magnification, with the caret
|
|
initially positioned at the first base.
|
|
|
|
When an initial file is given, a base number of interest and/or a
|
|
magnification can also be given, for example:
|
|
|
|
ted -ABI {ABI format file} -baseNum 280 -mag 30
|
|
|
|
or the bottom strand may be specified:
|
|
|
|
ted -ABI {ABI format file} -baseNum 280 -mag 30 -bottom 1
|
|
or
|
|
ted -ABI {ABI format file} -bottom 1
|
|
|
|
or a string of nucleotides on which the center the window:
|
|
|
|
ted -ABI {ABI format file} -astring 1
|
|
or
|
|
ted -ABI {ABI format file} -astring 1 -mag 30 -bottom 1
|
|
|
|
Options can be specified in any order.
|
|
|
|
An output filename can be specified in a similar manner:
|
|
|
|
ted -ABI inputfilename -output outputfilename
|
|
|
|
The default output filename is inputfilename.seq
|
|
|
|
If you are running the program on a remote machine, you must
|
|
specify a display parameter:
|
|
|
|
ted -display machine_name:0.2
|
|
|
|
You can also specify the size of the opening window or
|
|
other screen parameters by the following:
|
|
|
|
ted -geometry [{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]
|
|
[-fg {color}] [-bg {color}] [-bd {color}] [-bw {pixels}]
|
|
|
|
Displays
|
|
--------
|
|
|
|
When running, ted displays the name of the file it is currently
|
|
operating on (if any) and the original number of bases.
|
|
|
|
A so-called viewport presents four different synchronised views of
|
|
part of the trace. The top one indicates the sequence indices - the
|
|
first digit of the number if positioned over the base to which that
|
|
number corresponds. Below this is a list of the bases as originally
|
|
found in the file (this is the interpretation of the trace as made by
|
|
the sequencing machine). Below this is the list of bases as edited by
|
|
the user --- initially, if this file has not been edited in the past,
|
|
this is identical to the list of original bases. However, if in a
|
|
previous session the user has edited this sequence, the edited
|
|
version of the sequence will appear in the edit window.
|
|
The final display is of the traces produced by the sequencing
|
|
machine for the four respective bases.
|
|
|
|
Two controls allow the view presented to be adjusted: both are
|
|
horizontal sliders or scrollbars. The first affects the magnification
|
|
at which the trace is viewed. The minimum magnification is such that
|
|
the whole of the trace is visible within the viewport; when a trace is
|
|
first input, this is the magnification used. The maximum magnification
|
|
is such that bases are spaced out with several characters of space
|
|
between them --- this should allow more than enough room for base
|
|
insertions to be clearly visible. The second scrollbar is immediately
|
|
above the viewport and allows the user to select which part of the
|
|
trace is viewed. Both the sliders work in a similar way: the middle
|
|
mouse button can be used to drag the thumb to any desired position,
|
|
the left and right mouse buttons can be clicked within the scrollbar
|
|
to indicate that paging up or down is desired. In the case of the
|
|
viewport scrollbar, the amount of paging is determined by how far up
|
|
the scrollbar the pointer is.
|
|
|
|
The whole ted window can be expanded and contracted (to an extent) by
|
|
dragging the "grow-region" provided by whatever window manager is
|
|
running. The viewport takes up all of this change in size.
|
|
|
|
Controls
|
|
--------
|
|
|
|
ted has four buttons. "Quit" exits the program after first checking
|
|
whether there is a sequence which has been edited and not saved.
|
|
|
|
"Help" pops up this window which has a scrollbar on the left allowing
|
|
all the text to be viewed.
|
|
|
|
"Input" presents a dialogue which asks for the format and name of a
|
|
file to be processed. The bases and (if this is not a plain format
|
|
file) traces are read in and displayed for editing. The only
|
|
conversion performed on bases is from 'N' to '-'.
|
|
|
|
"Output" presents a dialogue which asks for a filename into which the
|
|
edited and clipped bases can be saved. The default value can be set
|
|
on the command line using the "-output" keyword. No conversion of bases
|
|
is performed on output.
|
|
|
|
ted operates in one of three editing modes, one of which is selected
|
|
from three "radio buttons". The currently selected mode is
|
|
highlighted.
|
|
|
|
Editing
|
|
-------
|
|
|
|
In "Edit sequence" mode, the (lower) list of editable bases can be
|
|
edited in much the same way as a text editor operates. A "caret" which
|
|
is visible in the display of edited bases can be moved left and right
|
|
with the cursor keys (these are sometimes called arrow keys and often
|
|
appear on numeric keypads). It can also be positioned by clicking any
|
|
button while the pointer is pointing into either of the list of bases
|
|
or the traces. The DELETE key deletes the base immediately to the left
|
|
of the caret. Any printing character can be inserted to the right of
|
|
the caret by simply typing it. Inserted characters are placed halfway
|
|
between their neighbours, or if a space is left by the deletion of a
|
|
base originally there, its position is used. A base can thus be
|
|
changed by deleting it and entering the new base.
|
|
|
|
Note that in the current version of ted the caret is not constrained
|
|
to remain within the viewed part of the display and that editing can
|
|
still continue while it is thus invisible. Such editing would probably
|
|
only occur by accident.
|
|
|
|
ted provides a facility to define a cutoff at either end of the trace.
|
|
A number of the leftmost bases (corresponding to the vector) and the
|
|
rightmost bases (corresponding to the point where the data become
|
|
unreliable) can be defined by setting the editor into "Adjust left
|
|
cutoff" or "Adjust right cutoff" mode. In either of these modes, the
|
|
pointer and mouse buttons can be used to indicate the cutoff point,
|
|
and the cursor keys can be used to adjust this leftwards or
|
|
rightwards. Initially, the cutoff regions are both empty. The cutoff
|
|
regions are clearly indicated on the list of edited bases display and
|
|
on the traces display by being drawn with a dimmed background.
|
|
|
|
When the sequence is written out, the list of edited bases, with both
|
|
cutoff regions removed, is written. The output contains newlines
|
|
for convenient formatting and always ends with one.
|