Como criar da origem OR ferramentas Python no MacOS

Introdução

Este guia explica como criar a partir de ferramentas OR de origem, com suporte para Python, no MacOS.

A menos que você pretenda modificar o código-fonte ou usar um solucionador de terceiros com ferramentas OR, recomendamos a instalação do pacote (link em inglês).

Embora essas instruções também possam funcionar em outras variantes do MacOS, as testamos apenas em máquinas que atendem aos seguintes requisitos:

  • MacOS 13.0.1 (Ventura) Intel 64 bits (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

Pré-requisitos

As seções a seguir descrevem os pré-requisitos para instalar as Ferramentas OU.

Ferramentas de linha de comando do Xcode

É necessário instalar as ferramentas de linha de comando do Xcode. Para fazer isso, abra o terminal, encontrado em /Applications/Utilities/, e insira:

xcode-select --install

Clique em "Instalar" para fazer o download e instalar as ferramentas de linha de comando do Xcode. Não é necessário "Obter Xcode" na App Store. Se sua conexão com a Internet for lenta, isso pode levar alguns minutos.

Verifique se você instalou as ferramentas de linha de comando do Xcode:

xcode-select -p

Você vai ver:

/Library/Developer/CommandLineTools

Homebrew

Para instalar os pré-requisitos restantes, recomendamos primeiro instalar o "gerenciador de pacotes ausente para macOS", conhecido também como Homebrew. Para fazer isso, abra uma janela de terminal e digite:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

Para verificar se você instalou o brew corretamente:

brew --version

Você vai ver:

Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)

Ferramentas C++

Para instalar ferramentas C++, abra uma janela do terminal e digite:

brew install cmake wget pkg-config

Ferramenta SWIG

Para instalar a ferramenta SWIG, abra uma janela do terminal e digite:

brew install swig

Python

Você precisa ter o Python 3.8+ instalado.

Para instalar o Python 3.8+, abra uma janela do terminal e digite:

brew install python
python3 -m pip install -U --user wheel six

Em seguida, verifique a instalação:

python3 --version
python3 -c "import platform; print(platform.architecture()[0])"
python3 -m pip --version

Faça o download do código-fonte

Há duas ramificações distintas do código-fonte OR-Tools no GitHub: stable e main.

A ramificação stable foi testada e funciona perfeitamente em todas as plataformas com suporte.
A ramificação main é onde as atualizações e melhorias mais recentes foram aplicadas. Ela é mais atual, mas menos estável.

Fazer o download do código-fonte estável

É possível obter o código-fonte estável para OR-Tools de uma das seguintes maneiras:

  • Clone a ramificação stable digitando:

    git clone https://github.com/google/or-tools

  • Faça o download da versão mais recente em um arquivo compactado clicando no botão Clone or download no GitHub. imagem de um clone ou botão de download

Fazer o download do código-fonte principal

Para recuperar o código-fonte da ramificação main, digite:

git clone -b main https://github.com/google/or-tools

Fazer o download de versões anteriores

É possível conseguir o código-fonte de versões anteriores de uma das seguintes maneiras:

  • Faça o download de uma versão anterior na página de versão do GitHub.

  • Supondo que você já tenha criado um repositório local (por git clone), confira uma versão específica usando uma tag do Git. Por exemplo, para trabalhar com a versão v9.9 em vez da ramificação main, insira os seguintes comandos no seu repositório local:

    git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9

Configure o build

Antes de criar ferramentas OR, configure o gerador do sistema de build do CMake.

Abra um terminal e navegue até o diretório onde você extraiu os arquivos. Em seguida, insira o seguinte comando:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON

.

Confira a documentação do CMake para mais detalhes.

Como usar o SCIP

Desde a v7.8, o SCIP agora está integrado para que você não precise instalá-lo manualmente.

Como usar o Gurobi

O Gurobi agora está pré-integrado. Quando necessário, no ambiente de execução, as ferramentas OR vão procurar a biblioteca compartilhada Gurobi no caminho de instalação padrão dos instaladores do Gurobi no MAC OS X e no Windows ou usando a variável de ambiente GUROBI_HOME.

Como usar um solucionador MIP de terceiros opcional

Também é possível usar ferramentas OU com qualquer um dos seguintes solucionadores de MIP de terceiros opcionais com suporte desativado por padrão:

Consulte esta documentação para mais detalhes.

Criar o código-fonte

Para criar o código-fonte, abra um terminal e navegue até o diretório em que você extraiu os arquivos. Insira o seguinte comando para compilar ferramentas OR:

cmake --build build --config Release --target ALL_BUILD -j -v

Confira a documentação do CMake para mais detalhes.

Testar o código-fonte

Você pode verificar se tudo está funcionando corretamente inserindo:

cmake --build build --config Release --target RUN_TESTS -v

Isso executa exemplos de ferramentas OU. Se todos os exemplos forem executados com sucesso, você estará pronto para começar a usar as ferramentas OR.

Como limpar os arquivos de build

Se você precisar reinstalar o OR-Tools, o comando:

rm -r build

vai remover todas as dependências compiladas. Isso pode ser útil para redefinir para um estado limpo.

Em seguida, insira os comandos novamente:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON


cmake --build build --config Release --target ALL_BUILD -j -v

Como instalar o OR-Tools em seu sistema operacional

Você pode instalar OU-Tools para Python em seu sistema operacional digitando:

cmake --build build --config Release --target install -v