catetomap{}				Package: unknown			R Documentation

Calcula uma matriz de coordenadas x,y e plota os pontos em um desenho (mapa)

Description:

Calcula as coordenadas x de pontos a partir da dist�ncia dos pontos at� uma linha principal (coordenadas y) e a dist�ncia diagonal entre esses pontos (hipotenusa), utilizando o Teorema de Pit�goras. Para utilizar o teorema de Pit�goras primeiro calcula um dos catetos a partir das diferencias entre as dist�ncias entre os pontos at� a linha principal. Depois calcula o cateto faltante com o teorema de Pit�goras. Tamb�m calcula as coordenadas x,y para pontos secund�rios nas proximidades dos pontos principais calculados, a partir da dist�ncia diagonal desde o ponto secund�rio at� o ponto principal e o �ngulo entre ponto secund�rio e o ponto principal, tamb�m utilizando o teorema de Pit�goras. A fun��o ira plotar em um desenho s� os pontos principais o tanto os pontos principais quanto os pontos secund�rios.   

Usage:

catetomap(tabla,individuals=�TRUE�)

Arguments:

tabla	data frame com 6 colunas: A identidade dos pontos principais que representam ninhos, manchas de recurso, indiv�duos, etc. A dist�ncia desde cada ponto principal at� uma linha reta que pode ser por exemplo uma rua. A dist�ncia diagonal entre os pontos principais, sempre de um ponto ao ponto anterior. A identidade dos pontos secund�rios que representam indiv�duos ou qualquer outro ponto pr�ximo aos pontos principais. A dist�ncia em diagonal desde o ponto secund�rio at� um ponto principal. O �ngulo entre o ponto secund�rio e o ponto principal (s� com valores a cada 45 graus, veja o details).

individuals	l�gico; se for TRUE a fun��o ir� plotar os pontos secund�rios no redor dos pontos principais. Se for FALSE a fun��o ira plotar s� os pontos principais. 

Details:

Na entrada de dados, catetomap s� aceita �ngulos entre os pontos secund�rios e um ponto principal cujos valores sejam a cada 45 graus, ou seja s� podem ser valores de: 0, 45, 90, 135, 180, 225, 270 e 315 graus.



Value:

A fun��o catetomap retorna um data.frame com os catetos calculados a partir do Teorema de Pit�goras, as coordenadas x para cada ponto principal, e as coordenadas x,y para os pontos secund�rios nas proximidades dos pontos principais. Tamb�m retorna um desenho ou mapa com s� os pontos principais plotados o tanto os pontos principais quanto os pontos secund�rios.   

Notes:

Muito importante: Cada valor da dist�ncia diagonal entre os pontos principais deve ser sempre em rela��o ao ponto principal anterior. Isto quer disser que o primeiro valor do vetor contendo as dist�ncias diagonais deve ser sempre zero, pois o primeiro ponto n�o tem ponto anterior.   

Author(s):

Rosannette Quesada-Hidalgo (2017).
21rosit@gmail.com

Example:

ninho=c(1,1,2,3,4)
h=c(10,10,2,15,16)
diagonal.ninho=c(0,0,30,40,10)
femeas.id=c(1:5)
distancia.fem=c(5,5,20,7,6)
angulo=c(45,90,135,270,225)
tabla=data.frame(ninho,h,diagonal.ninho, femeas.id,distancia.fem,angulo)
head(tabla)


write.csv(tabla,"exemplo.funcao.csv")
dados=read.csv("exemplo.funcao.csv")

catetomap(dados,individuals=FALSE)
catetomap(dados,individuals=TRUE)