Jupyter
Jupyter-interaktiivisovellus käynnistää Jupyter-laskentamuistikirjan IPython -ytimellä, jota voi käyttää supertietokoneen selainkäyttöliittymän kautta.
Sovelluksen käynnistyslomakkeessa voit määrittää Python-ympäristön, Jupyter-käyttöliittymän tyypin (Jupyter Notebook tai JupyterLab), työhakemiston sekä joitakin edistyneempiä asetuksia.
Lisätietoja eri Python-ympäristöjen käytöstä Roihussa, Puhdissa ja Mahdissa on Python-sovellussivullamme ja Pythonin käyttöoppaassa. Huomaa, että kaikkien Python-sovellussivulla lueteltujen moduulien ei taata toimivan Jupyter-interaktiivisovelluksessa. Lisäksi Python-pakettien asennus toimii eri tavalla kuin käyttöoppaan yleisohjeissa.
Tuetut Python-ympäristöt Roihussa
CPU-osiot:
- python-data
- python-geo
GPU-osiot:
- python-data
- python-pytorch
Huomaa, että Python-moduulin pudotusvalikko näyttää vain parhaillaan valitussa osiossa saatavilla olevat moduulit.
Tuetut Python-ympäristöt Puhdissa ja Mahdissa
- geoconda
- python-data
- pytorch
- qiskit
- tensorflow
Pakettien asentaminen
Python-paketteja on mahdollista asentaa pip:llä interaktiivisen Jupyter-istunnon sisällä. Tätä varten
sinun täytyy ottaa käyttöön joko User packages tai Virtual environment -vaihtoehto
kohdassa Additional packages ja antaa haluttu asennuspolku ennen istunnon käynnistämistä. Nämä
vaihtoehdot näkyvät, kun otat käyttöön lomakkeen lopussa olevan Enable advanced settings -vaihtoehdon.
Jos et määritä asennuspolkua, paketit asennetaan hakemistoon
$HOME/.local/lib Puhdissa ja Mahdissa sekä hakemistoon $HOME/.local/x86_64/lib tai $HOME/.local/aarch64/lib/
Roihussa. Tätä ei kuitenkaan suositella, koska kotihakemiston
tallennuskiintiö on rajallinen.
Jos haluat asentaa paketteja määritettyyn käyttäjäpakettihakemistoon, käytä muistikirjassa seuraavaa komentoa:
Jos haluat asentaa paketteja virtuaaliympäristöön, voit käyttää komentoa:
!{sys.executable} -m pip install <package>
On suositeltavaa käyttää joko virtuaaliympäristöä tai asettaa Pythonin käyttäjäpakettien poluksi hakemisto /scratch- tai /projappl-alueella sovellusta käynnistettäessä, jos sinun täytyy asentaa paketteja.
Ympäristön mukauttaminen
Mukautettuja Python-ympäristöjä voidaan luoda Python-moduulien tai järjestelmään asennetun Pythonin pohjalta. Python-ympäristön mukauttamisen asetukset ovat sovelluslomakkeen edistyneissä asetuksissa.
Jos haluat käyttää sellaisen moduulin Python-asennusta, jota ei tarjota sovelluslomakkeessa, voit valita Custom module ja syöttää omat moduulisi lomakkeen Custom Python module -kenttään. Jos Custom Python module -kenttä jätetään tyhjäksi, käytetään järjestelmän Pythonia. Huomaa, että tämä edellyttää virtuaaliympäristöjen käyttöä.
Tykky-asennukset
Jos haluat käyttää Tykky-asennusta Jupyterin kanssa, sisällytä ensin Jupyter-paketit Tykky-asennukseesi. Avaa sitten Roihun, Puhdin
tai Mahdin selainkäyttöliittymä ja siirry Jupyter-sovellussivulle. Valitse lomakkeessa Python-pudotusvalikosta vaihtoehto Custom path.
Syötä sitten Tykky-asennuksesi Python-tulkin täydellinen polku. Jos siis loit asennuksen komennolla conda-containerize new
--prefix=/scratch/proj/myInst env.yml, syötettävä polku olisi
/scratch/proj/myInst/bin/python.
Virtuaaliympäristö
Note
Varmista, että käytät oikeaa Python-ydintä käyttäessäsi virtuaaliympäristöä.
Muussa tapauksessa virtuaaliympäristöön asennettuja Python-paketteja
ei välttämättä voi tuoda muistikirjaan. Kun käynnistät
Jupyterin virtuaaliympäristöllä, selainkäyttöliittymän asentaman
ytimen nimi on Python 3 (venv).
Voit luoda virtuaaliympäristön ottamalla käyttöön Virtual environment -vaihtoehdon sovelluslomakkeessa,
kuten Pakettien asentaminen -osiossa näkyy, ja antamalla halutun polun
virtuaaliympäristöllesi kentässä Virtual environment path. Polun tulee sijaita joko
/scratch- tai /projappl-alueella. Esimerkiksi /scratch/<project>/<username>/<venv>.
Voit myös luoda virtuaaliympäristön päätteessäsi siirtymällä joko /scratch- tai /projappl-kansioon ja luomalla ympäristön komennolla:
python -m venv --system-site-packages <venv>
Varmista, että lataat moduulin, jota aiot käyttää, ennen virtuaaliympäristön luomista.
Kun käynnistät aiemmin luodun virtuaaliympäristön myöhemmin, sinun täytyy valita sama Python-moduuli ja antaa sama virtuaaliympäristön polku kuin ympäristöä luotaessa. Jupyterissa voit tarkistaa parhaillaan käyttämäsi virtuaaliympäristön suorittamalla muistikirjassa komennon !echo $VIRTUAL_ENV.
Jos haluat asentaa paketteja virtuaaliympäristöösi, voit suorittaa Jupyter-muistikirjassasi komennon !{sys.executable} -m pip install <package>.
Virtuaaliympäristöt eivät tällä hetkellä ole täysin eristettyjä, koska ne käyttävät ladattujen moduulien paketteja.
Hyödyllisiä Jupyter-komentoja
Muista suorittaa ensin import sys.
| Toiminto | Komento |
|---|---|
| Asenna paketti käyttäjähakemistoon | !{sys.executable} -m pip install --user <package> |
| Asenna paketti virtuaaliympäristöön | !{sys.executable} -m pip install <package> |
| Tarkista nykyinen venv | !echo $VIRTUAL_ENV |