astro_search_max_elongation: Search for maximum elongation
Description
Finds the next date and time when Mercury or Venus reaches its maximum angle
from the Sun as seen from the Earth. Maximum elongation events are the best
opportunities for observing these inner planets.
Usage
astro_search_max_elongation(body, start_time)
Value
A list with the following elements:
visibility
Integer flag indicating morning (0) or evening (1)
visibility.
elongation
The maximum elongation angle in degrees.
ecliptic_separation
The ecliptic separation at maximum elongation.
time
A POSIXct value representing the time of maximum elongation.
status
Status code from the underlying C function.
Arguments
body
Integer code for the celestial body. Must be Mercury (3) or
Venus (2). Other values will fail.
start_time
A POSIXct date-time value indicating the search start time.
The maximum elongation event found will be the first one occurring after
this time.