calculate_solar_arc
Compute true solar-arc directions across an age range, revealing directed-point contacts, exact hard-aspect dates, and positions at a chosen wheel age for astrological timing.
Instructions
Calculate true solar-arc directions over an age interval: directed-point/axis contacts, the hard-aspect matrix with exact dates, and directed positions at wheel_age. Use for solar-arc timing; choose calculate_secondary_progressions for day-for-year progressions, calculate_transits_to_natal for actual transits, or render_solar_arc_biwheel for an image. Requires exact local birth date/time and a confirmed birthplace location_id; omitted prerequisites return needs_clarification. Defaults to a five-year window on either side of the selected wheel age, clipped to ages 0-80. Returns calculation data, not event predictions. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | No | Birth day of month, valid for the supplied year and month in the birthplace local civil calendar. | |
| fold | No | For a repeated local time at a DST rollback, ask the user to choose 0 (first occurrence) or 1 (second). Otherwise omit; never guess. | |
| hour | No | Exact birth hour, 0-23, in birthplace local civil time; do not substitute noon for an unknown time. | |
| year | No | Birth year in the Gregorian calendar, using local civil time at the confirmed birthplace. Required for calculation; do not guess missing birth data. | |
| as_of | No | Reference date YYYY-MM-DD, default current UTC date, evaluated at 12:00 UTC. Determines wheel age when wheel_age is omitted; that derived age is clipped to 0-80. | |
| month | No | Birth month, 1-12, in the birthplace local civil calendar. | |
| age_to | No | End age in years, at most 80 and greater than age_from. Omit for min(80, selected wheel age plus 5). | |
| minute | No | Exact birth minute, 0-59, in birthplace local civil time. | |
| include | No | Optional 1-30 top-level content field names, each 1-80 characters. Omit to return all content. Control/provenance fields remain; unknown or control field names return invalid_input with available_fields. Known selectable fields: aspect_matrix, axis_contacts_by_directed_points, cross_aspects_at_wheel_age, directed_axes_to_natal_points, directed_positions_at_wheel_age. Use these exact names. | |
| age_from | No | Start age in years. Must satisfy 0 <= age_from < age_to <= 80. Omit for max(0, selected wheel age minus 5). | |
| wheel_age | No | Optional directed-position age in years, 0-80. Overrides the age derived from as_of and centers omitted age-range bounds on this age; explicit age_from/age_to remain unchanged. | |
| location_id | No | Confirmed birthplace ID returned by search_birthplace or resolve_birth_coordinates; not a city name. Resolve ambiguous places before calling. | |
| detail_level | No | full returns complete calculation content. summary previews up to five object/nested rows per list, preserves scalar membership lists, and reports omitted counts. References still identify the full calculation. | full |