Correçoes nas documentacoes.

a7bc6abb · Walmes Marques Zeviani · 8c10c007 · a7bc6abb · a7bc6abb · a7bc6abb
Commit a7bc6abb authored 8 years ago by Walmes Marques Zeviani
--- a/R/SoaresEx11.R
+++ b/R/SoaresEx11.R
 #' @name SoaresEx11
-#' @title Resultados de uma prova de Estatística
+#' @title Resultados de uma Prova de Estatística
 #' @description Os dados apresentados constituem o resultado da segunda
-#'     prova da turma C do 1° semestre de 1990 da disciplina de 
-#'     Estatística para Medicina.
-#' @format Um \code{data.frame} com 48 observações.
+#'     prova da turma C do 1\eqn{^\circ} semestre de 1990 da disciplina
+#'     de Estatística para Medicina. TODO É um resultado de prova ou de
+#'     avaliação de doença? A descrição do dado não confere com a
+#'     descrição das variáveis.
+#' @format Um \code{data.frame} com 48 observações, em que
 #'
 #' \describe{
 #'
 #' \item{\code{m}}{Tempo (em meses) entre a remissão de uma doença e a
-#' recidiva em pacientes do sexo masculino}
+#'     recidiva em pacientes do sexo masculino.}
 #'
 #' \item{\code{f}}{Tempo (em meses) entre a remissão de uma doença e a
 #'     recidiva em pacientes do sexo feminino.}
 #'
 #' }
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), TODO página XX, exercício 11.
 #' @examples
 #'
-#' library(lattice)
+#' data(SoaresEx11)
+#' str(SoaresEx11)
 #'
 #' par(mfrow = c(1,2))
 #' hist(SoaresEx11$m,
@@ -29,7 +31,6 @@
 #'      ylim = c(0, 8),
 #'      ylab = "Frequência absoluta",
 #'      xlab = "Tempo (em meses)")
-#'      
 #' rug(SoaresEx11$m)
 #'
 #' hist(SoaresEx11$f,
@@ -38,7 +39,11 @@
 #'      main = "Pacientes do sexo feminino",
 #'      ylab = "Frequência absoluta",
 #'      xlab = "Tempo (em meses)")
-#'      
 #' rug(SoaresEx11$f)
 #'
+#' library(latticeExtra)
+#'
+#' histogram(~m + f, data = SoaresEx11) +
+#'     layer(panel.rug(x))
+#'
 NULL
--- a/R/SoaresEx13.R
+++ b/R/SoaresEx13.R
 #' @name SoaresEx13
-#' @title Notas de um teste de psicoanalogia
+#' @title Notas de um Teste de Psicoanalogia
 #' @description Os dados apresentados referem-se as notas de 158
 #'     indivíduos que realizaram um teste de psicoanalogia (um teste de
 #'     inteligência em que o indivíduo tem que resolver uma série de
-#'     analogias).
-#' @format Um \code{data.frame} com 158 observações.
+#'     analogias). OS dados estão agregados com as frequências absolutas
+#'     em classes de tamanho 3.
+#' @format Um \code{data.frame} com 158 observações, em que
 #'
 #' \describe{
 #'
@@ -14,18 +15,16 @@
 #'
 #' }
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, exercício 13.
 #' @examples
 #'
-#' library(lattice)
-#' 
+#' layout(1)
 #' par(las = 2)
-#' barplot(SoaresEx13$FAS, names.arg = SoaresEx13$Escore, 
+#' barplot(SoaresEx13$FAS,
+#'         names.arg = SoaresEx13$Escore,
 #'         cex.names = 0.8,
 #'         xlab = "Escore",
 #'         ylab = "Frequência absoluta simples",
 #'         ylim = c(0, 25))
 #'
-#'  
 NULL
--- a/R/SoaresEx15.R
+++ b/R/SoaresEx15.R
 #' @name SoaresEx15
-#' @title Concentra\enc{ç}{c}\enc{ã}{a}o de minerais no leite materno
+#' @title Concentra\enc{ç}{c}\enc{ã}{a}o de Minerais no Leite Materno
 #' @description Pesquisa sobre a concentração de minerais no leite
 #'     materno em 55 mães do Hospital Maternidade Odete Valadares em
-#'     belo Horizonte, MG. Foram coletados no período de 1984 a 1985. As
+#'     Belo Horizonte, MG. Foram coletados no período de 1984 a 1985. As
 #'     mães foram divididas em dois grupos, segundo o período de
 #'     lactação: colostro e leite maduro. Os minerais considerados foram
 #'     cálcio e zinco.
-#' @format Um \code{data.frame} com 108 observações.
+#' @format Um \code{data.frame} com 108 observações, em que
 #'
 #' \describe{
 #'
@@ -19,13 +19,23 @@
 #'
 #' }
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, exercício 15.
 #' @examples
 #'
+#' str(SoaresEx15)
+#' boxplot(SoaresEx15$CTO)
+#'
 #' library(lattice)
 #'
-#' boxplot(SoaresEx15$CTO)
+#' xyplot(CTO ~ Grupo | Mineral,
+#'        data = SoaresEx15,
+#'        scales = "free",
+#'        type = c("p", "a"))
 #'
 NULL

+# TODO Estes dados parecer ser pareados, ou seja, os valores de zinco e
+# cálcio saem aos pares de cada mulher. Então, cada mineral deveria ser
+# uma coluna. A tabela teria que ter as colunas {grupo, calcio, zinco},
+# nas colunas calcio e zinco estão os calores de CTO, ao todo serão 55
+# linhas, uma por mãe.
--- a/R/SoaresEx8.R
+++ b/R/SoaresEx8.R
 #' @name SoaresEx8
-#' @title Resultados de uma prova de Estatística
+#' @title Resultados de uma Prova de Estatística
 #' @description Os dados apresentados constituem o resultado da segunda
-#'     prova da turma C do 1° semestre de 1990 da disciplina de 
-#'     Estatística para Medicina.
+#'     prova da turma C do 1\eqn{^\circ} semestre de 1990 da disciplina
+#'     de Estatística para Medicina. TODO essa prova é de 0 a 10?
 #' @format Um \code{vetor} numérico com 35 observações.
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, exercício 8.
 #' @examples
 #'
-#' library(lattice)
+#' data(SoaresEx8)
+#' str(SoaresEx8)
 #'
 #' hist(SoaresEx8,
 #'      labels = TRUE,
@@ -17,9 +17,8 @@
 #'      main = NULL,
 #'      ylab = "Frequência absoluta",
 #'      xlab = "Nota na segunda prova")
+#' rug(SoaresEx8)
 #'
-#' rug(SoaresTb3.19)
+#' stem(SoaresEx8)
 #'
 NULL
-
-
--- a/R/SoaresTb3.1.R
+++ b/R/SoaresTb3.1.R
 #' @name SoaresTb3.1
-#' @title Teor de gordura fecal em crianças.
-#' @description Embora os gastroenterologistas infantis reconhecessem
-#'     a utilidade diagnóstica do teor de gordura fecal, até 1984 não 
+#' @title Teor de Gordura Fecal em Crianças
+#' @description Embora os gastroenterologistas infantis reconhecessem a
+#'     utilidade diagnóstica do teor de gordura fecal, até 1984 não
 #'     existia um padrão de referência dessa medida para crianças
 #'     brasileiras. Para preencher esta lacuna, o Professor Francisco
 #'     Penna, titular de Pediatria da UFMG, examinou 43 crianças sadias
 #'     que produziram tais valores expressos em g/24 horas.
 #' @format Um \code{vetor} numérico com 43 observações.
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, tabela 3.1.
 #' @examples
 #'
-#' library(lattice)
-#'
 #' hist(SoaresTb3.1,
 #'      labels = TRUE,
 #'      col = "darkslategray1",
 #'      main = NULL,
 #'      ylab = "Frequência absoluta",
 #'      xlab = "Teor de gordura (g/24 horas)")
-#'      
 #' rug(SoaresTb3.1)
 #'
 NULL
--- a/R/SoaresTb3.19.R
+++ b/R/SoaresTb3.19.R
 #' @name SoaresTb3.19
-#' @title Doença de Chagas.
+#' @title Doença de Chagas TODO título está vago!
 #' @description Em 1992, Mota fez um estudo comparativo de crianças
 #'     filhas de mães chagásicas com filhas de mães não chagásicas
 #'     (grupo de controle). Neste estudo foram foram consideradas
 #'     dosagens obtidas em exames laboratoriais, medidas de variáveis
 #'     vitais, antropométricas e de desenvolvimeto motor (firmar a
-#'     cabeça, sentar e andar).
+#'     cabeça, sentar e andar). TODO não deveria ter a variável que
+#'     distingue se a criança é de mãe com chagas ou não? Esses
+#'     resultados são de que tipo de criança?
 #' @format Um \code{vetor} numérico com 46 observações.
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, tabela 3.19.
 #' @examples
 #'
-#' library(lattice)
+#' data(SoaresTb3.19)
+#' str(SoaresTb3.19)
 #'
 #' hist(SoaresTb3.19,
 #'      labels = TRUE,
@@ -24,5 +26,3 @@
 #' rug(SoaresTb3.19)
 #'
 NULL
-
-
--- a/R/SoaresTb3.2.R
+++ b/R/SoaresTb3.2.R
 #' @name SoaresTb3.2
-#' @title Doenças cardiovasculares em Honolulu.
+#' @title Doenças Cardiovasculares em Honolulu
 #' @description Em 1969 estudo realizado na população de Honolulu
-#'     (descrito em Kuzma, 1998). Para 7.683 indivíduos, foram
-#'     pesquisadas as seguintes variáveis: nível educacional, peso (Kg),
-#'     altura (cm), idade (anos), glicemia (\eqn{mg.dL^{-1}}), colesterol 
-#'     sérico (\eqn{mg.dL^{-1}}) e pressão sistólica (\eqn{mmHg^{-1}}).
-#'     Cada indivíduo foi classificado quanto ao hábito de fumar
-#'     (fumante ou não) e quanto à atividade em casa (pouca, moderada e
-#'     muita). 
+#'     (descrito em Kuzma, 1998). Para 7683 indivíduos, foram
+#'     pesquisadas as seguintes variáveis: nível educacional, peso (kg),
+#'     altura (cm), idade (anos), glicemia (mg dL\eqn{^{-1}}),
+#'     colesterol sérico (mg dL\eqn{^{-1}}) e pressão sistólica
+#'     (mmHg\eqn{^{-1}}).  Cada indivíduo foi classificado quanto ao
+#'     hábito de fumar (fumante ou não) e quanto à atividade em casa
+#'     (pouca, moderada e muita).
 #' @format Um \code{vetor} numérico com 80 observações.
 #' @keywords AAS
-#' @source Introdução à estatística médica/José Francisco Soares e 
-#' Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+#' @source SOARES; SIQUEIRA (2002), página TODO, tabela 3.2.
 #' @examples
 #'
-#' library(lattice)
-#'
 #' hist(SoaresTb3.2,
 #'      labels = TRUE,
 #'      col = "steelblue",
 #'      main = NULL,
 #'      ylab = "Frequência absoluta",
 #'      xlab = "Teor de colesterol (mg/dL)")
-#'      
 #' rug(SoaresTb3.2)
 #'
 NULL
-
-
--- a/man/SoaresEx11.Rd
+++ b/man/SoaresEx11.Rd
@@ -2,30 +2,32 @@
 % Please edit documentation in R/SoaresEx11.R
 \name{SoaresEx11}
 \alias{SoaresEx11}
-\title{Resultados de uma prova de Estatística}
-\format{Um \code{data.frame} com 48 observações.
+\title{Resultados de uma Prova de Estatística}
+\format{Um \code{data.frame} com 48 observações, em que

 \describe{

 \item{\code{m}}{Tempo (em meses) entre a remissão de uma doença e a
-recidiva em pacientes do sexo masculino}
+    recidiva em pacientes do sexo masculino.}

 \item{\code{f}}{Tempo (em meses) entre a remissão de uma doença e a
    recidiva em pacientes do sexo feminino.}

 }}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), TODO página XX, exercício 11.
 }
 \description{
 Os dados apresentados constituem o resultado da segunda
-    prova da turma C do 1° semestre de 1990 da disciplina de 
-    Estatística para Medicina.
+    prova da turma C do 1\eqn{^\circ} semestre de 1990 da disciplina
+    de Estatística para Medicina. TODO É um resultado de prova ou de
+    avaliação de doença? A descrição do dado não confere com a
+    descrição das variáveis.
 }
 \examples{

-library(lattice)
+data(SoaresEx11)
+str(SoaresEx11)

 par(mfrow = c(1,2))
 hist(SoaresEx11$m,
@@ -35,7 +37,6 @@ hist(SoaresEx11$m,
     ylim = c(0, 8),
     ylab = "Frequência absoluta",
     xlab = "Tempo (em meses)")
-     
 rug(SoaresEx11$m)

 hist(SoaresEx11$f,
@@ -44,9 +45,13 @@ hist(SoaresEx11$f,
     main = "Pacientes do sexo feminino",
     ylab = "Frequência absoluta",
     xlab = "Tempo (em meses)")
-     
 rug(SoaresEx11$f)

+library(latticeExtra)
+
+histogram(~m + f, data = SoaresEx11) +
+    layer(panel.rug(x))
+
 }
 \keyword{AAS}

--- a/man/SoaresEx13.Rd
+++ b/man/SoaresEx13.Rd
@@ -2,8 +2,8 @@
 % Please edit documentation in R/SoaresEx13.R
 \name{SoaresEx13}
 \alias{SoaresEx13}
-\title{Notas de um teste de psicoanalogia}
-\format{Um \code{data.frame} com 158 observações.
+\title{Notas de um Teste de Psicoanalogia}
+\format{Um \code{data.frame} com 158 observações, em que

 \describe{

@@ -13,27 +13,26 @@

 }}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, exercício 13.
 }
 \description{
 Os dados apresentados referem-se as notas de 158
    indivíduos que realizaram um teste de psicoanalogia (um teste de
    inteligência em que o indivíduo tem que resolver uma série de
-    analogias).
+    analogias). OS dados estão agregados com as frequências absolutas
+    em classes de tamanho 3.
 }
 \examples{

-library(lattice)
-
+layout(1)
 par(las = 2)
-barplot(SoaresEx13$FAS, names.arg = SoaresEx13$Escore, 
+barplot(SoaresEx13$FAS,
+        names.arg = SoaresEx13$Escore,
        cex.names = 0.8,
        xlab = "Escore",
        ylab = "Frequência absoluta simples",
        ylim = c(0, 25))

- 
 }
 \keyword{AAS}

--- a/man/SoaresEx15.Rd
+++ b/man/SoaresEx15.Rd
@@ -2,8 +2,8 @@
 % Please edit documentation in R/SoaresEx15.R
 \name{SoaresEx15}
 \alias{SoaresEx15}
-\title{Concentra\enc{ç}{c}\enc{ã}{a}o de minerais no leite materno}
-\format{Um \code{data.frame} com 108 observações.
+\title{Concentra\enc{ç}{c}\enc{ã}{a}o de Minerais no Leite Materno}
+\format{Um \code{data.frame} com 108 observações, em que

 \describe{

@@ -16,22 +16,27 @@

 }}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, exercício 15.
 }
 \description{
 Pesquisa sobre a concentração de minerais no leite
    materno em 55 mães do Hospital Maternidade Odete Valadares em
-    belo Horizonte, MG. Foram coletados no período de 1984 a 1985. As
+    Belo Horizonte, MG. Foram coletados no período de 1984 a 1985. As
    mães foram divididas em dois grupos, segundo o período de
    lactação: colostro e leite maduro. Os minerais considerados foram
    cálcio e zinco.
 }
 \examples{

+str(SoaresEx15)
+boxplot(SoaresEx15$CTO)
+
 library(lattice)

-boxplot(SoaresEx15$CTO)
+xyplot(CTO ~ Grupo | Mineral,
+       data = SoaresEx15,
+       scales = "free",
+       type = c("p", "a"))

 }
 \keyword{AAS}

--- a/man/SoaresEx8.Rd
+++ b/man/SoaresEx8.Rd
@@ -2,20 +2,20 @@
 % Please edit documentation in R/SoaresEx8.R
 \name{SoaresEx8}
 \alias{SoaresEx8}
-\title{Resultados de uma prova de Estatística}
+\title{Resultados de uma Prova de Estatística}
 \format{Um \code{vetor} numérico com 35 observações.}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, exercício 8.
 }
 \description{
 Os dados apresentados constituem o resultado da segunda
-    prova da turma C do 1° semestre de 1990 da disciplina de 
-    Estatística para Medicina.
+    prova da turma C do 1\eqn{^\circ} semestre de 1990 da disciplina
+    de Estatística para Medicina. TODO essa prova é de 0 a 10?
 }
 \examples{

-library(lattice)
+data(SoaresEx8)
+str(SoaresEx8)

 hist(SoaresEx8,
     labels = TRUE,
@@ -23,8 +23,9 @@ hist(SoaresEx8,
     main = NULL,
     ylab = "Frequência absoluta",
     xlab = "Nota na segunda prova")
+rug(SoaresEx8)

-rug(SoaresTb3.19)
+stem(SoaresEx8)

 }
 \keyword{AAS}

--- a/man/SoaresTb3.1.Rd
+++ b/man/SoaresTb3.1.Rd
@@ -2,15 +2,14 @@
 % Please edit documentation in R/SoaresTb3.1.R
 \name{SoaresTb3.1}
 \alias{SoaresTb3.1}
-\title{Teor de gordura fecal em crianças.}
+\title{Teor de Gordura Fecal em Crianças}
 \format{Um \code{vetor} numérico com 43 observações.}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, tabela 3.1.
 }
 \description{
-Embora os gastroenterologistas infantis reconhecessem
-    a utilidade diagnóstica do teor de gordura fecal, até 1984 não 
+Embora os gastroenterologistas infantis reconhecessem a
+    utilidade diagnóstica do teor de gordura fecal, até 1984 não
    existia um padrão de referência dessa medida para crianças
    brasileiras. Para preencher esta lacuna, o Professor Francisco
    Penna, titular de Pediatria da UFMG, examinou 43 crianças sadias
@@ -18,15 +17,12 @@ Embora os gastroenterologistas infantis reconhecessem
 }
 \examples{

-library(lattice)
-
 hist(SoaresTb3.1,
     labels = TRUE,
     col = "darkslategray1",
     main = NULL,
     ylab = "Frequência absoluta",
     xlab = "Teor de gordura (g/24 horas)")
-     
 rug(SoaresTb3.1)

 }

--- a/man/SoaresTb3.19.Rd
+++ b/man/SoaresTb3.19.Rd
@@ -2,11 +2,10 @@
 % Please edit documentation in R/SoaresTb3.19.R
 \name{SoaresTb3.19}
 \alias{SoaresTb3.19}
-\title{Doença de Chagas.}
+\title{Doença de Chagas TODO título está vago!}
 \format{Um \code{vetor} numérico com 46 observações.}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, tabela 3.19.
 }
 \description{
 Em 1992, Mota fez um estudo comparativo de crianças
@@ -14,11 +13,14 @@ Em 1992, Mota fez um estudo comparativo de crianças
    (grupo de controle). Neste estudo foram foram consideradas
    dosagens obtidas em exames laboratoriais, medidas de variáveis
    vitais, antropométricas e de desenvolvimeto motor (firmar a
-    cabeça, sentar e andar).
+    cabeça, sentar e andar). TODO não deveria ter a variável que
+    distingue se a criança é de mãe com chagas ou não? Esses
+    resultados são de que tipo de criança?
 }
 \examples{

-library(lattice)
+data(SoaresTb3.19)
+str(SoaresTb3.19)

 hist(SoaresTb3.19,
     labels = TRUE,

--- a/man/SoaresTb3.2.Rd
+++ b/man/SoaresTb3.2.Rd
@@ -2,33 +2,29 @@
 % Please edit documentation in R/SoaresTb3.2.R
 \name{SoaresTb3.2}
 \alias{SoaresTb3.2}
-\title{Doenças cardiovasculares em Honolulu.}
+\title{Doenças Cardiovasculares em Honolulu}
 \format{Um \code{vetor} numérico com 80 observações.}
 \source{
-Introdução à estatística médica/José Francisco Soares e 
-Arminda lucia Siqueira. 2.ed. Belo Horizonte: COOPMED, 2002.
+SOARES; SIQUEIRA (2002), página TODO, tabela 3.2.
 }
 \description{
 Em 1969 estudo realizado na população de Honolulu
-    (descrito em Kuzma, 1998). Para 7.683 indivíduos, foram
-    pesquisadas as seguintes variáveis: nível educacional, peso (Kg),
-    altura (cm), idade (anos), glicemia (\eqn{mg.dL^{-1}}), colesterol 
-    sérico (\eqn{mg.dL^{-1}}) e pressão sistólica (\eqn{mmHg^{-1}}).
-    Cada indivíduo foi classificado quanto ao hábito de fumar
-    (fumante ou não) e quanto à atividade em casa (pouca, moderada e
-    muita).
+    (descrito em Kuzma, 1998). Para 7683 indivíduos, foram
+    pesquisadas as seguintes variáveis: nível educacional, peso (kg),
+    altura (cm), idade (anos), glicemia (mg dL\eqn{^{-1}}),
+    colesterol sérico (mg dL\eqn{^{-1}}) e pressão sistólica
+    (mmHg\eqn{^{-1}}).  Cada indivíduo foi classificado quanto ao
+    hábito de fumar (fumante ou não) e quanto à atividade em casa
+    (pouca, moderada e muita).
 }
 \examples{

-library(lattice)
-
 hist(SoaresTb3.2,
     labels = TRUE,
     col = "steelblue",
     main = NULL,
     ylab = "Frequência absoluta",
     xlab = "Teor de colesterol (mg/dL)")
-     
 rug(SoaresTb3.2)

 }