LSST Applications  21.0.0+c4f5df5339,21.0.0+e70536a077,21.0.0-1-ga51b5d4+7c60f8a6ea,21.0.0-10-g560fb7b+411cd868f8,21.0.0-10-gcf60f90+8c49d86aa0,21.0.0-13-gc485e61d+38156233bf,21.0.0-16-g7a993c7b9+1041c3824f,21.0.0-2-g103fe59+d9ceee3e5a,21.0.0-2-g1367e85+0b2f7db15a,21.0.0-2-g45278ab+e70536a077,21.0.0-2-g5242d73+0b2f7db15a,21.0.0-2-g7f82c8f+feb9862f5e,21.0.0-2-g8f08a60+9c9a9cfcc8,21.0.0-2-ga326454+feb9862f5e,21.0.0-2-gde069b7+bedfc5e1fb,21.0.0-2-gecfae73+417509110f,21.0.0-2-gfc62afb+0b2f7db15a,21.0.0-3-g21c7a62+a91f7c0b59,21.0.0-3-g357aad2+062581ff1a,21.0.0-3-g4be5c26+0b2f7db15a,21.0.0-3-g65f322c+85aa0ead76,21.0.0-3-g7d9da8d+c4f5df5339,21.0.0-3-gaa929c8+411cd868f8,21.0.0-3-gc44e71e+fd4029fd48,21.0.0-3-ge02ed75+5d9b90b8aa,21.0.0-38-g070523fc+44fda2b515,21.0.0-4-g591bb35+5d9b90b8aa,21.0.0-4-g88306b8+3cdc83ea97,21.0.0-4-gc004bbf+d52368b591,21.0.0-4-gccdca77+a5c54364a0,21.0.0-5-g7ebb681+81e2098694,21.0.0-5-gdf36809+87b8d260e6,21.0.0-6-g2d4f3f3+e70536a077,21.0.0-6-g4e60332+5d9b90b8aa,21.0.0-6-g5ef7dad+3f4e29eeae,21.0.0-7-gc8ca178+0f5e56d48f,21.0.0-9-g9eb8d17+cc2c7a81aa,master-gac4afde19b+5d9b90b8aa,w.2021.07
LSST Data Management Base Package
ds9.py
Go to the documentation of this file.
1 #
2 # LSST Data Management System
3 # Copyright 2008, 2009, 2010, 2015 LSST Corporation.
4 #
5 # This product includes software developed by the
6 # LSST Project (http://www.lsst.org/).
7 #
8 # This program is free software: you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation, either version 3 of the License, or
11 # (at your option) any later version.
12 #
13 # This program is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
17 #
18 # You should have received a copy of the LSST License Statement and
19 # the GNU General Public License along with this program. If not,
20 # see <http://www.lsstcorp.org/LegalNotices/>.
21 #
22 
23 import lsst.afw.display
24 import lsst.afw.image as afwImage
25 from .interface import getDisplay as _getDisplay, getDefaultBackend, setDefaultBackend
26 # Backwards compatibility. Downstream code should be converted to use display.RED etc.
27 from .interface import BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, WHITE # noqa: F401
28 try:
29  loaded
30 except NameError:
31  try:
32  if getDefaultBackend() is None:
33  setDefaultBackend("lsst.display.ds9")
34  getDisplay = _getDisplay
35  except Exception as e:
36  # No usable version of display_ds9.
37  # Let's define a version of getDisplay() which will throw an exception.
38 
39  # Prior to DM-9433, we used a closure to implicitly capture the
40  # exception being thrown for future reference. Following changes to
41  # exception scope rules in Python 3 (see PEP 3110), it's now regarded
42  # as clearer to make the capture explicit using the following class.
44  def __init__(self, exception):
45  # The exception being caught above may have a bulky context which we
46  # don't want to capture in a closure for all time: see DM-9504 for a
47  # full discussion. We therefore define a new exception of the same
48  # type, which just encodes the error text.
49  self.exceptionexception = type(exception)(f"{exception} (is display_ds9 setup?)")
50 
51  def __call__(self, *args, **kwargs):
52  raise self.exceptionexception
53 
54  getDisplay = _RaiseException(e)
55 
56  class DisplayImpl:
57  __init__ = getDisplay
58 
59  loaded = False
60  else:
61  loaded = True
62 
63 
64 def Buffering():
65  # always use the real one
66  return _getDisplay(None, create=True).Buffering()
67 
68 #
69 # Functions provided for backwards compatibility
70 #
71 
72 
73 def setMaskPlaneColor(name, color=None, frame=None):
74  return getDisplay(frame, create=True).setMaskPlaneColor(name, color)
75 
76 
77 def getMaskPlaneColor(name, frame=None):
78  return getDisplay(frame, create=True).getMaskPlaneColor(name)
79 
80 
81 def setMaskTransparency(name, frame=None):
82  return getDisplay(frame, create=True).setMaskTransparency(name)
83 
84 
85 def getMaskTransparency(name, frame=None):
86  return getDisplay(frame, create=True).getMaskTransparency(name)
87 
88 
89 def show(frame=None):
90  return getDisplay(frame, create=True).show()
91 
92 
93 def mtv(data, frame=None, title="", wcs=None, *args, **kwargs):
94  return getDisplay(frame, create=True).mtv(data, title, wcs, *args, **kwargs)
95 
96 
97 def erase(frame=None):
98  return getDisplay(frame, create=True).erase()
99 
100 
101 def dot(symb, c, r, frame=None, size=2, ctype=None, origin=afwImage.PARENT, *args, **kwargs):
102  return getDisplay(frame, create=True).dot(symb, c, r, size, ctype, origin, *args, **kwargs)
103 
104 
105 def line(points, frame=None, origin=afwImage.PARENT, symbs=False, ctype=None, size=0.5):
106  return getDisplay(frame, create=True).line(points, origin, symbs, ctype, size)
107 
108 
109 def scale(algorithm, min, max=None, frame=None):
110  return getDisplay(frame, create=True).scale(algorithm, min, max)
111 
112 
113 def pan(colc=None, rowc=None, frame=None, origin=afwImage.PARENT):
114  disp = getDisplay(frame, create=True)
115 
116  disp.pan(colc, rowc, origin)
117 
118 
119 def zoom(zoomfac=None, colc=None, rowc=None, frame=None, origin=afwImage.PARENT):
120  disp = getDisplay(frame, create=True)
121 
122  disp.zoom(zoomfac)
123  disp.pan(colc, rowc, origin)
124 
125 
126 def interact(frame=None):
127  return getDisplay(frame, create=True).interact()
128 
129 
130 def setCallback(k, func=lsst.afw.display.noop_callback, noRaise=False, frame=None):
131  return getDisplay(frame, create=True).setCallback(k, noRaise=False)
132 
133 
134 def getActiveCallbackKeys(onlyActive=True, frame=None):
135  return getDisplay(frame, create=True).getActiveCallbackKeys(onlyActive)
def __call__(self, *args, **kwargs)
Definition: ds9.py:51
def __init__(self, exception)
Definition: ds9.py:44
def setMaskPlaneColor(name, color=None, frame=None)
Definition: ds9.py:73
def dot(symb, c, r, frame=None, size=2, ctype=None, origin=afwImage.PARENT, *args, **kwargs)
Definition: ds9.py:101
def show(frame=None)
Definition: ds9.py:89
def setMaskTransparency(name, frame=None)
Definition: ds9.py:81
def line(points, frame=None, origin=afwImage.PARENT, symbs=False, ctype=None, size=0.5)
Definition: ds9.py:105
def scale(algorithm, min, max=None, frame=None)
Definition: ds9.py:109
def zoom(zoomfac=None, colc=None, rowc=None, frame=None, origin=afwImage.PARENT)
Definition: ds9.py:119
def setCallback(k, func=lsst.afw.display.noop_callback, noRaise=False, frame=None)
Definition: ds9.py:130
def erase(frame=None)
Definition: ds9.py:97
def getActiveCallbackKeys(onlyActive=True, frame=None)
Definition: ds9.py:134
def getMaskPlaneColor(name, frame=None)
Definition: ds9.py:77
def getMaskTransparency(name, frame=None)
Definition: ds9.py:85
def mtv(data, frame=None, title="", wcs=None, *args, **kwargs)
Definition: ds9.py:93
def interact(frame=None)
Definition: ds9.py:126
def Buffering()
Definition: ds9.py:64
def pan(colc=None, rowc=None, frame=None, origin=afwImage.PARENT)
Definition: ds9.py:113
def setDefaultBackend(backend)
Definition: interface.py:870
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
table::Key< int > type
Definition: Detector.cc:163