Disha Shoola direction

derived.disha-shoola

A weekday table returns the traditionally avoided travel direction.

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	Not recorded as independently verified. The disclosed provenance state remains authoritative.

Computation method

Method type: decision-table

Return the avoided direction from the maintained seven-row weekday table.

Process

1. Use the sunrise-anchored Vaaram as the lookup key.
2. Return West, East, North, or South from DISHA_SHOOLA.
3. Return null when the weekday is absent or unrecognized.

Worked example

Thursday travel direction

Inputs

• Vaaram: Guruvaram

Calculation

1. DISHA_SHOOLA[Guruvaram] = South.

Result

• Avoided direction: South

Method notes

• This is a classification input to travel Muhurtam, not an instruction or automated remedy.

Contract

Owning layer: derived
Claim kind: textual-rule
Time basis: Sunrise-anchored Panchangam weekday.

Inputs

• Vaaram

Outputs

• avoided travel direction

References and evidence

Evidence classes: textual
Verification states: needs_locator

The table is tested but its exact edition locator remains part of derived-classification debt.

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_disha_shoola.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• Travel-direction rules vary by lineage and remedies are not automated.

Implementation

• owner: telugu_panchangam/disha_shoola.py — disha_shoola

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