Panchaka Rahita remainder

derived.panchaka-rahita

Tithi, Vaaram, Nakshatra, and Lagna ordinals are summed modulo nine to classify dosha.

Assurance

Level	Current statement
Documented and traceable	Yes — the canonical record includes the process and a worked example.
Regression or reproduction checked	Linked to 1 repository test file(s).
Independently source-supported	Available only for the explicitly named provenance claims or comparison cells.

Computation method

Method type: formula

Convert the four named limbs to one-based ordinals, sum them modulo nine, and map the remainder to a named activity-specific caution.

Process

1. Number Tithi 1-30, Vaaram 1-7, Nakshatra 1-27, and Lagna 1-12 in canonical table order.
2. Add the four ordinals and reduce modulo 9.
3. Map remainders 0, 3, 5, and 7 to Rahita; map 1, 2, 4, 6, and 8 to named cautions.
4. At slot level recompute with the Lagna active at the slot start.

Formulae

Panchaka remainder

r = (T + V + N + L) mod 9

• T: one-based Tithi ordinal
• V: one-based Vaaram ordinal
• N: one-based Nakshatra ordinal
• L: one-based Lagna ordinal

Worked example

Krishna Ekadashi, Thursday, Revati, Meena

Inputs

• T=26
• V=5
• N=27
• L=12

Calculation

1. 26 + 5 + 27 + 12 = 70.
2. 70 mod 9 = 7.
3. Remainder 7 maps to Rahita.

Result

• Remainder: 7
• Name: Rahita
• Auspicious flag: true

Method notes

• The output includes targeted avoid_for categories for non-Rahita remainders rather than treating every dosha as universal.

Contract

Owning layer: derived
Claim kind: textual-rule
Time basis: Sunrise snapshot for the day field; recomputed at slot Lagna for Muhurtam.

Inputs

• Tithi
• Vaaram
• Nakshatra
• Lagna

Outputs

• remainder
• dosha name
• auspicious flag
• activity cautions

References and evidence

Evidence classes: textual
Verification states: verified

Formula and remainder meanings have registered source evidence.

panchangam.panchaka_rahita

Evidence class: textual
Verification state: verified
Locator: B. V. Raman, Chapter III, 'Panchak (5-source energy),' inspected in the 2020 Chistabo derivative at internal printed pp. 8-9 (physical PDF pp. 11-12)
Last reviewed: 2026-09-04
Scope: Supports adding the ordinal Tithi, weekday, Nakshatra and Lagna and reducing modulo nine; remainders 1, 2, 4, 6 and 8 as Mrityu, Agni, Raja, Chora and Roga; and activity-specific avoidance for occupation, building, travel, marriage and Upanayanam. The broader software avoid-for aliases are operational mappings of those categories, not additional textual quotations.

Sources

• Muhurtha (Electional Astrology) — B. V. Raman; UBS Publishers' Distributors, 1993, ISBN 9788185674681, 181 catalogued pages; authority type: modern_synthesis
• Muhurtha (Electional Astrology) — Chistabo re-edited derivative — B. V. Raman; re-edited by Simon (Chistabo); 2020 re-edited transcription, 78 physical PDF pages; authority type: inspected_derivative

The complete machine-readable source registry is available in provenance.json. A regression fixture or same-code reproduction is not independent verification.

Reproduce and review

• tests/test_panchaka_rahita.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• Ordinal naming and activity cautions follow the registered convention.

Implementation

• owner: telugu_panchangam/panchaka.py — get_panchaka_remainder
• owner: telugu_panchangam/panchaka.py — evaluate_panchaka

This route is generated from computations.json. Edit the registry and canonical reference prose in the same pull request as a behavior change.