przewodnikPoPakiecieR3

18 Łagodne wprowadzenie do R

R will always be arcane to those who do itot make a scriotts effort to learn it. It us **not** meant to be intuitive and eagy for casuał utters to jusl plunge into. It is far too complcx and powerful for that. But tbe rewards are great for scrious dala analyst-s who pui in the effort.

Ber fon Gunter fortunc(19fi)

1.5.3 Gdzie szukać pomocy?

Jest, prawdą absolutną, że w przypadku, gdy nie wierny jak coś zrobić, to najłatwiej i najszybciej będzie zapytać się kogoś, kto to wie i chce nam podpowiedzieć. W sytuacji, gdy nie mamy takiej osoby pod ręką R oferuje bogaty system pomocy.

Pierwszym źródłem pomocy są wbudowane funkcje R ułatwiające wyszukiwanie informacji. Oto lista najbardziej przydatnych:

• Funkcja helpO bez argumentów. Wyświetla stronę powitalną systemu pomocy R. Na tej stronie opisane są szczegółowo wymienione poniżej funkcje.

• Funkcja help("nazuaFunkcji") lub ?nazvaFunkcji. Wyświetla stronę z pomocą dla funkcji o nazwie nazwaFunkcji. Format opisów funkcji jest ujednolicony, tak aby łatwiej było z nich korzystać. Kolejne sekcje pomocy zawierają: zwięzły opis funkcji (sekcja Description), deklaracje funkcji (sekcja Usage), objaśnienie poszczególnych argumentów (sekcjo Arguments), szczegółowy opis funkcji (sekcja Details), literaturę (sekcja Referenr.es), odnośniki do innych funkcji (sekcjo Sec Also) oraz przykłady użycia (sekcja Eiamplcs). Jeżeli określimy argument package, to uzyskamy pomoc dotyczącą koukretnego pakietu. Przykładowo polecenie help(package=MASS) wyświetla opis dla pakietu MASS.

• Funkcja args(nazwaFunkcji). Wyświetla listę argumentów dla danej funkcji.

• Funkcja apropos(słowo) lub f ind(slowo). Wypisuje listę funkcji (oraz obiektów), które w swojej nazwie mają podciąg słowo.

• Funkcja example(nazwaFunkcji). Uruchamia skrypt z przykładowymi wywoływaniami poszczególnych funkcji. Dzięki przykładom można szybko zobaczyć jak korzystać z danej funkcji, a także jakich wyników się należy spodziewać. Na dobry początek warto sprawdzić wynik polecenia example(plot).

• Funkcja help.search("slowoKluczowe”). Przegląda opisy funkcji znajdujących się w zainstalowanych pakietach i wyświetla te pozycje, w których znaleziono wskazane slowoKluczowe. W tym przypadku slowoKluczowe może oznaczać również kilka słów lub zwrot. W liście wyników znajduje się również informacja, w którym pakiecie znajdują się znalezione funkcje.

Poniżej przykładowa sesja w pakiecie R, poszukujemy dodatkowych informacji o funkcji plot O oraz o funkcjach do testowania statystycznego.

tt wyświetl pomoc dotyczącą funkcji plot()

?plot

# wyświetl przykłady użycia funkcji plotO eianple(plot)

P wyświetl nazwy funkcji ze słowem "test" w nasunie aproposCtest")

t> wyświetl nazwy funkc.ji ze zwrotem 'normality test’ w opisie help.searchCnormallty taat")

Powyżej przedstawione funkcje wyszukują informacje na dany temat wśród pakietów, które są już zainstalowane na komputerze. Jeżeli to okaże się niewystarczające (a może się zdarzyć, że nie mamy zainstalowanego pakietu, w którym znajduje się potencjalnie interesująca nas funkcja), to możemy skorzystać z zasobów dostępnych w Internecie. W szczególności warto wiedzieć gdzie znaleźć:

• Poradniki (manuale, ang. manuals) do R'a, poświęcone różnym aspektom programowania w R lub analizie danych w R. Dostępne są bezpośrednio z menu Help w R (gdy aktywna jest konsola) oraz w Internecie pod adresem http://cran.r-project.org/manuals.html.

• Książki poświęcone pakietowi R oraz o analizie danych z użyciem tego pakietu. Aktualizowana lista książek na ten temat znajduje się online pod adresem http://ww.r-project.org/doc/bib/R-books.html.

• Rwiki dostępne pod adresem http://wiki.r-project.org/rwiki/. Jest to Internetowa encyklopedia poświęcona R, czyli masa ciekawych informacji przekazanych w mniej lub bardziej kontrolowanej formie (szczególnie warto przejrzeć sekcje zatytułowaną „R graph galery”).

• Wyszukiwarka Rseek dostępna pod adresem http: //www. rseek. org/. Jest to potężna wyszukiwarka funkcji, obiektów, komentarzy i innych informacji. Jeżeli nic znajdzie się tego czego się szuka, to zawsze można też zapytać wyszukiwarkę google przeglądając tylko podstrony serwisu o R. Tak ustawiona wersja google znajduje się np. pod adresem http://www.r-project.org/search.html.

• Lista dyskusyjna poświęcona rozwiązywaniu problemów w korzystaniu z R. Jej archiwum znajduje się pod adresem http: //www. r-project. org/mail.html. W razie problemów ze znalezieniem odpowiedzi na frapujący nas problem można tu zadać pytanie i cierpliwie czekać na odpowiedź. W 99% przypadków już ktoś zada) takie pytanie i uzyska! odpowiedź, warto wiec najpierw przejrzeć archiwami listy.

• FAQ dostępne pod adresem http://www.r-project.org/faqs.html. Tysiące lub setki tysięcy osób używa R, więc pewne pytania zostały już zadane setki razy. FAQ, to miejsce, w którym znajdziesz odpowiedzi na najczęstsze pytania (stąd też nazwa FAQ, skrót od ang. Frequently Asked Question).

• Galeria ciekawych grafik: http://addictedtor.free.fr/graphiques/. Na tej stronie internetowej znaleźć można przykłady ciekmeych wykresów wykonanych w R. Warto zerknąć, bo z pewnością robi wrażenie. Co więcej kody R wykorzystane do wykonania poszczególnych wykresów można ściągnąć i samodzielnie przeanalizować.

Powyższe źródła są bez wyjątku angielskojęzyczne. Poza nimi w Internecie można znaleźć też wiele materiałów polskojęzycznych. W szczególności warto przejrzeć dokument „Wprowadzenie do środowiska R" Łukasza Komsty [13] dostępny pod adresem http://cran.r-project.org/doc/contrib/Komsta-Wprowadzenie.pdf. W polskim Internecie można też znaleźć wiele notatek do wykładów lub laboratoriów prowadzonych z użyciem pakietu R.

W razie wątpliwości lub problemów zawsze można zadać pytanie na którymś z polskich forów, na którym pojawiają się użytkownicy pakietu R, np. na forum poświęcone statystyce, znajdujące się pod adresem http://ww.statystycy.pl/ lub na forum dedykowane pakietowi R i jego użytkownikom, które jest dostępne pod adresem https: //ww. im. uj . edu. pl/gur/.