MacOS पर सोर्स OR-टूल Python से बनाना

परिचय

इस गाइड में, सोर्स 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 का इस्तेमाल किया जा सकता है ऐसे सॉल्वर जिनके लिए सहायता पाने की सुविधा डिफ़ॉल्ट रूप से बंद रहती है:

कृपया इस पर एक नज़र डालें यह दस्तावेज़ देखें.

सोर्स कोड बनाना

सोर्स कोड बनाने के लिए, कोई टर्मिनल खोलें और उस डायरेक्ट्री पर जाएं जहां आपने फ़ाइलें निकाली हों. इसके बाद, 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