Hide keyboard shortcuts

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

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

# 

# LSST Data Management System 

# Copyright 2008, 2009, 2010, 2011, 2012 LSST Corporation. 

# 

# This product includes software developed by the 

# LSST Project (http://www.lsst.org/). 

# 

# This program is free software: you can redistribute it and/or modify 

# it under the terms of the GNU General Public License as published by 

# the Free Software Foundation, either version 3 of the License, or 

# (at your option) any later version. 

# 

# This program is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the implied warranty of 

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

# GNU General Public License for more details. 

# 

# You should have received a copy of the LSST License Statement and 

# the GNU General Public License along with this program. If not, 

# see <http://www.lsstcorp.org/LegalNotices/>. 

# 

import lsst.pex.config as pexConfig 

import lsst.afw.math as afwMath 

import lsst.afw.geom as afwGeom 

import lsst.pipe.base as pipeBase 

from lsst.ip.diffim import ModelPsfMatchTask 

from lsst.meas.algorithms import WarpedPsf 

 

__all__ = ["WarpAndPsfMatchTask"] 

 

 

class WarpAndPsfMatchConfig(pexConfig.Config): 

"""Config for WarpAndPsfMatchTask 

""" 

psfMatch = pexConfig.ConfigurableField( 

target=ModelPsfMatchTask, 

doc="PSF matching model to model task", 

) 

warp = pexConfig.ConfigField( 

dtype=afwMath.Warper.ConfigClass, 

doc="warper configuration", 

) 

 

 

class WarpAndPsfMatchTask(pipeBase.Task): 

"""A task to warp and PSF-match an exposure 

""" 

ConfigClass = WarpAndPsfMatchConfig 

 

def __init__(self, *args, **kwargs): 

pipeBase.Task.__init__(self, *args, **kwargs) 

self.makeSubtask("psfMatch") 

self.warper = afwMath.Warper.fromConfig(self.config.warp) 

 

def run(self, exposure, wcs, modelPsf=None, maxBBox=None, destBBox=None, 

makeDirect=True, makePsfMatched=False): 

"""Warp and optionally PSF-match exposure 

 

Parameters 

---------- 

exposure : :cpp:class: `lsst::afw::image::Exposure` 

Exposure to preprocess. 

wcs : :cpp:class:`lsst::afw::image::Wcs` 

Desired WCS of temporary images. 

modelPsf : :cpp:class: `lsst::meas::algorithms::KernelPsf` or None 

Target PSF to which to match. 

maxBBox : :cpp:class:`lsst::afw::geom::Box2I` or None 

Maximum allowed parent bbox of warped exposure. 

If None then the warped exposure will be just big enough to contain all warped pixels; 

if provided then the warped exposure may be smaller, and so missing some warped pixels; 

ignored if destBBox is not None. 

destBBox: :cpp:class: `lsst::afw::geom::Box2I` or None 

Exact parent bbox of warped exposure. 

If None then maxBBox is used to determine the bbox, otherwise maxBBox is ignored. 

makeDirect : bool 

Return an exposure that has been only warped? 

makePsfMatched : bool 

Return an exposure that has been warped and PSF-matched? 

 

Returns 

------- 

An lsst.pipe.base.Struct with the following fields: 

 

direct : :cpp:class:`lsst::afw::image::Exposure` 

warped exposure 

psfMatched : :cpp:class: `lsst::afw::image::Exposure` 

warped and psf-Matched temporary exposure 

""" 

if makePsfMatched and modelPsf is None: 

raise RuntimeError("makePsfMatched=True, but no model PSF was provided") 

 

if not makePsfMatched and not makeDirect: 

self.log.warn("Neither makeDirect nor makePsfMatched requested") 

 

# Warp PSF before overwriting exposure 

xyTransform = afwGeom.makeWcsPairTransform(exposure.getWcs(), wcs) 

psfWarped = WarpedPsf(exposure.getPsf(), xyTransform) 

 

if makePsfMatched and maxBBox is not None: 

# grow warped region to provide sufficient area for PSF-matching 

pixToGrow = 2 * max(self.psfMatch.kConfig.sizeCellX, 

self.psfMatch.kConfig.sizeCellY) 

# replace with copy 

maxBBox = afwGeom.Box2I(maxBBox) 

maxBBox.grow(pixToGrow) 

 

with self.timer("warp"): 

exposure = self.warper.warpExposure(wcs, exposure, maxBBox=maxBBox, destBBox=destBBox) 

exposure.setPsf(psfWarped) 

 

if makePsfMatched: 

try: 

exposurePsfMatched = self.psfMatch.run(exposure, modelPsf).psfMatchedExposure 

except Exception as e: 

exposurePsfMatched = None 

self.log.info("Cannot PSF-Match: %s" % (e)) 

 

return pipeBase.Struct( 

direct=exposure if makeDirect else None, 

psfMatched=exposurePsfMatched if makePsfMatched else None 

)