Type: Package
Title: Analytical Procedures in Support of Brazilian Public Sector External Auditing
Version: 0.1.1
Author: Bruno M. S. S. Melo
Maintainer: Bruno Melo <ctbrunomelo@gmail.com>
Description: Set of analytical procedures based on advanced data analysis in support of Brazil's public sector external control activity.
Imports: data.table, igraph, sqldf, visNetwork
License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
URL: http://github.com/brunomssmelo/RcextTools/
Encoding: UTF-8
LazyData: true
RoxygenNote: 6.0.1
NeedsCompilation: no
Packaged: 2017-09-05 04:58:14 UTC; bruno
Depends: R (≥ 2.10)
Repository: CRAN
Date/Publication: 2017-09-05 05:04:20 UTC

Identifica potenciais mercados de risco de praticas colusivas a partir de grafo de licitacoes

Description

Identifica potenciais mercados de risco de praticas colusivas a partir de grafo de licitacoes

Usage

TipologiaRodizio(dados, considerarDesconto = 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.

considerarDesconto

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 TRUE

Value

objeto S3 da classe TipologiaRodizio, contendo os seguintes atributos:

Author(s)

Bruno M. S. S. Melo

See Also

igraph

Examples

## Not run: 

 # carrega dados de licitacoes da base fornecida pelo pacote RcextTools
 data("part_lic")

 dtDados <- part_lic[!is.na(part_lic$COD_LICITACAO),]

 dtDados <- data.frame(
   CNPJ = dtDados$CNPJCPF_FORNECEDORES,
   ID_LICITACAO = dtDados$COD_LICITACAO,
   ID_ITEM = dtDados$ID_ITEM,
   VENCEDOR = ifelse(dtDados$VENCEDOR == 'S', T, F),
   VALOR_ESTIMADO = NA,
   VALOR_HOMOLOGADO = as.numeric(dtDados$VALOR_FINAL),
   DESC_OBJETO = dtDados$RESUMO_OBJETO,
   stringsAsFactors = F
 )

 casosSuspeitos <- TipologiaRodizio(dtDados)

 # imprime dataframe com resultados
 print(casosSuspeitos)

 # plota grafo
 plot(casosSuspeitos)

## End(Not run)

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:

Usage

TipologiaRodizioCriaGrafo(dados, tipoRetorno = 0, agregarArestas = T,
  considerarDesconto = 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.

tipoRetorno

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()

agregarArestas

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.

considerarDesconto

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 tipoRetorno.

Author(s)

Bruno M. S. S. Melo

See Also

igraph

Examples

## Not run: 
grafoLic <- TipologiaRodizioCriaGrafo(dados = dfDadosLic, tipoRetorno = 0, considerarDesconto = F)

## End(Not run)

Identifica potencias mercados de risco de praticas colusivas a partir de grafo de licitacoes

Description

Identifica potencias mercados de risco de praticas colusivas a partir de grafo de licitacoes

Usage

TipologiaRodizioMetodologiaGrafo(grLicitacoes)

Arguments

grLicitacoes

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

Value

objeto do tipo environment, contendo os seguintes objetos:

Author(s)

Bruno M. S. S. Melo

See Also

igraph

Examples

## Not run: 
grafoLic <- TipologiaRodizioMetodologiaGrafo(grLicitacoes)

## End(Not run)

Metodo S3 que retorna a representacao rm 'data.frame' de um objeto da classe TipologiaRisco

Description

Este metodo simplesmente retorna o atributo 'tabela' de um objeto da classe TipologiaRisco.

Usage

## S3 method for class 'TipologiaRodizio'
as.data.frame(x, ...)

Arguments

x

objeto da classe 'TipologiaRodizio'.

...

eventuais argumentos adicionais.

Author(s)

Bruno M. S. S. Melo

Examples

## Not run: 
casosSuspeitos <- TipologiaRodizio(dados)
dfCasosSuspeitos <- as.data.frame.TipologiaRodizio(casosSuspeitos)

## End(Not run)

Dados de contratos relativos a base de licitacoes realizadas por orgaos de um ente federativo brasileiro no periodo de 2011 a 2015

Description

IMPORTANTE: Todos os campos que pudessem identificar o ente federativo, orgaos, empresas e certames tiveram seus valores alterados e embaralhados.

Usage

data(contratos)

Format

Um data frame contendo 127449 registros de 15 campos.

Details

contratos - Dados relativos aos contratos resultantes das licitacoes.

Um data frame contendo 127449 registros de 15 campos.

Os campos cujos valores foram alterados estao identificados por um asteristico (*):


Dados de licitacoes realizadas por orgaos de um ente federativo brasileiro no periodo de 2011 a 2015

Description

IMPORTANTE: Todos os campos que pudessem identificar o ente federativo, orgaos, empresas e certames tiveram seus valores alterados e embaralhados.

Usage

data(licitacoes)

Format

Um data frame contendo 8679 registros de 10 campos.

Details

Um data frame contendo 8679 registros de 10 campos.

Os campos cujos valores foram alterados estao identificados por um asteristico (*):


Dados relatvos aos participantes de licitacoes realizadas por orgaos de um ente federativo brasileiro no periodo de 2011 a 2015

Description

IMPORTANTE: Todos os campos que pudessem identificar o ente federativo, orgaos, empresas e certames tiveram seus valores alterados e embaralhados.

Usage

data(part_lic)

Format

Um data frame contendo 427242 registros de 13 campos.

Details

Um data frame contendo 427242 registros de 13 campos.

part_lic - Dados relativos aos participantes das licitacoes.

Os campos cujos valores foram alterados estao identificados por um asteristico (*):


Metodo S3 que plota na tela uma representacao visual do grafo do tipo 'igraph' contido no objeto da classe 'TipologiaRodizio'

Description

Os diferentes agrupamentos representam empresas suspeitas de praticarem alguma acao colusiva num determinado mercado. As arestas apontam na direcao de um perdedor para um vencedor de licitacao. Empresas sao sempre perdedoras sao representadas por quadrados cinzas.

Usage

## S3 method for class 'TipologiaRodizio'
plot(x, ...)

Arguments

x

objeto da classe 'TipologiaRodizio'.

...

eventuais parametros adicionais.

Author(s)

Bruno M. S. S. Melo

Examples

## Not run: 
casosSuspeitos <- TipologiaRodizio(dados)
plot(casosSuspeitos)

## End(Not run)

Metodo S3 que imprime na tela um data.frame que representa um objeto da classe 'TipologiaRodizio'

Description

Metodo S3 que imprime na tela um data.frame que representa um objeto da classe 'TipologiaRodizio'

Usage

## S3 method for class 'TipologiaRodizio'
print(x, ...)

Arguments

x

objeto da classe 'TipologiaRodizio'

...

eventuais parametros adicionais.

Author(s)

Bruno M. S. S. Melo

Examples

## Not run: 
casosSuspeitos <- TipologiaRodizio(dados)
print(casosSuspeitos)

## End(Not run)

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:

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)

Identifica potencias mercados de risco de praticas colusivas a partir de grafo de licitacoes

Description

Identifica potencias mercados de risco de praticas colusivas a partir de grafo de licitacoes

Usage

rcextRiscoAcaoColusivaAux(grLicitacoes)

Arguments

grLicitacoes

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

Value

objeto do tipo environment, contendo os seguintes objetos:

Author(s)

Bruno M. S. S. Melo

See Also

igraph#' @importFrom igraph walktrap.community

Examples

## Not run: 
grafoLic <- rodizioMetodologiaGrafoPageRank(grLicitacoes)

## End(Not run)