rcextCriaGrafoLic {RcextTools}

Cria um grafo de vencedores e participantes de licitacoes publicas

Description

Utiliza-se um grafo direcionado para representar a relacao entre as empresas participantes das licitacoes, da seguinte forma:

• cada empresa e representada por um no;

• as empresas que participaram de um mesmo certame estarao associadas por relacoes do tipo “perdedor-vencedor”. Tal relacao e representada por uma aresta que se inicia em no representativo da empresa participante perdedora para um no representativo da licitante vencedora.

• o desconto ofertado (diferenca entre o valor estimado e o valor homologado) podera influenciar, de forma inversamente proporcional, o peso das relacoes perdedor-vencedor. Quanto menor o desconto ofertado pelo vencedor, maior sera o peso da referida relacao.

Usage

rcextCriaGrafoLic(dados, tipo_retorno = 0, agregar_arestas = T,
  considerar_desconto = F)

Arguments

dados

data.frame contendo as seguintes colunas:

• CNPJ coluna do tipo character contendo cnpj, com 14 caracteres (sem .,-, ou /), da empresa participante do certame;

• ID_LICITACAO coluna do tipo character que identifica de forma unica o certame;

• ID_ITEM coluna do tipo character que identifica de forma unica o item do objeto a que a empresa esteja concorrendo. Caso o objeto da licitacao nao tenha sido dividido em itens, este campo

• VENCEDOR coluna do tipo logical contendo um valor booleano indicando se o licitante foi vitorioso no certame.

• VALOR_ESTIMADO coluna do tipo numeric correspondente ao valor estimado para o objeto ou serviço sendo licitado. Podera assumir o valor NA caso tal informacao nai esteja disponivel.

• VALOR_HOMOLOGADO coluna do tipo numeric correspondente ao valor homologado da proposta vencedora para o fornecimento do objeto ou serviço sendo licitado. Podera assumir o valor NA caso tal informacao nai esteja disponivel.

tipo_retorno

especifica o objeto a ser retornado pela funcao. As opcoes sao as que se seguem:

• 0 retorna um objeto do tipo environment, contendo um objeto do tipo igraph (grLicitacoes) e um data.frame (dfLicitacoes) a partir do qual o mesmo foi criado. E o valor padrao;

• 1 retorna um objeto do tipo igraph contendo um grafo direcionado de vencedores e participantes de licitacoes;

• 2 retorna um objeto do tipo data.frame a partir do qual podera ser criado um grafo por meio da funcao igraph::graph.data.frame()

agregar_arestas

parametro do tipo logical indicando se arestas repetidas deverao ser agregadas numa unica aresta cujo peso seja as soma dos pesos individuais. Por padrao este parametro tem valor TRUE.

considerar_desconto

parametro do tipo logical indicando se o desconto obtido (diferenca entre o valor homologado e o valor estimado) devera ser levado em consideracao na atribuicao dos pesos das relacoes perdedor-vencedor. Por padrao este parametro tem valor FALSE.

Value

o retorno depende do valor especificado para o parâmetro tipo_retorno.

Author(s)

Bruno M. S. S. Melo

See Also

igraph

Examples

## Not run: 
grafoLic <- rcextCriaGrafoLic(dados = dfDadosLic, tipo_retorno = 0, considerar_desconto = F)

## End(Not run)