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 sijaintiin /projappl/<project>/www_roihu_modules/ Roihussa, /projappl/<project>/www_puhti_modules/ Puhdissa ja /projappl/<project>/www_mahti_modules Mahdissa. 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 Restart Web Server Help-valikosta selainkäyttöliittymässä, 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ä.

Ohjeita

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