Tarabalam

personal.tarabalam

Cyclic distance from Janma Nakshatra produces one of nine Tara names and favourability.

Assurance

Level	Current statement
Documented and traceable	Yes — the canonical record includes the process and a worked example.
Regression or reproduction checked	Linked to 2 repository test file(s).
Independently source-supported	Not recorded as independently verified. The disclosed provenance state remains authoritative.

Computation method

Method type: formula

Count inclusively from Janma Nakshatra to the active Nakshatra around the 27-star cycle, reduce the count to a repeating nine-Tara cycle, and classify the configured auspicious Tara numbers.

Process

1. Look up both canonical Nakshatra indices.
2. Compute the wrapped inclusive count from 1 through 27.
3. Reduce that count to Tara number 1 through 9.
4. Map to Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Naidhana, Mitra, or Parama Mitra.
5. Mark 2, 4, 6, 8, and 9 auspicious; a group passes good_for_all only if every member is auspicious.

Formulae

Tara number

c=((index(day)-index(janma)) mod 27)+1; tara=((c-1) mod 9)+1

• c: inclusive cyclic Nakshatra count

Worked example

Ashvini birth star, Pushya active star

Inputs

• Ashvini index: 0
• Pushya index: 7

Calculation

1. Inclusive count = ((7 - 0) mod 27) + 1 = 8.
2. Tara number = 8, named Mitra.
3. 8 is in AUSPICIOUS_TARAS.

Result

• Tara: 8 Mitra
• Auspicious: true

Method notes

• This project follows the disclosed Telugu convention that Tara 1 Janma is avoid rather than auspicious.

Contract

Owning layer: personal
Claim kind: textual-rule
Time basis: Active day or slot Nakshatra relative to birth Nakshatra.

Inputs

• Janma Nakshatra
• day or slot Nakshatra

Outputs

• Tara number
• Tara name
• favourability

References and evidence

Evidence classes: textual
Verification states: needs_locator

Formula and browser parity are tested; a claim-specific exact locator is not yet registered.

panchangam.derived_classifications

Evidence class: textual
Verification state: needs_locator
Locator: No precise locator is registered.

Scope: Special Yogas, Panchaka labels, Khara month, Pitru Paksha, Simha-Stha, Maudhya, Anandadi Yoga, Disha Shoola, Nakshatra Mukha and Panchaka Rahita are separate traditional classifications. The group exists to expose evidence debt and grants no umbrella textual authority; each component needs its own inspected rule table and regional boundary.

Sources

• Muhurtha (Electional Astrology) — B. V. Raman; UBS Publishers' Distributors, 1993, ISBN 9788185674681, 181 catalogued pages; authority type: modern_synthesis
• Muhurta Chintamani — Rama Daivajna; Undated Sanskrit text with Hindi commentary, Internet Archive identifier muhurta-chintamani-hindi; authority type: primary_text_hindi_commentary

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_tarabalam.py
• tests/test_activity_surface_parity.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• Tarabalam is one personal factor and should not be presented as a complete Muhurta judgment.

Implementation

• owner: telugu_panchangam/personal/tarabalam.py — tara_number
• owner: telugu_panchangam/personal/tarabalam.py — tara_name
• owner: telugu_panchangam/personal/tarabalam.py — taras_for_day
• mirror: src/panels/tarabalam.ts — taraOf

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