-
Notifications
You must be signed in to change notification settings - Fork 0
/
cirdna.html
653 lines (523 loc) · 17 KB
/
cirdna.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
<HTML>
<HEAD>
<TITLE>
EMBOSS: cirdna
</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" text="#000000">
<table align=center border=0 cellspacing=0 cellpadding=0>
<tr><td valign=top>
<A HREF="/" ONMOUSEOVER="self.status='Go to the EMBOSS home page';return true"><img border=0 src="emboss_icon.jpg" alt="" width=150 height=48></a>
</td>
<td align=left valign=middle>
<b><font size="+6">
cirdna
</font></b>
</td></tr>
</table>
<br>
<p>
<H2>
Function
</H2>
Draws circular maps of DNA constructs
<H2>
Description
</H2>
The program 'cirdna' draws circular maps of DNA constructs.
<p>
It uses the graphical shapes: ticks, ranges, and blocks to
represent genetic markers (e.g, genes and ESTs) and places them
according to their position in a DNA fragment. The markers can be
organized in different groups. A group may contain up to 10000 markers, so the
program can be used to draw circular representations of genomic
sequences.
<p>
The program reads in one input file in which the user specifies the
names and positions of the genetic markers. In this file the user also
enters data for controlling the appearance of the markers.
<p>
A refined customization of the drawing can be achieved by running the
program with '-options' on the command line and changing the values of
the desired parameters.
<H2>
Usage
</H2>
<b>Here is a sample session with cirdna</b>
<p>
<p>
<table width="90%"><tr><td bgcolor="#CCFFFF"><pre>
% <b>cirdna -graph cps </b>
Draws circular maps of DNA constructs
Commands to the lindna drawing program file [inputfile]: <b>data.cirp</b>
Draw a ruler [Y]: <b></b>
Open : Open blocks
Filled : Filled blocks
Outline : Black border
Type of blocks [Filled]: <b></b>
1 : In
2 : Out
Ticks inside or outside the circle [Out]: <b></b>
1 : In
2 : Out
Text inside or outside the blocks [In]: <b></b>
Created cirdna.ps
</pre></td></tr></table><p>
<p>
<a href="#input.1">Go to the input files for this example</a><br><a href="#output.1">Go to the output files for this example</a><p><p>
<H2>
Command line arguments
</H2>
<table CELLSPACING=0 CELLPADDING=3 BGCOLOR="#f5f5ff" ><tr><td>
<pre>
Standard (Mandatory) qualifiers:
[-infile] infile [inputfile] Commands to the lindna drawing
program file
-[no]ruler boolean [Y] Draw a ruler
-blocktype menu [Filled] Type of blocks (Values: Open (Open
blocks); Filled (Filled blocks); Outline
(Black border))
-posticks selection [Out] Ticks inside or outside the circle
-posblocks selection [In] Text inside or outside the blocks
-graphout graph [$EMBOSS_GRAPHICS value, or x11] Graph type
(ps, hpgl, hp7470, hp7580, meta, cps, x11,
tekt, tek, none, data, xterm, png, gif)
Additional (Optional) qualifiers:
-maxgroups integer [20] Maximum number of groups (Integer 1 or
more)
-maxlabels integer [10000] Maximum number of labels (Integer 1
or more)
-originangle float [90] Position in degrees of the molecule's
origin on the circle (Number from 0.000 to
360.000)
-[no]intersymbol boolean [Y] Horizontal junctions between blocks
-intercolour integer [1] Colour of junctions between blocks
(enter a colour number) (Integer from 0 to
15)
-interticks boolean [N] Horizontal junctions between ticks
-gapsize integer [500] Interval between ticks in the ruler
(Integer 0 or more)
-ticklines boolean [N] Vertical lines at the ruler's ticks
-textheight float [1.0] Height of text. Enter a number <1.0 or
>1.0 to decrease or increase the size,
respectively (Number 0.000 or more)
-textlength float [1.0] Length of text. Enter a number <1.0 or
>1.0 to decrease or increase the size,
respectively (Number 0.000 or more)
-tickheight float [1.0] Height of ticks. Enter a number <1.0
or >1.0 to decrease or increase the size,
respectively (Number 0.000 or more)
-blockheight float [1.0] Height of blocks. Enter a number <1.0
or >1.0 to decrease or increase the size,
respectively (Number 0.000 or more)
-rangeheight float [1.0] Height of range ends. Enter a number
<1.0 or >1.0 to decrease or increase the
size, respectively (Number 0.000 or more)
-gapgroup float [1.0] Space between groups. Enter a number
<1.0 or >1.0 to decrease or increase the
size, respectively (Number 0.000 or more)
-postext float [1.0] Space between text and ticks, blocks,
and ranges. Enter a number <1.0 or >1.0 to
decrease or increase the size, respectively
(Number 0.000 or more)
Advanced (Unprompted) qualifiers: (none)
Associated qualifiers:
"-graphout" associated qualifiers
-gprompt boolean Graph prompting
-gdesc string Graph description
-gtitle string Graph title
-gsubtitle string Graph subtitle
-gxtitle string Graph x axis title
-gytitle string Graph y axis title
-goutfile string Output file for non interactive displays
-gdirectory string Output directory
General qualifiers:
-auto boolean Turn off prompts
-stdout boolean Write standard output
-filter boolean Read standard input, write standard output
-options boolean Prompt for standard and additional values
-debug boolean Write debug output to program.dbg
-verbose boolean Report some/full command line options
-help boolean Report command line options. More
information on associated and general
qualifiers can be found with -help -verbose
-warning boolean Report warnings
-error boolean Report errors
-fatal boolean Report fatal errors
-die boolean Report dying program messages
</pre>
</td></tr></table>
<P>
<table border cellspacing=0 cellpadding=3 bgcolor="#ccccff">
<tr bgcolor="#FFFFCC">
<th align="left" colspan=2>Standard (Mandatory) qualifiers</th>
<th align="left">Allowed values</th>
<th align="left">Default</th>
</tr>
<tr>
<td>[-infile]<br>(Parameter 1)</td>
<td>Commands to the lindna drawing program file</td>
<td>Input file</td>
<td>inputfile</td>
</tr>
<tr>
<td>-[no]ruler</td>
<td>Draw a ruler</td>
<td>Boolean value Yes/No</td>
<td>Yes</td>
</tr>
<tr>
<td>-blocktype</td>
<td>Type of blocks</td>
<td><table><tr><td>Open</td> <td><i>(Open blocks)</i></td></tr><tr><td>Filled</td> <td><i>(Filled blocks)</i></td></tr><tr><td>Outline</td> <td><i>(Black border)</i></td></tr></table></td>
<td>Filled</td>
</tr>
<tr>
<td>-posticks</td>
<td>Ticks inside or outside the circle</td>
<td>Choose from selection list of values</td>
<td>Out</td>
</tr>
<tr>
<td>-posblocks</td>
<td>Text inside or outside the blocks</td>
<td>Choose from selection list of values</td>
<td>In</td>
</tr>
<tr>
<td>-graphout</td>
<td>Graph type</td>
<td>EMBOSS has a list of known devices, including ps, hpgl, hp7470, hp7580, meta, cps, x11, tekt, tek, none, data, xterm, png, gif</td>
<td><i>EMBOSS_GRAPHICS</i> value, or x11</td>
</tr>
<tr bgcolor="#FFFFCC">
<th align="left" colspan=2>Additional (Optional) qualifiers</th>
<th align="left">Allowed values</th>
<th align="left">Default</th>
</tr>
<tr>
<td>-maxgroups</td>
<td>Maximum number of groups</td>
<td>Integer 1 or more</td>
<td>20</td>
</tr>
<tr>
<td>-maxlabels</td>
<td>Maximum number of labels</td>
<td>Integer 1 or more</td>
<td>10000</td>
</tr>
<tr>
<td>-originangle</td>
<td>Position in degrees of the molecule's origin on the circle</td>
<td>Number from 0.000 to 360.000</td>
<td>90</td>
</tr>
<tr>
<td>-[no]intersymbol</td>
<td>Horizontal junctions between blocks</td>
<td>Boolean value Yes/No</td>
<td>Yes</td>
</tr>
<tr>
<td>-intercolour</td>
<td>Colour of junctions between blocks (enter a colour number)</td>
<td>Integer from 0 to 15</td>
<td>1</td>
</tr>
<tr>
<td>-interticks</td>
<td>Horizontal junctions between ticks</td>
<td>Boolean value Yes/No</td>
<td>No</td>
</tr>
<tr>
<td>-gapsize</td>
<td>Interval between ticks in the ruler</td>
<td>Integer 0 or more</td>
<td>500</td>
</tr>
<tr>
<td>-ticklines</td>
<td>Vertical lines at the ruler's ticks</td>
<td>Boolean value Yes/No</td>
<td>No</td>
</tr>
<tr>
<td>-textheight</td>
<td>Height of text. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-textlength</td>
<td>Length of text. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-tickheight</td>
<td>Height of ticks. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-blockheight</td>
<td>Height of blocks. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-rangeheight</td>
<td>Height of range ends. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-gapgroup</td>
<td>Space between groups. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr>
<td>-postext</td>
<td>Space between text and ticks, blocks, and ranges. Enter a number <1.0 or >1.0 to decrease or increase the size, respectively</td>
<td>Number 0.000 or more</td>
<td>1.0</td>
</tr>
<tr bgcolor="#FFFFCC">
<th align="left" colspan=2>Advanced (Unprompted) qualifiers</th>
<th align="left">Allowed values</th>
<th align="left">Default</th>
</tr>
<tr>
<td colspan=4>(none)</td>
</tr>
</table>
<H2>
Input file format
</H2>
<p>
Blank lines in the input file are ignored.
<p>
The file is organized in several fields separated by one or more space
or TAB characters.
<p>
The first non-blank line gives the start position of the DNA fragment to
be drawn after the keyword 'Start'. The end position is on the second
line following the keyword 'End'.
<p>
Then, one or more groups (up to a maximum of 20) of genetic markers are
defined. Each group begins with a line consisting of the keyword
'group' and ends with a line consisting of the keyword 'endgroup'.
<p>
If desired, a group name can be given on the very next line but
will not be displayed (only for compatibilty with lindna).
<p>
Next, the individual markers (up to a maximum of 1000) of the group are
described. Each marker begins with a line consisting of the keyword
'label' and ends with a line consisting of the keyword 'endlabel'.
<p>
Do not start a new marker (by using a 'label' line) before you have
closed the previous marker (by using an 'endlabel' line). You must end
a previous marker specification before starting a new one. i.e. do not
overlap marker specifications in the input file.
<p>
For each marker, the line following the 'label' line describes the
marker. Three types of markers can be drawn: ticks, blocks, and ranges.
<p>
For a tick, the descriptive line begins with the keyword 'Tick',
followed by the position of the tick in the DNA fragment, and a number
from 0 to 15 specifying the color in which the tick will be drawn (a
list of available colors is given below). If desired, a name can be
written above the tick. This name must be given on the next line. If
more than one name are given (one name per line), only the first one
will be displayed.
<p>
For a block, the descriptive line begins with the keyword 'Block',
followed by the start and end positions of the block in the DNA
fragment, and the number of the block's color. If desired, a name can
be written above or inside the block. This name must be given on the
next line. If more than one name are given (one name per line), only
the first one will be displayed.
<p>
For a range, the descriptive line begins with the keyword 'Range',
followed by the start and end positions of the range in the DNA
fragment. Next on the line are the types of boundaries that are to be
drawn. The user can choose among '>', '<', '[', ']' and '|' for both
start and end boundaries. If none of these types is wanted for a given
boundary, then a point '.' must be entered. Next is the color number.
If desired, a name can be written above the range. This name must be
given on the next line. If more than one name are given (one name per
line), only the first one will be displayed.
<p>
For any type of markers, names will be written in the same color as the
marker. Also, try to avoid long names.
<p>
The colors defined in the PLPLOT graphics library are:
<p>
0 "BLACK", 1 "RED", 2 "YELLOW", 3 "GREEN", 4 "AQUAMARINE",
5 "PINK", 6 "WHEAT", 7 "GREY", 8 "BROWN", 9 "BLUE", 10 "BLUEVIOLET",
11 "CYAN", 12 "TURQUOISE", 13 "MAGENTA", 14 "SALMON", and 15 "WHITE".
<p>
This format can also be used for the program <a
href="lindna.html">"lindna".</a>
<p>
<a name="input.1"></a>
<h3>Input files for usage example </h3>
<p><h3>File: data.cirp</h3>
<table width="90%"><tr><td bgcolor="#FFCCFF">
<pre>
Start 1001
End 4270
group
label
Block 1011 1362 3
ex1
endlabel
label
Tick 1610 8
EcoR1
endlabel
label
Block 1647 1815 1
endlabel
label
Tick 2459 8
BamH1
endlabel
label
Block 4139 4258 3
ex2
endlabel
endgroup
group
label
Range 2541 2812 [ ] 5
Alu
endlabel
label
Range 3322 3497 > < 5
MER13
endlabel
endgroup
</pre>
</td></tr></table><p>
<H2>
Output file format
</H2>
<a name="output.1"></a>
<h3>Output files for usage example </h3>
<p><h3>Graphics File: cirdna.ps</h3>
<p><img src="cirdna.1.cirdna.gif" alt="[cirdna results]">
Output is to the specified graphics device.
<H2>
Data files
</H2>
None.
<H2>
Notes
</H2>
None.
<H2>
References
</H2>
None.
<H2>
Warnings
</H2>
None.
<H2>
Diagnostic Error Messages
</H2>
None.
<H2>
Exit status
</H2>
It always exits with a status of 0.
<H2>
Known bugs
</H2>
None.
<h2><a name="See also">See also</a></h2>
<table border cellpadding=4 bgcolor="#FFFFF0">
<tr><th>Program name</th><th>Description</th></tr>
<tr>
<td><a href="abiview.html">abiview</a></td>
<td>Reads ABI file and display the trace</td>
</tr>
<tr>
<td><a href="lindna.html">lindna</a></td>
<td>Draws linear maps of DNA constructs</td>
</tr>
<tr>
<td><a href="pepnet.html">pepnet</a></td>
<td>Displays proteins as a helical net</td>
</tr>
<tr>
<td><a href="pepwheel.html">pepwheel</a></td>
<td>Shows protein sequences as helices</td>
</tr>
<tr>
<td><a href="prettyplot.html">prettyplot</a></td>
<td>Displays aligned sequences, with colouring and boxing</td>
</tr>
<tr>
<td><a href="prettyseq.html">prettyseq</a></td>
<td>Output sequence with translated ranges</td>
</tr>
<tr>
<td><a href="remap.html">remap</a></td>
<td>Display sequence with restriction sites, translation etc</td>
</tr>
<tr>
<td><a href="seealso.html">seealso</a></td>
<td>Finds programs sharing group names</td>
</tr>
<tr>
<td><a href="showalign.html">showalign</a></td>
<td>Displays a multiple sequence alignment</td>
</tr>
<tr>
<td><a href="showdb.html">showdb</a></td>
<td>Displays information on the currently available databases</td>
</tr>
<tr>
<td><a href="showfeat.html">showfeat</a></td>
<td>Show features of a sequence</td>
</tr>
<tr>
<td><a href="showseq.html">showseq</a></td>
<td>Display a sequence with features, translation etc</td>
</tr>
<tr>
<td><a href="sixpack.html">sixpack</a></td>
<td>Display a DNA sequence with 6-frame translation and ORFs</td>
</tr>
<tr>
<td><a href="textsearch.html">textsearch</a></td>
<td>Search sequence documentation. Slow, use SRS and Entrez!</td>
</tr>
</table>
<H2>
Author(s)
</H2>
Nicolas Tourasse (nicolas.tourasse © biotek.uio.no)
<br>
Biotechnology Center of Oslo
<H2>
History
</H2>
Written 1999 - Nicolas Tourasse
<br>
Updated (2002) - Nicolas Tourasse
<H2>
Target users
</H2>
This program is intended to be used by everyone and everything, from naive users to embedded scripts.
<H2>
Comments
</H2>
None
</BODY>
</HTML>