Introduzione
Questa guida spiega come creare strumenti OR-Strumenti di origine con supporto per Python su MacOS.
A meno che tu non abbia intenzione di modificare il codice sorgente o di utilizzare un risolutore di terze parti con OR-Strumenti, ti consigliamo l'installazione del pacchetto.
Sebbene queste istruzioni possano funzionare anche su altre varianti di macOS, le abbiamo testate solo su macchine che soddisfano i seguenti requisiti:
- MacOS 13.0.1 (Ventura) Intel a 64 bit (x86_64)
- MacOS 13.0.1 (Ventura) M1 (arm64)
Prerequisiti
Le seguenti sezioni descrivono i prerequisiti per l'installazione di OR-Strumenti.
Strumenti a riga di comando Xcode
Devi installare gli strumenti a riga di comando Xcode. Per farlo, apri il Terminale, che trovi in /Applications/Utilities/
, e inserisci:
xcode-select --install
Fai clic su "Installa" per scaricare e installare gli strumenti a riga di comando Xcode. Non è necessario "Ottieni Xcode" dall'App Store. Se la tua connessione a internet è lenta, l'operazione potrebbe richiedere diversi minuti.
Verifica di aver installato correttamente gli strumenti a riga di comando Xcode:
xcode-select -p
Dovresti vedere:
/Library/Developer/CommandLineTools
Birreria artigianale
Per installare i prerequisiti rimanenti, ti consigliamo di installare prima il "gestore di pacchetti mancante per macOS", noto come Homebrew. Per farlo, apri una finestra del terminale e inserisci:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update
Per verificare di aver installato correttamente il caffè:
brew --version
Dovresti vedere:
Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)
Strumenti C++
Per installare gli strumenti C++, apri una finestra del terminale e inserisci:
brew install cmake wget pkg-config
Strumento SWIG
Per installare lo strumento SWIG, apri una finestra del terminale e inserisci:
brew install swig
Python
Devi avere installato Python 3.8 o versioni successive.
Per installare Python 3.8+, apri una finestra del terminale e inserisci:
brew install python
python3 -m pip install -U --user wheel six
Verifica quindi l'installazione:
python3 --version
python3 -c "import platform; print(platform.architecture()[0])"
python3 -m pip --version
Scarica il codice sorgente
Ci sono due rami distinti del codice sorgente OR-Tools su
GitHub: stable
e main
.
Il ramo stable
è stato testato in modo approfondito e dovrebbe funzionare perfettamente su tutte
le piattaforme supportate.
Nel ramo main
sono stati applicati gli ultimi aggiornamenti e miglioramenti. È più attuale, ma meno stabile.
Scarica il codice sorgente stabile
Puoi ottenere il codice sorgente stabile per OR-Tools in uno dei seguenti modi:
Clona il ramo
stable
inserendo:git clone https://github.com/google/or-tools
Scarica la release più recente in un file compresso facendo clic sul pulsante
Clone or download
in GitHub.
Scaricare il codice sorgente principale
Per recuperare il codice sorgente dal ramo main
, inserisci:
git clone -b main https://github.com/google/or-tools
Scaricare le release precedenti
Puoi ottenere il codice sorgente delle release precedenti in uno dei seguenti modi:
- Scaricare una release precedente dalla pagina di rilascio di GitHub.
Supponendo che tu abbia già creato un repository locale (entro il giorno
git clone
), puoi controllare una release specifica utilizzando un tag Git. Ad esempio, per lavorare con la release v9.10 anziché il ramomain
, inserisci i seguenti comandi nel repository locale:git fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10
Configura la build
Prima di creare OR-Tools, devi configurare il generatore di sistema di compilazione CMake.
Apri un terminale e vai alla directory in cui hai estratto i file. Inserisci quindi:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON
Per i dettagli, consulta la documentazione di CMake.
Utilizzo di SCIP
Dalla versione 7.8, SCIP è integrato in modo da non doverlo installare manualmente.
Utilizzo di Gurobi
Ora Gurobi è preintegrato. Se necessario, in fase di runtime, OR-Tools cercherà la libreria condivisa Gurobi nel percorso di installazione predefinito dei programmi di installazione di Gurobi su MAC OS X e Windows oppure utilizzando la variabile di ambiente GUROBI_HOME
.
Utilizzo di un risolutore MIP di terze parti facoltativo
Puoi anche utilizzare OR-Tools con uno dei seguenti risolutori MIP di terze parti facoltativi il cui supporto è disattivato per impostazione predefinita:
- CPLEX
- GLPK (solo Linux e MacOS)
- Risolutore XPRESS
Per informazioni dettagliate, consulta questa documentazione.
Crea il codice sorgente
Per creare il codice sorgente, apri un terminale e vai alla directory in cui hai estratto i file. Quindi inserisci il seguente comando per compilare OR-Strumenti:
cmake --build build --config Release --target ALL_BUILD -j -v
Per i dettagli, consulta la documentazione di CMake.
Testare il codice sorgente
Puoi verificare che tutto funzioni correttamente inserendo:
cmake --build build --config Release --target RUN_TESTS -v
Vengono eseguiti esempi per OR-Tools. Se tutti gli esempi vengono eseguiti correttamente, puoi iniziare a utilizzare OR-Strumenti.
Pulizia dei file di build
Se devi reinstallare OR-Strumenti, il comando:
rm -r build
rimuove tutte le dipendenze compilate. Questo può essere utile per ripristinare lo stato originale.
Quindi, inserisci di nuovo i comandi:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON
cmake --build build --config Release --target ALL_BUILD -j -v
Installazione di OR-Strumenti sul sistema operativo
Puoi installare OR-Tools per Python sul tuo sistema operativo inserendo:
cmake --build build --config Release --target install -v