Practical Astronomy
pa_coordinate Namespace Reference

Functions

def angle_to_decimal_degrees (degrees, minutes, seconds)
 
def decimal_degrees_to_angle (decimalDegrees)
 
def 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)
 
def 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)
 
def equatorial_coordinates_to_horizon_coordinates (hour_angle_hours, hour_angle_minutes, hour_angle_seconds, declination_degrees, declination_minutes, declination_seconds, geographical_latitude)
 
def horizon_coordinates_to_equatorial_coordinates (azimuth_degrees, azimuth_minutes, azimuth_seconds, altitude_degrees, altitude_minutes, altitude_seconds, geographical_latitude)
 
def mean_obliquity_of_the_ecliptic (greenwich_day, greenwich_month, greenwich_year)
 
def 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)
 
def equatorial_coordinate_to_ecliptic_coordinate (ra_hours, ra_minutes, ra_seconds, dec_degrees, dec_minutes, dec_seconds, gw_day, gw_month, gw_year)
 
def equatorial_coordinate_to_galactic_coordinate (ra_hours, ra_minutes, ra_seconds, dec_degrees, dec_minutes, dec_seconds)
 
def galactic_coordinate_to_equatorial_coordinate (gal_long_deg, gal_long_min, gal_long_sec, gal_lat_deg, gal_lat_min, gal_lat_sec)
 
def 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)
 
def 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)
 
def 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)
 
def nutation_in_ecliptic_longitude_and_obliquity (greenwich_day, greenwich_month, greenwich_year)
 
def 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)
 
def 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)
 
def 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)
 
def heliographic_coordinates (helio_position_angle_deg, helio_displacement_arcmin, gwdate_day, gwdate_month, gwdate_year)
 
def carrington_rotation_number (gwdate_day, gwdate_month, gwdate_year)
 
def selenographic_coordinates_1 (gwdate_day, gwdate_month, gwdate_year)
 
def selenographic_coordinates_2 (gwdate_day, gwdate_month, gwdate_year)
 

Function Documentation

◆ angle_between_two_objects()

def pa_coordinate.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()

def pa_coordinate.angle_to_decimal_degrees (   degrees,
  minutes,
  seconds 
)
Convert an Angle (degrees, minutes, and seconds) to Decimal Degrees 

◆ atmospheric_refraction()

def pa_coordinate.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()

def pa_coordinate.carrington_rotation_number (   gwdate_day,
  gwdate_month,
  gwdate_year 
)
Calculate carrington rotation number for a Greenwich date

Returns:
        carrington rotation number

◆ correct_for_aberration()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.decimal_degrees_to_angle (   decimalDegrees)
Convert Decimal Degrees to an Angle (degrees, minutes, and seconds)

Returns:
    degrees, minutes, seconds

◆ ecliptic_coordinate_to_equatorial_coordinate()

def pa_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()

def pa_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()

def pa_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()

def pa_coordinate.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()

def pa_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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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()

def pa_coordinate.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