AGASC Catalog Description and History

• THE AXAF Guide and Acquisition Star Catalog V1.8
  • Introduction
  • Use of the AGASC 1.8 in Chandra Operations
  • Organization of the FITS Data Files
  • Summary of the AGASC1.8 Format
  • History of the AGASC Version 1.8
  • Acknowledgements

• THE AXAF Guide and Acquisition Star Catalog V1.7

Getting started

The most common usage of the agasc package is getting the AGASC catalog data for stars near a location on the sky or by AGASC ID.

The three main functions are:

• get_agasc_cone(): Get stars within a radius of RA, Dec

• get_star(): Get information for one star by AGASC ID

• get_stars(): Get information for a list of stars by AGASC ID

AGASC catalog order

Catalogs with version 1.7 or before are ordered by increasing Declination. Cone search is done by selecting a band of Declination and then searching for stars within the required spatial cone.

Starting with version 1.8, catalogs are ordered by HEALpix index. HEALpix is a library that provides a fast way to uniquely tile a sphere with tiles of uniform area, providing a map between any point on the sphere and the index number. The HEALpix index is a pixel number between 0 and 12*NSIDE**2-1, where NSIDE is the HEALpix resolution parameter. For AGASC 1.8, NSIDE=64.

HEALpix-ordered catalogs include a healpix_index table that provides the row range for each HEALpix index. Cone search is done by finding the HEALpix pixels that overlap the required spatial cone and extracting the stars from the catalog that are in those pixels. This strategy is faster than the Declination-ordered catalog search and requires less memory.

Note that for testing, some version 1.7 catalogs are available in HEALpix order. These are denoted with a _healpix suffix in the filename.

agasc package API documentation

• API documentation
  • TABLE_DTYPE
  • TableOrder
  • add_pmcorr_columns()
  • get_agasc_cone()
  • get_agasc_filename()
  • get_star()
  • get_stars()
  • read_h5_table()
  • set_supplement_enabled()
  • sphere_dist()
  • write_agasc()
  • default_agasc_dir()
  • default_agasc_file()
  • add_bad_star()
  • get_supplement_table()
  • save_version()
  • update_mags_table()
  • update_obs_table()

Topics For Maintainers

• Maintaining the AGASC Supplement
  • Guidelines and Procedure to Update the Supplement
  • Details
  • Scripts
  • Data products
• Magnitude Supplement API
  • MagStatsException
  • add_obs_info()
  • calc_obs_stats()
  • get_agasc_id_stats()
  • get_droop_systematic_shift()
  • get_mag_from_img()
  • get_obs_stats()
  • get_responsivity()
  • get_star_position()
  • get_telemetry()
  • get_telemetry_by_agasc_id()
  • rolling_mean()
  • do()
  • get_agasc_id_stats()
  • get_agasc_id_stats_pool()
  • level0_archive_time_range()
  • update_mag_stats()
  • update_supplement()