ratiodiagram                package:nenhum               R Documentation

~~Diagrama de Proporção~~

Description:

Ilustra as relações proporcionais entre as médias e o erro padrão de diferentes grupos. 

Usage:

    ratiodiagram (x, ngrupos, na.rm=TRUE) 

Arguments:

x	   matriz ou data frame contento na primeira coluna os grupos que serão comparados, e nas colunas seguintes as variáveis que serão utilizadas na comparação dos grupos. 
name	   nome no qual a figura será exportada para a área de trabalho.	
ngrupos    número de grupos existentes no objeto x. O número de grupos existentes deve ser maior que um, senão não será executada a computação. 
na.rm      valor lógico que indica se os valores de NA devem ser removidos antes que computação prossiga.
erro=TRUE  indica se as barras do erro padrão da média devem ser plotadas no gráfico.

Details:

     Relações proporcionais entre as médias das variáveis de diferentes combinações de grupos são frequentemente utilizados, e podem ser ilustrados através de diagramas de razão. Essa função facilita a construção desses diagramas, sendo o objeto de entrada uma matriz de variáveis contínuas para diferentes grupos os quais se deseja comparar. Para cada amostra são calculados o valor absoluto da média de cada variável e o valor destas médias +/- duas vezes o erro padrão da média, e então estes três valores calculados são logaritmizados. Em seguida, o logaritmo da média da amostra padrão, ou seja, aquela à qual as outras serão comparadas, é subtraído dos logaritmos da média e dos valores de média +/- duas vezes o erro padrão de cada uma das outras amostras. As medidas maiores do que da amostra padrão são representados por valores positivos, as medidas menores por valores negativos. Linhas irão conectar as médias das variáveis de cada amostra e barras horizontais representarão +/- duas vezes o desvio padrão da média. A logaritmização dos dados elimina a distorção causada pelas diferenças de escala entre as variáveis, permitindo que todas sejam comparadas simultaneamente e de maneira proporcional entre os grupos. Quanto mais próximas as linhas de cada amostra, maior a similaridade entre as médias de suas variáveis. O objeto de saída é um diagrama de razão com a comparação entre os diferentes grupos.

Value:

A função ratiodiagram retorna o seguinte resultado:

grafico   Gráfico com as proporções das médias em imagem no formato TIFF
     

Warning:

Os grupos são organizados em ordem alfabética durante a computação e sempre o último grupo da lista será usado como a amostra padrão, à qual os outros grupos serão comparados.


Author(s):

Joyce Rodrigues do Prado

References:

MUSSER, G.G.; CARLETON, M.D.; BROTHERS, E.; GARDNER, A.L. Systematic studies of Oryzomyine rodents (Muridae, Sigmodontinae): diagnoses and distributions of species formerly assigned to Oryzomys “capito”. Bulletin of the American Museum of Natural History, New York, v. 236, p. 1-376, 1998.

SIMPSON, G.G. Large Pleistocene Felines of North America. American Museum Novitates, New York, v. 1136, p.1-27, 1941.


Examples:

#Para rodas os exemplos a seguir é necessário carregar o arquivo teste
dados<- read.table("teste.csv", header = TRUE,sep = ",")
ratiodiagram (teste)
ratiodiagram (teste, ngrupos, na.rm=FALSE)
ratiodiagram (teste, name="plot.tif", erro=FALSE)