Hyppää sisältöön

Docs CSC now features an automatic Finnish translation. Click here for more information.

Warning!

Puhti and Mahti are being decommissioned in stages, and their storage areas will become fully unavailable from 15 October 2026. Clean up unnecessary files and move any data you need to keep by 31 August 2026. See the Roihu data migration guide for instructions on transferring your data to Roihu.

Puhti scratch is very full: keep only active data there and move or delete everything else. No new Puhti scratch quota will be granted.

Geoconda

Geoconda on kokoelma Python-paketteja, jotka helpottavat Python-skriptien kehittämistä geoinformatiikan sovelluksiin. Se sisältää seuraavat Python-paketit:

Lisäksi geoconda sisältää:

  • jupyter - Jupyter Notebookit ja JupyterLabin. Käytä Puhdin selainkäyttöliittymästä ja Jupyter-sovelluksesta. Sisältää Dask Extensionin ja Resource usage Extensionin.
  • spyder - Scientific Python Development Environment graafisella käyttöliittymällä (samankaltainen kuin RStudio R:lle). Ei versiossa 3.14.3.
  • GDAL/OGR komentorivityökalut
  • GMT The Generic Mapping Tools
  • landsatlinks - Landsat Collection 2 Level 1 -tuotenippujen lataus-URL-osoitteiden luomiseen USGS/EROS Machine-to-Machine API:n avulla. Käytä komentoa python -m landsatlinks. Ei versiossa 3.14.3.
  • PDAL - Point Data Abstraction Library
  • ncview netcdf-tiedostojen visualisointiin. Ei versiossa 3.14.3. Käytä ncview-moduulia.
  • psy-view netcdf-tiedostojen visualisointiin. Ei versiossa 3.14.3.

Pythonissa on useita paketteja rinnakkaislaskentaan, esimerkiksi multiprocessing, joblib ja dask. Puhdin Python-esimerkeissämme on esimerkkejä siitä, miten näitä eri rinnakkaistamiskirjastoja voidaan hyödyntää.

Jos mielestäsi jokin tärkeä Pythonin GIS-paketti puuttuu tästä, voit pyytää asennusta CSC:n asiakastuesta.

Saatavuus

geoconda-moduuli on saatavilla:

  • 3.14.4 (Python 3.14.4, PDAL 2.10.0, GDAL 3.12.2, luotu toukokuussa 2026), LUMIssa
  • 3.14.3 (Python 3.14.3, PDAL 2.10.0, GDAL 3.12.2, luotu maaliskuussa 2026), Puhdissa ja Mahdissa
  • 3.12.10 (Python 3.12.10, PDAL 2.8.4, GDAL 3.10.2, luotu huhtikuussa 2025), Puhdissa.
  • 3.11.10 (Python 3.11.10, PDAL 2.8.0, GDAL 3.9.2, luotu marraskuussa 2024), Puhdissa ja LUMIssa.
  • 3.11.9 (Python 3.11.9, PDAL 2.7.2, GDAL 3.9.1, luotu elokuussa 2024), Puhdissa ja Mahdissa.
  • 3.10.9 (Python 3.10.9, PDAL 2.5.2, GDAL 3.6.2, luotu maaliskuussa 2023), Puhdissa.
  • 3.10.6 (Python 3.10.6, PDAL 2.4.1, GDAL 3.5.0, luotu syyskuussa 2022), Puhdissa ja Mahdissa.

Versionumero on sama kuin Python-versio.

Roihussa geocondan nimi on muutettu muotoon python-geo

Käyttö

Kun käytät LUMIa, suorita ensin tämä:

module use /appl/local/csc/modulefiles

Yllä lueteltujen Python-pakettien ja muiden työkalujen käyttöön voit alustaa ne komennolla:

module load geoconda

Oletuksena ladataan uusin geoconda-moduuli. Jos haluat tietyn version, voit määrittää geocondan versionumeron:

module load geoconda/[VERSION]

Voit tarkistaa ladattuun moduuliin sisältyvät tarkat paketit ja versiot komennolla:

list-packages

Voit lisätä lisää Python-paketteja geocondaan noudattamalla ohjeita Pythonin käyttöoppaassamme.

Voit muokata Python-koodiasi seuraavilla tavoilla:

Spyderin avaaminen Puhdin, Mahdin tai LUMIn selainkäyttöliittymässä etätyöpöydällä:

  1. Kirjaudu Puhdin tai LUMIn selainkäyttöliittymään.
  2. Avaa etätyöpöytä: Apps -> Desktop.
  3. Etätyöpöydän käynnistämisen jälkeen:
    • Puhdissa/Mahdissa avaa Terminal (Desktop-kuvake)
    • LUMIssa avaa Terminal Emulator vasemman alakulman valikosta
  4. Käynnistä spyder:
    • Muista LUMIssa suorittaa ensin module use /appl/local/csc/modulefiles
module load geoconda
spyder

r5py:n muistiasetukset

r5py ei oletuksena ymmärrä oikein, kuinka paljon muistia sillä on käytettävissä supertietokoneessa, joten se täytyy määrittää käsin. Se käyttää taustalla Javaa, joten lisää ympäristömuuttuja asettamaan Javalle käytettävissä oleva enimmäismuisti:

  • export _JAVA_OPTIONS="-Xmx4g" komentorivillä ennen Pythonin käynnistämistä TAI
  • os.environ["_JAVA_OPTIONS"] = "-Xmx4g" Python-koodisi alussa.

Google Earth Engine -tunnistautumisen käyttöönotto Puhdissa

Google Earth Engine (GEE) API:n käyttämiseen earthengine-api-paketilla tarvitaan GEE-tili ja projekti. Ennen ensimmäistä käyttöä ota myös GEE-tunnistautuminen käyttöön Puhdissa:

module load geoconda
export PATH=/appl/opt/csc-cli-utils/google-cloud-sdk/bin:$PATH
earthengine authenticate

Tämä tulostaa pitkän linkin ja pyytää koodia. Kopioi linkki paikallisen kannettavasi verkkoselaimeen. Seuraa verkkosivun ohjeita ja kopioi lopuksi luotu koodi takaisin terminaaliin.

Allaksen tai LUMI-O:n käyttö Pythonista

Geocondaan on asennettu kaksi Python-kirjastoa, jotka voivat olla vuorovaikutuksessa Allaksen tai LUMI-O:n kanssa. Swiftclient käyttää swift-protokollaa ja boto3 käyttää S3-protokollaa. Löydät CSC:n esimerkkejä molempien käytöstä täältä.

On myös mahdollista lukea ja kirjoittaa tiedostoja Allaksesta ja Altaaseen tai muuhun pilviobjektitallennukseen suoraan GDAL-pohjaisilla paketeilla, kuten geopandas ja rasterio. Katso ohjeet ja esimerkit Paikkatiedostojen käyttö suoraan pilvestä, ml. Allas -ohjeestamme.

Suurten rasteridatamäärien kanssa kannattaa harkita virtuaalirasterien käyttöä.

Lisenssi

Kaikki paketit on lisensoitu erilaisilla vapailla ja avoimen lähdekoodin lisensseillä (FOSS), katso tarkat tiedot yllä linkitetyiltä sivuilta.

Viittaaminen

Katso viittaustiedot pakettikohtaisesti yllä linkitetyiltä pakettisivuilta.

Kiitokset

Mainitse CSC ja Geoportti julkaisuissasi; tämä on tärkeää projektin jatkuvuuden ja rahoitusraporttien kannalta. Voit kirjoittaa esimerkiksi: "The authors wish to thank CSC - IT Center for Science, Finland (urn:nbn:fi:research-infras-2016072531) and the Open Geospatial Information Infrastructure for Research (Geoportti, urn:nbn:fi:research-infras-2016072513) for computational resources and support".

Asennus

Geoconda asennettiin Puhtiin ja Mahtiin käyttäen Tykkyn conda-containerize-toiminnallisuutta. LUMIssa Geoconda asennettiin käyttäen LUMI container wrapperia. Työkalujen toiminnallisuus on lähes identtinen, mutta --post-valinta on LUMI container wrapperissa --post-install. WhiteboxToolsin conda-paketti asentaa vain WhiteboxToolsin asennustyökalun, joten Whiteboxtoolsin oikea asennus vaati lisäksi asennuksen jälkeisen komennon ja kansion komentorivityökalujen käärimiseen.

conda-containerize new --mamba --prefix install_dir --post download_wbt -w miniconda/envs/env1/lib/python3.11/site-packages/whitebox/WBT/whitebox_tools geoconda_3.11.10.yml

Geocondan conda-ympäristötiedostot sekä WhiteboxToolsille tarvittavat download_wbt ja start_wbt.py ovat saatavilla CSC:n geocomputing-repositoriossa. Huomaa, että toistettavuuden vuoksi sinun täytyy määrittää pakettiversiot ympäristötiedostossa; ne voi tarkistaa Puhdissa ja Mahdissa list-packages-komennolla geoconda-moduulin lataamisen jälkeen.

Viitteet

Suomenkielinen tekoälykäännös

Sisällössä voi esiintyä virheellistä tietoa tekoälykäännöksestä johtuen.

Klikkaa tästä antaaksesi palautetta

Ymmärrän.