/research-experiment

/research-experiment — डिज़ाइन किए गए अध्ययन को निष्पादित करता है और पूर्ण उद्गम के साथ कच्चा डेटा कैप्चर करता है, साथ ही एक पुनरुत्पादनीयता मैनिफ़ेस्ट (एनवायरनमेंट, सीड, प्रोटोकॉल, वर्शन पिन)।

भूमिका: प्रधान अन्वेषक (निष्पादन) पाइपलाइन स्थिति: शृंखला-मध्य

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

विहित आह्वान

/research-experiment

तर्कों के साथ:

/research-experiment [path/to/research-suite/]

इनपुट

_inputs/study-design.md (डिज़ाइन) और _inputs/preregistration.md (फ़्रोज़न विश्लेषण योजना)।

आउटपुट

_outputs/experiment-log.md (टाइमस्टैम्प वाला प्रोटोकॉल ट्रेस), होस्ट-स्वाभाविक स्थान पर कच्चा डेटा, और _outputs/reproducibility-manifest.md (एनवायरनमेंट, सीड, प्रोटोकॉल, वर्शन पिन)।

डाउनस्ट्रीम

/research-analysis (डाउनस्ट्रीम उपभोक्ता)

वर्कफ़्लो चरण

यह कमांड मानक /research पाइपलाइन वर्कफ़्लो का अनुसरण करता है:

संदर्भ लोड करें — अध्ययन डिज़ाइन और प्री-रजिस्ट्रेशन पढ़ें।
अनुक्रम गेट सत्यापित करें — पुष्टि करें कि _inputs/study-design.md मौजूद है; अन्यथा Blocked: run /research-design first के साथ रुक जाएँ।
चलाएँ और रिकॉर्ड करें — प्रोटोकॉल निष्पादित करें; उद्गम के साथ कच्चा डेटा कैप्चर करें; टाइमस्टैम्प वाला प्रोटोकॉल ट्रेस लॉग करें।
पुनरुत्पादनीयता कैप्चर करें — एनवायरनमेंट, सीड, प्रोटोकॉल और वर्शन पिन रिकॉर्ड करें।
हैंडऑफ़ मैनिफ़ेस्ट अपडेट करें — डेटा स्थान और पुनरुत्पादनीयता मैनिफ़ेस्ट रिकॉर्ड करें।
लॉग उत्सर्जित करें — _outputs/experiment-log.md + कच्चा डेटा + _outputs/reproducibility-manifest.md।

कठोरता की निचली सीमा

निष्पादन बजट और परासों को अंशांकित करने के लिए एक पायलट पास चलाता है, फिर एक घोषित संगणना-उपयोग योजना (कोर आवंटन, स्मृति सीमाएँ, स्वतंत्र पुनरावृत्तियों का सुरक्षित समांतरीकरण) के तहत पूर्ण तुलना। प्रत्येक स्टोकैस्टिक विधि अपने पूर्व-पंजीकृत पुनरावृत्ति क्रम को रिकॉर्ड किए गए सीड और लॉग किए गए हार्डवेयर के साथ चलाती है। एक ऑप्ट-इन, डिफ़ॉल्ट-रूप-से-बंद स्वायत्त प्रयोग लूप उपलब्ध है: एक फ़्रोज़न हार्नेस के विरुद्ध यह एक एकल परिवर्तनीय लक्ष्य में परिवर्तन का प्रस्ताव करता है, उसे निश्चित बजट पर चलाता है, उसे केवल तभी बनाए रखता है जब वह मौजूदा से बेहतर हो, और प्रत्येक परीक्षण को दैनिकी में दर्ज करता है।

विफलता मोड

लक्षण	कारण	पुनर्प्राप्ति
Blocked: run /research-design first	कोई अध्ययन डिज़ाइन नहीं	`_inputs/study-design.md` बनाने के लिए `/research-design` चलाएँ
रन पुनरुत्पादनीय नहीं	सीड / एनवायरनमेंट रिकॉर्ड अनुपस्थित	आगे बढ़ने से पहले पूर्ण पुनरुत्पादनीयता मैनिफ़ेस्ट रिकॉर्ड करें
प्रोटोकॉल विचलन अप्रलेखित	रन के बीच का परिवर्तन लॉग नहीं किया गया	प्रयोग लॉग में विचलन लॉग करें; विश्लेषण के समय प्रकट करें

उदाहरण

# डिज़ाइन किए गए अध्ययन को चलाएँ और पुनरुत्पादनीय कच्चा डेटा कैप्चर करें
/research-experiment path/to/research-suite/