Tycho2.query_catalogue¶
- Tycho2.query_catalogue(ids=None, min_ra=0, max_ra=360, min_dec=- 90, max_dec=90, min_mag=- 4, max_mag=20, search_center=None, search_radius=None, new_epoch=None)[source]¶
This method queries stars from the catalogue that meet specified constraints and returns them as a DataFrame with columns of
GIANT_COLUMNS
.Stars can either be queried by ID directly or by right ascension/declination/magnitude. You cannot filter using both with this method. If
apply_proper_motion
isTrue
then this will shift the stars to the new epoch input by the user (new_epoch
) using proper motion.- Parameters
ids (Optional[Union[Sequence, numpy.ndarray]]) – A sequence of star ids to retrieve from the catalogue. The ids are given by zone, rnz and should be input as an iterable that yields tuples (therefore if you have a dataframe you should do
df.itertuples(false)
min_ra (numbers.Real) – The minimum ra bound to query stars from in degrees
max_ra (numbers.Real) – The maximum ra bound to query stars from in degrees
min_dec (numbers.Real) – The minimum declination to query stars from in degrees
max_dec (numbers.Real) – The maximum declination to query stars from in degrees
min_mag (numbers.Real) – The minimum magnitude to query stars from. Recall that magnitude is inverse (so lower magnitude is a dimmer star)
max_mag (numbers.Real) – The maximum magnitude to query stars from. Recall that magnitude is inverse (so higher magnitude is a dimmer star)
search_center (Optional[Union[Sequence, numpy.ndarray]]) – The center of a search cone as a ra/dec pair.
search_radius (Optional[numbers.Real]) – The radius about the center of the search cone
new_epoch (Optional[Union[datetime.datetime, numbers.Real]]) – The epoch to translate the stars to using proper motion if
apply_proper_motion
is turned on
- Returns
A Pandas dataframe with columns
GIANT_COLUMNS
.- Return type
pandas.core.frame.DataFrame