lsst.afw.display.ds9Regions Namespace Reference

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

Function Documentation

dot()

def 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.

def 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
    """
    if ctype is None:
        color = ""                       # the default
    else:
        color = ' # color=%s' % ctype
 
    regions = []
 
    r += 1
    c += 1                      # ds9 uses 1-based coordinates
    if isinstance(symb, afwGeom.ellipses.Axes):
        regions.append('ellipse %g %g %gi %gi %g%s' % (c, r, symb.getA(), symb.getB(),
                                                       math.degrees(symb.getTheta()), color))
    elif symb == '+':
        regions.append('line %g %g %g %g%s' % (c, r+size, c, r-size, color))
        regions.append('line %g %g %g %g%s' % (c-size, r, c+size, r, color))
    elif symb == 'x':
        size = size/math.sqrt(2)
        regions.append('line %g %g %g %g%s' %
                       (c+size, r+size, c-size, r-size, color))
        regions.append('line %g %g %g %g%s' %
                       (c-size, r+size, c+size, r-size, color))
    elif symb == '*':
        size30 = 0.5*size
        size60 = 0.5*math.sqrt(3)*size
        regions.append('line %g %g %g %g%s' % (c+size, r, c-size, r, color))
        regions.append('line %g %g %g %g%s' %
                       (c-size30, r+size60, c+size30, r-size60, color))
        regions.append('line %g %g %g %g%s' %
                       (c+size30, r+size60, c-size30, r-size60, color))
    elif symb == 'o':
        regions.append('circle %g %g %gi%s' % (c, r, size, color))
    else:
        color = re.sub("^ # ", "", color)  # skip the leading " # "
 
        angle = ""
        if textAngle is not None:
            angle += " textangle=%.1f"%(textAngle)
 
        font = ""
        if size != 2 or fontFamily != "helvetica":
            fontFamily = fontFamily.split()
            font += ' font="%s %d' % (fontFamily.pop(0),
                                      int(10*size/2.0 + 0.5))
            if not fontFamily:
                # appears to be needed at least for 7.4b1
                fontFamily = ["normal"]
            font += " " + " ".join(fontFamily)
            font += '"'
        extra = ""
        if color or angle or font:
            extra = " # "
            extra += color
            extra += angle
            extra += font
 
        regions.append('text %g %g \"%s\"%s' % (c, r, symb, extra))
 
    return regions
 
 

drawLines()

def 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.

def 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')
    """
 
    if ctype is None:  # default
        color = ""
    else:
        color = f"# color={ctype}"
 
    regions = []
    if len(points) > 0:
        c0, r0 = points[0]
        r0 += 1
        c0 += 1             # ds9 uses 1-based coordinates
        for (c, r) in points[1:]:
            r += 1
            c += 1            # ds9 uses 1-based coordinates
            regions.append('line %g %g %g %g %s' % (c0, r0, c, r, color))
            c0, r0 = c, r
 
    return regions