\documentclass[11pt,a4paper,parskip=full]{article}

\usepackage[utf8]{inputenc}
\usepackage[finnish]{babel}
\usepackage[T1]{fontenc}
\usepackage{palatino}
\usepackage{enumitem}
\usepackage[top=2.0cm, bottom=4.5cm, left=2.5cm, right=2.5cm]{geometry}
\usepackage{scrextend}
\usepackage{lastpage}
\usepackage{graphicx}


% header
\usepackage{fancyhdr}
\pagestyle{fancy}
\setlength{\headheight}{2.0cm}
\renewcommand{\headrulewidth}{0pt}
\lhead{\small Sovellusprojekti Groundhog \\}
\chead{\small 3. palaveri 25.2.2021 \\ \small Pöytäkirja}
\rhead{\small Sivu \thepage/\pageref{LastPage} \\}
\cfoot{}



\setlength{\parindent}{0em}
\setlength{\parskip}{1em}

\setlist{nosep}

\newcommand{\otsikkoA}[1]{{ \textbf{\LARGE #1} \vspace{3em}}}
\newcommand{\otsikkoB}[1]{{\vspace{1em} \textbf{\large #1}}}
\newcommand{\otsikkoC}[1]{ #1}
\newcommand{\sisennys}[1]{\begin{addmargin}[2em]{0em}{#1}\end{addmargin}}
\newcommand{\paatokset}[1]{\otsikkoB{Päätökset:}\begin{itemize}{#1}\end{itemize}} %lista päätöksille

\title{Sovellusprojekti Groundhog, 3. palaveri}
\author{}
\date{}

\makeatletter
\let\Title\@title
\makeatother

\begin{document}

\otsikkoA{\Title}


\noindent \begin{tabular}{@{}p{5em}l}
Aika    &   Torstai 25.2.2021 10.00--12.25 \\
Paikka  & Teams-palaveri
\end{tabular}

\vspace{1.0em}

\otsikkoB{Läsnä}

\otsikkoC{Projektiryhmä}
\sisennys{
Riikka Vilavaara, puheenjohtaja \\
Iiro Iivanainen (paikalla kohdissa 5-14)\\
Harri Linna \\
Jere Pakkanen, sihteeri
}
\otsikkoC{Tilaajat}
´\sisennys{
Jukka Kuva \\
Arttu Miettinen
}
\otsikkoC{Ohjaaja}
\sisennys{
Jukka-Pekka Santanen \\
Juuso Tuononen, tekninen ohjaaja
}

\section*{Pöytäkirja}

\begin{tabular}{@{}p{10em}l}
Pöytäkirja laadittu:    &  26.2.2021 \\
Muokattu:               &  \number\day.\number\month.\number\year % muokkauspäivä automaattisesti
                                                                  % kommentoi piiloon jos ei ole vielä
                                                                  % muokattu ja laita tilalle viiva: --
\end{tabular}

\section{Palaverin avaus}

\sisennys{
Vilavaara ehdotti palaverin puheenjohtajaksi itseään ja sihteeriksi Pakkasta. Ehdotus hyväksyttiin ja puheenjohtaja avasi palaverin.

Vilavaara jakoi esityslistan osallistujille ruudunjaon välityksellä.
}

\section{Laillisuus ja päätösvaltaisuus}

\sisennys{
Puheenjohtaja totesi, että palaverissa on paikalla Santanen, vähintään yksi projektiryhmän jäsen ja vähintään yksi tilaajan edustaja. Puheenjohtaja myös varmisti, että kaikki paikallaolijat olivat saaneet palaverin esityslistan ainakin vuorokauden ennen palaveria. 

Puheenjohtaja totesi, että palaverin osalta molemmat ennalta mainitut ehdot täyttyvät ja palaveri todettiin lailliseksi ja päätösvaltaiseksi.
}

\section{Esityslistan hyväksyminen}

\sisennys{
Santanen ehdotti projektisopimuksen 0.3.0 läpikäynnin lisäämisen esityslistaan. Puheenjohtaja ehdotti, että kyseinen käydään läpi tilakatsauksen jälkeen. Projektisopimus lisättiin esityslistaan tilakatsauksen jälkeen kohtaan 7. Esityslista hyväksyttiin tällä lisäyksellä.
}

\section{Edellisen palaverin pöytäkirjan tarkastaminen}

\sisennys{
Puheenjohtaja tarkisti, että kaikki olivat ehtineet tutustua toisen palaverin pöytäkirjaan.

Santanen ehdotti seuraavia muokkauksia kyseiseen pöytäkirjaan:
\begin{itemize}
    \item Ensimmäisen pöytäkirjan hyväksyminen lisätään päätökseksi toisen palaverin pöytäkirjaan.
    \item Versiohallinta kohdassa päätös tulee siirtää kohdan loppuun.
    \item Kohdan 12 päätöksen jälkimmäinen virke tulee poistaa.
\end{itemize}

Tuononen ehdotti, että pöytäkirjaan lisätään tarkennus, että versionhallinnalla tarkoitetaan juurikin yliopiston GitLabiä.

\paatokset{
    \item Pöytäkirja hyväksyttiin em. muutoksin.
}
}


\section{Edellisessä palaverissa sovitut toimenpiteet}

\sisennys{
Iivanainen saapui paikalle.

Palaverissa käytiin läpi viime kerralla sovittujen toimenpiteiden tila.

Harri Linna:
\begin{itemize}
    \item Korjaa sopimuksesta Santasen luettelemat muodolliset ja sisällölliset virheet \textbf{(Tehty)}.
    \item Valmistelee virallisen tilakatsauksen ensi- tai sitä seuraavalla viikolla \textbf{(Tehty)}.
\end{itemize}

Jere Pakkanen:
\begin{itemize}
    \item Jatkaa vaatimusmäärittelyn kirjoittamista \textbf{(Tehty)}.
\end{itemize}

Jukka Kuva:
\begin{itemize}
    \item Selvittää, onko hän valtuutettu hyväksymään projektiin liittyvät raportit \textbf{(Tehty)}.

\end{itemize}

Projektin jäsenet:
\begin{itemize}
    \item Korjaavat jäsenten työtuntien kirjaukseen käytettävän Excel-tiedoston \textbf{(Tehty)}.
    \item Perustavat JYU:n tarjoamaan GitLabiin repositorion projektia varten \textbf{(Tehty)}.
    \item Tekevät lisäykset palaverissa esitettyyn ajatuskarttaan \textbf{(Tehty)}.
    \item Alkavat hahmottamaan kehitettävän sovelluksen käyttöliittymää \textbf{(Tehty)}.
\end{itemize}

Santanen kysyi saavatko projektin ohjaajat, sekä tilaajan edustajat kutsun perustettuun GitLab-projektiin.

Vilavaara ei ollut varma, pystyykö hän kutsumaan JYU:n GitLab-projektiin henkilöitä, joilla ei ole yliopiston käyttäjätunnuksia. Esille tuotiin, että aiemmissa projekteissa tilaajalle ollaan pyydetty  tunnukset GitLab-palveluun.

}

\section{Tilakatsaus}

\sisennys{
Ryhmän sisäinen tavoite käyttää projektiin n. 100h/vk oli jäänyt vajaaksi. Santanen ehdotti, että tulevissa tilakatsauksissa kannattaa käyttää ajankäyttölomakkeesta saatavia piirakkakaavioita.

}

\section{Projektisopimus}

\sisennys{
Linna tarkasti, että kaikki palaveriin osallistujat ovat saaneet uuden version 0.3.0 projektisopimuksesta. 
Santanen ehdotti johtoryhmän määrittelyn lisäämisen projektisopimukseen.

Linna kysyi ketkä johtoryhmään kuuluuvat. Kuva sanoi että vain hän GTK:n puolelta.

Santanen kysyi voiko Miettinen toimia palavereissa tilaajan edustajana. Kuvan vastasi että on hyväksyttävää, että Miettinen toimii tilaajan edustajana palavereissa.

Kuva kysyi onko ryhmällä tarvittavat lisenssit projektin tekemiseen. Linna vastasi, että toistaiseksi kaikki projektissa mahdollisesti käytettävät kirjastot ovat avoimen lähdekoodin alla, eli jos projektissa tuotettu sovellus on avointa lähdekoodia, kyseisten kirjastojen käyttöön ei tarvita erillistä lisenssiä.

Kuva kertoi, että GTK:lta sopimuksen tulevat allekirjoittamaan hän ja Marja Lehtonen. Kuva kysyi onko allekirjoitusprosessilla kiire. Santasen mukaan kiirettä ei ole, mutta prosessi olisi hyvä saada alkamaan parin viikon sisään.

Linna kysyi onko tekijänoikeudet mahdollista säilyttää projektiryhmän jäsenillä. Kuvan mukaan GTK:n lakiryhmä ei toistaiseksi ole kiinnittänyt huomiota kyseiseen, joten se on alustavasti OK.

Tuononen kysyi, voiko Visual Studion ilmaisversiota käyttää projektissa.. Miettinen sanoi, että Visual Studion ilmaisversiolla pitäisi pystyä tekemään avointa lähdekoodia, mutta asiaa kannattaa käydä tarkemmin läpi kohdassa 11.

Santanen ehdotti seuraavien kohtien korjaamista sopimuksessa:
\begin{itemize}
    \item Kohdan 6.3 ekasta virkkeestä puuttuu sana “sekä”.
    \item Kurssin nimi kannattaa kirjoittaa kursiivilla kohdan 6.3 lopussa.
    \item Pakotetaan sivunvaihto ennen allekirjoituksia.
    \item Ryhmän nimi tulee tasata samalle riville ensimmäisen ryhmän allekirjoitusrivin kanssa.
    \item Poistetaan kohdasta 3. maininta ohjelmiston ohjeesta palautettavana dokumenttina.
\end{itemize}

\paatokset{
    \item Johtoryhmän muodostaa Jukka Kuva, Jukka-Pekka Santanen, sekä Harri Linna.
    \item Miettinen voi toimia tilaajan edustajana palavereissa.
}
}

\section{Käyttöliittymähahmottelu}

\sisennys{

Ryhmällä oli esittää kaksi erilaista näkemystä mahdollisesta käyttöliittymästä.

Puheenjohtaja esitti ensimmäisen käyttöliittymäluonnoksen.

Kuvan mielestä olisi hyvä, että tietyn kuvakulman suuntaisesti näkymät olisi värikoodattu tietyllä värillä. Kuvan mukaan myös jonkinlainen karttakuva olisi hyvä. Tätä karttakuvaa ei olisi tarkoitus manipuloida, joten siihen voitaisiin ottaa esim. jonkun pääakselin suuntaisen näkymän keskimmäinen siivu. Karttakuva voisi olla myös pienennetty alkuperäisestä koosta. Tästä näkymästä näkyisi kaikkien avattujen näkökulmien tarkasteltavat siivut viivoina. Nämä viivat voisivat myös olla värikoodattu kuvakulmia kuvaavien värien mukaan. Tässä karttakuvassa voisi olla myös valittavana ominaisuutena kaiken liitetyn datan liitoskohtien näyttäminen.

Miettinen kysyi Kuvan mielipidettä siitä, että kuvia avataan uusiin ikkunoihin. Kuvan mukaan uusien ikkunoiden avaamista suurissa määrin olisi vältettävä.

Santanen kysyi miten toimitaan tilanteessa, että ohjelmassa ei ole ladattu näytetiedostoa, mutta dataa pitäisi pystyä liittämään. 'Listassa esitettyjen näytteeseen liitettyjen datojen esittämisestä näytekuvassa myös keskusteltiin. Santasen mukaan liitetyn datan metatiedot voisivat näkyä erillisessä ikkunassa.

Kuva jakoi muokkaamansa version ensimmäisestä käyttöliittymähahmotelmasta. Tässä oltiin lisätty oikeaan karttakuvaan valintalaatikot, joista voitiin valita minkä pääakselin vastaisesti kuvaa katsotaan. Oikeanpuoleisesta kuvasta myös liukusäädin, jolla kuvan kerrosta valitaan oltiin poistettu.

Pakkanen kysyi onko datapisteiden merkkaaminen interpoloituun kuvaan ongelma, jos kuvakokoa muokatessa liitoskohta interpoloidaan vokselista toiseen. Miettinen sanoi että kyseinen ei ole ongelma, jos liitoskohdat määritellään vokselien sijasta johonkin avaruuden pisteisiin.

Linna kysyi onko kuvia tarkoitus interpoloida, jos ne ovat liian isoja näytettäväksi. Kuvan mukaan juuri näin olisi hyvä toimia. Myös kuvien ulospäin kohdentamisen olisi hyvä ominaisuus.

Linna näytti toisen käyttöliittymäluonnoksen.

Kuva ja Miettinen pitivät kyseisestä hahmotelmasta enemmän. Kyseisessä hahmotelmassa yksi ikkuna sisältää kaikki pääakselien suuntaiset näkökulmat, sekä karttakuva.

Miettinen sanoi, että jokaisen kuvan vapaavalintainen kääntely voisi olla hämmentävää käyttäjille. Toisaalta Linnan luonnoksessa oli kontrolleri, josta näkyivät kaikki valitun kuvan kääntökulmien asteet, kyseinen ei välttämättä kauhean isoksi ongelmaksi tulisi.

Miettinen ehdotti, että kolmiulotteisessa tilavuuskartassa voitaisiin näyttää liitetyn datan liitoskohdat.
}

\section{Alustava vaatimusmääritelmä}

\sisennys{

Puheenjohtaja jakoi Teamsin kautta vaatimusmäärittelydokumentin.

Santanen huomautti, että prioriteettiluokat kannattaa vaihtaa vastaamaan aiemmissa projekteissa käytettyä luokitusta. Tilaa kuvaavaan luokitukseen suositellaan lisäämään luokka "toteuttamatta".

Santanen suositteli tekemään uuden vaatimusosion, jossa erikseen käsitellään rajoitteiden vaatimuksia. Vaatimus 1.5. siirrettäisiin kyseisen osion alle.

Miettisen mukaan Windows 10 -käyttöjärjestelmää edeltäviä versioita sovelluksen ei ole tarpeen tukea. Kyseisen vaatimuksen prioriteettia tulee siis laskea tai vaatimuksen voi jättää kokonaan pois.

Kuvan mukaan kannattaa puhua tomograﬁadatan sijaan näytedatasta, koska kaikki sovelluksen kuvat, eivät välttämättä ole tomografiakuvia.

Santanen kysyi onko osion "Tomografia datan lukuvaatimukset", mainituista datatyypeistä useita eri versioita. Miettisen mukaan \texttt{3D-tiff} -tiedostoista on ainakin 3 eri versiota ja \texttt{image sequence} -tiedostoista useita riippuen, minkä muotoisiksi kuviksi näyte on tallennettu. Miettisen mukaan, että \texttt{3D-tiff} -tiedostot ovat hieman pienemmällä prioriteetilla muihin näytteiden datatyyppeihin verrattuna. 

Miettisen mukaan olisi hyvä lisätä vaatimukseksi näytekuvien zoom-mahdollisuus korkealla prioriteetilla.

Santanen muistutti vaatimukseksi lisättävän, että kuvia ei lueta kokonaan välimuistiin.

Santasen mukaan jatkokehitystä koskeville vaatimuksille olisi hyvä tehdä oma osio.

Santasen mukaan vaatimukset 4.7. ja 5.6. ovat hankala todeta täyttyneen.

Santanen sanoi, että liitettävän datan vaatimukseen olisi lisättävä datan poisto ja muokkaaminen vaatimuksiksi.

Santanen kysyi onko dataa tarvetta liittää useaan pisteeseen. Miettisen mukaan tämä olisi hyvä. Pakkanen kysyi onko yhteen pisteeseen tarvetta liittää useaa dataa. Miettisen mukaan tämä myös olisi hyvä.

Kuva sanoi, että vaatimusta 6.4. siirrettäisiin matalalle prioriteetille. Hänen mukaansa kyseinen voisi mahdollisesti tulla "ilmaiseksi" tasojen toteuttamisen yhteydessä.

Santanen sanoi, että metatiedot olisi hyvä laittaa omaksi vaatimusosioksi.

Santasen mukaan näytteen datojen liitetiedosto tulee tallentaa käyttäjän valitsemaan hakemistoon tomografiatiedoston hakemistopolun sijaan.

Kuva toivoi, että vaatimusten osiota kuvaava numero laitetaan vastaamaan lukunumeroita. Pakkanen vastasi, että tämä onnistuu.

Santanen sanoi, että vaatimukset 7.5. ja 7.6. olisi laitettava omaan osioonsa, ja kyseisiä vaatimuksia olisi tarkennettava. 

Lataamiseen liittyvien vaatimusten suhteen esille tuli seuraavat asiat: 
\begin{itemize}
    \item Ladataanko projekti valitsemalla tiedostohakemistosta projektitiedosto?
    \item Onko ohjelmassa viimeksi avattujen näytteitten lista?
    \item Selvennettävä vaatimusta 7.4. Tarkoitetaanko kyseisellä kaikkea esim. ikkunoiden paikkaa vai pelkästään projektissa olevan näytteen, liitosdatojen, metadatojen, sekä liitoskohtien tilaa.
\end{itemize}

Santanen huomautti että vaatimusta 8.1. olisi hyvä tarkentaa. Koskeeko kyseinen myös esim. desimaalierottimen muotoa tai päivämäärän merkintää. Vaatimuksia 8.4. ja 8.5. tulisi myös tarkentaa, koska nykyisessä muodossa ne ovat epäselviä.

Vaatimusmäärittelyä muokataan em. palautteiden mukaisesti. Santanen lähettää kirjallisen palautteen vaatimusmäärittelyn seuraavasta versiosta.
}

\section{Alustava projektisuunnitelma}

\sisennys{
Projektisuunnitelma sovittiin käytävän läpi seuraavassa palaverissa. Santanen lähettää palautteen projektisuunnitelmasta sähköpostitse projektin jäsenille.

\paatokset{
    \item Asian käsittely siirretään seuraavaan palaveriin.
}
}

\section{Muut esille tulevat asiat}

\sisennys{
Kohdassa 7 esille tullut Visual Studio asia päätettiin käydä läpi.

Santanen kysyi onko GTK:lla Visual Studio-lisenssejä kaupallista sovellusta varten. Kuvan mukaan kyseisiä lisenssejä ei ole.

Santanen sanoi, että hän kysyy onko Visual Studio lisenssejä yliopistolla.

}

\section{Läsnäolijoille sovitut toimenpiteet}

\sisennys{
Jukka-Pekka Santanen: 
\begin{itemize}
    \item Selvittää onko Harri Linnalle lainattavissa mikroa yliopistolta.
    \item Selvittää onko yliopistolla Visual Studio-lisenssejä projektiryhmän jäsenille.
    \item Lähettää palautteen projektisuunnitelmasta.
\end{itemize}

Harri Linna:
\begin{itemize}
    \item Tarkistaa toisen palaverin pöytäkirjan korjausten jälkeen.
    \item Jatkaa projektisopimuksen tekemistä palautteen mukaan.
\end{itemize}

Jukka Kuva:
\begin{itemize}
    \item Selvittää onko GTK:n puolelta mahdollista saada Visual Studio-lisenssejä, jos projektin sovellus ei tule olemaan avointa lähdekoodia.
\end{itemize}

Iiro Iivanainen:
\begin{itemize}
    \item Korjaa toisen palaverin pöytäkirjan palautteen mukaan.
\end{itemize}

Jere Pakkanen
\begin{itemize}
    \item Jatkaa vaatimusmäärittelyn työstämistä palaverissa saadun palautteen mukaan.
\end{itemize}

Projektin jäsenet:
\begin{itemize}
    \item Projektin jäsenet tekevät uuden hahmotelman käyttöliittymästä, ottaen huomioon palaverissa saamansa palautteen.
\end{itemize}
}

\section{Seuraavan palaverin aika ja paikka}

\sisennys{
Seuraava palaveri pidetään perjantaina 5.3.2021 kello 10:00 Teams-palaverina. Palaveriin varataan 2 tuntia.
}

\section{Palaverin päättäminen}

\sisennys{
Puheenjohtaja päätti palaverin.
}

\section*{Jaettu ja käsitelty materiaali}

\sisennys{

Palaverissa tarkasteltiin 2 eri projektiryhmän tekemää luonnosta käyttöliittymästä. Näiden lisäksi Jukka Kuva jakoi muokatun version ensimmäisestä käyttöliittymän luonnoksesta. Käyttöliittymän luonnosten lisäksi esityslistan liitteenä jaettiin projektisopimuksen ja vaatimusmäärittelyn ensimmäiset versiot, joista jälkimmäistä käytiin läpi palaverissa.

Ensimmäinen kuva esittä ensimmäistä käyttöliittymähahmotelmaa, jossa toiminnallisuus on sijoitettu pääosin valikkopalkin taakse.

\includegraphics[scale=0.49]{gui1}

\pagebreak

Toinen kuva esittää toista käyttöliittymähahmotelma, jossa toiminnallisuus on sijoitettu omien kontrolliensa alle ja kontrollit ovat telakoituna pääikkunaan.

\includegraphics[scale=0.95]{gui2}
}

\end{document}
