Bem-vindos ao repositório do projeto de software! 🥳

Este repositório concentra toda a base de código que será usado nesta seletiva. Nele, estão disponibilizados tanto o ambiente simulado para testar o código desenvolvido quanto o arquivo base para o desenvolvimento, no qual deverão ser integradas as mudanças que forem feitas. O projeto consiste em desenvolver formas de solucionar os problemas de planejamento de trajetória e de atribuição de tarefas para os agentes do ambiente. Para mais detalhes do projeto, reveja o documento de especificação no nosso site: https://www.robocin.com.br/seletiva.

Dependências

• Python versão 3.10.x
• Git
• Pygame
• Gymnasium versão 0.29.1
• Protobuf versão 3.20
• rSoccer
• PyVirtualDisplay versão 3.0 ou acima
• MoviePy versão 1.0.0 ou acima
• Numpy versão 1.21.2
• Argparse

Exceto o Python e o Git, as dependências podem ser instaladas com:

  pip install -r requirements.txt

Caso a sua versão do Python não seja a correta, esse tutorial explica como instalar a versão correta no Linux.

Instalação

Linux

1. Crie um fork desse repositório.

2. Clone o repositório.

  git clone https://github.com/NomeDoUsuario/software-project.git

3. Entre na diretório do repositório clonado.

  cd software-project

4. Dentro da pasta, use o comando de instalação das dependências.

  pip install -r requirements.txt

Windows (WSL)

Será necessário usar o WSL (Windows Subsystem for Linux) para ser capaz de rodar o projeto no Windows.

1. Instale o WSL. Esse tutorial explica como instalar o WSL, o Python e como fazer a integração com o Visual Studio Code.

2. Crie um fork desse repositório.

3. Clone o repositório.

  git clone https://github.com/NomeDoUsuario/software-project.git

4. Entre na diretório do repositório clonado.

  cd software-project

5. Dentro da pasta, use o comando de instalação das dependências.

  pip install -r requirements.txt

MacOS

1. Instale o Homebrew e a versão do Pyenv para instalação do Python

  brew install pyenv
  pyenv install 3.10
  pyenv global 3.10

2. Crie um fork desse repositório.

3. Clone o repositório.

  git clone https://github.com/NomeDoUsuario/software-project.git

4. Entre na diretório do repositório clonado.

  cd software-project

5. Instale a ODE (Open Dynamics Engine)

  brew install ode

6. Dentro da pasta, use o comando de instalação das dependências.

  pip install -r requirements.txt

⚠️ OBS: Para rodar no macOS com a configuração acima, utilize o comando python3.10 ao invés de python3 no passo a passo a seguir.

Tudo pronto para rodar o projeto! 🚀

Como rodar?

Para rodar, basta executar o arquivo start.py.

  python3 start.py

Como o projeto possui 4 fases, é possível escolher qual fase rodar utilizando a flag -d com o argumento de dificuldade, que vai de 1 a 4:

  python3 start.py -d [DIFICULDADE]

Para tirar dúvidas, use o comando com a flag -h:

  python3 start.py -h

⚠️ OBS: Caso a instalação das dependências não tenha sido feita em um ambiente virtual e os comandos para rodar não estejam funcionando, tente usar python3.10 ao invés de python3. ⚠️ OBS: Caso tenha problemas com a instalação das dependências do pacote rc-robosimou de CMAKE no ambiente Linux, experimente atualizar o sistema de pacotes do sistema e reinstalar a biblioteca ODE (Open Dynamics Engine) com os comandos:

  sudo apt update
  sudo apt upgrade
  sudo apt install libode-dev