Metropolia Konenäkö Harjoitustyö
In-Sight käyttöohje
Sisällysluettelo
1.0 Käyttöliittymän käyttö
1.1 System menu
1.2 Edit menu
2.0 Yhtälöiden tekeminen
3.0 Ominaisuuksien löytäminen
3.1 Yhdistettyjen alueiden löytäminen
3.2 ExtractBlobs funktio
3.3 FindBlobs funktio
3.4 SortBlobs funktio
4.0 Reunojen löytäminen
4.1 FindLine funktio
4.2 FindSegment funktio
4.3 FindMultiLine funktio
4.4 FindCurve funktio
4.5 FindCircle funktio
5.0 Kuvioiden löytäminen
1.0 Käyttöliittymän käyttö
1.1 System menu
Oikealla hiiren näppäimellä klikkaamalla tai näppäintä painamalla pääsee System valikkoon (kuva 1), josta voi valita seuraavia toimintoja:
Kuva 1 System valikko
Live
Live kuvaa kamerasta. 
painamalla ohjelma pysäyttää kuvan ja menee takaisin laskentataulukkoon.
New Job
Luo uuden laskentataulukon.
Save & Load
Voi tallentaa tai ladata yksittäisiä kuvia tai töitä.
1.2 Edit menu
Oikealla hiiren näppäimellä klikkaamalla maalatun solun päällä tai 
näppäintä painamalla pääsee Edit valikkoon (kuva 2, s.3), jossa on mm. nämä tärkeät toiminnot:
Formula
Tuo valittuun soluun/soluihin matemaattisia funktioita tai tekstiä.
Custom View
Custom Viewillä voidaan tuoda laskentataulukosta käyttöliittymään valittuja arvoja
Kuva 2 Edit valikko
2.0 Yhtälöiden tekeminen
Maalattuun soluun voi formula editorilla (kuva 3, s.4) lisätä kaavoja, jotka palauttavat seuraavia arvoja: numeerisia arvoja, tekstiä, struktuureja. Struktuurit palauttavat numeerisia arvoja ja tekstiä enemmän kuin yhteen soluun. Kaavoissa voidaan excel tyyppisesti viitata soluihin taulukossa käyttäen absoluuttisia tai relatiivisia viittauksia.
Esimerkki relatiivisesta viittauksesta:
A5=A3+A4 jos tämä kaava kopioidaan soluun B5, siitä tulee B5=B3+B4
A5=A3+A4 jos tämä kaava kopioidaan soluun A6, siitä tulee A6=A4+A5
Esimerkki absoluuttisesta viittauksesta jossa solut ovat lukittuina:
A5=$A$3+$A$4 jos tämä kaava kopioidaan soluun B5, siitä tulee B5=$A$2+$A$3
A5=A$3+A$4 jos tämä kaava kopioidaan soluun B5, siitä tulee B5=B$2+B$3
Kuva 3 Formula editori
Aktivoi solu valikointimoodin, jossa voidaan valita absoluuttinen viittaus soluun, joka lisätään kaavaan.
Aktivoi solu valikointimoodin, jossa voidaan valita relatiivinen viittaus soluun, joka lisätään kaavaan.
Avaa tekstin lisäys dialogin.
Enemmän kuin yhden solun valikoiminen onnistuu 
+ nuolinäppäimellä tai painamalla oikealla hiirennäppäintä pohjassa ja ”maalaamalla” soluja.
3.0 Ominaisuuksien löytäminen
Objekti voi sisältää yksinkertaisia ominaisuuksia kuten koloja, kaartevia reunoja ja suoria reunoja tai sitten monimutkaisempia ominaisuuksia kuten epäsäännöllisiä muotoja tai mustavalkoisia kuviota. In-Sight ohjelman päätyökalut ominaisuuksien löytämiseksi ovat seuraavat:
- Yhdistetyt alueet (Blob)
- Reunat
- Kuviot
3.1 Yhdistettyjen alueiden löytäminen
Monet objektin piirteet voidaan erottaa niiden taustasta riippuen siitä miten kirkkaana tai tummana ne esiintyvät kuvassa. Näitä kirkkaita ja tummia alueita kutsutaan Blobeiksi. In-Sight tarjoaa seuraavia funktioita määrittämään ja tunnistamaan Blob piirteitä kuvasta:
ExtractBlobs Määrittää Blobin kuvasta.
FindBlobs Vertaa määritettyjä Blobeja referenssi Blobiin.
SortBlobs Lajittelee määritetyt Blobit koordinaattien mukaan.
3.2 ExtractBlobs funktio
Näin lisätään ExtractBlobs funktio laskentataulukkoon:
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella.
- Avaa formula editori.
- Vision Processing valikon alla valitse ExtractBlobs Blob alavalikosta, tämä avaa ExtractBlobs ominaisuus valikon.
- Suurenna Region ryhmää. Maalaa X parametrin arvo ja vaihda se Interactive Graphics moodiin.
- Aseta alue siten että se peittää täysin kaikki Blobit jotka haluat löytää. Hyväksy muutokset.
- Tee valmiiksi loput ominaisuus valikosta.
- Paina OK hyväksyäksesi muutokset.
ExtractBlobs funktio lisää Blobs struktuurin laskentataulukolle Vision Data Access funktion GetNFoundin lisäksi:
GetNFound Palauttaa kuinka monta Blobia löydettiin.
3.3 FindBlobs funktio
Näin lisätään FindBlobs funktio laskentataulukkoon:
- Tarkista että laskentataulukosta löytyy Blobs struktuuri joka sisältää ExtractBlobs funktion.
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella ja alapuolella.
- Avaa formula editori.
- Vision Processing valikon alla valitse FindBlobs Blob alavalikosta, tämä avaa FindBlobs ominaisuus valikon.
- Maalaa Blobs parametrin arvo ja vaihda solun valinta moodiin. Valitse solu joka sisältää Blobs struktuurin.
- Tee valmiiksi ominaisuus valikko tarkentamalla kuinka monta Blobia etsitään.
- Paina OK hyväksyäksesi muutokset.
FindBlobs funktio lisää Blobs struktuurin laskentataulukolle Vision Data Access funktioiden lisäksi jotka palauttavat dataa joka kuvaa jokaista Blobia jotka löydettiin. Näitä funktioita on mm:
GetRow Palauttaa rivin keskiön (Row).
GetCol Palauttaa pystyrivin keskiön (Col).
GetAngle Palauttaa Blobin kulman (Angle).
GetScore Palauttaa arvon joka kuvaa Blobin yhteensopivuutta (Score).
3.4 SortBlobs funktio
Näin lisätään SortBlobs funktio laskentatalukkoon:
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella ja alapuolella.
- Avaa formula editori.
- Vision Processing valikon alla valitse SortBlobs Blob alavalikosta, tämä avaa SortBlobs ominaisuus valikon.
- Maalaa Blobs parametrin arvo rivillä 0 ja vaihda solun valinta moodiin.
- Valitse Blobs struktuurin solu joka sisältää ExtractBlobs funktion.
- Tee valmiiksi ominaisuus valikko tarkentamalla kuinka monta Blobia raportoidaan ja mitä lajittelu metodia käytetään.
- Paina OK hyväksyäksesi muutokset.
SortBlobs funktio lisää Blobs struktuurin laskentataulukkoon Vision Data Access funktioiden lisäksi jotka palauttavat dataa jotka kuvaavat lajiteltuja Blobeja.
GetRow Palauttaa rivin keskiön (Row).
GetCol Palauttaa pystyrivin keskiön (Col).
GetAngle Palauttaa Blobin kulman (Angle).
GetScore Palauttaa arvon joka kuvaa Blobin yhteensopivuutta (Score).
4.0 Reunojen löytäminen
Reunat ovat paikkoja kuvassa jossa kirkkaus muuttuu äkisti tummasta vaaleaan tai vaaleasta tummaan. Reunat jotka In-Sight löytää voivat olla suoria, kaarevia tai muodostaa ympyrän.
In-Sight tarjoaa seuraavia funktioita löytämään suoria tai kaarevia reunoja:
FindLine Löytää yhden suoran viivan segmentistä.
FindSegment Löytää kaksi suoraa viivaa segmentistä.
FindMultiline Löytää monta suoraa viivaa segmentistä.
FindCurve Löytää kaaren segmentistä.
FindCircle Löytää kokonaisen ympyrän muotoisen reunan.
4.1 FindLine funktio
Näin lisätään FindLine funktio laskentataulukkoon:
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella.
- Avaa formula editori.
- Vision processing valikon alla valitse FindLine Edge alavalikosta, tämä avaa FindLine ominaisuus valikon.
- Suurenna Region ryhmää. Maalaa X parametrin arvo ja vaihda se Interactive Graphics moodiin.
- Aseta alue siten että y-akseli on kohtisuorassa reunaa vasten jota yritetään löytää. Hyväksy muutokset.
- Muuta jäljellä olevia parametrejä jos on tarvetta.
- Paina OK hyväksyäksesi muutokset.
FindLine funktio lisää reunat struktuurin laskentataulukkoon Vision Data Access funktioiden lisäksi jotka palauttavat dataa reuna segmentistä joka löydettiin:
GetRow Palauttaa alku ja loppu rivin koordinaatit (Row0 ja Row1).
GetCol Palauttaa alku ja loppu pystyrivin koordinaatit (Col0 ja Col1).
GetScore Palauttaa arvon joka kuvaa reunan huippua (Score).
4.2 FindSegment funktio
FindSegment funktio on samanlainen kuin FindLine paitsi että FindSegment löytää kaksi reunaa, vertaa niitä ja laskee etäisyyden niiden välillä. FindSegment funktio konfiguroidaan samalla tavalla kuin FindLine funkito.
FindSegment funktio lisää reunat struktuurin laskentataulukkoon kahden Vision Data Access funktion kanssa:
PairDistance Palauttaa kahden reuna segmentin välisen etäisyyden arvon (Distance).
GetScore Palauttaa arvon joka kuvaa kahden reunan keskiarvoa (Score).
4.3 FindMultiLine funktio
FindMultiLine funktio etsii monta suoraa reunaa. Reunat jotka löytyvät FindMultiLine funktiolla voidaan lajitella reuna pareihin.
FindMultiLine funktio lisää reuna struktuurin laskentataulukolle Vision Data Access funktion GetNFound lisäksi:
GetNFound Palauttaa löydettyjen reunojen lukumäärän.
4.4 FindCurve funktio
Näin lisätään FindCurve funktio laskentataulukkoon:
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella.
- Avaa formula editori
- Vision processing valikon alla valitse FindCurve Edge alavalikosta, tämä avaa FindPatterns ominaisuus valikon.
- Suurenna Region ryhmää. Maalaa X parametrin arvo ja vaihda se Interactive Graphics moodiin.
- Valitse saatavilla olevista Interactive Graphics moodeista Curved moodi.
- Aseta alue siten että y-akseli on keskellä kaarevaa reunaa joka halutaan havaita.
- Säädä loput parametrit tarvittaessa.
- Paina OK hyväksyäksesi muutokset
Findcurve funktio lisää reunat struktuurin laskentataulukolle Vision Data Access funktioiden lisäksi jotka palauttavat dataa löydetystä kaarevasta reunasta:
GetRow Palauttaa keskipiste, pääty ja alku koordinaatit riviltä (CentRow,StartRow ja EndRow).
GetCol Palauttaa keskipiste, pääty ja alku koordinaatit pystyriviltä (CentCol, StartCol ja EndCol).
GetRadius Palauttaa säteen arvon (Radius).
GetScore Palauttaa arvon joka kuvaa reunan huippuarvoa (Score).
4.5 FindCircle funktio
Findcircle funktio on samanlainen kuin FindCurve sillä erolla että se löytää ja raportoi reunan 360-asteen ympyrästä. FindCirclen configuroinnissa ero muihin reuna funktioihin on alueen määrittely mistä reunan löytää. Kaarevuuden ja asteen sijaan määritellään torus sisäisellä ja ulkoisella säteellä.
FindCircle funktio lisää reunat struktuurin laskentataulukolle Vision Data Access funktioiden lisäksi jotka palauttavat dataa pyöreänmuotoisesta reunasta:
GetRow Palauttaa keskipiste rivin koordinaatit (CentRow).
CentCol Palauttaa keskipiste pystyrivin koordinaatit (CentCol).
GetRadius Palauttaa säteen arvon (Radius).
GetScore Palauttaa arvon joka kuvaa reunan huippuarvoa (Score).
5.0 Kuvioiden löytäminen
In-Sight pystyy löytämään objekteja ja muita kuvan piirteitä ”opettamalla” kuvioita ja etsimällä sitä seuraavista kuvista samanlaisia kuvia.
Näin lisätään FindPatterns funktio laskentataulukkoon:
- Pystyrivillä A, valitse solu tyhjällä rivillä jolla on myös yksi tyhjä rivi sen yläpuolella ja alapuolella.
- Avaa formula editori.
- Vision processing valikon alla valitse FindPatterns PatFind alavalikosta, tämä avaa FindPatterns ominaisuus valikon.
- Suurenna Model Region ryhmää. Maalaa X parametrin arvo ja vaihda se Interactive Graphics moodiin.
- Aseta alue siten että se peittää kokonaan alueen josta haluat löytää mallin. Hyväksy muutokset.
- Suurenna Find Region ryhmää. Maalaa X parametrin arvo ja vaihda se Interactive Graphics moodiin.
- Aseta alue siten että se peittää kuvasta kokonaan alueen josta kuvio löytyy. Hyväksy muutokset.
- Tee valmiiksi loput ominaisuus valikosta.
- Paina OK hyväksyäksesi muutokset.
FindPatterns funktio lisää kuvio struktuurin laskentataulukolle Vision Data Access funktioiden lisäksi jotka palauttavat seuraavaa dataa kuviosta:
GetRow Palauttaa rivin koordinaatit (Row).
GetCol Palauttaa pystyrivin koordinaatit (Col).
GetScale Palauttaa kuvion skaalan offsetin (Scale).
GetAngle Palauttaa kuvion kulman offsetin (Angle).
Get Score Palauttaa arvon joka kuvaa kuvion yhteensopivuutta (Score).