Universidade Federal de Ouro Preto - UFOP
Departamento de Ciência da Computação - DECOM

Simulação de coleta de dados em redes de sensores sem fio por robôs móveis utilizando a ferramenta Player Stage.

Gabriel Angelo Nazário
dúvidas: gabrielnazario25@gmail.com

Ouro Preto, Novembro de 2012

-------------------------------------------------
DIRETÓRIOS
Diretório ColetaDeDados: contém o código-fonte utilizado para as simulações de coleta em RSSF utilizando robôs móveis, scripts usados para rodar os experimentos, arquivos para compilação, arquivos de entrada dos sensores, saída gerada após as simulações.
	-> /bitmaps: imagens usadas para gerar desenhos no mapa, especialmente para gerar obstáculos. Neste trabalho, como não existem obstáculos, a imagem usada é vazia, sem desenhos.
	-> /build, /CMakeFiles, /nbprojects: diretórios de configuração e compilação de arquivos. Mais adiante será explicado como compilar os arquivos para uma nova simulação.
	-> /entrada: arquivos de entrada, descrevendo os sensores presentes na simulação.
	-> /graficos: tabelas com as médias de tempo e perda, comparações entre as heurísticas de planejamento e Student's t-test dos resultados.
	-> /include, /src: código-fonte.
	-> /saida: saída gerada após as simulações, com os resultados de tempo total de coleta e perda de dados.

-------------------------------------------------
ARQUIVOS DE ENTRADA:
Nomenclatura: #sensores_distribuição_tipoCarga

-> #sensores: 9, 16, 25, ..., 100.
-> distribuição: 1 = aleatoria 1, 2 = aleatoria 2, ..., 25 = aleatoria 25, 26 = regular.
-> tipoCarga: 1 = buffer alto, taxa igual; 2 = buffer alto, taxa dobro; 3 = buffer baixo, taxa igual; 4 = buffer baixo, taxa dobro.

Cada linha descreve as características de um nó sensor, com seu identificador, posição, tamanho do raio de comunicação, taxa de aquisição de dados e tamanho de buffer de memória. Por exemplo a linha
"1 -30 -4 10 1 556"
indica que o sensor número 1 está na posição x = -30, y = -4, possui raio de comunicação de tamanho 10, taxa de produção de dados 1 unidade por segundo, e tamanho de buffer 556.

-------------------------------------------------
ARQUIVOS DE SAÍDA:
Nomenclatura: tipoPlanejamento_nomeArquivoEntrada

-> tipoPlanejamento: 1 = Caixeiro Viajante (CV) sem considerar taxas de produção de dados nem vizinhança.
		  2 = CV considerando apenas taxas de prod. de dados, mas não vizinhança.
		  3 = CV sem considerar taxas de produção de dados, apenas vizinhança.
		  4 = CV considerando taxas de produção de dados e vizinhança.

A primeira linha do arquivo indica o tempo total da coleta e a perda total de dados, respectivamente. As demais linhas indicam o momento (em segundos a partir do início da simulação) em que o nó sensor teve seus dados coletados pelo robô, e a quantidade de dados que esse nó perdeu até o momento da coleta. Por exemplo a linha
"5 661 105"
indica que o nó sensor número 5 teve seus dados coletados pelo robô aos 661 segundos de coleta, e perdeu até esse momento 105 unidades de dados.

-------------------------------------------------
COMPILAÇÃO
Para compilar pela primeira vez: no diretório ColetaDeDados/build, remova todo os arquivos de lá e execute:
cmake ..

Volte para o diretório ColetaDeDados e execute: 
sh bc.sh

Para cada quantidade de nós sensores, é preciso mudar a diretiva TARGETNUMBER para a quantidade desejada. Basta mudar o valor do TARGETNUMBER em ColetaDeDados/include/AuctionConsts.h e recompilar o projeto, voltando para o diretório ColetaDeDados e executando: 
sh bc.sh

-------------------------------------------------
EXECUÇÃO
Após compilado, o Stage deve ser executado com os argumentos abaixo.

Chamada na linha de comando para execução de uma simulação:
stage --gui --args "arqEntrada arqSaida planejamento" arquivo.world
Argumentos:
-> --gui: para desabilitar a interface gráfica. Caso seja necessário ver a interface gráfica da simulação, basta retirar esse argumento.

-> --args: argumentos passados para o Stage. Deve ser passados obrigatoriamente entre aspas duplas.

-> arqEntrada: arquivo com a descrição dos nós sensores presentes na simulação. São os arquivos presentes no diretório ColetaDeDados/entrada

-> arqSaida: onde será gerado o arquivo de saída com os resultados da simulação. Caso o arquivo não exista, ele será criado; caso o arquivo já exista, o resultado será adicionado ao final do seu conteúdo pré-existente. 

-> planejamento deve ser uma das seguintes strings:
	planejamento_1 : CV sem considerar taxas de produção de dados nem vizinhança.
	planejamento_2 : CV considerando apenas taxas de prod. de dados, mas não vizinhança.
	planejamento_3 : CV sem considerar taxas de produção de dados, apenas vizinhança.
	planejamento_4 : CV considerando taxas de produção de dados e vizinhança.

-> arquivo.world: arquivo que descreve o que está presente na simulação. Neste arquivo é possível descrever o robô e demais itens que se queira que estejam presentes no mundo de simulação.

Exemplo de chamada ao Stage para uma simulação com 9 nós sensores:
stage --gui --args "entrada/9_1_1.txt saida/1_9_1_1.txt planejamento_1" leilao.world


