TimeInfo¶
-
class
astropy.time.
TimeInfo
(bound=False)[source]¶ Bases:
astropy.utils.data_info.MixinInfo
Container for meta information like name, description, format. This is required when the object is used as a mixin column within a table, but can be used as a general way to store meta information.
Attributes Summary
Methods Summary
__call__
(self[, option, out])Write summary information about data object to the
out
filehandle.adjust_indices
(self, index, value, col_len)Adjust info indices after column modification.
get_sortable_arrays
(self)Return a list of arrays which can be lexically sorted to represent the order of the parent column.
info_summary_stats
(dat)iter_str_vals
(self)This is a mixin-safe version of Column.iter_str_vals.
merge_cols_attributes
(cols, …)Utility method to merge and validate the attributes
attrs
for the input table columnscols
.new_like
(self, cols, length[, …])Return a new Time instance which is consistent with the input Time objects
cols
and haslength
rows.slice_indices
(self, col_slice, item, col_len)Given a sliced object, modify its indices to correctly represent the slice.
Attributes Documentation
-
attr_names
= {'description', 'dtype', 'format', 'indices', 'meta', 'name', 'parent_table', 'serialize_method', 'unit'}¶
-
attrs_from_parent
= {}¶
-
description
¶
-
dtype
¶
-
format
¶
-
indices
¶
-
mask_val
= masked¶
-
meta
¶
-
name
¶
-
parent_table
¶
-
serialize_method
¶
-
unit
¶
Methods Documentation
-
__call__
(self, option='attributes', out='')¶ Write summary information about data object to the
out
filehandle. By default this prints to standard output via sys.stdout.The
option
argument specifies what type of information to include. This can be a string, a function, or a list of strings or functions. Built-in options are:attributes
: data object attributes likedtype
andformat
stats
: basic statistics: min, mean, and max
If a function is specified then that function will be called with the data object as its single argument. The function must return an OrderedDict containing the information attributes.
If a list is provided then the information attributes will be appended for each of the options, in order.
- Parameters
- optionstr, function, list of (str or function)
Info option, defaults to ‘attributes’.
- outfile-like object, None
Output destination, defaults to sys.stdout. If None then the OrderedDict with information attributes is returned
- Returns
- infoOrderedDict if out==None else None
Examples
>>> from astropy.table import Column >>> c = Column([1, 2], unit='m', dtype='int32') >>> c.info() dtype = int32 unit = m class = Column n_bad = 0 length = 2
>>> c.info(['attributes', 'stats']) dtype = int32 unit = m class = Column mean = 1.5 std = 0.5 min = 1 max = 2 n_bad = 0 length = 2
-
adjust_indices
(self, index, value, col_len)¶ Adjust info indices after column modification.
- Parameters
- indexslice, int, list, or ndarray
Element(s) of column to modify. This parameter can be a single row number, a list of row numbers, an ndarray of row numbers, a boolean ndarray (a mask), or a column slice.
- valueint, list, or ndarray
New value(s) to insert
- col_lenint
Length of the column
-
get_sortable_arrays
(self)[source]¶ Return a list of arrays which can be lexically sorted to represent the order of the parent column.
- Returns
- arrayslist of ndarray
-
static
info_summary_attributes
(dat)¶
-
static
info_summary_stats
(dat)¶
-
iter_str_vals
(self)¶ This is a mixin-safe version of Column.iter_str_vals.
-
static
merge_cols_attributes
(cols, metadata_conflicts, name, attrs)¶ Utility method to merge and validate the attributes
attrs
for the input table columnscols
.Note that
dtype
andshape
attributes are handled specially. These should not be passed inattrs
but will always be in the returned dict of merged attributes.- Parameters
- colslist
List of input Table column objects
- metadata_conflictsstr (‘warn’|’error’|’silent’)
How to handle metadata conflicts
- namestr
Output column name
- attrslist
List of attribute names to be merged
- Returns
- attrsdict of merged attributes
-
new_like
(self, cols, length, metadata_conflicts='warn', name=None)[source]¶ Return a new Time instance which is consistent with the input Time objects
cols
and haslength
rows.This is intended for creating an empty Time instance whose elements can be set in-place for table operations like join or vstack. It checks that the input locations and attributes are consistent. This is used when a Time object is used as a mixin column in an astropy Table.
- Parameters
- colslist
List of input columns (Time objects)
- lengthint
Length of the output column object
- metadata_conflictsstr (‘warn’|’error’|’silent’)
How to handle metadata conflicts
- namestr
Output column name
- Returns
- colTime (or subclass)
Empty instance of this class consistent with
cols
-
slice_indices
(self, col_slice, item, col_len)¶ Given a sliced object, modify its indices to correctly represent the slice.
- Parameters
- col_sliceColumn or mixin
Sliced object
- itemslice, list, or ndarray
Slice used to create col_slice
- col_lenint
Length of original object
-