empyrean.SphericalOrbits

class SphericalOrbits(table, **kwargs)

Bases: Table

Orbits in spherical coordinates.

Methods

__init__(table, **kwargs)
apply_mask(mask)	Return a new table with rows filtered to match a boolean mask.
as_column([nullable, metadata])	Embed the Table as a column in another Table.
attributes()	Return a dictionary of the table's attributes.
chunk_counts()	Returns the number of discrete memory chunks that make up each of the Table's underlying arrays.
column(column_name)	Returns the column with the given name as a raw pyarrow ChunkedArray.
drop_duplicates([subset, keep])	Drop duplicate rows from a ~quivr.Table.
empty(**kwargs)	Create an empty instance of the table.
flattened_table()	Completely flatten the Table's underlying Arrow table, taking into account any nested structure, and return the data table itself.
fragmented()	Returns true if the Table has any fragmented arrays.
from_csv(input_file[, validate])	Read a table from a CSV file.
from_dataframe(df[, validate])	Load a DataFrame into the Table.
from_feather(path[, validate])	Read a table from a Feather file.
from_flat_dataframe(df[, validate])	Load a flattened DataFrame into the Table.
from_kwargs([validate, permit_nulls])	Create a Table instance from keyword arguments.
from_parquet(path[, memory_map, ...])	Read a table from a Parquet file.
from_pyarrow(table[, validate, permit_nulls])	Create a new table from a pyarrow Table.
invalid_mask()	Return a boolean mask indicating which rows are invalid.
is_valid()	Validate the table against the schema.
null_mask()	Return a boolean mask indicating which rows of the entire table are null.
nulls(size, **kwargs)	Create a table with nulls.
select(column_name, value)	Select from the table by exact match, returning a new Table which only contains rows for which the value in column_name equals value.
select_by_object_id(object_ids)	Return rows whose object_id is in object_ids.
select_by_orbit_id(orbit_ids)	Return rows whose orbit_id is in orbit_ids.
separate_invalid()	Separates rows that have invalid data from those that have valid data.
set_column(name, data)	Return a copy of the table with a particular column replaced with new data.
sort_by(by)	Sorts the Table by the given column name (or multiple columns).
take(row_indices)	Return a new Table with only the rows at the given indices.
to_csv(path[, attribute_columns])	Write the table to a CSV file.
to_dataframe([flatten, attr_handling])	Returns self as a pandas DataFrame.
to_feather(path, **kwargs)	Write the table to a Feather file.
to_parquet(path, **kwargs)	Write the table to a Parquet file.
to_structarray()	Returns self as a StructArray.
unique_indices([subset, keep])	Get the indices of the first or last occurrence of each unique row in the table.
validate()	Validate the table against the schema, raising an exception if invalid.
where(expr)	Return a new table with rows filtered to match an expression.
with_table(table)

Attributes

coordinates	A column which represents an embedded quivr table.
non_grav	A column which represents an embedded quivr table.
object_id	A column for storing large strings (over 231 bytes long).
orbit_id	A column for storing large strings (over 231 bytes long).
photometric	A column which represents an embedded quivr table.
schema
table

Parameters:

• table (Table)

• kwargs (AttributeValueType)

orbit_id

A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

object_id

A column for storing large strings (over 2³¹ bytes long). Large string data is stored in variable-length chunks.

coordinates

A column which represents an embedded quivr table.

Parameters:

• table_type – The type of the table to embed.

• nullable – Whether the column can contain null values.

• metadata – A dictionary of metadata to attach to the column.

non_grav

A column which represents an embedded quivr table.

Parameters:

• table_type – The type of the table to embed.

• nullable – Whether the column can contain null values.

• metadata – A dictionary of metadata to attach to the column.

photometric

A column which represents an embedded quivr table.

Parameters:

• table_type – The type of the table to embed.

• nullable – Whether the column can contain null values.

• metadata – A dictionary of metadata to attach to the column.

select_by_orbit_id(orbit_ids)

Return rows whose orbit_id is in orbit_ids.

Return type:

SphericalOrbits

Parameters:

orbit_ids (Iterable[str])

select_by_object_id(object_ids)

Return rows whose object_id is in object_ids.

Return type:

SphericalOrbits

Parameters:

object_ids (Iterable[str])

schema: ClassVar[Schema] = orbit_id: large_string not null object_id: large_string coordinates: struct<epoch: double, rho: double, lon: double, lat: double, vrho: double, vlon: double, vlat: doubl (... 506 chars omitted)   child 0, epoch: double   child 1, rho: double   child 2, lon: double   child 3, lat: double   child 4, vrho: double   child 5, vlon: double   child 6, vlat: double   child 7, covariance: struct<cov_rho_rho: double, cov_rho_lon: double, cov_lon_lon: double, cov_rho_lat: double, cov_lon_l (... 368 chars omitted)       child 0, cov_rho_rho: double       child 1, cov_rho_lon: double       child 2, cov_lon_lon: double       child 3, cov_rho_lat: double       child 4, cov_lon_lat: double       child 5, cov_lat_lat: double       child 6, cov_rho_vrho: double       child 7, cov_lon_vrho: double       child 8, cov_lat_vrho: double       child 9, cov_vrho_vrho: double       child 10, cov_rho_vlon: double       child 11, cov_lon_vlon: double       child 12, cov_lat_vlon: double       child 13, cov_vrho_vlon: double       child 14, cov_vlon_vlon: double       child 15, cov_rho_vlat: double       child 16, cov_lon_vlat: double       child 17, cov_lat_vlat: double       child 18, cov_vrho_vlat: double       child 19, cov_vlon_vlat: double       child 20, cov_vlat_vlat: double   child 8, origin: large_string non_grav: struct<a1: double, a2: double, a3: double, model: large_string, alpha: double, r0: double, m: double (... 47 chars omitted)   child 0, a1: double   child 1, a2: double   child 2, a3: double   child 3, model: large_string   child 4, alpha: double   child 5, r0: double   child 6, m: double   child 7, n: double   child 8, k: double   child 9, cr: double   child 10, dt: double photometric: struct<model: large_string, h: double, g: double, g1: double, g2: double, g12: double>   child 0, model: large_string   child 1, h: double   child 2, g: double   child 3, g1: double   child 4, g2: double   child 5, g12: double