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.
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.
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
-
...
Para ver a documentação do projeto basta clicar nesse link.
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.
-
Nomeando Elementos Definições comuns a todos os nomes:
- Utilizar nomes que indiquem facilmente a finalidade da variável, função, classe ou arquivo.
- O uso de números (como enumeração) deve ser feito ao final do nome.
- Não utilizar caracteres especiais ou acentos ortográficos.
- Nenhum nome deve conter espaços entre as palavras.
Nomenclatura das variáveis (Em andamento):
- Separação das palavras por "_".
- Utilização apenas de letras minúsculas.
- Caso a variável seja uma tupla, lista, matriz, dicionário ou set a primeira palavra do nome deve ser respectivamente, tupl, list, mtrx, dict ou set.
- Exemplo:
- nome_da_variavel
- variavel_2
- tupl_outra_variavel
Nomenclatura das funções (Em andamento):
- Separação das palavras por "_".
- Capitalização das palavras, exceto pela primeira palavra. (A primeira letra de cada palavra deve ser maiúscula e todas as outras minúsculas).
- Exemplo:
- nome_Da_Funcao
- funcao_1
Nomenclatura das Classes (Em andamento):
- Separação das palavras por Camelcase.
- Primeira palavra inicia com letra maiúscula.
- Exemplo:
- ClasseExemplo
- ExemploDeClasse3
- Classe4
Nomenclatura dos Arquivos (Em andamento):
- A primeira palavra deve indicar que tipo de arquivo é:
- Arquivo de Classes: "Classe".
- Arquivo de Funções: "funcoes".
- Arquivo de configuração de Gráficos: "graficos".
- Arquivo de configuração de Simulações: "simulacao".
- Arquivo de Testes: "teste"/"testes".