From bac823396746ebd0fade5d68fff80281c5aa1c51 Mon Sep 17 00:00:00 2001
From: Eduardo Junior <edujrrib@gmail.com>
Date: Sat, 22 Oct 2016 17:54:07 -0200
Subject: [PATCH] =?UTF-8?q?Corrige=20dados=20do=20=C3=ADndice=20da=20bolsa?=
 =?UTF-8?q?=20de=20valores=20de=20S=C3=A3o=20Paulo?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Corrige formato da série para 'zoo' para que as observações fiquem
  associadas com suas respectivas datas de coleta, uma vez que são
  coletados dados somente em dias utéis.
- Complementa documentação e seção de exemplos
---
 R/IBV.R      |  15 +++++++++------
 data/IBV.rda | Bin 4116 -> 9108 bytes
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/R/IBV.R b/R/IBV.R
index 818b087a..dda52358 100644
--- a/R/IBV.R
+++ b/R/IBV.R
@@ -1,24 +1,27 @@
 #' @name IBV
-#' @title IBV de São Paulo
+#' @title Índice da Bolsa de Valores de São Paulo
 #' @description Dados sobre o Índice da Bolsa de Valores (IBV) de São
-#'     Paulo. Os dados são referentes ao período do dia três de 
-#'     Janeiro de 1995 até 27 de Dezembro de 2000.
-#'          
+#'     Paulo. Os dados são referentes ao período de 03 de Janeiro de
+#'     1995 até 27 de Dezembro de 2000.
+#'
 #' @format Uma série temporal (classe \code{ts}), com 1498 observações
 #'     diárias, de 3 de janeiro de 1995 a 27 de dezembro de 2000.
 #' @keywords TS
 #' @source Morettin, P. A., Toloi, C. M. C. (2006). Análise de Séries
 #'     Temporais (2nd ed.). São Paulo, SP: Editora Egard
-#'     Blucher. (Série A9 - Mercado Financeiro, mencionada em diversas 
+#'     Blucher. (Série A9 - Mercado Financeiro, mencionada em diversas
 #'     páginas)
 #' @examples
 #'
 #' data(IBV)
 #' str(IBV)
+#'
+#' library(zoo)
 #' IBV
 #'
 #' # Médias anuais
-#' aggregate(IBV, FUN = mean)
+#' aggregate(IBV, by = format(time(IBV), "%Y"), FUN = mean)
+#' aggregate(IBV, by = format(time(IBV), "%B"), FUN = mean)
 #'
 #' # Visualização da série
 #' library(lattice)
diff --git a/data/IBV.rda b/data/IBV.rda
index 7f17d9bb3bc96cecfce15ce7302f950535d5f54b..464755fc1f573f5611f7b6983dc82b64a5f89ec2 100644
GIT binary patch
literal 9108
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

literal 4116
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

-- 
GitLab