LSST Applications g0f08755f38+9c285cab97,g1635faa6d4+13f3999e92,g1653933729+a8ce1bb630,g1a0ca8cf93+bf6eb00ceb,g28da252d5a+0829b12dee,g29321ee8c0+5700dc9eac,g2bbee38e9b+9634bc57db,g2bc492864f+9634bc57db,g2cdde0e794+c2c89b37c4,g3156d2b45e+41e33cbcdc,g347aa1857d+9634bc57db,g35bb328faa+a8ce1bb630,g3a166c0a6a+9634bc57db,g3e281a1b8c+9f2c4e2fc3,g414038480c+077ccc18e7,g41af890bb2+fde0dd39b6,g5fbc88fb19+17cd334064,g781aacb6e4+a8ce1bb630,g80478fca09+55a9465950,g82479be7b0+d730eedb7d,g858d7b2824+9c285cab97,g9125e01d80+a8ce1bb630,g9726552aa6+10f999ec6a,ga5288a1d22+2a84bb7594,gacf8899fa4+c69c5206e8,gae0086650b+a8ce1bb630,gb58c049af0+d64f4d3760,gc28159a63d+9634bc57db,gcf0d15dbbd+4b7d09cae4,gda3e153d99+9c285cab97,gda6a2b7d83+4b7d09cae4,gdaeeff99f8+1711a396fd,ge2409df99d+5e831397f4,ge79ae78c31+9634bc57db,gf0baf85859+147a0692ba,gf3967379c6+41c94011de,gf3fb38a9a8+8f07a9901b,gfb92a5be7c+9c285cab97,w.2024.46
LSST Data Management Base Package
Loading...
Searching...
No Matches
Functions
lsst.afw.display.ds9Regions Namespace Reference

Functions

 dot (symb, c, r, size, ctype=None, fontFamily="helvetica", textAngle=None)
 
 drawLines (points, ctype=None)
 

Function Documentation

◆ dot()

lsst.afw.display.ds9Regions.dot ( symb,
c,
r,
size,
ctype = None,
fontFamily = "helvetica",
textAngle = None )
Draw a symbol onto the specified DS9 frame.

Parameters
----------
symb
    Possible values are:

        ``"+"``
            Draw a +
        ``"x"``
            Draw an x
        ``"*"``
            Draw a *
        ``"o"``
            Draw a circle
        ``"@:Mxx,Mxy,Myy"``
            Draw an ellipse with moments (Mxx, Mxy, Myy) (argument size is ignored)
        `lsst.afw.geom.ellipses.BaseCore`
            Draw the ellipse (argument size is ignored). N.b. objects
            derived from `~lsst.afw.geom.ellipses.BaseCore` include
            `~lsst.afw.geom.ellipses.Axes` and `~lsst.afw.geom.ellipses.Quadrupole`.
        Any other value
            Interpreted as a string to be drawn. Strings obey the ``fontFamily``
            (which may be extended with other characteristics, e.g. "times
            bold italic".  Text will be drawn rotated by ``textAngle``
            (textAngle is ignored otherwise).
c, r
    Zero-based coordinates at which to draw the symbol
size
ctype : `str`
    the name of the desired color (e.g. 'red', 'orchid')
fontFamily
textAngle

Definition at line 27 of file ds9Regions.py.

27def dot(symb, c, r, size, ctype=None, fontFamily="helvetica", textAngle=None):
28 """Draw a symbol onto the specified DS9 frame.
29
30 Parameters
31 ----------
32 symb
33 Possible values are:
34
35 ``"+"``
36 Draw a +
37 ``"x"``
38 Draw an x
39 ``"*"``
40 Draw a *
41 ``"o"``
42 Draw a circle
43 ``"@:Mxx,Mxy,Myy"``
44 Draw an ellipse with moments (Mxx, Mxy, Myy) (argument size is ignored)
45 `lsst.afw.geom.ellipses.BaseCore`
46 Draw the ellipse (argument size is ignored). N.b. objects
47 derived from `~lsst.afw.geom.ellipses.BaseCore` include
48 `~lsst.afw.geom.ellipses.Axes` and `~lsst.afw.geom.ellipses.Quadrupole`.
49 Any other value
50 Interpreted as a string to be drawn. Strings obey the ``fontFamily``
51 (which may be extended with other characteristics, e.g. "times
52 bold italic". Text will be drawn rotated by ``textAngle``
53 (textAngle is ignored otherwise).
54 c, r
55 Zero-based coordinates at which to draw the symbol
56 size
57 ctype : `str`
58 the name of the desired color (e.g. 'red', 'orchid')
59 fontFamily
60 textAngle
61 """
62 if ctype is None:
63 color = "" # the default
64 else:
65 color = ' # color=%s' % ctype
66
67 regions = []
68
69 r += 1
70 c += 1 # ds9 uses 1-based coordinates
71 if isinstance(symb, afwGeom.ellipses.Axes):
72 regions.append('ellipse %g %g %gi %gi %g%s' % (c, r, symb.getA(), symb.getB(),
73 math.degrees(symb.getTheta()), color))
74 elif symb == '+':
75 regions.append('line %g %g %g %g%s' % (c, r+size, c, r-size, color))
76 regions.append('line %g %g %g %g%s' % (c-size, r, c+size, r, color))
77 elif symb == 'x':
78 size = size/math.sqrt(2)
79 regions.append('line %g %g %g %g%s' %
80 (c+size, r+size, c-size, r-size, color))
81 regions.append('line %g %g %g %g%s' %
82 (c-size, r+size, c+size, r-size, color))
83 elif symb == '*':
84 size30 = 0.5*size
85 size60 = 0.5*math.sqrt(3)*size
86 regions.append('line %g %g %g %g%s' % (c+size, r, c-size, r, color))
87 regions.append('line %g %g %g %g%s' %
88 (c-size30, r+size60, c+size30, r-size60, color))
89 regions.append('line %g %g %g %g%s' %
90 (c+size30, r+size60, c-size30, r-size60, color))
91 elif symb == 'o':
92 regions.append('circle %g %g %gi%s' % (c, r, size, color))
93 else:
94 color = re.sub("^ # ", "", color) # skip the leading " # "
95
96 angle = ""
97 if textAngle is not None:
98 angle += " textangle=%.1f"%(textAngle)
99
100 font = ""
101 if size != 2 or fontFamily != "helvetica":
102 fontFamily = fontFamily.split()
103 font += ' font="%s %d' % (fontFamily.pop(0),
104 int(10*size/2.0 + 0.5))
105 if not fontFamily:
106 # appears to be needed at least for 7.4b1
107 fontFamily = ["normal"]
108 font += " " + " ".join(fontFamily)
109 font += '"'
110 extra = ""
111 if color or angle or font:
112 extra = " # "
113 extra += color
114 extra += angle
115 extra += font
116
117 regions.append('text %g %g \"%s\"%s' % (c, r, symb, extra))
118
119 return regions
120
121

◆ drawLines()

lsst.afw.display.ds9Regions.drawLines ( points,
ctype = None )
Draw a line by connecting the points

Parameters
----------
points : `list` of `tuple` of `float`
    a list of (col,row)
ctype : `str`
    the name of the desired color (e.g. 'red', 'orchid')

Definition at line 122 of file ds9Regions.py.

122def drawLines(points, ctype=None):
123 """Draw a line by connecting the points
124
125 Parameters
126 ----------
127 points : `list` of `tuple` of `float`
128 a list of (col,row)
129 ctype : `str`
130 the name of the desired color (e.g. 'red', 'orchid')
131 """
132
133 if ctype is None: # default
134 color = ""
135 else:
136 color = f"# color={ctype}"
137
138 regions = []
139 if len(points) > 0:
140 c0, r0 = points[0]
141 r0 += 1
142 c0 += 1 # ds9 uses 1-based coordinates
143 for (c, r) in points[1:]:
144 r += 1
145 c += 1 # ds9 uses 1-based coordinates
146 regions.append('line %g %g %g %g %s' % (c0, r0, c, r, color))
147 c0, r0 = c, r
148
149 return regions