LSST Applications g042eb84c57+730a74494b,g04e9c324dd+8c5ae1fdc5,g134cb467dc+1f1e3e7524,g199a45376c+0ba108daf9,g1fd858c14a+fa7d31856b,g210f2d0738+f66ac109ec,g262e1987ae+83a3acc0e5,g29ae962dfc+d856a2cb1f,g2cef7863aa+aef1011c0b,g35bb328faa+8c5ae1fdc5,g3fd5ace14f+a1e0c9f713,g47891489e3+0d594cb711,g4d44eb3520+c57ec8f3ed,g4d7b6aa1c5+f66ac109ec,g53246c7159+8c5ae1fdc5,g56a1a4eaf3+fd7ad03fde,g64539dfbff+f66ac109ec,g67b6fd64d1+0d594cb711,g67fd3c3899+f66ac109ec,g6985122a63+0d594cb711,g74acd417e5+3098891321,g786e29fd12+668abc6043,g81db2e9a8d+98e2ab9f28,g87389fa792+8856018cbb,g89139ef638+0d594cb711,g8d7436a09f+80fda9ce03,g8ea07a8fe4+760ca7c3fc,g90f42f885a+033b1d468d,g97be763408+a8a29bda4b,g99822b682c+e3ec3c61f9,g9d5c6a246b+0d5dac0c3d,ga41d0fce20+9243b26dd2,gbf99507273+8c5ae1fdc5,gd7ef33dd92+0d594cb711,gdab6d2f7ff+3098891321,ge410e46f29+0d594cb711,geaed405ab2+c4bbc419c6,gf9a733ac38+8c5ae1fdc5,w.2025.38
LSST Data Management Base Package
Loading...
Searching...
No Matches
lsst.scarlet.lite.source.Source Class Reference

Public Member Functions

 __init__ (self, list[Component] components)
 
int n_components (self)
 
tuple[int, int]|None center (self)
 
tuple[int, int]|None source_center (self)
 
bool is_null (self)
 
Box bbox (self)
 
tuple bands (self)
 
Image get_model (self, bool use_flux=False)
 
 parameterize (self, Callable parameterization)
 
 __str__ (self)
 
 __repr__ (self)
 

Public Attributes

 components = components
 
Image|None flux_weighted_image = None
 
int n_components = 0
 
 is_null
 

Detailed Description

A container for components associated with the same astrophysical object

A source can have a single component, or multiple components,
and each can be contained in different bounding boxes.

Parameters
----------
components:
    The components contained in the source.

Definition at line 31 of file source.py.

Constructor & Destructor Documentation

◆ __init__()

lsst.scarlet.lite.source.Source.__init__ ( self,
list[Component] components )

Definition at line 43 of file source.py.

43 def __init__(self, components: list[Component]):
44 self.components = components
45 self.flux_weighted_image: Image | None = None
46

Member Function Documentation

◆ __repr__()

lsst.scarlet.lite.source.Source.__repr__ ( self)

Definition at line 143 of file source.py.

143 def __repr__(self):
144 return f"Source(components={repr(self.components)})>"

◆ __str__()

lsst.scarlet.lite.source.Source.__str__ ( self)

Definition at line 140 of file source.py.

140 def __str__(self):
141 return f"Source<{len(self.components)}>"
142

◆ bands()

tuple lsst.scarlet.lite.source.Source.bands ( self)
The bands in the full source model.

Definition at line 91 of file source.py.

91 def bands(self) -> tuple:
92 """The bands in the full source model."""
93 if self.is_null:
94 return ()
95 return self.components[0].bands
96

◆ bbox()

Box lsst.scarlet.lite.source.Source.bbox ( self)
The minimal bounding box to contain all of this sources components

Null sources have a bounding box with shape `(0,0,0)`

Definition at line 78 of file source.py.

78 def bbox(self) -> Box:
79 """The minimal bounding box to contain all of this sources components
80
81 Null sources have a bounding box with shape `(0,0,0)`
82 """
83 if self.n_components == 0:
84 return Box((0, 0))
85 bbox = self.components[0].bbox
86 for component in self.components[1:]:
87 bbox = bbox | component.bbox
88 return bbox
89

◆ center()

tuple[int, int] | None lsst.scarlet.lite.source.Source.center ( self)
The center of the source in the full Blend.

Definition at line 53 of file source.py.

53 def center(self) -> tuple[int, int] | None:
54 """The center of the source in the full Blend."""
55 if not self.is_null and hasattr(self.components[0], "peak"):
56 return self.components[0].peak # type: ignore
57 return None
58

◆ get_model()

Image lsst.scarlet.lite.source.Source.get_model ( self,
bool use_flux = False )
Build the model for the source

This is never called during optimization and is only used
to generate a model of the source for investigative purposes.

Parameters
----------
use_flux:
    Whether to use the re-distributed flux associated with the source
    instead of the component models.

Returns
-------
model:
    The full-color model.

Definition at line 97 of file source.py.

97 def get_model(self, use_flux: bool = False) -> Image:
98 """Build the model for the source
99
100 This is never called during optimization and is only used
101 to generate a model of the source for investigative purposes.
102
103 Parameters
104 ----------
105 use_flux:
106 Whether to use the re-distributed flux associated with the source
107 instead of the component models.
108
109 Returns
110 -------
111 model:
112 The full-color model.
113 """
114 if self.n_components == 0:
115 return 0 # type: ignore
116
117 if use_flux:
118 # Return the redistributed flux
119 # (calculated by scarlet.lite.measure.weight_sources)
120 return self.flux_weighted_image # type: ignore
121
122 model = self.components[0].get_model()
123 for component in self.components[1:]:
124 model = model + component.get_model()
125 return model
126

◆ is_null()

bool lsst.scarlet.lite.source.Source.is_null ( self)
True if the source does not have any components

Definition at line 73 of file source.py.

73 def is_null(self) -> bool:
74 """True if the source does not have any components"""
75 return self.n_components == 0
76

◆ n_components()

int lsst.scarlet.lite.source.Source.n_components ( self)
The number of components in this source

Definition at line 48 of file source.py.

48 def n_components(self) -> int:
49 """The number of components in this source"""
50 return len(self.components)
51

◆ parameterize()

lsst.scarlet.lite.source.Source.parameterize ( self,
Callable parameterization )
Convert the component parameter arrays into Parameter instances

Parameters
----------
parameterization:
    A function to use to convert parameters of a given type into
    a `Parameter` in place. It should take a single argument that
    is the `Component` or `Source` that is to be parameterized.

Definition at line 127 of file source.py.

127 def parameterize(self, parameterization: Callable):
128 """Convert the component parameter arrays into Parameter instances
129
130 Parameters
131 ----------
132 parameterization:
133 A function to use to convert parameters of a given type into
134 a `Parameter` in place. It should take a single argument that
135 is the `Component` or `Source` that is to be parameterized.
136 """
137 for component in self.components:
138 component.parameterize(parameterization)
139

◆ source_center()

tuple[int, int] | None lsst.scarlet.lite.source.Source.source_center ( self)
The center of the source in its local bounding box.

Definition at line 60 of file source.py.

60 def source_center(self) -> tuple[int, int] | None:
61 """The center of the source in its local bounding box."""
62 _center = self.center
63 _origin = self.bbox.origin
64 if _center is not None:
65 center = (
66 _center[0] - _origin[0],
67 _center[1] - _origin[1],
68 )
69 return center
70 return None
71

Member Data Documentation

◆ components

lsst.scarlet.lite.source.Source.components = components

Definition at line 44 of file source.py.

◆ flux_weighted_image

Image | None lsst.scarlet.lite.source.Source.flux_weighted_image = None

Definition at line 45 of file source.py.

◆ is_null

lsst.scarlet.lite.source.Source.is_null

Definition at line 93 of file source.py.

◆ n_components

int lsst.scarlet.lite.source.Source.n_components = 0

Definition at line 75 of file source.py.


The documentation for this class was generated from the following file: