Como criar usando a origem OR ferramentas Python no Windows

Introdução

Este guia explica como criar a partir do código OR-Tools, com suporte para Python no Windows.

A menos que você planeje modificar o código-fonte ou usar um solucionador de terceiros com OR-Tools, recomendamos a instalação do pacote.

Embora essas instruções também possam funcionar em outras variantes do Windows, nós os testou apenas em máquinas que atendem aos seguintes requisitos:

Windows 10 de 64 bits (x86_64) com:

  • Microsoft Visual Studio Enterprise 2022
  • Microsoft Visual Studio Community 2022 Preview 2 ou mais recente

Pré-requisitos

As seções a seguir descrevem os pré-requisitos para instalar o OR-Tools.

Visual Studio

Para criar e executar as ferramentas OR no Windows, você precisa ter o Visual Studio 2022 ou instalado no computador com o conjunto de ferramentas C++ para o Visual Studio.

Veja mais detalhes aqui.

Para criar programas OR-Tools na linha de comando, você precisa usar uma Prompt de comando de ferramentas nativas x64 (não do prompt de comando do desenvolvedor).

Veja mais detalhes aqui.

Git

Git, que pode ser baixado de https://git-scm.com/.

CMake

CMake (>= 3.18). Faça o download dele no https://www.cmake.org/download. Ao instalar o CMake, selecione a opção para um cmake acessível por linha de comando.

Python

Você precisa ter uma das seguintes versões do Python instalada:

Em seguida, verifique se o PIP 9.01 ou mais recente está disponível no seu PATH:

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

Faça o download do código-fonte

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

A ramificação stable foi totalmente testada e vai funcionar sem falhas em todos plataformas com suporte.
A ramificação main é onde as atualizações e melhorias foram aplicadas. é mais atual, mas menos estável.

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

Você pode obter o código-fonte estável para as ferramentas OR de uma das seguintes maneiras:

  • Clone a ramificação stable digitando:

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

  • Baixe a versão mais recente em um arquivo compactado, clicando no Botão Clone or download no GitHub. imagem do botão de clone ou download

.

Fazer o download do código-fonte principal

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

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ões do GitHub.

  • Supondo que você já tenha criado um repositório local (por git clone), é possível conferir uma versão específica usando Tag. Por exemplo, para trabalhar com a versão v9.10 em vez da main, insira os seguintes comandos no repositório local:

    git fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10

Configure o build

Antes de criar o OR-Tools, você precisa configurar o sistema de build CMake gerador.

Abra um terminal e navegue até o diretório de 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 versão 7.8, o SCIP agora está integrado para que você não precise instalá-lo manualmente.

Como usar o Gurobi

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

Como usar um solucionador MIP de terceiros opcional

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

Consulte o 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. Depois, digite o seguinte comando para compilar as 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

Para verificar se tudo está funcionando corretamente, insira:

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

Isso executa exemplos para o OR-Tools. Se todos os exemplos forem executados com sucesso, está tudo pronto começar a usar o OR-Tools.

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 na redefinição para um estado limpo.

Em seguida, insira novamente os comandos:

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 no seu sistema operacional

Para instalar o OR-Tools for Python no sistema operacional, digite:

cmake --build build --config Release --target INSTALL -v