practical_astronomy.pa_eclipses Namespace Reference

Functions
	lunar_eclipse_occurrence (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
	lunar_eclipse_circumstances (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
	solar_eclipse_occurrence (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours)
	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()

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

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

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

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).