Coverage for python/lsst/obs/decam/_instrument.py : 47%

Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
1# This file is part of obs_decam.
2#
3# Developed for the LSST Data Management System.
4# This product includes software developed by the LSST Project
5# (http://www.lsst.org).
6# See the COPYRIGHT file at the top-level directory of this distribution
7# for details of code ownership.
8#
9# This program is free software: you can redistribute it and/or modify
10# it under the terms of the GNU General Public License as published by
11# the Free Software Foundation, either version 3 of the License, or
12# (at your option) any later version.
13#
14# This program is distributed in the hope that it will be useful,
15# but WITHOUT ANY WARRANTY; without even the implied warranty of
16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17# GNU General Public License for more details.
18#
19# You should have received a copy of the GNU General Public License
20# along with this program. If not, see <http://www.gnu.org/licenses/>.
22"""Butler instrument description for the Dark Energy Camera.
23"""
25__all__ = ("DarkEnergyCamera",)
27import os
28from functools import lru_cache
30from lsst.afw.cameraGeom import makeCameraFromPath, CameraConfig
31from lsst.obs.base import Instrument
32from lsst.obs.base.gen2to3 import AbstractToPhysicalFilterKeyHandler, TranslatorFactory
33from lsst.obs.decam.decamFilters import DECAM_FILTER_DEFINITIONS
35from lsst.daf.butler.core.utils import getFullTypeName
36from lsst.utils import getPackageDir
39class DarkEnergyCamera(Instrument):
40 filterDefinitions = DECAM_FILTER_DEFINITIONS
41 policyName = "decam"
42 obsDataPackage = "obs_decam_data"
44 def __init__(self, **kwargs):
45 super().__init__(**kwargs)
46 packageDir = getPackageDir("obs_decam")
47 self.configPaths = [os.path.join(packageDir, "config")]
49 @classmethod
50 def getName(cls):
51 return "DECam"
53 def getCamera(self):
54 path = os.path.join(getPackageDir("obs_decam"), self.policyName, "camGeom")
55 return self._getCameraFromPath(path)
57 @staticmethod
58 @lru_cache()
59 def _getCameraFromPath(path):
60 """Return the camera geometry given solely the path to the location
61 of that definition."""
62 config = CameraConfig()
63 config.load(os.path.join(path, "camera.py"))
64 return makeCameraFromPath(
65 cameraConfig=config,
66 ampInfoPath=path,
67 shortNameFunc=lambda name: name.replace(" ", "_"),
68 )
70 def register(self, registry):
71 camera = self.getCamera()
72 obsMax = 2**31
73 registry.insertDimensionData(
74 "instrument",
75 {"name": self.getName(), "detector_max": 64, "visit_max": obsMax, "exposure_max": obsMax,
76 "class_name": getFullTypeName(self),
77 }
78 )
80 for detector in camera:
81 registry.insertDimensionData(
82 "detector",
83 {
84 "instrument": self.getName(),
85 "id": detector.getId(),
86 "full_name": detector.getName(),
87 "name_in_raft": detector.getName()[1:],
88 "raft": detector.getName()[0],
89 "purpose": str(detector.getType()).split(".")[-1],
90 }
91 )
93 self._registerFilters(registry)
95 def getRawFormatter(self, dataId):
96 # local import to prevent circular dependency
97 from .rawFormatter import DarkEnergyCameraRawFormatter
98 return DarkEnergyCameraRawFormatter
100 def makeDataIdTranslatorFactory(self) -> TranslatorFactory:
101 # Docstring inherited from lsst.obs.base.Instrument.
102 factory = TranslatorFactory()
103 factory.addGenericInstrumentRules(self.getName(), calibFilterType="abstract_filter",
104 detectorKey="ccdnum")
105 # DECam calibRegistry entries are abstract_filters, but we need physical_filter
106 # in the gen3 registry.
107 factory.addRule(AbstractToPhysicalFilterKeyHandler(self.filterDefinitions),
108 instrument=self.getName(),
109 gen2keys=("filter",),
110 consume=("filter",),
111 datasetTypeName="cpFlat")
112 return factory