empyrean.Ephemeris¶

class Ephemeris(table, **kwargs)[source]

Bases: Table

Predicted astrometric ephemeris for observed objects.

Each row is one (orbit, observer, epoch) combination with topocentric spherical coordinates (with covariance), aberrated Cartesian state, and ancillary data. All angles are in degrees.

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

`aberrated_state`	A column which represents an embedded quivr table.
`azimuth`	A column for storing 64-bit floating point numbers.
`coordinates`	A column which represents an embedded quivr table.
`elongation`	A column for storing 64-bit floating point numbers.
`heliocentric_distance`	A column for storing 64-bit floating point numbers.
`hour_angle`	A column for storing 64-bit floating point numbers.
`light_time`	A column for storing 64-bit floating point numbers.
`lunar_elongation`	A column for storing 64-bit floating point numbers.
`mag`	A column for storing 64-bit floating point numbers.
`mag_sigma`	A column for storing 64-bit floating point numbers.
`object_id`	A column for storing large strings (over 2³¹ bytes long).
`obs_code`	A column for storing large strings (over 2³¹ bytes long).
`orbit_id`	A column for storing large strings (over 2³¹ bytes long).
`phase_angle`	A column for storing 64-bit floating point numbers.
`position_angle`	A column for storing 64-bit floating point numbers.
`schema`
`sky_rate`	A column for storing 64-bit floating point numbers.
`zenith_angle`	A column for storing 64-bit floating point numbers.
`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.

obs_code: 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.

aberrated_state

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.

light_time: A column for storing 64-bit floating point numbers.

phase_angle: A column for storing 64-bit floating point numbers.

elongation: A column for storing 64-bit floating point numbers.

heliocentric_distance: A column for storing 64-bit floating point numbers.

mag: A column for storing 64-bit floating point numbers.

mag_sigma: A column for storing 64-bit floating point numbers.

zenith_angle: A column for storing 64-bit floating point numbers.

azimuth: A column for storing 64-bit floating point numbers.

hour_angle: A column for storing 64-bit floating point numbers.

lunar_elongation: A column for storing 64-bit floating point numbers.

position_angle: A column for storing 64-bit floating point numbers.

sky_rate: A column for storing 64-bit floating point numbers.

schema: ClassVar[Schema] = orbit_id: large_string not null object_id: large_string obs_code: large_string not null 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 aberrated_state: struct<epoch: double, x: double, y: double, z: double, vx: double, vy: double, vz: double, covarianc (... 410 chars omitted) child 0, epoch: double child 1, x: double child 2, y: double child 3, z: double child 4, vx: double child 5, vy: double child 6, vz: double child 7, covariance: struct<cov_x_x: double, cov_x_y: double, cov_y_y: double, cov_x_z: double, cov_y_z: double, cov_z_z: (... 284 chars omitted) child 0, cov_x_x: double child 1, cov_x_y: double child 2, cov_y_y: double child 3, cov_x_z: double child 4, cov_y_z: double child 5, cov_z_z: double child 6, cov_x_vx: double child 7, cov_y_vx: double child 8, cov_z_vx: double child 9, cov_vx_vx: double child 10, cov_x_vy: double child 11, cov_y_vy: double child 12, cov_z_vy: double child 13, cov_vx_vy: double child 14, cov_vy_vy: double child 15, cov_x_vz: double child 16, cov_y_vz: double child 17, cov_z_vz: double child 18, cov_vx_vz: double child 19, cov_vy_vz: double child 20, cov_vz_vz: double child 8, origin: large_string light_time: double phase_angle: double elongation: double heliocentric_distance: double mag: double mag_sigma: double zenith_angle: double azimuth: double hour_angle: double lunar_elongation: double position_angle: double sky_rate: double