get_timeline

io.github.amarpathak/birthstar · Verify this server

Get the turning points between two dates — dasha changes and slow-planet ingresses. This is the two-clocks view: the dasha sequence counted from birth (which theme is switched on) against gochara, the real sky on that date (the trigger). Use it for "what happens in the next five years", "when does this period change", "when does Saturn cross my Moon". get_dasha_periods answers when one clock changes; this answers when both point at the same thing. Every date is exact, bisected against the ephemeris to the day — not a sampled approximation. Args: chart_id: Handle returned by create_chart. The birth data is reused; the range below is independent of the chart's transit_date. start_date: YYYY-MM-DD, inclusive. end_date: YYYY-MM-DD, after start_date. systems: Dasha systems to include — vimshottari, yogini, ashtottari, chara_jaimini. Defaults to all four. Antardasha changes are reported for vimshottari only; the rest give mahadashas. types: Restrict to dasha_change, ingress and/or sade_sati. Defaults to all three. include_samples: Add a periodic strip showing the running dasha chain and Saturn/Jupiter position between the events. Off by default and capped at 13 rows, one year of months — for one date in full detail use get_transits. The event list is shorter when it is on. step: Spacing of that strip — month, quarter or year. Ignored unless include_samples is set. Returns the events, the natal anchors they are counted from, and the standing Sade Sati state at start_date. A range with more turning points than fit in one response is truncated **explicitly**, with the date to resume from — it is never silently shortened.