sorvi - asennus

Sorvi-paketti toimii Linux-, Mac- ja Windows-ympäristöissä. Alla tiiviit asennusohjeet. Pyydämme raportoimaan havaituista puutteista (yhteystiedot).

Sorvin lähdekoodi löytyy GitHubista, josta paketin voi myös suoraan asentaa omalle koneelleen. Paketin asentaminen edellyttää tiettyjen kehitystyökalujen asentamista, mikä vaatii käyttäjältä järjestelmävalvojan oikeudet. Sorvi on mahdollista asentaa Windows-alustalla myös ilman järjestelmävalvojan oikeuksia, ohjeet tähän löydät täältä.

Asennusohjeet (suositeltu tapa)

1. Asenna R-laskentaympäristö

   • Lataa ja asenna R-laskentaympäristö. Tuemme uusinta R-versiota (R-2.15.2); saattaa toimia myös aikaisemmilla.
   • Graafisista R-käyttöliittymistä suosittelemme ohjelmistoa RStudio (desktop-versio). Vaihda RStudion asetuksista 'Default text encoding' -kohtaan 'UTF-8'.

2. Asenna riippuvuudet

   • Windows: Asenna RTools. Asenna RToolsin versio, joka vastaa käyttämääsi R-versiota (tarkista versionumero esim. R:ssä komennolla 'R.Version()'). Huomaa lisäksi että RTools:n asennuksessa kohdassa 'Select Components' pitää olla valittuna checkboxit 'R toolset' ja 'Cygwin DLLs', sekä kohdassa 'Select Additional Tasks' checkbox 'Edit the system PATH'.
   • Mac: Asenna XCode.
   • Linux: Asenna CURL. Lisäksi voit asentaa joissakin esimerkeissä tarvittavat riippuvuudet GDAL, freeglut, XML, GEOS ja PROJ.4. Asentamisen sujuvoittamiseksi voit käyttää valmista asennusskriptiä (Debian / Ubuntu / Fedora / OpenSuse).

3. Asenna sorvi

   Kun vaaditut riippuvuudet on asennettu (ks. yllä), sorvi-paketin voi asentaa suoraan R:stä käsin. Käynnistä R ja asenna devtools:

   install.packages("devtools")
   

   Nyt sorvin asentaminen onnistuu R:stä käsin komennolla:

   library(devtools)
   install_github(repo = "sorvi", username = "louhos")
   

4. Kokeile asennuksen onnistumista

   Lataa sorvi käyttöön R:ssä komennolla

   library("sorvi")
   

   Jos asennus onnistui, ruudulle tulostuu tietoa paketista. Seuraavaksi voit kokeilla vaikkapa seuraavaa esimerkkiä:

   source("http://louhos.github.com/sorvi/installation.scripts/helloworld.R")
   

Asennusohjeet Windows-alustalla ilman järjestelmävalvojan oikeuksia

Jos käyttäjällä ei ole tarvittavia oikeuksia, ei yllä olevien ohjeiden kohdan 2 riippuvuuksien asentaminen onnistu. Sorvista on olemassa etukäteen käännetty binääriversio, jonka käyttäminen ei vaadi RToolsin asentamista. Huomaa, että yllä olevat asennusohjeet asentavat aina viimeisimmän sorvi-version kun taas binääriversio ei päivity aivan yhtä nopeasti.

Nämä ohjeet myös olettavat, että R-laskentaympäristö on asennettuna ja että käyttäjällä on kirjoitusoikeudet omaan kotikansioonsa.

1. Asenna sorvin binääripaketti

   Käynnistä R ja suorita sorvin asennusskripti komennolla:

   source("http://louhos.github.com/sorvi/win-install.R")
   

   Skripti asentaa kaikki sorvin tarvitsemat paketit sekä itse sorvin binääriversion.

2. Kokeile asennuksen onnistumista

   Kuten yllä olevien ohjeiden kohdassa 4.