Ayuda en R

Introducción a R Conceptos básicos de R
Obtén ayuda de paquetes y funciones de R

En este tutorial aprenderás cómo obtener ayuda en R, explorar todos los recursos disponibles y obtener las respuestas que necesitas a la hora de programar. Así que si eres nuevo en R o quieres saber toda la ayuda disponible que puedes encontrar, ¡sigue leyendo!

Libros y manuales gratuitos

Si necesitas un libro que te ayude a aprender R sin gastar dinero, hay libros gratuitos disponibles en línea. Los recursos oficiales se pueden encontrar en la página web del ‘R project’.

https://cran.r-project.org/manuals.html

En la siguiente tabla encontrarás todos los libros disponibles. El primero es una lectura recomendada para todos aquellos que se están iniciando en la programación en R.

Libro Nivel
An Introduction to R Principiante e intermedio
R Data Import/Export Principiante e intermedio
R Installation and Administration Avanzado
Writing R Extensions Avanzado
R language definition (Draft) Avanzado
R Internals Avanzado
The R Reference Index Avanzado

Si trabajas con R GUI (no RStudio), puedes ir al menú AyudaManuales (PDF) y acceder a distintos libros.

También hay recursos traducidos por contribuidores, pero la página ya no se mantiene activamente. Puedes ver la lista completa en el siguiente enlace.

https://cran.r-project.org/other-docs.html

Manuales PDF de los paquetes

Hay manuales en PDF de cada paquete de R. Algunos de ellos son más extensos y detallados que otros, ya que no hay restricciones sobre la calidad de la documentación al subir un paquete a CRAN. Puedes acceder a la documentación en PDF en enlaces de la siguiente estructura:

https://cran.r-project.org/web/packages/Nombre_del_paquete/Nombre_del_paquete.pdf

La función help.start

Si eres nuevo en el lenguaje de programación R y te sientes perdido al comenzar, puedes llamar a la función help.start.

help.start() # Se abrirá ayuda en formato HTML

Una vez ejecutado, si estás usando RStudio, la pestaña de ayuda te mostrará la ayuda en HTML, de lo contrario, se abrirá un navegador con la documentación. De esta manera podrás acceder a manuales, referencias y material diverso o específico.

La función help

Ayuda de una función

R tiene documentación integrada en el entorno de desarrollo. Para obtener ayuda de una función puedes usar las funciones help o ?.

# Llamando a la ayuda de la función rnorm
help(rnorm)
?rnorm # Equivalente

La ayuda será en formato HTML y como mínimo mostrará una descripción de la función, los argumentos con la definición de cada uno de ellos y un ejemplo de uso.

Ayuda de un paquete

Equivalentemente, puedes obtener ayuda detallada sobre un paquete de R especificándolo en el argumento package.

help(package = "stats")
?stats # Equivalente

La función help.search

A veces no sabemos el nombre exacto de la función de la que se quiere obtener la documentación. En estos casos la función help.search busca la documentación en todos los paquetes instalados que contengan cierta palabra, aunque no estén cargados en la memoria. Por ejemplo, si no sabes qué función utilizar para calcular la mediana de un conjunto de datos, puedes utilizar el siguiente código:

help.search("median")

Dentro de la función también puedes especificar el paquete en el que quieres que se realice la búsqueda.

help.search("median", package = "stats")

Si quieres obtener más información sobre los argumentos de la función help.search ejecuta ?help.search.

Equivalentemente, se podría usar la función ??.

??median

Ten en cuenta que se puede ver la lista completa de funciones de un paquete, entre otra información ejecutando library(help = “nombre_paquete”)

La función apropos

Cuando busques un tema específico, o cuando solo recuerdes parte del nombre de una función, puedes buscar esa palabra con la función apropos. Supón que quieres buscar una función que contenga la palabra plot. Para obtener una lista de todas las funciones que contienen ‘plot’ dentro de su nombre puedes escribir:

# Funciones que contienen 'plot'
apropos("plot", mode = "function")
"assocplot"       "barplot"         "barplot.default"
"biplot"          "boxplot"         "boxplot.default"

También podrías usar una expresión regular. Como ejemplo, si deseas mostrar todas las funciones que comienzan con ‘plot’ puedes ejecutar:

# Funciones que empiezan por 'plot'
apropos("^plot", mode = "function")
"plot"          "plot.default"   "plot.design"   
"plot.ecdf"     "plot.function"  "plot.new" 

Función RSiteSearch

La función RSiteSearch se usa para buscar ayuda online sobre algún tema. Como ejemplo, si buscas ‘plot’ con esta función se abrirá una página web y mostrará resultados para tu búsqueda.

# Buscando 'plot' en los recursos online de CRAN
RSiteSearch("plot")

Guías rápidas de R

Las guías rápidas, más conocidas como R cheat sheets explican de manera esquemática algún tema, como el uso de la librería ggplot2 o de las expresiones regulares, entre otros. Puedes descargarlos en PDF desde la página web oficial de RStudio. Aunque la mayoría están en inglés, puedes encontrar algunas guías traducidas por colaboradores al final de la página.

https://rstudio.com/resources/cheatsheets/

Ayuda de conjuntos de datos

Si quieres ver la lista completa de conjuntos de datos disponibles, puedes usar la función data de la siguiente manera:

data()

En el caso de que prefieras mostrar la lista completa de los conjuntos de datos de todos los paquetes que has instalado, puedes llamar a la función y especificar el argumento package de la siguiente forma:

data(package = .packages(all.available = TRUE))

Ten en cuenta que puedes establecer cualquier paquete que desees en ese argumento, en lugar de llamar a todos con la función .packages.

Además, cuando trabajes con conjuntos de datos, es posible que necesites información sobre ellos, como información sobre las variables o cómo se recopilaron los datos. Para este propósito llama a la función help o ? y especifica el nombre del conjunto de datos. Por ejemplo, si quieres información sobre conjunto de datos diamonds ejecuta uno de los siguientes códigos:

help("diamonds")
?diamonds # Equivalente

Ejemplos de uso de funciones

Los paquetes incluyen ejemplos de uso de sus propias funciones que pueden ser ejecutados con la función example. Como ejemplo, puedes ver diferentes ejemplos de la función plot escribiendo:

example("plot")

Después de ejecutar, se mostrarán varios gráficos por orden. Puedes ver la siguiente gráfica presionando Enter o haciendo click sobre la gráfica que se abra (solo en R base). Si quieres cerrar los ejemplos pulsa Esc. Otro ejemplo puede ser el que se muestra en el siguiente bloque de código.

example("quantile")
example(quantile) # Equivalent

El código anterior generará un ejemplo de uso de la función quantile con datos de muestra aleatorios.

Recuerda que si quieres ejecutar un ejemplo de una función de un paquete, primero debes cargar el paquete.

Demos incluídas en los paquetes

Relacionado con la función example, existe otra función denominada demo que ejecuta ejemplos extensos de algunas funciones importantes.

Nótese que pocos paquetes de R incluyen demos.

Si llamas a la función demo, se mostrará una lista de demos disponibles para ejecutar.

demo()

Una vez que hayas decidido cuál quieres ejecutar, escríbelo dentro de la función con o sin comillas.

demo("smooth")
demo(smooth) # Equivalente

Viñetas de R

Las viñetas o vignettes son largas guías de paquetes de R que describen su uso con amplias explicaciones y ejemplos más detallados que los de la documentación base, escritos en formato R Markdown. Nótese que muchos paquetes contienen viñetas, pero no todos. Puedes ver la lista completa de viñetas de tus paquetes de R instalados con la función vignette.

vignette()

También puedes especificar uno o más paquetes, en lugar de buscar todas las viñetas, con el argumento package.

vignette(package = "ggplot2")
Vignettes in package ‘ggplot2’:

ggplot2-specs           Aesthetic specifications (source, html)
extending-ggplot2       Extending ggplot2 (source, html)
ggplot2-in-packages     Using ggplot2 in packages (source, html)

Un vez decidas qué viñeta quieres ver, escribe:

vignette("nombre_de_la_viñeta")

# Ejemplo:
vignette("ggplot2-specs")

Después de llamar a la función se abrirá una ventana con la documentación completa.