BaseColumnView

class lsst.afw.table.BaseColumnView

Bases: _BaseColumnViewBase

Attributes Summary

schema

table

Methods Summary

extract(*patterns, **kwds)

Extract a dictionary of {<name>: <column-array>} in which the field names match the given shell-style glob pattern(s).

get(key)

Get a column view; key may be a key object or the name of a field.

getAllBits(self)

getBits([keys])

Get the bits associated with the specified keys.

getSchema(self)

getTable(self)

get_bool_array(key)

Get the value of a flag column as a boolean array; key must be a key object or the name of a field.

set(key, value)

Set a full column to an array or scalar; key may be a key object or the name of a field.

Attributes Documentation

schema
table

Methods Documentation

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 row-major ColumnView into a possibly more efficient set of contiguous NumPy arrays.

String fields are silently ignored. Support for Flag columns is deprecated; at present they are copied into full boolean arrays, but after v26 they will be silently ignored as well.

Parameters:
patternsArray of str

List of glob patterns to use to select field names.

kwdsdict

Dictionary of additional keyword arguments. May contain:

itemslist

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.

wherearray index expression

Any 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.

copybool

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.

regexstr or re pattern

A 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.

substr

A replacement string (see re.MatchObject.expand) used to set the dictionary keys of any fields matched by regex.

orderedbool

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.

Returns:
ddict

Dictionary of extracted name-column array sets.

Raises:
ValueError

Raised if a list of items is supplied with additional keywords.

get(key)

Get a column view; key may be a key object or the name of a field.

getAllBits(self: lsst.afw.table._BaseColumnViewBase) lsst.afw.table.BitsColumn
getBits(keys=None)

Get the bits associated with the specified keys.

Parameters:
keystr

Key to retrieve. Unlike the C++ version, each key may be a field name or a key, and if keys is None then all bits are returned.

Returns:
bitsint

Integer array of the requested bitmask.

getSchema(self: lsst.afw.table._BaseColumnViewBase) lsst.afw.table.Schema
getTable(self: lsst.afw.table.BaseColumnView) lsst.afw.table.BaseTable
get_bool_array(key)

Get the value of a flag column as a boolean array; key must be a key object or the name of a field.

Parameters:
keylsst.afw.table.KeyFlag

Flag column to search for.

Returns:
valuelist of bool

Array of booleans corresponding to the flag.

Raises:
TypeError

Raised if the key is not a KeyFlag.

Deprecated since version v26: Catalog.__getitem__ now provides better support for accessing Flag/bool columns. Will be removed after v26.

set(key, value)

Set a full column to an array or scalar; key may be a key object or the name of a field.