contagem                package:unknown                R Documentation

Contagem de ocorrências de índices

Descrição:

Cria um data.frame com os valores totais de ocorrência de fatores (índices) de um data.frame de dados textuais.

Uso:

contagem(data, index, save.file=FALSE)

Argumentos:

data		um data.frame de fatores.
index		um vetor contendo os índices que serão contabilizados pela função. Os valores de index são as posições das colunas em data. 
save.file	lógico. Se "TRUE", salva o data.frame gerado pela função no diretório de trabalho.

Detalhes:

"Contagem” é útil para resumir os dados de planilhas textuais. Ela foi pensada com o intuito de organizar e contabilizar dados de coleções biológicas, mas poderá ser usada em qualquer data.frame.
Se os argumentos data e index não forem das classes requeridas pela função, a função para e retorna um aviso de erro.
Os dados de data serão tratados como fatores e sua frequência será contabilizada de acordo com os índices (colunas) apontados no argumento index.
Os valores de index equivalem às colunas de data cujas ocorrências combinadas serão contabilizadas. O número de elementos de index não pode ultrapassar o número de colunas de data. Se isso acontecer, a função para e retorna um aviso de erro.
Os espaços vazios em data serão considerados um dos fatores da coluna a qual pertencem, combinados e contados.
As ocorrências cujas fequência for 0 (zero) não serão listadas no data.frame resultante.

Valores:

Com contagem o usuário tem a opção de retornar um arquivo "Contagem.csv" com resultados das contagens dos índices em ordem decrescente.

Avisos:

Caso o número de elementos em index seja muito grande, a função poderá levar alguns segundos para rodar.

Autor(s):

Érika Marques de Santana (erika.ms@gmail.com)

Exemplos:

cidades = c("Santos","São Paulo","Boracéia","Cubatão")
coletores = c("Ana","Paulo","João", "Sofia")
sp = sample(LETTERS, 10, replace=TRUE)
tabela = data.frame(especie=sample(sp, 100, replace=TRUE), localidade=sample(cidades, 100, replace=TRUE), coletor=sample(coletores, 100, replace=TRUE))
contagem(tabela, index=c(2,3), save.file=TRUE)
contagem(tabela, index=c(2,3), save.file=FALSE)
contagem(tabela, index=c(1,2))