USNOGNC.get_stars_directions_and_pixels

giant.catalogs.usnognc:

USNOGNC.get_stars_directions_and_pixels(image, model, max_mag, min_mag=-4, image_number=0)

This function produces the visible stars in an image, including their records, their inertial unit vectors, and their pixel locations.

The function queries the catalog using information contained in the OpNavImage input and the min/max mag inputs. Important attributes of the OpNavImage are observation_date, rotation_inertial_to_camera, temperature, position, and velocity.

The function corrects the catalog unit vectors for parallax and for stellar aberration.

Parameters:

  • image (OpNavImage) – The OpNavImage used to specify metadata about the camera

  • model (CameraModel) – The camera model used to project unit vectors onto the image

  • max_mag (float) – the maximum magnitude star to query from the catalog

  • min_mag (float) – the minimum magnitude star to query from the catalog

  • image_number (int) – The number of the image being processed

  • self (Catalog)

Returns:

A tuple containing the star records as a pandas DataFrame, the star inertial unit vectors (corrected for aberration and parallax), and the pixels the stars project to

Return type:

tuple[DataFrame, ndarray, ndarray, ndarray]