परिचय
इस गाइड में, सोर्स OR-टूल से ऐप्लिकेशन बनाने का तरीका बताया गया है. MacOS पर Python.
अगर आपको सोर्स कोड में बदलाव करना है या इसके साथ तीसरे पक्ष के सॉल्वर का इस्तेमाल करना है, तो OR-टूल का इस्तेमाल करते हैं, तो हम पैकेज इंस्टॉलेशन का सुझाव देते हैं.
हालांकि, ये निर्देश MacOS के अन्य वैरिएंट पर भी काम कर सकते हैं, लेकिन इनकी सिर्फ़ उन मशीनों पर टेस्ट किया है जो नीचे दी गई ज़रूरी शर्तों को पूरा करती हैं:
- MacOS 13.0.1 (वेंचुरा) Intel 64-बिट (x86_64)
- MacOS 13.0.1 (वेंचुरा) M1 (arm64)
ज़रूरी शर्तें
OR-टूल इंस्टॉल करने के लिए ज़रूरी शर्तों के बारे में यहां दिए गए सेक्शन में बताया गया है.
Xcode कमांड लाइन टूल
आपको Xcode कमांड लाइन टूल इंस्टॉल करने होंगे. ऐसा करने के लिए,
टर्मिनल, /Applications/Utilities/
में मिला, और डालें:
xcode-select --install
Xcode कमांड लाइन टूल डाउनलोड और इंस्टॉल करने के लिए “इंस्टॉल करें” पर क्लिक करें. आपको इनकी ज़रूरत नहीं है "Xcode डाउनलोड करें" पर से डाउनलोड कर सकते हैं. अगर आपका इंटरनेट कनेक्शन धीमा है, तो इसमें कुछ मिनट लग सकते हैं.
पुष्टि करें कि आपने Xcode कमांड लाइन टूल सही तरीके से इंस्टॉल कर लिया है:
xcode-select -p
आपको यह जानकारी दिखेगी:
/Library/Developer/CommandLineTools
होमब्रू
बाकी आवश्यकताएं इंस्टॉल करने के लिए, हमारा सुझाव है कि आप पहले "macOS के लिए पैकेज मैनेजर मौजूद नहीं है" इस नाम से जाना जाता है होमब्रू. ऐसा करने के लिए, टर्मिनल विंडो खोलें और यह डालें:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update
आपके शराब बनाने की सुविधा इंस्टॉल हो गई है या नहीं, इस बात की पुष्टि करने के लिए:
brew --version
आपको यह जानकारी दिखेगी:
Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)
C++ टूल
C++ टूल इंस्टॉल करने के लिए, टर्मिनल विंडो खोलें और यह डालें:
brew install cmake wget pkg-config
SWIG टूल
एसडब्ल्यूआईजी टूल इंस्टॉल करने के लिए, टर्मिनल विंडो खोलें और यह डालें:
brew install swig
Python
आपके पास Python 3.8+ इंस्टॉल होना ज़रूरी है.
Python 3.8+ इंस्टॉल करने के लिए, टर्मिनल विंडो खोलें और यह डालें:
brew install python
python3 -m pip install -U --user wheel six
फिर इंस्टॉल हो जाने की पुष्टि करें:
python3 --version
python3 -c "import platform; print(platform.architecture()[0])"
python3 -m pip --version
सोर्स कोड डाउनलोड करें
OR-Tools सोर्स कोड की दो अलग-अलग ब्रांच होती हैं
GitHub: stable
और main
.
stable
की ब्रांच की अच्छी तरह से जांच कर ली गई है. साथ ही, यह सभी पर सही तरीके से काम करेगी
इस्तेमाल किए जा सकते हैं.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
main
ब्रांच में नए अपडेट और
सुधार लागू किए गए हैं; यह ज़्यादा नया, लेकिन कम स्थिर है.
स्थिर सोर्स कोड डाउनलोड करना
OR-Tools के लिए आपको नीचे दिए गए किसी भी तरीके से स्थिर सोर्स कोड मिल सकता है:
stable
ब्रांच का क्लोन बनाएं. इसके लिए यह तरीका अपनाएं:git clone https://github.com/google/or-tools
सबसे नई रिलीज़ को कंप्रेस की गई फ़ाइल में डाउनलोड करने के लिए, GitHub में
Clone or download
बटन.
मुख्य सोर्स कोड डाउनलोड करना
main
की ब्रांच से सोर्स कोड पाने के लिए, यह डालें:
git clone -b main https://github.com/google/or-tools
पिछली रिलीज़ डाउनलोड करना
पिछली रिलीज़ के लिए सोर्स कोड पाने के लिए, इनमें से किसी एक तरीके का इस्तेमाल किया जा सकता है:
- GitHub के रिलीज़ पेज से पिछली रिलीज़ डाउनलोड करें.
यह मानते हुए कि आपने पहले ही एक लोकल डेटा स्टोर करने की जगह बना ली है (
git clone
ने), तो Google Chat का इस्तेमाल करके किसी ख़ास रिलीज़ को टैग. उदाहरण के लिए,main
ब्रांच, तो अपने लोकल रेपो में ये कमांड डालें:git fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10
बिल्ड कॉन्फ़िगर करें
OR-टूल बनाने से पहले, आपको CMake बिल्ड सिस्टम कॉन्फ़िगर करना होगा जनरेटर.
कोई टर्मिनल खोलें और उस डायरेक्ट्री में जाएं जहां से आपने फ़ाइलें निकाली थीं. फिर यह डालें:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON
क्लिक करें
चेकआउट करें CMake दस्तावेज़ देखें.
SCIP का इस्तेमाल किया जा रहा है
वर्शन 7.8 और इसके बाद के वर्शन में, SCIP को अब इंटिग्रेट कर दिया गया है. इसलिए, आपको इसे मैन्युअल तरीके से इंस्टॉल नहीं करना पड़ेगा.
Gurobi का इस्तेमाल करना
Gurobi अब पहले से एकीकृत है. ज़रूरत पड़ने पर, रनटाइम के दौरान OR-Tools खोज करेंगे
Gurobi इंस्टॉल करने वाले लोगों के डिफ़ॉल्ट इंस्टॉल पाथ में Gurobi की शेयर की गई लाइब्रेरी
MAC OS X और Windows पर या GUROBI_HOME
एनवायरमेंट वैरिएबल का इस्तेमाल करके ऐसा किया जा सकता है.
तीसरे पक्ष के किसी वैकल्पिक MIP सॉल्वर का इस्तेमाल करना
तीसरे पक्ष के इन वैकल्पिक MIP में से किसी एक के साथ भी OR-Tools का इस्तेमाल किया जा सकता है ऐसे सॉल्वर जिनके लिए सहायता पाने की सुविधा डिफ़ॉल्ट रूप से बंद रहती है:
- CPLEX
- GLPK (सिर्फ़ Linux और MacOS के लिए)
- XPRESS सॉल्वर
कृपया इस पर एक नज़र डालें यह दस्तावेज़ देखें.
सोर्स कोड बनाना
सोर्स कोड बनाने के लिए, कोई टर्मिनल खोलें और उस डायरेक्ट्री पर जाएं जहां आपने फ़ाइलें निकाली हों. इसके बाद, OR-Tools को कंपाइल करने के लिए यह कमांड डालें:
cmake --build build --config Release --target ALL_BUILD -j -v
चेकआउट करें CMake दस्तावेज़ देखें.
सोर्स कोड की जांच करना
सब कुछ ठीक से काम कर रहा है या नहीं, यह देखने के लिए आप नीचे दी गई जानकारी डाल सकते हैं:
cmake --build build --config Release --target RUN_TESTS -v
यह OR-टूल के लिए उदाहरण चलाता है. अगर सभी उदाहरण तो आप इसके लिए तैयार हैं OR-Tools का इस्तेमाल शुरू करें.
बिल्ड फ़ाइलों को मिटाया जा रहा है
अगर आपको OR-Tools को फिर से इंस्टॉल करना है, तो कमांड:
rm -r build
इकट्ठा की गई सभी डिपेंडेंसी हटा दी जाएगी. क्लीन स्थिति पर रीसेट करने के लिए यह उपयोगी हो सकता है.
इसके बाद, कमांड दोबारा डालें:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON
cmake --build build --config Release --target ALL_BUILD -j -v
अपने ऑपरेटिंग सिस्टम पर OR-Tools इंस्टॉल करना
अपने ऑपरेटिंग सिस्टम पर OR-Tools इंस्टॉल करने के लिए यह डालें:
cmake --build build --config Release --target install -v