r-env
Page undergoing cleanup after Puhti and Mahti retirement
This page contains outdated references to Puhti and/or Mahti, which have now been decommissioned. The page is undergoing changes to reflect CSC's new supercomputer Roihu.
r-env tarjoaa R:n ja RStudio Serverin sekä useita muita ominaisuuksia niiden käytön helpottamiseksi. Se toimii Apptainer-kontissa.
-
R on avoimen lähdekoodin kieli ja ympäristö data-analytiikkaan, tilastolliseen laskentaan ja grafiikkaan. Lisätietoja R:stä löytyy R Projectin verkkosivuilta. Monet hyödylliset R-oppaat löytyvät myös CRANista.
-
RStudio Server on integroitu kehitysympäristö (IDE) R:lle. Lisätietoja RStudiosta löytyy RStudion verkkosivuilta.
Uutiset
18.8.2026 R-versio 4.6.1 on nyt saatavilla r-env:ssä Roihussa, ja se on asetettu oletusversioksi.
25.5.2026 r-env-dokumentaatio on päivitetty sisältämään ohjeet R:n käyttöön Roihu-supertietokoneella.
29.4.2026 r-env-dokumentaatio on päivitetty ja järjestelty uudelleen. Rinnakkaisten R-eräajojen malliskriptit löytyvät nyt
erilliseltä opassivulta Esimerkkejä rinnakkaisista R-eräajoista.
Vanhemmat uutiset (näytä napsauttamalla)
17.2.2026 R-versio 4.5.2 on nyt saatavilla r-env:ssä Puhdissa ja Mahdissa, ja se on asetettu oletusversioksi.
22.7.2025 R-versio 4.5.1 on nyt saatavilla r-env:ssä Puhdissa ja Mahdissa, ja se on asetettu oletusversioksi.
7.4.2025 r-env on nyt saatavilla myös Mahdissa, mukaan lukien RStudio Mahdin selainkäyttöliittymässä. Moduuli toimii yleisesti ottaen samalla tavalla kuin r-env Puhdissa, mutta huomaa, että alla olevaa dokumentaatiota ei ole vielä päivitetty Mahdille. Mahdin uusi small-osio soveltuu monenlaiseen R- ja RStudio-työskentelyyn kaikkein muistisyöpimpiä tehtäviä lukuun ottamatta. Puhtiin tottuneiden käyttäjien kannattaa huomata, että Mahdissa ei ole erillistä muistivarausta, ja ainoa tapa saada lisää muistia on varata enemmän ytimiä. Jos sinulla on kysyttävää R:n käytöstä Mahdissa, ota yhteyttä CSC:n asiakastukeen.
Saatavuus
r-env sisältää yli 1700 esiasennettua R-pakettia, mukaan lukien tuki paikkatietoanalyyseille ja rinnakkaislaskennalle. Suorituskyvyn parantamiseksi r-env on käännetty käyttäen Intel® oneAPI Math Kernel Librarya (oneMKL) (entinen Intel® MKL).
Muutamaa poikkeusta lukuun ottamatta r-env:n R-pakettiversiot ovat päivämäärälukittuja (CRAN-paketit) tai sidottuja tiettyyn Bioconductor -versioon.
Nykyiset moduulit ja CSC:n supertietokoneilla tuetut versiot:
| Moduulin nimi (R-versio) | CRAN-pakettien päiväys | Bioconductor-versio | RStudio Server -versio | oneMKL-versio | Cmdstan-versio |
|---|---|---|---|---|---|
| r-env/461 (oletus) | 23.7.2026 | 3.23 | 2026.07.1-147 | 2026.1.0 | 2.39.0 |
| r-env/452 | 4.4.2026 | 3.22 | 2026.01.0-392 | 2025.3.0 | 2.39.0 |
| Moduulin nimi (R-versio) | CRAN-pakettien päiväys | Bioconductor-versio | RStudio Server -versio | oneMKL-versio | Cmdstan-versio |
|---|---|---|---|---|---|
| r-env/452 (oletus) | 7.1.2026 | 3.22 | 2026.01.0-392 | 2025.3.0 | 2.38.0 |
| r-env/451 | 7.7.2025 | 3.21 | 2025.05.1-513 | 2025.2.0 | 2.36.0 |
| r-env/442 | 12.2.2025 | 3.20 | 2024.12.0-467 | 2025.0.1 | 2.36.0 |
Muut ohjelmistot ja kirjastot:
- Open MPI (Mellanox OFED™ -ohjelmistolla) 4.1.9 (Roihu-CPU), 4.1.7 (
r-env/452 Mahdissa,r-env/451), 4.1.2 (r-env442) - TensorFlow 2.20.0 (
r-env/452), 2.19.0 (r-env/451), 2.18.0 (r-env/442) - cget 0.2.0
Lisenssit
-
Tietoa R:n ja siihen liittyvien ohjelmistojen (mukaan lukien paketit) käytössä olevista lisensseistä löytyy R Projectin verkkosivuilta. Paketin tarkka lisenssi voidaan tarkistaa myös R:n sisällä:
packageDescription("package", fields="License"). Lisätietoja R:n ja eri R-pakettien siteeraamisesta löytyy myös (sivun alareunasta). -
RStudio Server -asennus perustuu Open Source Editioniin (saatavilla AGPL v3 -lisenssillä). Tutustu myös RStudion loppukäyttäjän lisenssisopimukseen.
-
Open MPI:tä jaellaan 3-lausekkeisella BSD-lisenssillä (lisätietoja Open MPI:n verkkosivuilla).
-
Mellanox OFED™ perustuu OFED™:iin (saatavilla kaksoislisenssillä BSD tai GPL 2.0) sekä suljettuihin komponentteihin (katso Mellanox OFED™ End-User Agreement).
-
Intel® MKL:ää jaellaan Intel Simplified Software License -lisenssillä.
-
NVIDIA NCCL:ää jaellaan 3-lausekkeisella BSD-lisenssillä.
-
NVIDIA cuDNN:ää jaellaan Software License Agreement for NVIDIA software development kits -lisenssillä.
-
cget on saatavilla Boost Software License -lisenssillä.
-
CmdStania jaellaan 3-lausekkeisella BSD-lisenssillä.
Lisenssitiedot r-env-kontin sisällä ovat saatavilla tiedostossa /usr/licensing.txt.
Käyttö
R:ää voi käyttää r-env-moduulilla useilla tavoilla:
Interaktiivinen käyttö
-
RStudio Server, joka toimii interaktiivisissa ajoissa laskentasolmulla
-
R-konsoli komentorivillä interaktiivisessa komentotulkki-istunnossa laskentasolmulla
-
Kirjautumissolmulla R-konsolia käyttäen. Käytä tätä vaihtoehtoa vain datan siirtämiseen, pakettien saatavuuden tarkistamiseen ja pakettien asentamiseen. Kirjautumissolmuja ei ole tarkoitettu raskaaseen laskentaan.
interactive-osiolla ajettavilla interaktiivisilla ajoilla on tietyt resurssirajat (aika, muisti, CPU-ytimet). Katso Roihun käytettävissä olevat resurssit.
Ei-interaktiivinen käyttö
- Ei-interaktiiviset eräajot ilman varattuihin laskentaresursseihin kohdistuvia rajoituksia (muita kuin ne, jotka koskevat kyseistä CSC:n supertietokonetta yleisesti)
Miten minun kannattaa käyttää R:ää r-env:n kanssa?
- Interaktiivinen käyttö on tarkoitettu koodin valmisteluun ja pienempiin analyyseihin, jotka kestävät enintään muutamia tunteja, ja siinä resurssit voivat olla rajalliset.
- Ei-interaktiiviset eräajot tarjoavat enemmän resursseja, ja niitä tulisi käyttää erityisesti pitkiin tai paljon resursseja vaativiin tehtäviin.
Interaktiivinen käyttö laskentasolmulla
1. RStudio
r-env-moduulia voidaan käyttää RStudio Serverin etäkäynnistämiseen verkkoselaimessa.
Suositeltu tapa käynnistää RStudio on käyttää supertietokoneen selainkäyttöliittymää. Katso myös erillinen dokumentaatio selainkäyttöliittymän RStudiosta.
RStudio Serverin voi käynnistää myös SSH-tunneloinnin kautta Mahdissa. Tämä vaihtoehto edellyttää tunnistautumista Secure Shell (SSH) -avaimella. Yksityiskohtaiset ohjeet löytyvät erillisestä RStudio Serverin käyttöoppaasta.
RStudio on tarkoitettu interaktiiviseen työskentelyyn, joka käyttää kohtuullisen vähän laskentaresursseja. Pitkät, paljon muistia vaativat tai muuten raskaat tehtävät kannattaa tehdä ei-interaktiivisina eräajoina.
2. R-konsoli interaktiivisessa komentotulkki-istunnossa
Jos haluat käyttää R:ää interaktiivisesti komentoriviltä laskentasolmulla, käynnistä ensin interaktiivinen komentotulkki-istunto.
Interaktiivisen komentotulkki-istunnon käynnistäminen (näytä ohjeet napsauttamalla)
Vaihtoehto 1. Avaa supertietokoneen selainkäyttöliittymissä komentotulkki-istunto Compute node shell -työkalulla. Resursseja valitessasi varmista, että varaat paikallista levytilaa väliaikaistiedostoille.
Vaihtoehto 2. Kun yhdistät supertietokoneeseen omalta työasemaltasi SSH-asiakasohjelmalla, avaa komentotulkki-istunto käyttäen sinteractive-komentoa.
Esimerkiksi alla oleva komento käynnistäisi istunnon, jossa on 2 ydintä ja 4 GiB muistia.
Oletuksena jokainen varattu ydin antaa 1 GiB muistia. Pyydä lisää muistia valitsimella --mem (enintään 64 GiB)
varaamatta ylimääräisiä ytimiä.
Jokaisella käyttäjällä on oletuksena 20 GB väliaikaista levytilaa interactive-osiossa.
On mahdollista määrittää myös muita valitsimia, mukaan lukien ajoaika (katso sinteractive --help tai sinteractive-dokumentaatio).
Kun olet avannut interaktiivisen komentotulkki-istunnon, voit käynnistää R:n komentoriviversion seuraavasti (huomaa, että komento täytyy suorittaa Roihu-CPU-laskentasolmulla):
Interaktiivinen käyttö kirjautumissolmulla
R-konsolia voi käyttää kirjautumissolmulla myös kevyisiin tehtäviin. Käytä tätä vaihtoehtoa vain datan siirtämiseen, pakettien saatavuuden tarkistamiseen ja pakettien asentamiseen. Kirjautumissolmuja ei ole tarkoitettu raskaaseen laskentaan.
Käynnistä R-konsoli kirjautumissolmulla suorittamalla seuraavat komennot Roihu-CPU:ssa:
Ei-interaktiiviset eräajot
R-skriptien ajaminen ei-interaktiivisesti eräajotiedostojen avulla antaa käyttöön enemmän resursseja ja painottaa tehokkuutta interaktiivisuuden sijaan. Eräajoja suositellaan erityisesti kaikkiin pitkiin ja paljon resursseja vaativiin tehtäviin.
Seuraavien esimerkkien lisäksi katso lisätietoja yleisestä eräajodokumentaatiosta. Jos eräajot ovat sinulle uusia, tutustu CSC Computing Environment -kurssin eräajomateriaaleihin ja tähän opastukseen interaktiivisten R-ajojen ja R-eräajojen suorittamisesta.
Perusskripti R-eräajolle
Alla on esimerkki sarjallisesta R-eräajosta, joka käyttää yhtä ydintä. Huomaa, että käytössä on test-osio, jonka aikaraja on 15 minuuttia ja jota käytetään vain testaustarkoituksiin.
Varsinaiset R-eräajot tulisi useimmissa tapauksissa ajaa small-osiossa. Katso lisätietoja Roihun käytettävissä olevista eräajo-osioista täältä.
Enemmän kuin yksi CPU-ydin?
Oletuksena R käyttää yhtä CPU-ydintä. Kun työskentelet R-skriptin tai -paketin kanssa, joka voi hyödyntää useita ytimiä ja rinnakkaisprosessointia, tutustu rinnakkaisten R-eräajojen skriptiesimerkkeihin.
Määrittelemme eräajoskriptin suorittamaan R-skriptin (tässä myscript.R):
#!/bin/bash
#SBATCH --job-name=r_serial # Ajon nimi
#SBATCH --account=<project> # Määritä laskutusprojekti, esim. project_2001234
#SBATCH --output=output_%j.txt # Tiedosto tulosteelle (%j on ajon tunniste)
#SBATCH --error=errors_%j.txt # Tiedosto virheille (%j on ajon tunniste)
#SBATCH --partition=test # Ajo-osio (jono), käytä yleensä 'small'
#SBATCH --time=00:05:00 # Ajon enimmäiskesto (hh:mm:ss)
#SBATCH --cpus-per-task=1 # Ytimien määrä
#SBATCH --ntasks=1 # Tehtävien määrä (muuta tätä vain monisolmu-/MPI-ajoille)
#SBATCH --nodes=1 # Solmujen määrä (muuta tätä vain monisolmu-/MPI-ajoille)
#SBATCH --mem-per-cpu=2000M # Varattava muisti CPU-ydintä kohti
# Lataa r-env-moduuli
module load r-env
# Suorita R-skripti
srun Rscript --no-save myscript.R
Yllä olevassa esimerkissä yksi tehtävä (--ntasks=1) suoritetaan yhdellä CPU-ytimellä (--cpus-per-task=1), 2 GB muistilla (--mem-per-cpu=2000M) ja viiden minuutin ajoajalla (--time=00:05:00), jotka on varattu ajolle.
Komento module load r-env lataa uusimman saatavilla olevan r-env-version. Jos haluat määrittää ladattavan moduuliversion, käytä komentoa module load r-env/<version>, esimerkiksi module load r-env/461.
Tärkeää: varmista, että R-eräajollasi on riittävästi levytilaa väliaikaistiedostoille
Jokaisella käyttäjällä on oletuksena 20 GiB väliaikaista tallennustilaa paikallisella levyllä osioissa small, interactive ja test.
Tähän tallennustilaan viitataan ympäristömuuttujalla $TMPDIR.
Jos R-ajosi tuottavat erittäin paljon tai erittäin suuria väliaikaistiedostoja niin, että 20 GiB ylittyy,
käytä medium-osiota ja varaa kokonainen solmu, jolloin saat oletuksena 600 GiB väliaikaista tallennustilaa muuttujan $TMPDIR kautta.
Vaihtoehtoisesti voit varata nopeaa tallennustilaa eriytetystä tallennuksesta
tai ohjata väliaikaistiedostot projektisi /scratch-hakemistoon alla olevan esimerkin mukaisesti. Paikallisen tallennustilan käyttö on suositeltavampaa kuin /scratch-hakemiston käyttö.
Kun eräajotiedosto on valmis, se lähetetään eräajojärjestelmään kirjautumissolmulla:
Rinnakkaiset eräajot
r-env-moduulia voidaan käyttää rinnakkaislaskentaan useilla tavoilla. Näihin kuuluvat moniydin- ja taulukkolähetykset sekä MPI (Message Passing Interface) -pohjaiset ja moni-solmu -ajot.
Moduulin mukana tulee useita paketteja, jotka tukevat monisolmuviestintää MPI:n kautta: future, snow, doMPI (käytetään yhdessä foreach-paketin kanssa) ja pbdMPI.
Katso erillinen dokumentaatio seuraavista aiheista:
Jos tarvitset lisäneuvoja rinnakkaisista R-ajoista ja niiden tehokkaasta suorittamisesta CSC:n supertietokoneilla, ota yhteyttä CSC:n asiakastukeen.
R-pakettien asennukset
r-env sisältää yli 1700 esiasennettua R-pakettia. Jos haluat tarkistaa, onko tietty paketti jo asennettu, helpoin tapa on yrittää ladata se:
Jos et halua ladata pakettia, voit myös hakea sitä listasta:
Lisää R-paketteja voidaan asentaa kahta reittiä:
-
Asenna paketti itse projektillesi erilliseen pakettihakemistoon
/projappl/<project>-hakemistossa (ohjeet alla) -
Pyydä yleistä asennusta (tarjotaan kaikille käyttäjille osana moduulia): ota yhteyttä CSC:n asiakastukeen
Jos haluat asentaa paketin itse projektillesi:
Luo ensin uusi kansio projektisi projappl -hakemistoon. Kansion nimen voit valita vapaasti, mutta huomaa, että kansion tulee olla käytössäsi olevalle R-versiolle yksilöllinen.
Eri r-env- ja R-versio vaativat uuden asennuksen. Luo kansio R:ssä näin:
# Replace <project> with your project number (project_xxxxxxx) and <rversion> with the R version you are working with, for example `project_rpackages_461` for r-env/461.
dir.create("/projappl/<project>/project_rpackages_<rversion>")
Tämän jälkeen voit lisätä kansion R:n kirjastopolkuihin suorittamalla R:ssä seuraavan komennon:
Jos haluat käyttää/projappl-hakemistoon asennettuja R-paketteja, lisää yllä oleva komento R-skriptisi alkuun. Se muokkaa kirjastopolkuja vain kyseisen R-istunnon aikana. Toisin sanoen sinun täytyy suorittaa se joka kerta, kun käynnistät R:n.
Yllä olevien ohjeiden jälkeen pakettiasennusten pitäisi nyt oletuksena kohdistua projektikansioon. Seuraavalla komennolla voit tarkistaa, että kansio näkyy R:lle. Sen pitäisi olla listan ensimmäisenä.
Voit tarvittaessa määrittää polun myös asennuskomennossa:
R-version voi hakea myös automaattisesti komennolla getRversion(). Esimerkiksi:
Jotta .libPaths-asetusta ei tarvitsisi määrittää joka kerta R:ää käynnistettäessä, voit lisätä halutut muutokset .Renviron-tiedostoon alla olevan esimerkin mukaisesti. Tätä lähestymistapaa suositellaan erityisesti silloin, jos asentamaasi pakettia
käytetään rinnakkaisprosessoinnissa, jotta kaikki prosessit näkevät paketin.
Kun käytät r-env:iä, käyttäjän määrittämät muutokset R:n kirjastopolkuihin on tehtävä R-istunnon sisällä tai .Renviron-tiedostoon liittyen. Muut muutokset (esim. ympäristömuuttujien muokkaaminen export-komennolla) eivät toimi, koska R-asennus toimii Apptainer-kontin sisällä. Jos analyysisi vaatisi muutoksia, joita ei voi toteuttaa yllä kuvatuilla tavoilla, ota yhteyttä meihin moduulinlaajuista pakettiasennusta varten.
Nopean paikallisen tallennustilan käyttö
Töissä, joissa luetaan ja kirjoitetaan suuri määrä tiedostoja (I/O-intensiiviset analyysit), nopeaa paikallista tallennustilaa voidaan käyttää ei-interaktiivisissa eräajoissa pienin muutoksin eräajotiedostoon. Interaktiiviset R-ajot käyttävät nopeaa paikallista tallennustilaa oletuksena.
Alla on esimerkki sarjallisesta eräajosta, joka käyttää 10 GB nopeaa paikallista tallennustilaa (--gres=nvme:10) Mahdissa. Tässä väliaikaishakemisto määritetään ympäristömuuttujalla TMPDIR, toisin kuin aiemmassa esimerkissä, jossa se asetettiin muotoon /scratch/<project>.
Roihun CPU-osioissa small, interactive ja test jokaisella käyttäjällä on oletuksena 20 GiB väliaikaista paikallista tallennustilaa. Tämä tallennustila soveltuu I/O-intensiivisiin tehtäviin, ja siihen viitataan
ympäristömuuttujalla $TMPDIR. Jos tarvitset enemmän tallennustilaa I/O-intensiivisiin tehtäviin, katso ohjeet nopeasta paikallisesta scratch-tallennustilasta Roihussa.
r-env:n käyttö Stanin kanssa
r-env-moduuli sisältää useita paketteja, jotka tarjoavat rajapinnan Staniin bayesilaiseen päättelyyn perustuvaa tilastollista mallinnusta varten, kuten rstan ja cmdstanr.
R:n käyttö CmdStan-taustaohjelman kanssa
r-env-moduulin mukana tulee erillinen CmdStan -asennus, joka on sidottu jokaiseen moduuliversioon.
Sen käyttämiseksi oikea polku CmdStaniin täytyy asettaa cmdstanr:n avulla. Tämä tehdään seuraavasti:
Jos käytät CmdStania interaktiivisessa istunnossa, yllä oleva komento toimii suoraan. Ei-interaktiivisissa eräajoissa Mahdissa CmdStanin polku täytyy asettaa erikseen eräajotiedostossa. Tämä tehdään lisäämällä seuraavat komennot muun eräajotiedoston sisällön jatkoksi:
Muut CmdStan-taustaohjelman käyttöön liittyvät yksityiskohdat ovat pakettikohtaisia. Yhtenä esimerkkinä sitä voidaan käyttää brms -paketin kanssa:
library(brms)
fit_serial <- brm(
count ~ zAge + zBase * Trt + (1|patient),
data = epilepsy, family = poisson(),
chains = 4, cores = 4, backend = "cmdstanr"
)
Huomaa, että ketjun sisäinen rinnakkaistaminen brms:llä vaatii projektikohtaisen CmdStan-asennuksen. Ota yhteyttä CSC:n asiakastukeen saadaksesi ohjeet.
Säieaffiniteettimuuttujan APPTAINERENV_OMP_PLACES=cores on havaittu häiritsevän rinnakkaisajoja, joissa käytetään rstan-pakettia. Suosittelemme tällä hetkellä, että tätä muuttujaa ei käytetä Stania hyödyntävissä rinnakkaisissa R-ajoissa.
Profilointityökalut R:ssä
Yleisimmät profilointityökalut R:ssä ovat utils::Rprof() ja profvis.
Kun yrität nopeuttaa R-ajoa, voit käyttää näitä työkaluja skriptisi hitaimpien osien tunnistamiseen ja muokata sitten niitä. Esimerkiksi eri pakettien funktiot voivat käyttää eri määrän aikaa samankaltaiseen laskennalliseen tehtävään.
Lisätietoja saat aloittamalla lukemisesta profiloinnista profvisillä RStudiossa ja profiloinnista R:ssä yleisesti.
Käytännössä yleensä paras tapa nopeuttaa R-ajoa supertietokoneella on muokata se käyttämään useita ytimiä ja ajamaan rinnakkain. Katso esimerkkejä rinnakkaisten R-eräajojen skripteistä ja johdanto rinnakkaisiin R-ajoihin, ja ota yhteyttä CSC:n asiakastukeen saadaksesi neuvoja.
Työskentely Allaksen kanssa
r-env-moduulin mukana tulee aws.s3 -paketti S3-tallennuksen käyttöön, mikä mahdollistaa Allas-tallennusjärjestelmän käytön suoraan R-skriptistä. Katso tästä linkistä käytännön esimerkki rasteridatasta.
Allakseen pääsee r-env-moduulin kautta seuraavasti. Määritä ensin Allas suorittamalla nämä komennot terminaalissa. Tämä tarvitsee tehdä vain kerran, kun
käytetään oletusarvoista S3-protokollaa Roihussa.
Voit nyt hakea ämpärilistasi seuraavasti:
library(aws.s3)
Sys.setenv(AWS_S3_ENDPOINT="a3s.fi")
options("cloudyr.aws.default_region" = "")
bucketlist()
Datan latauskomennot riippuvat tiedostotyypistä. Tässä on esimerkkejä .RData-, .json- ja .csv-tiedostoille:
# .RData:
s3load(
object = "path/to/file.RData",
bucket = "your-bucket-name"
)
# .json file:
data <- s3read_using(
FUN = jsonlite::fromJSON,
object = "path/to/file.json",
bucket = "your-bucket-name"
)
# .csv file:
data <- s3read_using(
FUN = read_csv,
object = "path/to/file.csv",
bucket = "your-bucket-name"
)
Ongelmia pdf-renderöinnissä
Jos R Markdown- tai Quarto-dokumenttien pdf-renderöinti ei toimi, suorita seuraava komento R:ssä. Kun sinulta kysytään olemassa olevasta LaTeX-jakelusta, valitse y eli kyllä jatkaaksesi asennusta siitä huolimatta.
Viittaaminen
Jos haluat selvittää oikeat viittaukset R:lle ja eri R-paketeille, voit kirjoittaa:
Lisätietoja
-
r-env-kontin reseptit (linkki julkiseen GitHub-repositorioon) -
R:n UKK (CRANin ylläpitämä)
-
Aiheeseen liittyvät projektit (lista R:ään liittyvistä projekteista R Projectin verkkosivulla)
-
R-pakettien cheatsheetit (ylläpidetty RStudion verkkosivulla)
-
tidyverse (esiasennettu
r-env-moduuliin)