astromodule.table.guess_coords_columns#

guess_coords_columns(df: DataFrame, ra: str | None = None, dec: str | None = None) Tuple[str, str][source]#

Receives a pandas dataframe and try to guess the columns names used to identify the RA and DEC coordinates.

Parameters:
dfpd.DataFrame

A pandas dataframe

rastr | None, optional

The column name used to name the RA column. If a string is passed, this function will skip the RA guessing and will return the value of RA passed by this parameter. If the value is set to None, this function will guess the RA column name using a pre-defined regular expression and will return the value of the first match found following the sequence of the columns.

decstr | None, optional

The column name used to name the DEC column. If a string is passed, this function will skip the DEC guessing and will return the value of DEC passed by this parameter. If the value is set to None, this function will guess the DEC column name using a pre-defined regular expression and will return the value of the first match found following the sequence of the columns.

Returns:
Tuple[str, str]

A tuple of RA and DEC columns guessed.

Raises:
ValueError

Raises a error if the RA or DEC columns cannot be found.