गणना पद्धति

ग्रहों की स्थिति NASA JPL के एफ़ेमेरिस डेटा से निकाली जाती है। छोटा किया हुआ नहीं, पूरा 105 MB डेटा, 735 स्थिर तारों के साथ, सन् 500 से 2999 तक। कुछ भी पहले से बनी पंचांग तालिका से अंदाज़े से नहीं निकाला जाता, और कोई पुराना नतीजा सहेजकर नहीं लौटाया जाता। हर उत्तर अनुरोध में दिए ठीक उसी पल और उसी जगह के लिए गणना करके बनता है।

यह दायरा दो असली कामों में मायने रखता है: सदियों पुरानी ऐतिहासिक कुंडलियाँ, और दशा व गोचर की लंबी गणनाएँ जो आज से कई दशक आगे तक जाती हैं। जो लाइब्रेरी सिर्फ़ आधुनिक काल तक सीमित है, वह किनारों पर चुपचाप गलत होने लगती है।

यही गणना इंजन Yoga Panchang को चलाता है, जो हमारी मुफ़्त पंचांग और ज्योतिष साइट है, इसलिए उसके पाठक रोज़ जो आँकड़े देखते हैं, वे यहाँ बताए गए कोड से ही आते हैं।

दो वैदिक गणनाओं में सबसे बड़ा अंतर गणित से नहीं, अयनांश से आता है। भारतीय परंपराओं में इस पर सच में मतभेद है, और एक अंश का अंतर भी किसी ग्रह को एक नक्षत्र से दूसरे में पहुँचा देता है।

इसलिए हम 48 अयनांश देते हैं: सूर्य सिद्धांत वाले, ट्रू चित्रा, ट्रू रेवती, ट्रू पुष्य, रमन, KP, युक्तेश्वर और बाकी सब। इनमें से किसी को भी अंश, कला और विकला तक ठीक किया जा सकता है। हम कोई एक अयनांश देकर उसे ही सही नहीं ठहराते। अगर हमारा नतीजा किसी दूसरे स्रोत से नहीं मिलता, तो सबसे पहले यह देखिए कि दोनों एक ही अयनांश इस्तेमाल कर रहे हैं या नहीं।

ज़्यादातर API के डॉक्स यह दावा नहीं कर सकते। हमारा API संदर्भ हाथ से नहीं लिखा जाता। build_api_catalogue उसे सीधे सीरियलाइज़र से बनाता है, फिर verify_api_catalogue उसे चालू सर्वर पर परखता है: डॉक्स में दिया हर नमूना अनुरोध भेजकर देखता है कि उत्तर 2xx आता है या नहीं।

इसका असली फ़ायदा यह है: 299 में से 255 एंडपॉइंट के पेज पर सर्वर से लिया गया असली उत्तर दिखता है, गढ़ा हुआ नहीं। बाकी पर साफ़ लिखा है कि वे अभी जाँचे नहीं गए, उन्हें चालू बताकर नहीं दिखाया जाता। हाथ से संभाली जाने वाली स्प्रेडशीट की तरह कोई फ़ील्ड चुपचाप डॉक्स से अलग नहीं हो सकता। अगर कोई सीरियलाइज़र बदले और डॉक्स दोबारा न बनें, तो जाँच विफल हो जाती है, गलत जानकारी प्रकाशित नहीं होती।

इसी कैटलॉग से OpenAPI स्पेक, Postman कलेक्शन और llms.txt भी बनते हैं, इसलिए चारों अपने-आप एक ही API का वर्णन करते हैं।

बैकएंड में 87 मॉड्यूल में 1,783 टेस्ट फ़ंक्शन हैं। सबसे ज़्यादा टेस्ट क्रेडिट काटने वाले हिस्से के हैं, क्योंकि वहीं की गलती किसी का पैसा ले लेती है। ये जाँचते हैं कि सफल कॉल पर ठीक उतना ही कटे जितनी उस एंडपॉइंट की कीमत है, 4xx और 5xx पर कुछ न कटे, आख़िरी क्रेडिट के लिए एक साथ आई कॉल बैलेंस को शून्य से नीचे न ले जा सकें, और क्रेडिट जुड़ने व खर्च होने के किसी भी बेतरतीब क्रम के बाद खाता-बही बैलेंस से मेल खाए।

हम 62 ms का मीडियन और 76% उत्तर 100 ms से कम बताते हैं। ये संख्याएँ 22 अक्टूबर 2026 को 254 प्रकाशित उदाहरणों को, हर एक को उसके अपने नमूना अनुरोध के साथ, API के लोकल रन पर कॉल करके निकली हैं — एक बार वॉर्म-अप के लिए, फिर एक बार समय नापकर। किसी तेज़ एंडपॉइंट का समय नापकर गोल नहीं किया गया। AI चैट इसमें शामिल नहीं है: उसका समय लैंग्वेज मॉडल का होता है।

इसीलिए हम यह भी बताते हैं: कुछ एंडपॉइंट काफ़ी धीमे हैं, और डॉक्स में यह लिखा है। पूरे वर्षफल की जाँच या एक साल की राशि दशा में मिलीसेकंड नहीं, सेकंड लगते हैं, क्योंकि यह कुछ ढूँढना नहीं, पूरी अवधि को खंगालना है। मीडियन यह बात छिपा देता है; उसके साथ पूरा बँटवारा दिखाने से नहीं छिपती।

मीडियन   62 ms      आधे एंडपॉइंट इससे तेज़ हैं
<100ms   76%        ज़्यादातर सामान्य गणनाएँ
धीमे      कुछ सेकंड    भारी गणनाएँ, संदर्भ में नाम सहित

दो चीज़ें जो हम प्रकाशित करना चाहते हैं पर अभी नहीं की हैं। साफ़ बता रहे हैं, ताकि आपको अंदाज़ा न लगाना पड़े:

• ग्रह स्थितियों की कोई स्वतंत्र जाँच। हमारी गणना JPL के एफ़ेमेरिस डेटा पर आधारित है, पर हमने अभी तक ऐसी कोई जाँच प्रकाशित नहीं की है जिसमें अलग-अलग तारीख़ों और ग्रहों पर हमारे नतीजों की JPL Horizons से तुलना हो, अंतर के आँकड़ों और उसे दोहराने के कोड के साथ। जब तक ऐसा नहीं होता, सटीकता के दावे को “इस स्रोत से गणना की गई” समझिए, “इतनी सीमा तक जाँची गई” नहीं।
• लंबे समय का अपटाइम। उपलब्धता स्टेटस पेज पर अक्टूबर 2026 से ही प्रकाशित की जा रही है, इसलिए अभी बताने लायक कोई लंबा इतिहास नहीं है। हम किस बात की ज़िम्मेदारी लेते हैं, यह पारदर्शिता में देखें।

दोनों हमारी सूची में हैं। कोई भी मुश्किल नहीं है; बस दोनों ऐसे काम हैं जिन्हें हम अंदाज़े से नहीं, ठीक से करना चाहते हैं।

प्लेग्राउंड आपकी अपनी कुंजी से असली कॉल करता है, और विफल कॉल पर कुछ नहीं लगता। इसलिए आप हमारे नतीजों की तुलना किसी भी ऐसे स्रोत से कर सकते हैं जिस पर आपको पहले से भरोसा है। अगर कोई ऐसा अंतर मिले जिसे अयनांश से न समझाया जा सके, तो हमें ज़रूर बताइए।