dividir.gastos                package:unknown                R Documentation

Divide igualmente gastos compartilhados durante um per�odo por duas ou mais pessoas.

Description:

     A fun��o � uma ferramenta para resolver divis�es de gastos entre grupos de pessoas que 
compartilham eventuais gastos durante um per�odo, como viagens, festas, churrascos e 
eventos em geral. Utilizando um data.frame contendo os gastos efetuados por cada pessoa, 
a categoria do gasto e a data, calcula as transa��es que devem ser feitas para que as contas 
possam ser equilibradas ap�s o t�rmino do per�odo. Como op��o, � poss�vel plotar gr�ficos 
(gastos cumulativos, gastos por categoria e gastos por pessoa) e realizar convers�es de 
moedas(real, dolar e euro).

Usage:

     dividir.gastos=function(x, moeda.entrada="real", moeda.saida="real", graficos=TRUE)

Arguments:

       x    	data.frame contendo os eventos de gastos nas linhas, contendo 
                os valores pagos pelas pessoas discriminadas nas colunas. Nas 
                primeiras colunas devem constar as pessoas e seus nomes no 
                cabe�alho. A pen�ltima coluna deve se chamar "categoria" e 
                deve conter as categorias de cada gasto (character). A �ltima 
                coluna deve se chamar "data" e conter as datas dos respectivos
                gastos, em formato dd/mm/yy. 

 moeda.entrada  a moeda correspondente aos valores apresentados em x. Pode ser
                "real"(default), "dolar" ou "euro".

  moeda.saida	a moeda que se deseja na devolu��o dos valores pela fun��o.
                Pode ser "real" (default), "dolar" ou "euro".

   graficos	argumento l�gico. Se TRUE(default), habilita a plotagem dos
                gr�ficos da fun��o. Se FALSE, desabilita a plotagem.



Details:

     Os nomes das pessoas devem estar explicitados no data.frame como cabe�alho, assim 
como 
     a pen�ltima e �ltima colunas devem ter como cabe�alho "categoria" e "data", 
respectivamente
     (e conter tais dados, obrigatoriamente).
     
     Regras para o preenchimento dos valores no data.frame: em cada linha, valores de 
gastos efetuados
     ser�o colocados de acordo com a pessoa que gastou. Pessoas que efetuaram de fato um 
gasto recebem 
     o valor do gasto efetuado. Pessoas que participam do consumo mas n�o gastaram no ato 
recebem o 
     o valor zero. E por fim, pessoas que n�o participam do consumo daquele gasto devem 
receber NA. 

Value:

     A fun��o retorna uma matriz de pagamentos. Para saber se uma pessoa deve pagar algo 
a outra,
     basta olhar na linha que cont�m seu nome. Nas colunas estar�o dispostos os valores que 
essa
     pessoa deve pagar a todas as outras. Se ela n�o deve nada, o valor � zero.

Warning:

     Caso os par�metros especificados para o data.frame n�o esteja corretamente 
preenchidos, a fun��o
     n�o ir� funcionar corretamente.

Author(s):

     Gabriel Massami Kayano

References:

   Google Finance Converter  
     https://www.google.com/finance/converter

Examples:

## Exemplo 1 : divis�o de gastos sem plotagem e sem convers�o de moeda
# criando data.frame com os dados:
exemplo1=read.table("exemplo1.csv", header=TRUE, sep=",", as.is=TRUE)
# aplica��o da fun��o com graficos=FALSE e moeda.entrada=moeda.saida
dividir.gastos(exemplo1, graficos=FALSE)

## Exemplo 2: divis�o de gastos com plotagem e sem convers�o de moeda
# criando data.frame com os dados:
exemplo2=read.table("exemplo2.csv", header=TRUE, sep=",", as.is=TRUE)
# aplica��o da fun��o com graficos=TRUE
dividir.gastos(exemplo2, graficos=TRUE)

## Exemplo 3: divis�o de gastos com plotagem e com convers�o de moeda (BRL-USD)
# criando data.frame com os dados:
exemplo3=read.table("exemplo3.csv", header=TRUE, sep=",", as.is=TRUE)
# aplica��o da fun��o com graficos=TRUE
dividir.gastos(exemplo3, moeda.entrada="real", moeda.saida="dolar", graficos=TRUE)