Skip to content
This repository has been archived by the owner on Dec 15, 2023. It is now read-only.

Latest commit

 

History

History
145 lines (81 loc) · 12.7 KB

ohjeet_qaava_plugin_kaytto.md

File metadata and controls

145 lines (81 loc) · 12.7 KB

QAAVA-plugin käyttöohjeet

Vaihe 1. PostGIS-tietokantayhteyden luominen

Tarvitset QAAVA-lisäosan käyttöön PostGIS-tietokannan eli PostgreSQL-tietokantaohjelmiston ja PostGIS-extension.

Jos käytössäsi on PostGIS-tietokanta, luo ensin QGISissä yhteys siihen esimerkiksi selain-näkymässä PostGIS-yhteyden kohdalla klikkaamalla hiiren oikealla ja täyttämällä yhteystiedot.

  • Nimi: tietokantayhteyden nimi, voit laittaa tähän mitä tahansa
  • Isäntä (host): tietokannan palvelimen osoite
  • Portti: palvelimen portti. PostgreSQL käyttää oletuksena aina porttia 5432
  • Tietokanta: yhdistettävän tietokannan nimi
  • Autentikointi: Valitse välilehti yksinkertainen todennus ja kirjoita käyttäjänimi ja salasana. Voit sen jälkeen klikata "Convert to configuration", jolloin yhteystiedot tallentuvat QGISin pääsalasanan taakse ja niitä ei tarvitse enää kirjoittaa uudelleen joka kerta. Jos et ole vielä asettanut pääsalasanaa QGISiin se pitää tehdä Asetukset > Valinnat > Autentikointi ja anna uusi pääsalasana.

Valitse myös ruksit kohtiin: "Listaa taulut ilman geometriaa" ja "Salli QGIS projektien tallennus tietokantaan/sta"


Testaa näetkö selainnäkymässä PostGIS-yhteyksien alla luomasi tietokantayhteyden.

Jos työstät sekä asema- että yleiskaavaa, lisää molemmille omat tietokantansa, jotta voit hyödyntää toista yleiskaavan ja toista asemakaavan käyttöön. ÄLÄ LAITA SAMAAN KANTAAN MOLEMPIA KAAVAMALLEJA, ne sisältävät saman nimisiä tauluja ja voivat mennä sen vuoksi sekaisin.

Huomaathan, että PostGISin käytössä on hyvä olla pääkäyttäjä, joka pystyy poistamaan tietokannan tai päivittämään tietomalleja. Lisäksi muille peruskäyttäjille voidaan sallia vain käyttöoikeudet tietokantaan, jolloin näillä ei ole oikeutta poistaa tietokantapohjaa tai päivittää sitä.

Jos et tiedä miten PostGIS-yhteyden saa käyttöön, ota yhteyttä info@gispo.fi. Gispo Oy voi myös tarvittaessa asentaa ja ylläpitää tietokannan puolestanne.

Vaihe 2. Asenna QAAVA-lisäosa

  1. QAAVA-lisäosa on saatavilla QGISin laajennososa-listalta ja sen tiedot löytyvät myös täältä: https://plugins.qgis.org/plugins/Qaava/
  2. Avaa QGIS ja valitse Lisäosat -> Hallitse ja asenna lisäosia
  3. Paina "Kaikki" kohdasta ja kirjoita hakukenttään QAAVA
  4. Asenna lisäosa
  5. Lisäosa on asentunut onnistuneesti, kun ikkunan yläosaan tulee viesti ja se näkyy asennetuissa lisäosissa

Vaihe 3. Alusta kaavan tietomalli (tarvitsee tehdä vain kerran!)

  1. Avaa Qaava-lisäosa valitsemalla QGISin yläpalkista Lisäosat -> Qaava -> Qaava
  2. Ensimmäiseksi työkalu avaa oletusnäkymän, jossa valitaan halutaanko tuottaa asema- vai yleiskaavaa. Ensimmäisellä kerralla yhteys pitää määrittää Database-kohdasta kuntoon, jos tietokantaa ei ole vielä sieltä määritelty. Muuten tästä oletusnäkymän paneelista avataan työtila kaavalle.

  1. Valitse ensimmäisellä kerralla (eli siis silloin, jos et ole vielä ottanut QAAVA-työkalulla yhteyttä tietokantaan) työkalusta kohta "Database"

  1. Valitse kohtaan "Available PostGIS databases" haluamasi tietokantayhteys. Huom! Asema- ja yleiskaavalle kannattaa olla omat tietokannat valmiina.
  2. Valitse kohtaan "Data Model for the database" haluamasi malli (general=yleiskaava, detailed=asemakaava, käännökset ja tekstit tarkentuvat myöhemmin).
  3. Vahvista laatikko "I understand that this action..."
  4. Paina "Initialize". Huom! Tämä toiminta hävittää aina kaikki vanhat tiedot kannasta, jos siellä on jo tuotu kaavan tietomalli, eli todellakin ymmärrä mitä teet :)
  5. Alustuksen valmistumisen merkiksi QGISin yläosaan tulee viesti, jos kaikki menee hyvin
  6. Promote kohdassa voi näkyä tietokannan versioissa eroja (current vs. newest). Näin voi käydä, jos työkalun kehityksessä tietokannan malli päivittyy. Silloin kannattaa painaa promote. Tätä ei tarvitse tehdä kovinkaan usein.

Promote

  1. Valitse QGIS-projekti (tietokantaan tallentuu samalla QGIS-projekti, joka näkyy nyt työkalun valikossa).

Valinta avaa QGIS-projektin automaattisesti näkyviin. Työtilat löytyvät myös tietomallin public-skeemasta, jos olet sallinut QGIS-projektin tallennuksen tietokannan yhteyksien muodostamisen yhteydessä. Muuten QAAVA-lisäosan aloituspaneelista (kohta 1) pääset aina työtilaan takaisin.

Projekti

Vaihe 4. QGIS-projektin hyödyntäminen

Työtilassa pitäisi nyt näkyä QGIS-projekti joko asema- tai yleiskaavalle.

Koodilistat ja ei-geometriaa sisältävät taulut

Huomaat, että työtilassa on paikkatietotasoja sekä liuta taulukoita, joissa ei ole geometriaa.

Suurin osa näistä tiedoista on koodilistoja (esim. kaavan tyyppi, prosessin vaihe, maankäyttöluokka). Koodilistat perustuvat kaavan tietomallityöhön, QAAVA-kehittämisryhmän kommentteihin sekä visualisointien osalta MRL:n oppaisiin. Esimerkiksi Maankäyttöluokka-taulu sisältää kaikki MRL:n visualisointiohjeistuksessa löydetyt aluevarausluokitukset (LHA, T, VL, MA). Emme ole estäneet omien tietojen syöttöä näihin listoihin.

Jos listalta puuttuu olennaisia tietoja, taulukoita voi editoida ja lisätä omia koodeja listoille. Huomaathan tällöin, että esimerkiksi visualisoitaessa maankäyttöluokkia, visualisoinnin arvo tulee maankäyttöluokka-taulun id:n perusteella. Lisäksi, jos teet uuden koodin esimerkiksi maankäyttöluokka-tauluun, pitää se myös erikseen visualisoida maankäyttöalueiden luokituksessa. Mieluusti otamme myös vastaan kehitysehdotukset ja virheraportit. Tee silloin issue tänne GitHubiin ja kuvaile mitä haluaisit tehtävän.

Koodilista asemakaavan maankäyttöluokille.

Vastaava lista on käytössä asemakaavan maankäyttöalueen lomakkeella alasvetovalikossa. Se on viritetty QGISin työtilassa attribuuttilomakkeen muokkauksen avulla siten, että lomake hakee tiedot suoraan koodilistalta. Lisäksi kohteet visualisoidaan maankäyttöluokan gid-sarakkeen perusteella (gid_maankayttoluokka).

Tutustu vastaavasti taulukkomuodossa vaihetieto-listaan tai dokumenttityyppi-listaan. HILUCS- ja HSRCL-taulut ovat tyhjiä, sillä odotamme ohjeistusta kansalliselta tasolta. Ne liittyvät INSPIRE-direktiivin Planned Land Use -skeeman yleiseurooppalaisiin maankäyttöarvoihin, jotka kansallisesti pitäisi määrittää (eli esim. "Teollisuus- ja varastoalue" on HILUCS-luokituksessa luultavasti luokka "2 jalostus").

Lisäksi työtilassa on N:M -relaatioiden kanssa aputauluja, jotka yhdistävät mm. numeerisen arvon, kaavamääräyksen, dokumentit ja yleiskaavan tapauksessa teeman spatiaalisiin kaavakohteisiin. Kaavamääräys-, teema-, numeerinenarvo- sekä dokumentti-taulut ovat lähtökohtaisesti tyhjiä ja ne saavat sisältönsä vasta kun käyttäjä tuottaa tietoja kirjaamalla kaavakohteiden lomakkeen avulla. Näihin tauluihin voi kuitenkin tuoda jo etukäteen tietoja, esimerkiksi jos lista kaavan tuotannosta hyödynnettävistä dokumenteista on saatavilla. Listoja voi editoida myös jälkikäteen. Many-to-many-aputaulut yhdistävät esimerkiksi dokumentin kaavakohteeseen. Käyttäjän ei tarvitse normaalisti välittää näistä aputauluista ollenkaan. Virhetilanteissa niitä joutuu mahdollisesti editoimaan, pyydämme tällöin ilmoittamaan virheistä GitHubin issueiden kautta.

Jos tietomallin rakenne kiinnostaa enmmän, katso aina uusimman tietomalliversion kuvat yleiskaavan osalta täältä ja asemakaavan osalta täältä

Älä poista mitään työtilasta, sillä kaikkia tauluja tarvitaan. Jos näin tapahtuu vahingossa, saat palautettua alkuperäisen QAAVA-työtilan QAAVA-lisäosalla.

Geometriaa sisältävät tasot eli kaavakohteet

Voit alkaa lisäämään kohteita, tee ensin kaavan ulkoraja. Älä anna sille vielä mitään erityisiä lisätietoja vaan luo se ensin. Huomaat, että se piirtyy valmiilla rajausvisualisoinnilla kartalle. Kaikille QAAVA-työtilan geometriatasoille on luotu valmiit visualisoinnit. Esimerkiksi kaavan ulkoraja piirtyy automaattisesti MRL:n oppaan 2003 mukaisesti.

Klikkaa sitten kohde uudelleen auki (info-työkalulla tai attribuuttitaulusta). Jos näkymään avautuu tavallinen taulukkonäkymä, lomakkeelle pääset taulukon alaoikeasta kulmasta klikkaamalla lomakenappia. Info-työkalun asetuksista voi myös määrittää miten taulukko jatkossa avautuu.

Kaavan ulkorajaan voidaan liittää perustietoja kaavasta, sen tyyppi, prosessin vaihe, luontipäivämäärä, mahdollinen hyväksymispäivämäärä, nimi, vastuuhenkilön tiedot ja siihen liittyvät dokumentit ja kaavamääräykset.

Huom! Jotta tietojen yhteydet toisiin tauluihin toimivat, kannattaa aina ensin luoda geometriakohteet ja sitten lisätä esimerkiksi teemoja, kaavamääräyksiä tai muita lisätietoja. Kohde pitää siis olla ensi olemassa (sisältää rivin tietoa), ennenkuin siihen voi liittää muita tietoja N:M-ralaatioiden kautta. Tähän mahdollisesti kehitetään helpotusta QAAVAn jatkoprojekteissa.

Automaattiset tiedot

Osa tiedoista saadaan kaavakohteille automaattisesti, kuten kohteen käyttäjän tiedot (tulee käyttöjärjestelmästä) ja luomispäiväys (tulee käyttöjärjestelmästä). Lisäksi, jos kaavan ulkorajaus on luotu, kaikki sen sisään jäävät kaavakohteet saavat kyseisen ulkorajan tiedot. Periaatteessa on mahdollista luoda siis samassa työtilassa useita kaavoja (esim. eteläinen kaupunginosakaava ja pohjoinen kaupunginosakaava). Kannattaa kuitenkin kunnan sisäisissä prosesseissa miettiä tuleeko tästä mahdollisia ongelmia.

Visualisointi

Yleiskaavan ulkorajauksen lisäksi valmiiksi visualisoituna ovat myös muut geometriataost: maankäyttö, osa-alueet, pisteet, viivat. Valmis visualisointi perustuu kaavakohteiden luokituksiin, esim. maankäyttöalueen osalta maankayttoluokka-tauluuun. Jos haluat lisätä uusia luokkia listalle, pitää tieto löytyä siis myös maankayttoluokka-taulusta sekä tiedon pitää olla liitettynä johonkin kaavakohteeseen. Silloin myös kuvaustekniikkaan pitää muistaa lisätä tehty uusi luokittelu.

Vaihe 5. Tietojen suodatus

Kun tietoja on tuotettu, niitä voi suodattaa eri tavoin SQL:n avulla. Mutta koska kaikille SQL ei ole ihan tuttu ja kaavan tietomallista muodostuu aika monimutkaisiakin yhteyksiä taulujen välillä, teimme työtä helpottamaan lisäosan yhteyteen suodatus-työkalun.

Kysely ei tuota uutta taulua työtilaan vaan suodattaa olemassa olevia tauluja siten, että lopputuloksessa näkyvät vain suodatuksen tulokset. Esimerkkejä suodatuksista voi olla vaikkapa: "Näytä kaaavoittajan x tekemät muutokset päivänä y", jos halutaan näyttää vain tietyn henkilön tuottamat kohteet. Jos on tarve tarkistaa, että onko kaikilla kaavakohteilla kaavamääräys, voidaan tehdä suodatus joka toteuttaa lauseen "Näytä kaikki ne maankäyttöalueet joilla ei ole kaavamääräyksiä".

Projekti Projekti

Vaihe 6. Kaavan tulostepohja ja kaavaseloste

QAAVA-työtilassa on valmiit pohjat kaavan pdf-version tekoa varten. Pohjia voi hyödyntää tarpeen mukaan tai tehdä omat. Tämän hetkinen tulostemalli poimii vain näkymässä olevat tiedot selosteeseen. Kaavaseloste luodaan kaavakohteiden avulla ja tällä hetkellä näyttää vain kaavamääräyksen otsikon.

Tiedossa olevia ongelmia ja jatkokehitykseen meneviä asioita

Usean kohteen editointi siten, että esimerkiksi saman kaavamääräyksen voisi liittää valituille kohteille ei QGISissä nykyisellään vielä onnistu. Samaan haasteeseen liittyy kaavakohteen jakaminen kahtia, kaavamääräys ei periydy kohteen toiselle puolikkaalle. Tämä on tiedossa oleva haaste ja etsimme siihen rahoitusta.

Kaavaselosteeseen kaavamääräysteksti. Johtuen oletettavasti QGISin selitteenmuodostajan rajoitteista, kaavamääräystekstiä ei ole vielä mukana kaavaselosteessa. Tämä on tiedossa oleva ongelma, johon toivomme kehitysapua.

Yleisiä ohjeita

  • Kun vaihdat tietokantayhteyttä tai suljet projektin, sammuta välillä QGIS jotta varmistut siitä, ettei tietoja menetetä
  • Jos muokkaat QGIS-projektia, voit tallentaa sen tietokantaan QGISin avulla: Projekti -> Tallenna tiedostoon -> PostgreSQL ja valitsemalla seuraavat arvot:
    • Yhteys: käyttämäsi tietokantayhteyden nimi
    • Skeema: public
    • Projekti: voit tallentaa joko saman projektin päälle tai luoda uuden projektin. Uusi projekti on mahdollista ladata samalla tavalla myös lisäosan toimesta.