कम्यूट लागत तुलना कैलकुलेटर

--- name: commute-cost-comparison-calculator description: विभिन्न कम्यूट विकल्पों की तुलना करता है - कार (ईंधन या इलेक्ट्रिक), सार्वजनिक परिवहन, साइकिल, ई-बाइक, पैदल, डे-शेयर मिश्रण और पार्क-एंड-राइड चरण - प्रति माह और वर्ष के हिसाब से नकद लागत, डोर-टू-डोर समय, आपके प्रति घंटे के मूल्य पर समय लागत, प्रति यात्रा लागत और CO2 के साथ। आपके यात्रा करने के दिनों के लिए पास बनाम पे-पर-राइड चुनता है, कार की चलने की लागत को निश्चित लागतों से अलग करता है, और एक घंटे का ब्रेक-ईवन मूल्य दिखाता है। इसमें --self-test के साथ एक stdlib Python कैलकुलेटर शामिल है। --- # कम्यूट लागत तुलना कैलकुलेटर आप किसी को यह तय करने में मदद करते हैं कि काम पर कैसे जाना है, हर विकल्प को एक ही आधार पर रखकर: इसमें नकद में कितना खर्च होता है, उनके जीवन का कितना समय लगता है, और उस समय का उनके लिए क्या मूल्य है। आप केवल उन लागतों को गिनते हैं जो विकल्प के साथ वास्तव में बदलती हैं (ईंधन, पार्किंग, किराया, साइकिल), उन लागतों को बाहर रखते हैं जो वे वैसे भी चुकाते हैं जब तक कि वे वास्तव में कार नहीं बेचेंगे, और व्यापार-बंद को एक स्पष्ट संख्या के रूप में दिखाते हैं: "ड्राइविंग से साल में 32 खोए हुए घंटे बचते हैं और $3,697 अधिक खर्च होता है, इसलिए यह केवल तभी फायदेमंद है जब आपका एक घंटा $115 से अधिक मूल्य का हो"। ## इस स्किल में फ़ाइलें - `scripts/commute_cost.py` - एक परिदृश्य JSON (दूरी, कम्यूट दिन, समय का मूल्य, विकल्प) पढ़ता है और एक तुलना तालिका, मुख्य पंक्ति, समय के ब्रेक-ईवन मूल्य और प्रति-विकल्प नोट्स प्रिंट करता है; मीट्रिक (km, L/100 km) और इम्पीरियल (mi, mpg), इलेक्ट्रिक वाहन, दैनिक कैप और नियोक्ता सब्सिडी के साथ ट्रांज़िट पास, डे-शेयर मिश्रण और मल्टी-लेग यात्राओं का समर्थन करता है (केवल Python 3.8+ मानक लाइब्रेरी) - `references/cost-components.md` - हर विकल्प फ़ील्ड, प्रत्येक मोड के लिए क्या शामिल करें, संख्याएँ कहाँ खोजें, और विशिष्ट सीमाएँ - `references/time-value-and-assumptions.md` - समय का मूल्य कैसे चुनें, ट्रांज़िट पर उपयोग योग्य समय, कुल राशि में क्या शामिल नहीं है (स्वास्थ्य, सुरक्षा, मौसम, लचीलापन) और संवेदनशीलता जाँच कैसे चलाएँ - `templates/commute-comparison.md` - वापस देने के लिए निर्णय सारांश - `examples/commute.json` - एक 11-मील कम्यूट जिसमें ड्राइविंग, बस + लाइट रेल, एक ई-बाइक, एक ई-बाइक/ट्रांज़िट मिश्रण और पार्क-एंड-राइड शामिल है - `examples/comparison-output.md` - उस परिदृश्य के लिए कैलकुलेटर का वास्तविक आउटपुट ## कार्यप्रवाह ### 1. तथ्य एकत्र करें एक-तरफ़ा दूरी, प्रति सप्ताह कम्यूट दिन (हाइब्रिड काम बहुत मायने रखता है) और प्रति वर्ष काम किए गए सप्ताह, प्रति विकल्प डोर-टू-डोर मिनट (पैदल चलना, प्रतीक्षा, पार्किंग और स्थानांतरण सहित: मानचित्र अनुमान नहीं, वास्तविक यात्रा के लिए पूछें), और प्रति मोड: कार ईंधन दक्षता, ईंधन या बिजली की कीमत, पार्किंग और टोल, क्या वे वैसे भी कार रखेंगे; ट्रांज़िट किराया, पास मूल्य, दैनिक कैप, नियोक्ता सब्सिडी; साइकिल या ई-बाइक मूल्य, अपेक्षित जीवन और रखरखाव। पूछें कि उनके समय का एक घंटा कितना मूल्यवान है, या एक डिफ़ॉल्ट (उनके प्रति घंटे वेतन का आधा) प्रदान करें और संवेदनशीलता दिखाएं। ### 2. कैलकुलेटर चलाएं ``` python3 scripts/commute_cost.py examples/commute.json python3 scripts/commute_cost.py scenario.json --days-per-week 3 python3 scripts/commute_cost.py scenario.json --value-of-time 0 --json python3 scripts/commute_cost.py --self-test ``` बाहर निकलें 0 = तुलना मुद्रित, 2 = खराब इनपुट (लापता फ़ील्ड, मिश्रण शेयरों का योग 1 नहीं, अज्ञात मोड, नकारात्मक मूल्य)। कोड के बिना, `references/cost-components.md` में सूत्रों का पालन करें। ### 3. परिणाम पढ़ें - तालिका कुल (नकद + समय लागत) द्वारा क्रमबद्ध है; मुख्य पंक्ति नकद में सबसे सस्ता, समय गिनने पर सबसे सस्ता और सबसे तेज़ नाम देती है। - **समय का ब्रेक-ईवन मूल्य** हर विकल्प की नकद में सबसे सस्ते से तुलना करता है: एक विकल्प जो अधिक खर्च करता है वह केवल तभी मूल्यवान है जब आपका एक घंटा दिखाई गई संख्या से अधिक मूल्य का हो। "कभी नहीं" का मतलब है कि यह अधिक खर्च करता है और उपयोग योग्य समय नहीं बचाता। - ट्रांज़िट पर बिताया गया समय जिसे आप उपयोग कर सकते हैं (पढ़ना, ईमेल) `usable_time_share` के साथ छूट दी जाती है; वही फ़ील्ड साइकिल समय को क्रेडिट कर सकती है जो व्यायाम की जगह लेता है जो आप वैसे भी करेंगे। बताएं कि आपने किसका उपयोग किया। - ट्रांज़िट नोट जांचें: सप्ताह में 2-3 कम्यूट दिनों पर, मासिक पास अक्सर पे-पर-राइड से महंगा होता है; कैलकुलेटर सस्ता चुनता है और ऐसा कहता है। ### 4. वितरण `templates/commute-comparison.md` भरें: एक वाक्य में सिफारिश, तालिका, ब्रेक-ईवन मूल्य, क्या उत्तर बदलता है (हाइब्रिड दिन, ईंधन मूल्य, पार्किंग, समय का मूल्य), क्या मूल्य निर्धारित नहीं है, और एक परीक्षण सुझाव (जैसे कुछ भी खरीदने से पहले मिश्रण के दो सप्ताह)। ## उदाहरण परिणाम 11 मील प्रत्येक तरफ़, सप्ताह में 5 दिन, 46 सप्ताह, समय का मूल्य $20/घंटा (`examples/commute.json`)। नकद में सबसे सस्ता: बस + लाइट रेल $50 नियोक्ता सब्सिडी के बाद $49/माह ($99 पास $105 के एकल किराए से बेहतर है)। समय गिनने पर सबसे सस्ता: पार्क एंड राइड ($95 नकद, $361/माह कुल) क्योंकि ट्रेन चरण का 80% उपयोग योग्य है। डाउनटाउन ड्राइविंग सबसे तेज़ है (28 मिनट) लेकिन $12/दिन पार्किंग के साथ $357/माह खर्च करती है और केवल तभी फायदेमंद है जब एक घंटा $115 से अधिक मूल्य का हो। ई-बाइक की कुल लागत $67/माह है और कुछ भी उत्सर्जित नहीं करती, लेकिन इन संख्याओं पर यह उपयोग योग्य समय नहीं बचाती; यह जीतती है यदि सवारी जिम समय की जगह लेती है। `examples/comparison-output.md` देखें। ## नियम - केवल उन लागतों को गिनें जो विकल्प के साथ बदलती हैं; कार बीमा, पंजीकरण और ऋण लागत केवल तभी शामिल करें यदि व्यक्ति वास्तव में कार छोड़ देगा (`count_fixed`)। - वास्तविक डोर-टू-डोर समय का उपयोग करें, जिसमें पैदल चलना, प्रतीक्षा, पार्किंग और स्थानांतरण शामिल हैं। - समय के मूल्य को कभी तथ्य के रूप में प्रस्तुत न करें: यह व्यक्ति की अपनी पसंद है; कम से कम एक संवेदनशीलता रन दिखाएं (जैसे `--value-of-time 0` और उनकी मजदूरी)। - स्वास्थ्य, सुरक्षा और मौसम को धन कुल से बाहर रखें लेकिन उनका उल्लेख करें; कारों या साइकिलों के बारे में नैतिकता न बनाएं। - हर धारणा को उसकी संख्या के साथ बताएं (ईंधन मूल्य, पार्किंग, प्रति मील मूल्यह्रास) ताकि व्यक्ति इसे बदल सके। - मुद्रा और इकाइयाँ वैसे दें जैसे व्यक्ति उपयोग करता है; एक परिदृश्य में मील और किलोमीटर न मिलाएं।