practical_astronomy.pa_moon Namespace Reference

Functions
	approximate_position_of_moon (lct_hour, lct_min, lct_sec, is_daylight_saving, zone_correction_hours, local_date_day, local_date_month, local_date_year)
	precise_position_of_moon (lct_hour, lct_min, lct_sec, is_daylight_saving, zone_correction_hours, local_date_day, local_date_month, local_date_year)
	moon_phase (lct_hour, lct_min, lct_sec, is_daylight_saving, zone_correction_hours, local_date_day, local_date_month, local_date_year, accuracy_level="A")
	times_of_new_moon_and_full_moon (is_daylight_saving, zone_correction_hours, local_date_day, local_date_month, local_date_year)
	moon_dist_ang_diam_hor_parallax (lct_hour, lct_min, lct_sec, is_daylight_saving, zone_correction_hours, local_date_day, local_date_month, local_date_year)
	moonrise_and_moonset (local_date_day, local_date_month, local_date_year, is_daylight_saving, zone_correction_hours, geog_long_deg, geog_lat_deg)

Function Documentation

approximate_position_of_moon()

approximate_position_of_moon	(		lct_hour,
			lct_min,
			lct_sec,
			is_daylight_saving,
			zone_correction_hours,
			local_date_day,
			local_date_month,
			local_date_year
	)

    Calculate approximate position of the Moon.

    Arguments:
        lct_hour -- Local civil time, in hours.
        lct_min -- Local civil time, in minutes.
        lct_sec -- Local civil time, in seconds.
        is_daylight_saving -- Is daylight savings in effect?
        zone_correction_hours -- Time zone correction, in hours.
        local_date_day -- Local date, day part.
        local_date_month -- Local date, month part.
        local_date_year -- Local date, year part.

    Returns:
        moon_ra_hour -- Right ascension of Moon (hour part)
        moon_ra_min -- Right ascension of Moon (minutes part)
        moon_ra_sec -- Right ascension of Moon (seconds part)
        moon_dec_deg -- Declination of Moon (degrees part)
        moon_dec_min -- Declination of Moon (minutes part)
        moon_dec_sec -- Declination of Moon (seconds part)

moon_dist_ang_diam_hor_parallax()

moon_dist_ang_diam_hor_parallax	(		lct_hour,
			lct_min,
			lct_sec,
			is_daylight_saving,
			zone_correction_hours,
			local_date_day,
			local_date_month,
			local_date_year
	)

    Calculate Moon's distance, angular diameter, and horizontal parallax.

    Arguments:
        lct_hour -- Local civil time, in hours.
        lct_min -- Local civil time, in minutes.
        lct_sec -- Local civil time, in seconds.
        is_daylight_saving -- Is daylight savings in effect?
        zone_correction_hours -- Time zone correction, in hours.
        local_date_day -- Local date, day part.
        local_date_month -- Local date, month part.
        local_date_year -- Local date, year part.

    Returns:
        earth_moon_dist -- Earth-Moon distance (km)
        ang_diameter_deg -- Angular diameter (degrees part)
        ang_diameter_min -- Angular diameter (minutes part)
        hor_parallax_deg -- Horizontal parallax (degrees part)
        hor_parallax_min -- Horizontal parallax (minutes part)
        hor_parallax_sec -- Horizontal parallax (seconds part)

moon_phase()

moon_phase	(		lct_hour,
			lct_min,
			lct_sec,
			is_daylight_saving,
			zone_correction_hours,
			local_date_day,
			local_date_month,
			local_date_year,
			accuracy_level = "A"
	)

    Calculate Moon phase and position angle of bright limb.

    Arguments:
        lct_hour -- Local civil time, in hours.
        lct_min -- Local civil time, in minutes.
        lct_sec -- Local civil time, in seconds.
        is_daylight_saving -- Is daylight savings in effect?
        zone_correction_hours -- Time zone correction, in hours.
        local_date_day -- Local date, day part.
        local_date_month -- Local date, month part.
        local_date_year -- Local date, year part.
        accuracy_level -- "A" (approximate) or "P" (precise)

    Returns:
        moon_phase -- Phase of Moon, between 0 and 1, where 0 is New and 1 is Full.
        pa_bright_limb_deg -- Position angle of the bright limb (degrees)

moonrise_and_moonset()

moonrise_and_moonset	(		local_date_day,
			local_date_month,
			local_date_year,
			is_daylight_saving,
			zone_correction_hours,
			geog_long_deg,
			geog_lat_deg
	)

    Calculate date/time of local moonrise and moonset.

    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_long_deg -- Geographical longitude, in degrees.
        geog_lat_deg -- Geographical latitude, in degrees.

    Returns:
        mr_lt_hour -- Moonrise, local time (hour part)
        mr_lt_min -- Moonrise, local time (minutes part)
        mr_local_date_day -- Moonrise, local date (day)
        mr_local_date_month -- Moonrise, local date (month)
        mr_local_date_year -- Moonrise, local date (year)
        mr_azimuth_deg -- Moonrise, azimuth (degrees)
        ms_lt_hour -- Moonset, local time (hour part)
        ms_lt_min -- Moonset, local time (minutes part)
        ms_local_date_day -- Moonset, local date (day)
        ms_local_date_month -- Moonset, local date (month)
        ms_local_date_year -- Moonset, local date (year)
        ms_azimuth_deg -- Moonset, azimuth (degrees)

precise_position_of_moon()

precise_position_of_moon	(		lct_hour,
			lct_min,
			lct_sec,
			is_daylight_saving,
			zone_correction_hours,
			local_date_day,
			local_date_month,
			local_date_year
	)

    Calculate approximate position of the Moon.

    Arguments:
        lct_hour -- Local civil time, in hours.
        lct_min -- Local civil time, in minutes.
        lct_sec -- Local civil time, in seconds.
        is_daylight_saving -- Is daylight savings in effect?
        zone_correction_hours -- Time zone correction, in hours.
        local_date_day -- Local date, day part.
        local_date_month -- Local date, month part.
        local_date_year -- Local date, year part.

    Returns:
        moon_ra_hour -- Right ascension of Moon (hour part)
        moon_ra_min -- Right ascension of Moon (minutes part)
        moon_ra_sec -- Right ascension of Moon (seconds part)
        moon_dec_deg -- Declination of Moon (degrees part)
        moon_dec_min -- Declination of Moon (minutes part)
        moon_dec_sec -- Declination of Moon (seconds part)
        earth_moon_dist_km -- Distance from Earth to Moon (km)
        moon_hor_parallax_deg -- Horizontal parallax of Moon (degrees)

times_of_new_moon_and_full_moon()

times_of_new_moon_and_full_moon	(		is_daylight_saving,
			zone_correction_hours,
			local_date_day,
			local_date_month,
			local_date_year
	)

    Calculate new moon and full moon instances.

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

    Returns:
        nm_local_time_hour -- new Moon instant - local time (hour)
        nm_local_time_min -- new Moon instant - local time (minutes)
        nm_local_date_day -- new Moon instance - local date (day)
        nm_local_date_month -- new Moon instance - local date (month)
        nm_local_date_year -- new Moon instance - local date (year)
        fm_local_time_hour -- full Moon instant - local time (hour)
        fm_local_time_min -- full Moon instant - local time (minutes)
        fm_local_date_day -- full Moon instance - local date (day)
        fm_local_date_month -- full Moon instance - local date (month)
        fm_local_date_year -- full Moon instance - local date (year)