Practical Astronomy
pa_eclipses Namespace Reference

Functions

def lunar_eclipse_occurrence (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
 
def lunar_eclipse_circumstances (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
 
def solar_eclipse_occurrence (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
 
def solar_eclipse_circumstances (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours, geog_longitude_deg, geog_latitude_deg)
 

Function Documentation

◆ lunar_eclipse_circumstances()

def pa_eclipses.lunar_eclipse_circumstances (   local_date_day,
  local_date_month,
  local_date_year,
  is_daylight_saving,
  zone_correction_hours 
)
Calculate the circumstances of a lunar eclipse.

Arguments:
    local_date_day -- Local date, day part.
    local_date_month -- Local date, month part.
    local_date_year -- Local date, year part.
    is_daylight_saving -- Is daylight savings in effect?
    zone_correction_hours -- Time zone correction, in hours.

Returns:
    lunar_eclipse_certain_date_day -- Lunar eclipse date (day)
    lunar_eclipse_certain_date_month -- Lunar eclipse date (month)
    lunar_eclipse_certain_date_year -- Lunar eclipse date (year)
    ut_start_pen_phase_hour -- Start of penumbral phase (hour)
    ut_start_pen_phase_minutes -- Start of penumbral phase (minutes)
    ut_start_umbral_phase_hour -- Start of umbral phase (hour)
    ut_start_umbral_phase_minutes -- Start of umbral phase (minutes)
    ut_start_total_phase_hour -- Start of total phase (hour)
    ut_start_total_phase_minutes -- Start of total phase (minutes)
    ut_mid_eclipse_hour -- Mid-eclipse (hour)
    ut_mid_eclipse_minutes -- Mid-eclipse (minutes)
    ut_end_total_phase_hour -- End of total phase (hour)
    ut_end_total_phase_minutes -- End of total phase (minutes)
    ut_end_umbral_phase_hour -- End of umbral phase (hour)
    ut_end_umbral_phase_minutes -- End of umbral phase (minutes)
    ut_end_pen_phase_hour -- End of penumbral phase (hour)
    ut_end_pen_phase_minutes -- End of penumbral phase (minutes)
    eclipse_magnitude -- Eclipse magnitude

◆ lunar_eclipse_occurrence()

def pa_eclipses.lunar_eclipse_occurrence (   local_date_day,
  local_date_month,
  local_date_year,
  is_daylight_saving,
  zone_correction_hours 
)
Determine if a lunar eclipse is likely to occur.

Arguments:
    local_date_day -- Local date, day part.
    local_date_month -- Local date, month part.
    local_date_year -- Local date, year part.
    is_daylight_saving -- Is daylight savings in effect?
    zone_correction_hours -- Time zone correction, in hours.

Returns:
    status -- One of "Lunar eclipse certain", "Lunar eclipse possible", or "No lunar eclipse".
    event_date_day -- Date of eclipse event (day).
    event_date_month -- Date of eclipse event (month).
    event_date_year -- Date of eclipse event (year).

◆ solar_eclipse_circumstances()

def pa_eclipses.solar_eclipse_circumstances (   local_date_day,
  local_date_month,
  local_date_year,
  is_daylight_saving,
  zone_correction_hours,
  geog_longitude_deg,
  geog_latitude_deg 
)
Calculate the circumstances of a lunar eclipse.

Arguments:
    local_date_day -- Local date, day part.
    local_date_month -- Local date, month part.
    local_date_year -- Local date, year part.
    is_daylight_saving -- Is daylight savings in effect?
    zone_correction_hours -- Time zone correction, in hours.
    geog_longitude_deg -- Geographical longitude of observer.
    geog_latitude_deg -- Geographical latitude of observer.

Returns:
    solar_eclipse_certain_date_day -- Solar eclipse date (day)
    solar_eclipse_certain_date_month -- Solar eclipse date (month)
    solar_eclipse_certain_date_year -- Solar eclipse date (year)
    ut_first_contact_hour -- First contact of shadow (hour)
    ut_first_contact_minutes -- First contact of shadow (minutes)
    ut_mid_eclipse_hour -- Mid-eclipse (hour)
    ut_mid_eclipse_minutes -- Mid-eclipse (minutes)
    ut_last_contact_hour -- Last contact of shadow (hour)
    ut_last_contact_minutes -- Last contact of shadow (minutes)
    eclipse_magnitude -- Eclipse magnitude

◆ solar_eclipse_occurrence()

def pa_eclipses.solar_eclipse_occurrence (   local_date_day,
  local_date_month,
  local_date_year,
  is_daylight_saving,
  zone_correction_hours 
)
Determine if a solar eclipse is likely to occur.

Arguments:
    local_date_day -- Local date, day part.
    local_date_month -- Local date, month part.
    local_date_year -- Local date, year part.
    is_daylight_saving -- Is daylight savings in effect?
    zone_correction_hours -- Time zone correction, in hours.

Returns:
    status -- One of "Solar eclipse certain", "Solar eclipse possible", or "No solar eclipse".
    event_date_day -- Date of eclipse event (day).
    event_date_month -- Date of eclipse event (month).
    event_date_year -- Date of eclipse event (year).