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
|
2007-02-12