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
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
|
<!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
<meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux
2.4.7-10 i686) [Netscape]">
<title>Regions</title>
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
<meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux
2.4.7-10 i686) [Netscape]">
</head>
<body link="#0000ff" alink="#ff0000" bgcolor="#ffffff" text="#000000"
vlink="#551a8b">
<h3><img alt="" src="../sun.gif" height="98" align="middle"
width="100"> Regions</h3>
<blockquote>
<p>Regions provide a means for marking particular areas of an
image for further analysis. Regions may also be used for
presentation purposes. DS9 supports a number of region
descriptions, each of which may be edited, moved, rotated,
displayed, saved and loaded, via the GUI and XPA.</p>
<a href="#RegionDescriptions">Region Descriptions</a><br>
<a href="#RegionProperties">Region Properties</a><br>
<a href="#RegionFileFormat">Region File Format</a><br>
<a href="#CompositeRegion">Composite Region</a><br>
<a href="#TemplateRegion">Template Region</a><br>
<a href="#ExternalRegionFiles">External Region Files</a><br>
<p><b> <a name="RegionDescriptions"></a>Region Descriptions</b></p>
<p><tt>Circle<br>
Usage: circle x y radius<br>
</tt></p>
<p><tt>Ellipse<br>
Usage: ellipse x y radius radius angle<br>
</tt></p>
<p><tt>Box <br>
Usage: box x y width height angle<br>
</tt></p>
<p><tt>Polygon <br>
Usage: polygon x1 y1 x2 y2 x3 y3 ...<br>
</tt></p>
<p><tt>Point <br>
Usage: point x y #
point=[circle|box|diamond|cross|x|arrow|boxcircle] [size]<br>
circle point x y </tt></p>
<p><tt>Line <br>
Usage: line x1 y1 x2 y2 # line=[0|1] [0|1] </tt></p>
<p><tt>Vector <br>
Usage: vector x1 y1 length angle # vector=[0|1] </tt></p>
<p><tt>Text <br>
Usage: text x y # text={Your Text Here}<br>
text x y {Your Text Here}
</tt></p>
<p><tt>Ruler <br>
Usage: ruler x1 y1 x2 y2 #
ruler=[pixels|degrees|arcmin|arcsec]</tt></p>
<p><tt>Compass <br>
Usage: compass x1 y1 length # compass=<coordinate
system> <north label> <east label> [0|1] [0|1]
</tt></p>
<p><tt>Projection <br>
Usage: projection x1 y1 x2 y2 width</tt></p>
<p><tt>Annulus <br>
Usage: annulus x y inner outer n=# <br>
annulus x y r1 r2 r3... </tt></p>
<p><tt>Ellipse Annulus <br>
Usage: ellipse x y r11 r12 r21 r22 n=# [angle]<br>
ellipse x y r11 r12 r21
r22 r31 r32 ... [angle] </tt></p>
<p><tt>Box Annulus <br>
Usage: box x y w1 h1 w2 h2 [angle] <br>
box x y w1 h1 w2 h2 w3 h3
... [angle] </tt></p>
<p><tt>Panda <br>
Usage: panda x y startangle stopangle nangle inner outer
nradius</tt></p>
<p><tt>Epanda <br>
Usage: epanda x y startangle stopangle nangle inner outer
nradius [angle]</tt></p>
<p><tt>Bpanda <br>
Usage: bpanda x y startangle stopangle nangle inner outer
nradius [angle]</tt></p>
<p><tt>Composite<br>
Usage: # composite x y angle</tt></p>
<p><b> <a name="RegionProperties"></a>Region Properties</b></p>
<p>Each region has a number of properties associated with the
region, which indicates how the region is to be rendered or
manipulated. Properties are defined for a region in the comment
section of the region description. The exception is the
Include/Exclude property. It is set via '+' or '-' preceding the
region. In addition, the Line, Point, and Ruler regions have
unique properties, not shared by others. Not all properties are
available via the GUI or are applicable for all regions. </p>
<blockquote>
<p><b> Text</b></p>
<p>All regions may have text associated with them. Use the text
property to set the text. Strings may be quoted with " or ' or
{}. For best results, use {}. Use <tt>textangle</tt> to
specify angle in degress based on current coordinate system
axes.<br>
</p>
<tt>Example: circle(100,100,20) # text={This message has both a
" and ' in it} textangle=30</tt>
<p><b> Color</b></p>
<p>The color property specifies the color of the region when
rendered. DS9 recognizes many symbolic color names (i.e.
"red", "green", "blue", "pink", etc) along with 3, 6, and 9
digit RGB hex values (#fff, #ffffff, #fffffffff)<br>
</p>
<tt>Example: <br>
circle(100,100,20) # color=green<br>
</tt><tt>circle(100,100,20) # color=#48f</tt>
<p><b>Dash List</b></p>
<p>Sets dashed line parameters. This does not render the region
in dashed lines.</p>
<tt>Example: circle(100,100,20) # dashlist=8 3</tt><br>
<p><b>Width</b></p>
<p>Sets the line width used to render the region.</p>
<tt>Example: circle(100,100,20) # width=2</tt><br>
<p><b>Font</b></p>
<p>The font property specifies the font family, size, weight,
and slant of any text to be displayed along with the region. </p>
<tt>Example: circle(100,100,20) # font="times 12 bold italic"</tt>
<p><b> Can Select</b></p>
<p>The Select property specifies if the user is allowed to
select (hence, edit) the region via the GUI. For Regions used
for catalogs and such, it is desirable that the user is unable
to edit, move, or delete the region.<br>
</p>
<tt>Example: circle(100,100,20) # select=1</tt><br>
<p><b>Can Highlite</b></p>
The Highlite property specifies if the edit handles become
visible when the region is selected.<br>
<tt>Example: circle(100,100,20) # hightlite=1</tt><br>
<p><b>Dash</b></p>
<p>Render region using dashed lines using current <tt>dashlist</tt>
value.</p>
<tt>Example: circle(100,100,20) # dash=1</tt><br>
<p><b>Fixed in Size</b></p>
<p>The Fixed in Size property specifies that the region does not
change in size as the image magnification factor changes. This
allows the user to build complex pointer type regions. </p>
<tt>Example: circle(100,100,20) # fixed=1</tt>
<p><b> Can Edit</b></p>
<p>The Edit property specifies if the user is allowed to edit
the region via the GUI. </p>
<tt>Example: circle(100,100,20) # edit=1</tt>
<p><b> Can Move</b></p>
<p>The Move property specifies if the user is allowed to move
the region via the GUI. </p>
<tt>Example: circle(100,100,20) # move=1</tt>
<p><b> Can Rotate</b></p>
<p>The Rotate property specifies if the user is allowed to
rotate the region via the GUI. </p>
<tt>Example: circle(100,100,20) # rotate=1</tt>
<p><b> Can Delete</b></p>
<p>The Delete property specifies if the user is allowed to
delete the region via the GUI. </p>
<tt>Example: circle(100,100,20) # delete=1</tt>
<p><b> Include/Exclude</b></p>
<p>The Include/Exclude properties flags the region with a
boolean <tt>NOT </tt>for later analysis. Use '+' for include
(default), '-' for exclude. </p>
<tt>Example: -circle(100,100,20)<br>
</tt>
<p><b>Source/Background</b></p>
<p>The Source/Background properties flag the region for use with
other analysis applications. The default is <tt>source</tt></p>
<tt>Example: circle(100,100,20) # source<br>
circle(200,200,10)
# background</tt><br>
<p><b>Tag</b></p>
<p>All regions may have zero or more tags associated with it,
which may be used for grouping and searching. </p>
<tt>Example: circle(100,100,20) # tag={Group 1} tag={Group
2}</tt>
<p><b> Line</b></p>
<p>The line region may be rendered with arrows, one at each end.
To indicate arrows, use the line property. A '1' indicates an
arrow, '0' indicates no arrow. </p>
<tt>Example: line(100,100,200,200) # line=1 1</tt>
<p><b> Ruler</b></p>
<p>The ruler region may display information in 'pixels',
'degrees', 'arcmin', or 'arcsec'. Use the ruler property to
indicate which format to display distances in. </p>
<tt>Example: ruler(100,100,200,200) # ruler=arcmin</tt>
<p><b> Point</b></p>
<p>Point regions have an associated type and size. Use the point
property to set the point type. </p>
<tt>Example: point(100,100) # point=diamond 31</tt>
<p><b> Default Properties</b></p>
<p>The default properties are: </p>
<blockquote> <tt>text={}</tt> <br>
<tt>color=green</tt> <br>
<tt>font="helvetica 10 normal roman"</tt> <br>
<tt>select=1</tt> <br>
<tt>edit=1</tt> <br>
<tt>move=1</tt> <br>
<tt>delete=1</tt> <br>
<tt>highlite=1</tt> <br>
<tt>include=1</tt> <br>
<tt>fixed=0</tt> </blockquote>
</blockquote>
<p><b><a name="RegionFileFormat"></a>Region File Format</b></p>
<blockquote>
<p><b> Syntax</b></p>
<p>Region arguments may be separated with either a comma or
space. Optional parentheses may be used a the beginning and
end of a description. </p>
<blockquote> <tt>circle 100 100 10</tt> <br>
<tt>circle(100 100 10)</tt> <br>
<tt>circle(100,100,10)</tt> </blockquote>
<p><b> Comments</b></p>
<p>All lines that begin with <tt>#</tt> are comments and will
be ignored.</p>
<blockquote> <tt># This is a comment</tt> </blockquote>
<p><b> Delimiter</b></p>
<p>All lines may be delimited with either a new-line or
semi-colon. </p>
<blockquote> <tt>circle 100 100 10</tt> <br>
<tt>ellipse 200 200 20 40 ; box 300 300 20 40</tt> </blockquote>
<p><b> Header</b></p>
<p>A DS9 region file may start with the following optional
header: </p>
<blockquote> <tt># Region file format: DS9 version 4.0</tt> </blockquote>
<p><b> Global Properties</b></p>
<p>Global properties affect all regions unless a local property
is specified. The <tt>global</tt> keyword is first, followed
by a list of keyword = value pairs. Multiple global property
lines may be used within a region file. </p>
<blockquote> <tt>global color=green font="helvetica 10 normal
roman" edit=1 move=1 delete=1 highlite=1 include=1 wcs=wcs</tt>
</blockquote>
<p><b> Local Properties</b></p>
<p>Local properties start with a # after a region description
and only affect the region it is specified with. </p>
<blockquote> <tt>physical;circle(504,513,20) # color=red
text={This is a Circle}</tt> </blockquote>
<p><b> Coordinate Systems</b></p>
<p>For each region, it is important to specify the coordinate
system used to interpret the region, i.e., to set the context
in which the position and size values are interpreted. For
this purpose, the following keywords are recognized: </p>
<blockquote>
<blockquote> <tt>PHYSICAL
#
pixel coords of original file using LTM/LTV</tt> <br>
<tt>IMAGE
#
pixel coords of current file</tt> <br>
<tt><tt><tt>FK4,B1950
# sky coordinate systems</tt> <br>
FK5,J2000
#
sky coordinate systems</tt> <br>
</tt><tt><tt><tt>ICRS
#
sky coordinate systems</tt> <br>
</tt>GALACTIC
#
sky coordinate systems</tt> <br>
<tt>ECLIPTIC
#
sky coordinate systems</tt> <br>
<tt>WCS
# primary WCS<br>
</tt><tt>WCSA
#
secondary WCS<br>
</tt><tt>LINEAR
#
linear primary WCS</tt> <tt><br>
</tt></blockquote>
<tt></tt> </blockquote>
<p><b> Mosaic Images</b></p>
<p>While some coordinate systems are unique across mosaic
images, others coordinate systems, such as <tt>image</tt>, or
<tt>physical</tt> , are valid on a per segment basis. In this
case, use <tt>tile</tt> to specify which header to use in all
coordinate conversions. The default is the first header, or <tt>tile
1</tt>. </p>
<tt>Example: tile 2;fk5;point(100,100)</tt>
<p><b> Multiple WCS</b></p>
<p>If an image has multiple wcs's defined, use <tt>wcs#</tt> to
specify which wcs to use for all wcs references. Valid values
are <tt>wcs, wcsa, wcsb, wcsc... wcsz.</tt><br>
<tt>Example: wcsa;linear;point(100,100) # point=diamond</tt></p>
<p><b> Specifying Positions and Sizes</b></p>
<p>The arguments to region shapes can be floats or integers
describing positions and sizes. They can be specified as pure
numbers or using explicit formatting directives: </p>
<blockquote>
<p><b>position arguments</b> </p>
<tt>[num]
#
context-dependent (see below)</tt> <br>
<tt>[num]d
#
degrees</tt> <br>
<tt>[num]r
#
radians</tt> <br>
<tt>[num]p
#
physical pixels</tt> <br>
<tt>[num]i
#
image pixels</tt> <br>
<tt>[num]:[num]:[num] #
hms for 'odd' position arguments</tt> <br>
<tt>[num]:[num]:[num] #
dms for 'even' position arguments</tt> <br>
<tt>[num]h[num]m[num]s #
explicit hms</tt> <br>
<tt>[num]d[num]m[num]s #
explicit dms</tt>
<p><b>size arguments</b> </p>
<tt>[num]
#
context-dependent (see below)</tt> <br>
<tt>[num]"
#
arc sec</tt> <br>
<tt>[num]'
#
arc min</tt> <br>
<tt>[num]d
#
degrees</tt> <br>
<tt>[num]r
#
radians</tt> <br>
<tt>[num]p
#
physical pixels</tt> <br>
<tt>[num]i
#
image pixels</tt>
<p></p>
</blockquote>
<p>When a "pure number" (i.e. one without a format directive
such as 'd' for 'degrees') is specified, its interpretation
depends on the context defined by the 'coordsys' keyword. In
general, the rule is: </p>
<p><i>All pure numbers have implied units corresponding to the
current coordinate system.</i> </p>
<p>If no such system is explicitly specified, the default system
is implicitly assumed to be <tt>PHYSICAL</tt>. In practice
this means that for <tt>IMAGE</tt> and <tt>PHYSICAL</tt>
systems, pure numbers are pixels. Otherwise, for all systems
other than linear, pure numbers are degrees. For <tt>LINEAR</tt>
systems, pure numbers are in the units of the linear system.
This rule covers both positions and sizes. The input values to
each shape can be specified in several coordinate systems
including: </p>
<blockquote> <tt>IMAGE
#
pixel coords of current file</tt> <br>
<br>
<tt>LINEAR
#
linear wcs as defined in file</tt>
<p><tt>FK4,
B1950
#
sky coordinate systems</tt> <br>
<tt>FK5, J2000</tt> <br>
<tt>GALACTIC</tt> <br>
<tt>ECLIPTIC</tt> <br>
<tt>ICRS</tt> <br>
<tt>PHYSICAL
#
pixel coords of original file using LTM/LTV</tt> <br>
<tt>AMPLIFIER
#
mosaic coords of original file using ATM/ATV</tt> <br>
<tt>DETECTOR
#
mosaic coords of original file using DTM/DTV</tt><br>
<br>
<tt>WCS,WCSA-WCSZ
# specify which WCS system to be
used for <br>
#
linear and sky coordinate systems<br>
</tt></p>
</blockquote>
<p>If no coordinate system is specified, <tt>PHYSICAL</tt> is
assumed. <tt>PHYSICAL</tt> or a World Coordinate System such
as <tt>J2000</tt> is preferred and most general. The
coordinate system specifier should appear at the beginning of
the region description, on a separate line (in a file), or
followed by a new-line or semicolon; e.g., </p>
<blockquote> <tt>image; circle 100 100 10</tt> <br>
<tt>physical; ellipse 200 200 10 20</tt> <br>
<tt>fk5; point 30 50</tt><br>
<tt>wcsa; fk4; point 202 47</tt><br>
<tt>wcsp; linear; point 100 100</tt><br>
</blockquote>
<p>The use of celestial input units automatically implies WORLD
coordinates of the reference image. Thus, if the world
coordinate system of the reference image is <tt>J2000</tt>,
then</p>
<blockquote> <tt>circle 10:10:0 20:22:0 3'</tt> </blockquote>
<p>is equivalent to: <br>
</p>
<blockquote> <tt>j2000; circle 10:10:0 20:22:0 3'</tt> </blockquote>
<p>Note that by using units as described above, you may mix
coordinate systems within a region specifier; e.g., </p>
<blockquote> <tt>physical; circle 6500 9320 3'<br>
</tt></blockquote>
<p>Note that, for regions which accept a rotation angle such as:
</p>
<blockquote> <tt>ellipse (x, y, r1, r2, angle)<br>
box(x, y, w, h, angle)</tt>
<p></p>
</blockquote>
<p>the angle is relative to the specified coordinate system. In
particular, if the region is specified in WCS coordinates, the
angle is related to the WCS system, not x/y image coordinate
axis. For WCS systems with no rotation, this obviously is not
an issue. However, some images do define an implicit rotation
(e.g., by using a non-zero CROTA value in the WCS parameters)
and for these images, the angle will be relative to the WCS
axes. In such case, a region specification such as:</p>
<blockquote> <tt>fk4;ellipse(22:59:43.985, +58:45:26.92,320",
160", 30)</tt> </blockquote>
<p>will not, in general, be the same region specified as:</p>
<blockquote> <tt>physical;ellipse(465, 578, 40, 20, 30)</tt> </blockquote>
<p>even when positions and sizes match. The angle is relative to
WCS axes in the first case, and relative to physical x,y axes
in the second.</p>
</blockquote>
<p><b><a name="CompositeRegion"></a>Composite Region</b></p>
<p>A Composite Region is a region which is a collection of other
regions, which share common properties. A composite region is
composed of a center point and a rotation angle, of which all
its members are rendered in reference to. A composite region is
defined by the # composite x y angle declaration followed by a
number of regions who are or'd together. A composite region is
manipulated as a single region within ds9. A composite region
maybe created from the current selection of regions by selecting
the Create Composite Region menu option. Likewise, a composite
region can be dissolved by selecting the Dissolve Composite
Region menu option.</p>
<p><b> <a name="TemplateRegion"></a>Template Region</b></p>
<p>A Template Region is a special form of a region which is saved
in a special wcs coordinate system WCS0. WCS0 indicates that the
ra and dec values are relative to the current WCS location, not
absolute. A template region can be loaded at any location into
any fits image which contains a valid wcs. For example, a user
may create a series of regions, which represent an instrument
template. Then, by selecting the Save As Template menu option, a
template region saved. The user may now load this templated into
any other fits image which contains a valid WCS. </p>
<p><b> <a name="ExternalRegionFiles"></a>External Region Files</b></p>
<p>DS9 can read and write a number of region file formats. Not all
formats support all the functionality of DS9 regions. Therefore,
the user may loose some information when writing and then
reading back from a region file in a format other that DS9. On
output, the regions File Format menu or the <a
href="xpa.html#regions">XPA</a> regions point is used specify
the output coordinate system and format. On input, the menu or
xpa point is used only for the <tt>X Y </tt>format. For all
other formats, the input coordinate system is specified in the
regions file itself. </p>
<blockquote>
<p><b> <a name="FUNTools"></a><a
href="http://hea-www.harvard.edu/RD/funtools/regions.html">Funtools</a></b><tt></tt><br>
</p>
<blockquote> <tt>When using DS9 regions file in FUNTOOLS:<br>
LINE is ignored<br>
</tt> <tt>VECTOR is ignored</tt> <br>
<tt>PROJECTION is ignored<br>
SEGMENT is ignored<br>
TEXT is ignored<br>
</tt> <tt>RULER is ignored</tt><br>
<tt>COMPASS is ignored</tt><br>
</blockquote>
<a name="Ciao"></a>CIAO
<blockquote> <tt><tt>When importing from CIAO into DS9:<br>
POINT is translated into BOX CIRCLE POINT</tt><br>
</tt><tt>ROTBOX is translated into BOX<br>
RECTANGLE is translated into BOX<br>
</tt><tt>PANDA is translated as PIE<br>
SECTOR is ignored<br>
FIELD is ignored</tt><br>
<tt><tt>REGION is ignored<br>
</tt><br>
When exporting from DS9 into CIAO:<br>
</tt> <tt>PANDA is translated into PIE<br>
LINE is ignored</tt><br>
<tt>VECTOR is ignored</tt> <br>
<tt><tt>PROJECTION is ignored</tt><br>
</tt><tt><tt>SEGMENT is ignored<br>
</tt></tt><tt><tt>TEXT is ignored</tt><br>
RULER is ignored</tt><br>
<tt>COMPASS is ignored</tt><br>
<tt>ELLIPSE ANNULUS is ignored</tt><br>
<tt>BOX ANNULUS is ignored</tt><br>
<tt>EPANDA is ignored</tt><br>
<tt>BPANDA is ignored</tt><br>
</blockquote>
<a name="SAOimage"></a><a
href="http://tdc-www.harvard.edu/software/saoimage/saoimage.region.html">SAOimage</a>
<blockquote> <tt><tt><tt>When importing from SAOIMAGE into DS9:<br>
POINT is translated into BOX CIRCLE POINT</tt></tt></tt><br>
<tt><tt><tt><tt>ROTBOX is translated into BOX<br>
</tt></tt> </tt></tt><tt><br>
</tt><tt><tt>When exporting from DS9 into SAOIMAGE:<br>
</tt> </tt><tt><tt><tt>LINE is ignored</tt><br>
<tt>VECTOR is ignored</tt> <br>
<tt><tt>PROJECTION is ignored</tt><br>
</tt><tt><tt>SEGMENT is ignored<br>
</tt></tt><tt><tt>TEXT is ignored</tt><br>
RULER is ignored</tt><br>
<tt>COMPASS is ignored</tt><br>
</tt></tt><tt><tt>ELLIPSE ANNULUS is ignored</tt><br>
<tt>BOX ANNULUS is ignored</tt><br>
PANDA is ignored</tt><br>
<tt>EPANDA is ignored</tt><br>
<tt>BPANDA is ignored</tt><br>
</blockquote>
<a name="IRAFPROS"></a>IRAF PROS
<blockquote> <tt><tt><tt><tt>When importing from PROS into DS9:<br>
POINT is translated into BOX CIRCLE POINT</tt></tt></tt><br>
</tt><tt><tt><tt><tt>ROTBOX is translated into BOX<br>
</tt></tt> </tt></tt><tt><br>
</tt><tt><tt><tt>When exporting from DS9 into SAOIMAGE:<br>
</tt> </tt><tt><tt><tt>LINE is ignored</tt><br>
<tt>VECTOR is ignored</tt> <br>
<tt><tt>PROJECTION is ignored</tt><br>
</tt><tt><tt>SEGMENT is ignored<br>
</tt></tt><tt><tt>TEXT is ignored</tt><br>
RULER is ignored</tt><br>
<tt>COMPASS is ignored</tt><br>
</tt></tt><tt><tt>ELLIPSE ANNULUS is ignored</tt><br>
<tt>BOX ANNULUS is ignored</tt><br>
PANDA is ignored</tt><br>
<tt>EPANDA is ignored</tt><br>
<tt>BPANDA is ignored</tt></tt><br>
</blockquote>
<a name="FITSREGIONBinaryTable"></a>FITS REGION Binary Table
<blockquote> <tt><tt><tt><tt><tt>When importing from FITS
REGION into DS9:<br>
POINT is translated into BOX CIRCLE POINT</tt></tt></tt><br>
</tt><tt><tt><tt><tt>ROTBOX is translated into BOX</tt></tt></tt></tt></tt><br>
<tt><tt><tt><tt><tt><tt>RECTANGLE is translated into BOX</tt><br>
<tt>ROTRECTANGLE is translated into a BOX</tt><br>
<tt>PIE is translated into PANDA<br>
ELLIPTANNULUS is translated into EPANDA<br>
SECTOR is ignored<br>
</tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>FIELD
is ignored</tt><br>
</tt><tt>DIAMOND</tt><tt><tt> is ignored<br>
</tt>RHOMBUS</tt><tt><tt> is ignored<br>
</tt>ROTDIAMOND</tt><tt><tt> is ignored<br>
</tt>ROTRHOMBUS</tt><tt> is ignored<br>
</tt> </tt></tt></tt></tt><tt><br>
</tt>DS9 currently can not export into this format.</tt><br>
</blockquote>
<a name="XY"></a>X Y <br>
<p>This format consists of a number of coordinate pairs, one per
line. The coordinate format for both input and output is
specified via the Save Regions Parameters menu or <a
href="xpa.html#regions">XPA</a> regions point. The first two
coordinates are read, the rest of the line is ignored. The
comment character '#' may be used at the beginning of line and
the line is ignored. This format is very useful for reading in
coordinates from other external analysis programs, such as
IRAF. </p>
<blockquote> <tt>Example:</tt> <tt># this is a comment</tt> <br>
<tt>physical # this overrides the specified coordinate system</tt><br>
<tt>300 300</tt> <br>
<tt>400 400 # this is a comment</tt> <br>
</blockquote>
</blockquote>
</blockquote>
</body>
</html>
|