Jupyter kursseille

Jupyter kursseille -sovellus on versio Jupyter-sovelluksesta, joka tekee mukautetun Python-ympäristön käytöstä helppoa kurssien järjestämisessä tai niille osallistuttaessa.

Python-ympäristöt voidaan määritellä moduuleina projektin ProjAppl-hakemistossa. Kurssin Python-ympäristön oletusresurssit voidaan myös määritellä samassa hakemistossa.

Sovelluksen käyttö

Sovelluksen käynnistyslomakkeessa:

Valitse kurssilla käytettävä projekti ja varaus. Varauskenttä näkyy vain, jos sinulla on aktiivinen varaus, johon sinulla on käyttöoikeus.
Valitse kurssimoduuli
Käynnistä sovellus

Kurssiympäristön luominen

Kurssiympäristöjen (moduulien) tiedostot voidaan luoda Puhdissa hakemistoon /projappl/<project>/www_puhti_modules/ ja Mahdissa hakemistoon /projappl/<project>/www_mahti_modules. Hakemistot voidaan luoda, jos niitä ei vielä ole olemassa.

Kurssiympäristö näkyy vain sille projektille, jota varten se on luotu. Huomaa, että sinun voi olla tarpeen valita selainkäyttöliittymän Help-valikosta Restart Web Server, jos kurssiympäristö ei näy lomakkeessa tiedostojen luomisen ja oikean projektin valinnan jälkeen.

Kurssimoduuleihin tarvitaan kaksi tiedostoa:

<course>.lua-tiedosto, joka määrittelee moduulin, joka ottaa Python-ympäristön käyttöön. Vain tiedostot, jotka sisältävät tekstin Jupyter, näkyvät sovelluksessa.
<course>-resources.yml-tiedosto, joka määrittelee Jupyterille käytettävät oletusresurssit.

Esimerkkejä

Moduuli (/projappl/project_1234567/www_puhti_modules/some-course.lua):

-- Jupyter
depends_on("module1","module2")
prepend_path("PATH","/path/to/installation/bin")
setenv("_COURSE_BASE_NAME","FolderName")
-- Relative to the course dir
setenv("_COURSE_NOTEBOOK","notebooks/tutorial.ipynb")
setenv("_COURSE_GIT_REPO","https://github.com/VeryCoolCode/projectA.git")
-- Anything valid for checkout
setenv("_COURSE_GIT_REF","")
-- lab / notebook / empty (defaults to jupyter)
setenv("_COURSE_NOTEBOOK_TYPE","notebook")

Resurssit (/projappl/project_1234567/www_puhti_modules/some-course-resources.yml):

cores: 4
time: "02:00:00"
partition: "interactive"
local_disk: 32
mem: "16GB"
reservation: "my-course-reservation"

Osa resursseista voidaan jättää pois, jos ne eivät ole olennaisia, esimerkiksi jos sinulla ei ole varausta tai osiossa ei ole paikallisia levyjä.

Oppaat

Kurssijärjestäjille tarkoitettu opasesimerkki: Tämä opas on hyödyllinen kurssijärjestäjille, jotka haluavat tarjota mukautettuja Jupyter-muistikirjoja selainkäyttöliittymien kautta.