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, jota sinulla on oikeus käyttää.
Valitse kurssimoduuli
Käynnistä sovellus

Kurssiympäristön luominen

Kurssiympäristöjen (moduulien) tiedostot voidaan luoda Roihussa hakemistoon /projappl/<project>/www_roihu_modules/ ja Mahdissa hakemistoon /projappl/<project>/www_mahti_modules. Hakemistot voidaan luoda, jos niitä ei 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 asettaa Python- ympäristön. Vain tiedostot, jotka sisältävät tekstin Jupyter, näkyvät sovelluksessa.
<course>-resources.yml, joka määrittelee Jupyterille käytettävät oletusresurssit.

Esimerkkejä

Moduuli (/projappl/project_1234567/www_roihu_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_roihu_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äjien opasesimerkki: Tämä opas on hyödyllinen kurssijärjestäjille, jotka haluavat tarjota mukautettuja Jupyter-muistikirjoja selainkäyttöliittymien kautta.