PeakCatalog¶
- class lsst.afw.detection.PeakCatalog¶
Bases:
pybind11_object
Attributes Summary
a column view of the catalog
Methods Summary
addNew
()append
(record)asAstropy
([cls, copy, unviewable])Return an astropy.table.Table (or subclass thereof) view into this catalog.
between
(*args, **kwargs)Overloaded function.
capacity
(self)cast
(type_[, deep])Return a copy of the catalog with the given type.
clear
()copy
([deep])Copy a catalog (default is not a deep copy).
equal_range
(*args, **kwargs)Overloaded function.
extend
(iterable[, deep, mapper])Append all records in the given iterable to the catalog.
extract
(*patterns, **kwds)Extract a dictionary of {<name>: <column-array>} in which the field names match the given shell-style glob pattern(s).
find
(*args, **kwargs)Overloaded function.
getSchema
(self)getTable
(self)insert
(key, value)isContiguous
(self)isSorted
(*args, **kwargs)Overloaded function.
lower_bound
(*args, **kwargs)Overloaded function.
readFits
(*args, **kwargs)Overloaded function.
reserve
(self, arg0)resize
(self, arg0)set
(self, arg0, arg1)sort
(*args, **kwargs)Overloaded function.
subset
(*args, **kwargs)Overloaded function.
upper_bound
(*args, **kwargs)Overloaded function.
writeFits
(*args, **kwargs)Overloaded function.
Attributes Documentation
- columns¶
a column view of the catalog
- dtype = 'Peak'¶
- schema¶
- table¶
Methods Documentation
- addNew()¶
- append(record)¶
- asAstropy(cls=None, copy=False, unviewable='copy')¶
Return an astropy.table.Table (or subclass thereof) view into this catalog.
- Parameters:
- cls
Table subclass to use;
None
impliesastropy.table.Table
itself. Useastropy.table.QTable
to get Quantity columns.- copybool, optional
If
True
, copy data from the LSST catalog to the astropy table. Not copying is usually faster, but can keep memory from being freed if columns are later removed from the Astropy view.- unviewable
str
, optional One of the following options (which is ignored if copy=`True` ), indicating how to handle field types (
str
andFlag
) for which views cannot be constructed:‘copy’ (default): copy only the unviewable fields.
‘raise’: raise ValueError if unviewable fields are present.
‘skip’: do not include unviewable fields in the Astropy Table.
- Returns:
- cls
astropy.table.Table
Astropy view into the catalog.
- cls
- Raises:
- ValueError
Raised if the
unviewable
option is not a known value, or if the option is ‘raise’ and an uncopyable field is found.
- between(*args, **kwargs)¶
Overloaded function.
between(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: int, arg2: lsst.afw.table.KeyI) -> slice
between(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: int, arg2: lsst.afw.table.KeyL) -> slice
between(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: float, arg2: lsst.afw.table.KeyF) -> slice
between(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: float, arg2: lsst.afw.table.KeyD) -> slice
between(self: lsst.afw.detection.PeakCatalog, arg0: lsst.geom.Angle, arg1: lsst.geom.Angle, arg2: lsst.afw.table.KeyAngle) -> slice
- capacity(self: lsst.afw.detection.PeakCatalog) int ¶
- cast(type_, deep=False)¶
Return a copy of the catalog with the given type.
- clear()¶
- copy(deep=False)¶
Copy a catalog (default is not a deep copy).
- equal_range(*args, **kwargs)¶
Overloaded function.
equal_range(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyI) -> slice
equal_range(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyL) -> slice
equal_range(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyF) -> slice
equal_range(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyD) -> slice
equal_range(self: lsst.afw.detection.PeakCatalog, arg0: lsst.geom.Angle, arg1: lsst.afw.table.KeyAngle) -> slice
- extend(iterable, deep=False, mapper=None)¶
Append all records in the given iterable to the catalog.
- extract(*patterns, **kwds)¶
Extract a dictionary of {<name>: <column-array>} in which the field names match the given shell-style glob pattern(s).
Any number of glob patterns may be passed (including none); the result will be the union of all the result of each glob considered separately.
Note that extract(“*”, copy=True) provides an easy way to transform a catalog into a set of writeable contiguous NumPy arrays.
This routines unpacks
Flag
columns into full boolean arrays. String fields are silently ignored.- Parameters:
- patternsArray of
str
List of glob patterns to use to select field names.
- kwds
dict
Dictionary of additional keyword arguments. May contain:
items
list
The result of a call to self.schema.extract(); this will be used instead of doing any new matching, and allows the pattern matching to be reused to extract values from multiple records. This keyword is incompatible with any position arguments and the regex, sub, and ordered keyword arguments.
where
array index expressionAny expression that can be passed as indices to a NumPy array, including slices, boolean arrays, and index arrays, that will be used to index each column array. This is applied before arrays are copied when copy is True, so if the indexing results in an implicit copy no unnecessary second copy is performed.
copy
bool
If True, the returned arrays will be contiguous copies rather than strided views into the catalog. This ensures that the lifetime of the catalog is not tied to the lifetime of a particular catalog, and it also may improve the performance if the array is used repeatedly. Default is False. Copies are always made if the catalog is noncontiguous, but if
copy=False
these set as read-only to ensure code does not assume they are views that could modify the original catalog.regex
str
orre
patternA regular expression to be used in addition to any glob patterns passed as positional arguments. Note that this will be compared with re.match, not re.search.
sub
str
A replacement string (see re.MatchObject.expand) used to set the dictionary keys of any fields matched by regex.
ordered
bool
If True, a collections.OrderedDict will be returned instead of a standard dict, with the order corresponding to the definition order of the Schema. Default is False.
- patternsArray of
- Returns:
- d
dict
Dictionary of extracted name-column array sets.
- d
- Raises:
- ValueError
Raised if a list of
items
is supplied with additional keywords.
- find(*args, **kwargs)¶
Overloaded function.
find(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyI) -> lsst.afw.detection.PeakRecord
find(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyL) -> lsst.afw.detection.PeakRecord
find(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyF) -> lsst.afw.detection.PeakRecord
find(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyD) -> lsst.afw.detection.PeakRecord
find(self: lsst.afw.detection.PeakCatalog, arg0: lsst.geom.Angle, arg1: lsst.afw.table.KeyAngle) -> lsst.afw.detection.PeakRecord
- getColumnView()¶
- getSchema(self: lsst.afw.detection.PeakCatalog) lsst.afw.table.Schema ¶
- getTable(self: lsst.afw.detection.PeakCatalog) lsst.afw.detection.PeakTable ¶
- insert(key, value)¶
- isContiguous(self: lsst.afw.detection.PeakCatalog) bool ¶
- isSorted(*args, **kwargs)¶
Overloaded function.
isSorted(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyI) -> bool
isSorted(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyL) -> bool
isSorted(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyF) -> bool
isSorted(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyD) -> bool
isSorted(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyAngle) -> bool
- lower_bound(*args, **kwargs)¶
Overloaded function.
lower_bound(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyI) -> int
lower_bound(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyL) -> int
lower_bound(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyF) -> int
lower_bound(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyD) -> int
lower_bound(self: lsst.afw.detection.PeakCatalog, arg0: lsst.geom.Angle, arg1: lsst.afw.table.KeyAngle) -> int
- static readFits(*args, **kwargs)¶
Overloaded function.
readFits(filename: str, hdu: int = -2147483648, flags: int = 0) -> lsst.afw.detection.PeakCatalog
readFits(manager: lsst.afw.fits._fits.MemFileManager, hdu: int = -2147483648, flags: int = 0) -> lsst.afw.detection.PeakCatalog
- reserve(self: lsst.afw.detection.PeakCatalog, arg0: int) None ¶
- resize(self: lsst.afw.detection.PeakCatalog, arg0: int) None ¶
- set(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.detection.PeakRecord) None ¶
- sort(*args, **kwargs)¶
Overloaded function.
sort(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyI) -> None
sort(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyL) -> None
sort(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyF) -> None
sort(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyD) -> None
sort(self: lsst.afw.detection.PeakCatalog, arg0: lsst.afw.table.KeyAngle) -> None
- subset(*args, **kwargs)¶
Overloaded function.
subset(self: lsst.afw.detection.PeakCatalog, arg0: numpy.ndarray) -> lsst.afw.detection.PeakCatalog
subset(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: int, arg2: int) -> lsst.afw.detection.PeakCatalog
- upper_bound(*args, **kwargs)¶
Overloaded function.
upper_bound(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyI) -> int
upper_bound(self: lsst.afw.detection.PeakCatalog, arg0: int, arg1: lsst.afw.table.KeyL) -> int
upper_bound(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyF) -> int
upper_bound(self: lsst.afw.detection.PeakCatalog, arg0: float, arg1: lsst.afw.table.KeyD) -> int
upper_bound(self: lsst.afw.detection.PeakCatalog, arg0: lsst.geom.Angle, arg1: lsst.afw.table.KeyAngle) -> int
- writeFits(*args, **kwargs)¶
Overloaded function.
writeFits(self: lsst.afw.detection.PeakCatalog, filename: str, mode: str = ‘w’, flags: int = 0) -> None
writeFits(self: lsst.afw.detection.PeakCatalog, manager: lsst.afw.fits._fits.MemFileManager, mode: str = ‘w’, flags: int = 0) -> None