Daily Guru and Shukra Maudhya

panchangam.graha-maudhya

Shortest-arc Sun-planet elongation is compared with configured combustion thresholds.

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: formula

Compute the absolute shortest angular separation between the Sun and Guru or Shukra and compare it with the maintained strict combustion threshold.

Process

1. Select threshold 11 degrees for Guru or 10 degrees for Shukra.
2. Normalize planet-Sun difference onto the signed shortest arc and take its absolute value in 0-180 degrees.
3. Set combust=true only when separation is strictly less than the threshold.
4. Return graha, separation, flag, and threshold.

Formulae

Shortest-arc combustion

d = abs((planet - sun + 180) mod 360 - 180)
combust = d < threshold[graha]

• d: shortest angular separation
• threshold: Guru 11 degrees; Shukra 10 degrees

Worked example

Illustrative Guru conjunction

Inputs

• Sun longitude: 100 degrees
• Guru longitude: 109 degrees
• Guru threshold: 11 degrees

Calculation

1. d=abs((109-100+180) modulo 360 - 180)=9 degrees.
2. 9 < 11.

Result

• elongation_deg=9; combust=true; threshold_deg=11

Method notes

• Equality is not combust because comparison is strict.
• Surya Siddhanta and Vakya do not populate outer-planet Maudhya fields.

Contract

Owning layer: derived
Claim kind: textual-rule
Time basis: Drik snapshot at local sunrise.

Inputs

• graha
• solar longitude
• planetary longitude

Outputs

• elongation
• threshold
• combust boolean

References and evidence

Evidence classes: astronomical, textual
Verification states: needs_locator

Numerical behavior is tested; exact threshold locators remain under 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_maudhya.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• Only Drik populates outer-planet Maudhya in PanchangamDay.

Implementation

• owner: telugu_panchangam/gochara/combustion.py — compute_maudhya

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