Modelos para Medição da Entropia em Cidades Simuladas

Esse projeto tem como objetivo observar como o grau de entropia de uma cidade muda com o passar do tempo, para isso utilizamos diferentes modelos de simulação e analisamos os resultados.

Primeiros passos:

Para criar uma simulação a primeira coisa que você precisa decidir é qual modelo você irá usar, atualmente o projeto tem 3 modelos de simulação:

Simulação 1D:

O modelo 1D tem como objetivo a simulação de uma cidade em um ambiente 1D (uma linha). O programa roda inteiramente pelo terminal.

Simulação 2D Fast:

O modelo 2D fast tem como objetivo a simulação de uma cidade em um ambiente 2D. O programa roda inteiramente pelo terminal.

Simulação 2D com Visualização:

O modelo 2D com Visualização também tem como objetivo a simulação de uma cidade em um ambiente 2D, porém esse modelo permite a visualização dos passos do sistema atráves de uma interface gráfica.

Rodando o programa:

Para conseguir utilizar o programa no seu computador será necessário fazer alguns passos:

Fazer o Download do Repositório
Criar um Ambiente Virtual

É necessário que o você crie um ambiente virtual (é aconselhavel que você o adicione dentro da pasta do programa).
Configurar seu ambiente virtual

É necessário que você garanta que seu ambiente virtual tem instalado as seguintes linguagens/bibliotecas:
- python 3.9 ou superior
- biblioteca matplotlib
- biblioteca numpy
- biblioteca pandas
- biblioteca pygame
...

Documentação

Para ver a documentação do projeto basta clicar nesse link.

Utilizando o programa

Aqui estão alguns exemplos de uso que podem ser úteis.

Preparar um arquivo para simulação

Esse script roda automaticamente quando o arquivo que recebeu sua importação é executado, logo, basta apenas que as pastas sejam configuradas e as importações sejam feitas como demonstrado abaixo para que seja feita a utilização no código.

Importações necessárias:

import Testes.main.recebe_arquivo_original

Configuração das pastas:

├── Entropy
│   ├── Arquivos
│   │   ├── Arquivos_base
│   │   ├── Arquivos_caminhos
│   │   ├── Arquivos_lugares
│   │   ├── Arquivos_originais
│   │   ├── Arquivos_resultados
│   │   └── Arquivos_resultados_ts
│   ...
...

Exemplos de Inputs:

Arquivo do tipo 1 com matriz de 25x25:

Digite o nome, nº de linhas, nº de colunas e tipo do arquivo:
cidadeTal.txt 25 25 1

Arquivo do tipo 2 com matriz de 100x100:

Digite o nome, nº de linhas, nº de colunas e tipo do arquivo:
outraCidade.txt 100 100 2

Fazer uma simulação (fast) com arquivos de Layout utilizando o arquivo de inputs
Como organizar seu arquivo de inputs:
```
1                                                       -> tipo da simulação
0.1 0.1                                                 -> alfa e beta
0.5 0.5                                                 -> C e D agentes
0.5 0.5                                                 -> C e D lugares
2000 2.5                                                -> quantidade de timesteps e FQA
caminho\\onde\\voce\\quer\\guardar\\os\\resultados      -> caminho para a pasta-mãe
nome-da-pasta-que-sera-criada                           -> nome da pasta
arquivo-de-layout(12x12)[tipo_1].txt                    -> a partir daqui arquivos utilizados
arquivo-de-layout-2(12x12)[tipo_2].txt
```
- Tipo da Simulação
Caso a simulação escolhida seja a simulação fast o valor escolhido deve ser "1". Caso a simulação escolhida seja a simulação com saída gráfica o valor escolhido deve ser "2" (ainda a ser implementado).
- Alfa e Beta
Alfa e Beta definem, respectivamente, o peso que a diferença de orientação e a distancia entre agente e lugar terão na escolha do próximo lugar que o agente visitará.
- C e D Agentes
C e D definem, respectivamente, o peso que a orientação atual do agente e a orientação do lugar onde ela se encontra terão no cálculo da próxima orientação do agente.
- C e D Lugares
C e D definem, respectivamente, o peso que a orientação atual do lugar e as orientações dos agentes que se encontram nele terão no cálculo da próxima orientação do lugar.
- Quantidade de TimeSteps e Fator Quantitativo dos Agentes
A quantidade de timesteps indica quantos ciclos a simulação deve ter. O Fator Quantitativo dos Agentes indica o número pelo qual a quantidade de lugares deve ser multiplicada para a descoberta do número total de agentes.
- Caminho para a Pasta-mãe
Caminho relativo até a pasta de destino.
- Nome da Pasta
Nome da pasta que será criada pela simulação (não pode ser uma pasta existente, o programa não sobrescreve uma pasta criada).
- Arquivos de Layout
As últimas linhas devem conter cada uma apenas 1 arquivo que será utilizado para a simulação. Tendo como mínimo 1 arquivo e sem máximo estipulado.
Fazendo a Simulação:

Depois de preenchido o arquivo de input é só rodar o arquivo "Simulacoes.py" e as simulações serão feitas automaticamente.

Organização dos Arquivos