Cómo pedir ayuda

R dispone de un sistema de ayuda muy eficaz que nos va a permitir aprender el uso de los comandos con bastante rapidez. Si conocemos el nombre del comando sobre el que deseamos ayuda (p.e. plot) podemos utilizar la función help(). Lo único que debemos teclear es help(plot) o ?plot.
En ese momento, si trabajamos con la versión de Linux, el terminal abandona entorno de R en el que estamos para arrancar el visualizador de la ayuda. El desplazamiento por la ayuda se realiza con las teclas de arriba-abajo y de Av.Pag-Re.Pag. Todas las ayudas suelen acabar con ejemplos de utilización de la función. Para salir de ella sólo hay que pulsar la tecla q.
Existe la posibilidad de visualizar la ayuda con un navegador web. Para ello, en el caso anterior se debería teclear help(plot, htmlhelp=T) con lo que arrancaría el navegador Mozilla. En la página web aparecerá el mismo contenido de la ayuda pero con sus ventajas en cuanto a navegación. Además, en este caso, no se pierde en ningún momento el controlde edición de comandos en el prompt de R.
El problema viene cuando no conocemos el nombre de los comandos, pero, ni siquiera en ese caso está todo perdido. Entre otras cosas, tenemos manuales (como este) que nos van presentando algunos de los comandos más habituales. Sólo es cuestión de empezar a recordarlos. Además, existen varias posibilidades de ayuda desde R. Si tecleamos help.start(), arrancará el navegador web en una página de inicio que presenta enlaces a diferentes documentos. En este momento nos interesa especialmente el enlace a los paquetes de R (Packages). De este modo podremos obtener una relación de todo lo que contiene un paquete determinado. De entrada nos viene el nombre del comando a teclear y una pequeña descripción de lo que hace (si es un procedimiento) o de lo que contiene (si es un fichero de datos). Aunque tiene infinidad de funciones, es conveniente echar un vistazo al paquete Base porque podremos ir reconociendo las que utilizaremos con más frecuencia.
Si tenemos alguna idea de cómo puede llamarse la función que queremos emplear podemos utilizar la función apropos(). Por ejemplo, si quiero hacer una media ponderada pero no sé el nombre exacto de la función que me permita obtenerla, puedo teclear apropos(mean) cuya salida sería
[1]``mean'' ``mean.POSIXc'' ``mean.POSIXl'' ``mean.default''
[5] ``weighted.mean''
Podemos ver entonces que existe una función llamada weighted.mean(). El siguiente paso sería solicitar ayuda sobre la misma con help(weighted.mean) para aprender a utilizarla.

Otra herramienta muy útil para pedir ayuda en R es la función help.search(). Esta nos devuelve todas las entradas de ayuda que presenten en sus tilulos o palabras clave la cadena de caracteres introducida como argumento de la función. Así,
help.search(``help'')
devuelve
example(base) Run an Examples Section from the Online Help
help(base) Documentation
help.search(base) Search the Help System
help.start(base) Hypertext Documentation
index.search(base) Search Indices for Help Files
Cuando
apropos(help)
devuelve
[1]``help'' ``help.search'' ``help.start''

Otra función muy útil es methods(), que permite conocer diferentes posibilidades de uso de procedimientos utilizados en R. Por ejemplo, si nos interesa conocer variantes de uso de la función lines(), podemos teclear
methods(lines)
que nos proporciona la siguiente salida
[1] ``lines.default'' ``lines.formula'' ``lines.histogram'' ``lines.ts''.
Tambiém podemos aplicarlo a una clase de objetos, como hacemos en el siguiente ejemplo con las tablas
methods(class=table)
[1] ``pairwise.table'' ``as.data.frame.table'' ``as.table''
[4] ``is.table'' ``margin.table'' ``plot.table''
[7] ``print.summary.table'' ``int.table'' ``prop.table''
[10] ``read.table'' ``summary.table'' ``write.table''
Posteriormente, con las funciones normales de ayuda, podemos entrar a estudiar el funcionamiento de aquellas que nos puedan interesar.

En Windows encontramos en la pantalla un menú de ayuda. Allí nos encontramos con accesos a las FAQ's, al manual de R y otras fuentes de documentación. Éstos están en formato PDF, pero la versión en HTML podemos lanzarla desde la línea de comandos con la función help.start(). La captura de pantalla de la Figura [*] se ha obtenido de esa manera.

Figura: Manual de R en html
Image capturapantalla1
2007-02-12