1.4 Come reperire informazioni sui comandi di R

Poiché in R esistono migliaia di comandi, ognuna con il proprio elenco di argomenti, è praticamente impossibile memorizzarli tutti. Ognuno dei comandi disponibili in R possiede una documentazione molto dettagliata.

Esistono due modi per ottenere informazioni su un comando. Se si conosce il nome del comando, basta digitare il punto interrogativo (?) seguito dal nome della funzione stessa (provate ad esempio con ?var). Se state lavorando in RStudio19, questa operazione mostrerà l’help della funzione var() nel tab denominato Help (vedi Figura 1.10).

Help della funzione `var()` come mostrato da RStudio.

Figura 1.10: Help della funzione var() come mostrato da RStudio.

Le pagine di help delle funzioni sono tutte strutturate nello stesso modo e riportano le seguenti informazioni:

  • nella sezione Description trovate una breve descrizione della funzione
  • nella sezione Usage trovate la sintassi completa della funzione
  • nella sezione Arguments sono elencati tutti gli argomenti, obbligatori e facoltativi, della funzione con l’indicazione dei valori di default di questi ultimi
  • nella sezione Details sono riportati i dettagli tecnici dei calcoli svolti dalla funzione
  • nella sezione Value viene descritto l’output restituito dalla funzione
  • nella sezione Note trovate ulteriori note sulla funzione
  • nella sezione References sono elencati dei riferimenti bibliografici
  • nella sezione SeeAlso} si indicano altre funzioni collegate a quella di cui state leggendo l’help
  • nella sezione Examples sono riportati alcuni esempi sull’uso della funzione

La seconda situazione in cui possiamo trovarci è quella in cui non conosciamo il nome del comando che ci serve. In questo caso possiamo digitare un doppio punto interrogativo (??) seguito da una o più parole chiavi20. L’output proposto consiste in una lista di pagine di help in cui le parole chiavi indicate vengono menzionate. A titolo di esempio, provate ad eseguire il comando ??median.

  1. Se state lavorando direttamente in R, le pagine di help saranno mostrate nel browser se usate un computer Windows, oppure in una nuova finestra chiamata RHelp} se usate un computer Mac.↩

  2. Nel caso indicassimo più di una parola chiave, è necessario includere queste tra virgolette.↩