practical_astronomy.pa_coordinate Namespace Reference

Functions
	angle_to_decimal_degrees (degrees, minutes, seconds)
	decimal_degrees_to_angle (decimalDegrees)
	right_ascension_to_hour_angle (ra_hours, ra_minutes, ra_seconds, lct_hours, lct_minutes, lct_seconds, is_daylight_saving, zone_correction, local_day, local_month, local_year, geographical_longitude)
	hour_angle_to_right_ascension (hour_angle_hours, hour_angle_minutes, hour_angle_seconds, lct_hours, lct_minutes, lct_seconds, is_daylight_saving, zone_correction, local_day, local_month, local_year, geographical_longitude)
	equatorial_coordinates_to_horizon_coordinates (hour_angle_hours, hour_angle_minutes, hour_angle_seconds, declination_degrees, declination_minutes, declination_seconds, geographical_latitude)
	horizon_coordinates_to_equatorial_coordinates (azimuth_degrees, azimuth_minutes, azimuth_seconds, altitude_degrees, altitude_minutes, altitude_seconds, geographical_latitude)
	mean_obliquity_of_the_ecliptic (greenwich_day, greenwich_month, greenwich_year)
	ecliptic_coordinate_to_equatorial_coordinate (ecliptic_longitude_degrees, ecliptic_longitude_minutes, ecliptic_longitude_seconds, ecliptic_latitude_degrees, ecliptic_latitude_minutes, ecliptic_latitude_seconds, greenwich_day, greenwich_month, greenwich_year)
	equatorial_coordinate_to_ecliptic_coordinate (ra_hours, ra_minutes, ra_seconds, dec_degrees, dec_minutes, dec_seconds, gw_day, gw_month, gw_year)
	equatorial_coordinate_to_galactic_coordinate (ra_hours, ra_minutes, ra_seconds, dec_degrees, dec_minutes, dec_seconds)
	galactic_coordinate_to_equatorial_coordinate (gal_long_deg, gal_long_min, gal_long_sec, gal_lat_deg, gal_lat_min, gal_lat_sec)
	angle_between_two_objects (ra_long_1_hour_deg, ra_long_1_min, ra_long_1_sec, dec_lat_1_deg, dec_lat_1_min, dec_lat_1_sec, ra_long_2_hour_deg, ra_long_2_min, ra_long_2_sec, dec_lat_2_deg, dec_lat_2_min, dec_lat_2_sec, hour_or_degree)
	rising_and_setting (ra_hours, ra_minutes, ra_seconds, dec_deg, dec_min, dec_sec, gw_date_day, gw_date_month, gw_date_year, geog_long_deg, geog_lat_deg, vert_shift_deg)
	correct_for_precession (ra_hour, ra_minutes, ra_seconds, dec_deg, dec_minutes, dec_seconds, epoch1_day, epoch1_month, epoch1_year, epoch2_day, epoch2_month, epoch2_year)
	nutation_in_ecliptic_longitude_and_obliquity (greenwich_day, greenwich_month, greenwich_year)
	correct_for_aberration (ut_hour, ut_minutes, ut_seconds, gw_day, gw_month, gw_year, true_ecl_long_deg, true_ecl_long_min, true_ecl_long_sec, true_ecl_lat_deg, true_ecl_lat_min, true_ecl_lat_sec)
	atmospheric_refraction (true_ra_hour, true_ra_min, true_ra_sec, true_dec_deg, true_dec_min, true_dec_sec, coordinate_type, geog_long_deg, geog_lat_deg, daylight_saving_hours, timezone_hours, lcd_day, lcd_month, lcd_year, lct_hour, lct_min, lct_sec, atmospheric_pressure_mbar, atmospheric_temperature_celsius)
	corrections_for_geocentric_parallax (ra_hour, ra_min, ra_sec, dec_deg, dec_min, dec_sec, coordinate_type, equatorial_hor_parallax_deg, geog_long_deg, geog_lat_deg, height_m, daylight_saving, timezone_hours, lcd_day, lcd_month, lcd_year, lct_hour, lct_min, lct_sec)
	heliographic_coordinates (helio_position_angle_deg, helio_displacement_arcmin, gwdate_day, gwdate_month, gwdate_year)
	carrington_rotation_number (gwdate_day, gwdate_month, gwdate_year)
	selenographic_coordinates_1 (gwdate_day, gwdate_month, gwdate_year)
	selenographic_coordinates_2 (gwdate_day, gwdate_month, gwdate_year)

Function Documentation

angle_between_two_objects()

angle_between_two_objects	(		ra_long_1_hour_deg,
			ra_long_1_min,
			ra_long_1_sec,
			dec_lat_1_deg,
			dec_lat_1_min,
			dec_lat_1_sec,
			ra_long_2_hour_deg,
			ra_long_2_min,
			ra_long_2_sec,
			dec_lat_2_deg,
			dec_lat_2_min,
			dec_lat_2_sec,
			hour_or_degree
	)

 Calculate the angle between two celestial objects 

angle_to_decimal_degrees()

angle_to_decimal_degrees	(		degrees,
			minutes,
			seconds
	)

 Convert an Angle (degrees, minutes, and seconds) to Decimal Degrees 

atmospheric_refraction()

atmospheric_refraction	(		true_ra_hour,
			true_ra_min,
			true_ra_sec,
			true_dec_deg,
			true_dec_min,
			true_dec_sec,
			coordinate_type,
			geog_long_deg,
			geog_lat_deg,
			daylight_saving_hours,
			timezone_hours,
			lcd_day,
			lcd_month,
			lcd_year,
			lct_hour,
			lct_min,
			lct_sec,
			atmospheric_pressure_mbar,
			atmospheric_temperature_celsius
	)

    Calculate corrected RA/Dec, accounting for atmospheric refraction.

    NOTE: Valid values for coordinate_type are "TRUE" and "APPARENT".

    Returns:
        corrected RA hours,minutes,seconds
        corrected Declination degrees,minutes,seconds

carrington_rotation_number()

carrington_rotation_number	(		gwdate_day,
			gwdate_month,
			gwdate_year
	)

    Calculate carrington rotation number for a Greenwich date

    Returns:
            carrington rotation number

correct_for_aberration()

correct_for_aberration	(		ut_hour,
			ut_minutes,
			ut_seconds,
			gw_day,
			gw_month,
			gw_year,
			true_ecl_long_deg,
			true_ecl_long_min,
			true_ecl_long_sec,
			true_ecl_lat_deg,
			true_ecl_lat_min,
			true_ecl_lat_sec
	)

    Correct ecliptic coordinates for the effects of aberration.

    Returns:
        apparent ecliptic longitude (degrees, minutes, seconds)
        apparent ecliptic latitude (degrees, minutes, seconds)

correct_for_precession()

correct_for_precession	(		ra_hour,
			ra_minutes,
			ra_seconds,
			dec_deg,
			dec_minutes,
			dec_seconds,
			epoch1_day,
			epoch1_month,
			epoch1_year,
			epoch2_day,
			epoch2_month,
			epoch2_year
	)

    Calculate precession (corrected coordinates between two epochs)

    Returns:
        corrected RA hour
        corrected RA minutes
        corrected RA seconds
        corrected Declination degrees
        corrected Declination minutes
        corrected Declination seconds

corrections_for_geocentric_parallax()

corrections_for_geocentric_parallax	(		ra_hour,
			ra_min,
			ra_sec,
			dec_deg,
			dec_min,
			dec_sec,
			coordinate_type,
			equatorial_hor_parallax_deg,
			geog_long_deg,
			geog_lat_deg,
			height_m,
			daylight_saving,
			timezone_hours,
			lcd_day,
			lcd_month,
			lcd_year,
			lct_hour,
			lct_min,
			lct_sec
	)

    Calculate corrected RA/Dec, accounting for geocentric parallax.

    NOTE: Valid values for coordinate_type are "TRUE" and "APPARENT".

    Returns:
        corrected RA hours,minutes,seconds
        corrected Declination degrees,minutes,seconds

decimal_degrees_to_angle()

decimal_degrees_to_angle

(

decimalDegrees

)

    Convert Decimal Degrees to an Angle (degrees, minutes, and seconds)
    
    Returns:
        degrees, minutes, seconds

ecliptic_coordinate_to_equatorial_coordinate()

ecliptic_coordinate_to_equatorial_coordinate	(		ecliptic_longitude_degrees,
			ecliptic_longitude_minutes,
			ecliptic_longitude_seconds,
			ecliptic_latitude_degrees,
			ecliptic_latitude_minutes,
			ecliptic_latitude_seconds,
			greenwich_day,
			greenwich_month,
			greenwich_year
	)

 Convert Ecliptic Coordinates to Equatorial Coordinates 

equatorial_coordinate_to_ecliptic_coordinate()

equatorial_coordinate_to_ecliptic_coordinate	(		ra_hours,
			ra_minutes,
			ra_seconds,
			dec_degrees,
			dec_minutes,
			dec_seconds,
			gw_day,
			gw_month,
			gw_year
	)

 Convert Equatorial Coordinates to Ecliptic Coordinates 

equatorial_coordinate_to_galactic_coordinate()

equatorial_coordinate_to_galactic_coordinate	(		ra_hours,
			ra_minutes,
			ra_seconds,
			dec_degrees,
			dec_minutes,
			dec_seconds
	)

 Convert Equatorial Coordinates to Galactic Coordinates 

equatorial_coordinates_to_horizon_coordinates()

equatorial_coordinates_to_horizon_coordinates	(		hour_angle_hours,
			hour_angle_minutes,
			hour_angle_seconds,
			declination_degrees,
			declination_minutes,
			declination_seconds,
			geographical_latitude
	)

 Convert Equatorial Coordinates to Horizon Coordinates 

galactic_coordinate_to_equatorial_coordinate()

galactic_coordinate_to_equatorial_coordinate	(		gal_long_deg,
			gal_long_min,
			gal_long_sec,
			gal_lat_deg,
			gal_lat_min,
			gal_lat_sec
	)

 Convert Galactic Coordinates to Equatorial Coordinates 

heliographic_coordinates()

heliographic_coordinates	(		helio_position_angle_deg,
			helio_displacement_arcmin,
			gwdate_day,
			gwdate_month,
			gwdate_year
	)

    Calculate heliographic coordinates for a given Greenwich date, with a given heliographic position angle and heliographic displacement in arc minutes.

    Returns:
        heliographic longitude and heliographic latitude, in degrees

horizon_coordinates_to_equatorial_coordinates()

horizon_coordinates_to_equatorial_coordinates	(		azimuth_degrees,
			azimuth_minutes,
			azimuth_seconds,
			altitude_degrees,
			altitude_minutes,
			altitude_seconds,
			geographical_latitude
	)

 Convert Horizon Coordinates to Equatorial Coordinates 

hour_angle_to_right_ascension()

hour_angle_to_right_ascension	(		hour_angle_hours,
			hour_angle_minutes,
			hour_angle_seconds,
			lct_hours,
			lct_minutes,
			lct_seconds,
			is_daylight_saving,
			zone_correction,
			local_day,
			local_month,
			local_year,
			geographical_longitude
	)

 Convert Hour Angle to Right Ascension 

mean_obliquity_of_the_ecliptic()

mean_obliquity_of_the_ecliptic	(		greenwich_day,
			greenwich_month,
			greenwich_year
	)

 Calculate Mean Obliquity of the Ecliptic for a Greenwich Date 

nutation_in_ecliptic_longitude_and_obliquity()

nutation_in_ecliptic_longitude_and_obliquity	(		greenwich_day,
			greenwich_month,
			greenwich_year
	)

    Calculate nutation for two values: ecliptic longitude and obliquity, for a Greenwich date.

    Returns:
        nutation in ecliptic longitude (degrees)
        nutation in obliquity (degrees)

right_ascension_to_hour_angle()

right_ascension_to_hour_angle	(		ra_hours,
			ra_minutes,
			ra_seconds,
			lct_hours,
			lct_minutes,
			lct_seconds,
			is_daylight_saving,
			zone_correction,
			local_day,
			local_month,
			local_year,
			geographical_longitude
	)

 Convert Right Ascension to Hour Angle 

rising_and_setting()

rising_and_setting	(		ra_hours,
			ra_minutes,
			ra_seconds,
			dec_deg,
			dec_min,
			dec_sec,
			gw_date_day,
			gw_date_month,
			gw_date_year,
			geog_long_deg,
			geog_lat_deg,
			vert_shift_deg
	)

    Rising and setting times

    Arguments:
        ra_hours -- Right Ascension, in hours.
        ra_minutes -- Right Ascension, in minutes.
        ra_seconds -- Right Ascension, in seconds.
        dec_deg -- Declination, in degrees.
        dec_min -- Declination, in minutes.
        dec_sec -- Declination, in seconds.
        gw_date_day -- Greenwich Date, day part.
        gw_date_month -- Greenwich Date, month part.
        gw_date_year -- Greenwich Date, year part.
        geog_long_deg -- Geographical Longitude, in degrees.
        geog_lat_deg -- Geographical Latitude, in degrees.
        vert_shift_deg -- Vertical Shift, in degrees.

    Returns:
        rise_set_status -- "Never Rises", "Circumpolar", or "OK".
        ut_rise_hour -- Rise time, UT, hour part.
        ut_rise_min -- Rise time, UT, minute part.
        ut_set_hour -- Set time, UT, hour part.
        ut_set_min -- Set time, UT, minute part.
        az_rise -- Azimuth angle, at rise.
        az_set -- Azimuth angle, at set.

selenographic_coordinates_1()

selenographic_coordinates_1	(		gwdate_day,
			gwdate_month,
			gwdate_year
	)

    Calculate selenographic (lunar) coordinates (sub-Earth)

    Returns:
        sub-earth longitude
        sub-earth latitude
        position angle of pole

selenographic_coordinates_2()

selenographic_coordinates_2	(		gwdate_day,
			gwdate_month,
			gwdate_year
	)

    Calculate selenographic (lunar) coordinates (sub-Solar)

    Returns:
        sub-solar longitude
        sub-solar colongitude
        sub-solar latitude