Xema

Yleistä

Xema on päiväkirja lintubongareille jonka avulla pidät kirjaa havainnoistasi. Xema on BirdLife Suomen hyväksymä ja mahdollistaa havaintojen lähettämisen suoraan Tiiraan.

Uutiset

Uusimmat uutiset Xemasta löydät Xeman Facebook-sivulta.

Videot

Allaolevista videoista näet lyhyen esittelyn Xeman perustoiminnoista.

Havainnon syöttö ja lähetys Tiiraan

Linnun paikan määrittäminen, useamman havainnon syöttö

Tuetut laitteet:

Xema toimii uusimmilla Android (2.2 tai uudempi) ja Symbian-laitteilla sekä Nokia N9:llä.

Lataa

Löydät Xeman Androidille Google Playsta

Ilmaisen Xema Lite version löydät tästä Google Play linkistä

Ilmainen versio on muuten identtinen täysversion kanssa, mutta havaintoja ei voi viedä Tiiran tai csv-tiedostoon.

Xema ilmaiseksi vanhempiin Nokian laitteisiin tästä.

Versio 1.2.5, Nokia N9:lle

Nokian Symbian-laitteille (^3 ja uudemmat)

Nokia Storesta ladatun Xeman päivitys uusimpaan versioon

Nokia N9

Päivitys tapahtuu seuraavin askelin

Avaa Xema
Valitse Vie - Kaikki - Kaikki - ;
Avaa asetukset - Vie omat listat
Poista eli tyhjennä havainnot
Sulje Xema
Poista Xeman asennus laitteesta
Avaa laitteen asetukset
Valitse Sovellukset - Asennukset - Salli asennukset muista lähteistä kuin Kaupasta
Lataa uuden version .deb tiedosto laitteeseen ja asenna se avaamalla
Kopioi MyDocs/xema/exported kansiosta .csv tiedostot MyDocs/xema/imported kansioon
Avaa Xema
Valitse Tuo

Symbian laitteet

Päivitys tapahtuu seuraavin askelin

Avaa Xema
Valitse Vie - Kaikki - Kaikki - ;
Avaa asetukset - Vie omat listat
Sulje Xema
Poista Xeman asennus laitteesta
Lataa uuden version .sis tiedosto laitteeseen ja asenna se avaamalla. (Huom. asentaja varoittaa että sovellus ei ole luotettu, koska se ei ole Nokia Storesta)
Kopioi E:\xema\exported kansiosta (tai C: asemalta) .csv tiedostot E:\xema\imported kansioon (tai C: asemalle)
Avaa Xema
Avaa asetukset - Tuo omat listat
Palaa päänäkymään
Valitse Tuo

Ohjeet

Vinkit

Voit jakaa havainnon tekstiviestillä, sähköpostilla tai vaikkapa Whatsappilla. Valitse listalta yksittäinen havainto ja paina sitä pitkään, avautuvasta valikosta valitse 'Jaa'.

Voit etsiä listoja nopeasti syöttämällä hakukenttään osan vaikkapa nimestä tai lyhenteestä. Esim. harakka löytyy historia- ja lajilistalta nopeasti syöttämällä kenttään picpic

Paikkalistalla voit käyttää gps:ää listan lyhentämisessä, olettaen että syötät havaintoa paikan päällä.

Voit varmuuskopioida kaikki Xeman tiedot viemällä havainnot csv-tiedostoon ja listat (paikat, henkilöt...) asetusten kautta omiin tiedostoihin. Jos nyt poistat kyseiset tiedostot tai vaikkapa poistat Xeman, voit palauttaa tiedot tuomalla ensin asetusten kautta listatiedot ja sitten havainnot.

Vienti & tuonti

Xeman havaintohistorian sekä muokatut ja omat listat voit viedä Xemasta .csv muotoon. Näin voit tehdä varmuuskopiot tiedoistasi ja tallettaa ne vaikkapa PC:llesi. Vastaavasti voit tuoda .csv muotoisia tiedostoja Xemaan. Seuraavassa on tarkemmat ohjeet tarvittavista tiedoista.

Vienti

Henkilöiden, paikkojen, lajien ja tilojen vienti tapahtuu asetukset näkymästä. Vienti tuottaa omat tiedostot näistä listoista exported kansioon. Android laitteissa löydät tämän kansion joko muistikortilta tai laitteen sisäiseltä muistilta kansiosta Android/data/fi.iki.z7.xema/files. Exported kansio sijaitsee Symbian laitteilla joko E: tai C: asemalla xema kansiossa. N9:n tapauksessa se sijaitsee MyDocs kansion alla xema kansiossa. Tiedostoihin kirjoitetaan kyseisten listojen muutetut ja lisätyt tiedot.

Havaintohistorian voit viedä havainnot sivulta. Voit valita haluatko viedä Xemasta kaikki havainnot, vai vain uudet aikaisemmin viemättömät havainnot. Lisäksi voit valita haluatko kenttien erotettimeksi # vai ; merkin ja sen viedäänkö tiedostoon kaikkien maiden havainnot vai vain oletusmaan. Viety tiedosto löytyy myös exported kansiosta.

Tuonti

Tuotavien tiedostojen tulee olla .csv tai .txt muotoisia listoja, joiden erottimina on # tai ; merkki. Tiedoston ensimmäisen rivin pitää olla otsikkorivi, jossa on kenttien nimet. Helpoiten näet oikean formaatin viemällä Xemasta tiedot ja muokkaamalla näitä tiedostoja. Tuotavat tiedostot tulevat olla import kansiossa. Tuonnin jälkeen nämä tiedostot siirretään automaattisesti imported kansioon.

Havaintohistoria

Havaintohistorian voit tuoda havainnot sivulta. Historiatiedoston nimen tulee sisältää sana history, record tai _csv_. Historiatiedostossa voi käyttää seuraavia kenttiä:

Rivi-ID;Laji;Pvm1;Pvm2;Kello_hav_1;Kello_hav_2;Kunta;Paikka;X-koord;Y-koord;Paikan_tark;X-koord-linnun;Y-koord-linnun;Linnun_tark;Paikannettu;Lisätietoja;Atlaskoodi;Tallentaja;Tallennusaika;
Havainnoijat;Salattu;Koontihavainto;Kuuluu havaintoon;Määrä;Kello_lintu_1;Kello_lintu_2;Sukupuoli;Puku;Ikä;Tila;Lisätietoja_2;Parvi;Bongattu;Pesintä;Epäsuora havainto;Sää;Maa;Koord_tyyppi;Species_en;Species_sv;Species_sc;Species_fi;Tiira_csv;NotToTiira

esim:

3;PARMAJ;06.08.2012;06.08.2012;13:10;13:15;Oulu;Peltola;3371168;7120210;;;;;;l2;2;;;Tero Siironen;X;;;2;13:10;13:15;n;eijp;pm;m;l1;1;X;X;;Aurinkoinen;Suomi;YKJ;Great Tit;Talgoxe;Parus Major;Talitiainen;;X

Lataa esimerkkitiedosto

Huom! Xema ei käytä näitä kaikkia kenttiä, mutta ne ovat yhteensopivuussyistä mukana
Id saa olla mikä tahansa kokonaisluku. Jos otsikon nimi on 'Havainto id', tulkitaan tiedosto Tiirasta tuoduksi csv-tiedostoksi ja havainnot merkitään jo Tiiraa viedyiksi, muina vaihtoehtoina ovat ID ja Rivi-ID
True/falsen sijaan käytetään X merkkiä jos kentän arvo on tosi ja tyhjää kenttää jos arvo on epätosi (esim. pesintä)

Kun tuot historiatietoja, Xema luo automaattisesti puuttuvat paikat ja henkilöt, jotka esiintyvät historiatiedoissa.

Henkilöt

Henkilöt, kuten muutkin listatiedot, voit tuoda asetukset sivulta. Tiedostonimen tulee sisältää sana person, observer tai people, ja voi sisältää seuraavia kenttiä:

firstname;lastname;registered;default;saver

Eli: Etunimi;Sukunimi;Rekisteröitynyt;Oletusnimi;Tallentaja + rivinvaihto

esim:

Tero;Siironen;true;true;true

Lataa esimerkkitiedosto

Huom! Listassa tulisi olla korkeintaan yksi tallentaja

Tilat

Tilatiedoston tiedostonimen tulee sisältää sana status, ja voi sisältää seuraavia kenttiä:

abbrev;status_fi;status_sv;status_en

Eli: Lyhenne;Tila suomeksi;Tila ruotsiksi;Tila englanniksi + rivinvaihto

esim:

p;Paikallinen;Stationär;Stationary

Lataa esimerkkitiedosto

Huom! Ruotsin ja englanninkieliset kentät eivät ole pakollisia vaan ne voidaan jättää tyhjäksi.

Lajit

Lajitiedoston tiedostonimen tulee sisältää sana birds tai species, ja voi sisältää seuraavia kenttiä:

id;group_fi;group_en;group_lat;name_fi;name_sv;abbrev_lat;name_lat;category;name_en;group_sv

Eli: Id;Ryhmä;Ryhmä englanniksi;Tieteellinen ryhmännimi;Laji;Laji ruotsiksi;Lyhenne;Tieteellinen nimi;Kategoria;Laji englanniksi;Ryhmä ruotsiksi + rivinvaihto

esim:

393;Lokit;Gulls;Laridae;Tiiralokki;Tärnmås;XEMSAB;Xema sabini;A;Sabine's Gull;Måsfåglar

Lataa esimerkkitiedosto

Huom! Ruotsin- ja englanninkieliset kentät eivät ole pakollisia vaan ne voidaan jättää tyhjäksi.
Id saa olla mikä tahansa kokonaisluku.

Paikat

Paikkatiedoston tiedostonimen tulee sisältää sana location, ja voi sisältää seuraavia kenttiä:

town_fi;place_fi;wgs;ykj;town_sv;place_sv;town_en;place_en;country_fi;country_sv;country_en;organization;org_abbrev

esim:

Eli: Paikkakunta;Paikka;64:24;7103442:3353417;Paikkakunta ruotsiksi;Paikka ruotsiksi;Paikkakunta englanniksi;Paikka englanniksi;Maa;Maa ruotsiksi;Maa englanniksi;Yhdistys;Yhdistyksen lyhenne + rivinvaihto

esim:

Kokkola;Isokari;63.8307:23.0335;7087180:3305004;Karleby;Stora Enskär;;;Suomi;Finland;Finland;Keskipohjanmaan Lintutieteellinen Yhdistys;KPLY

Lataa esimerkkitiedosto

Huom! Ruotsin ja englanninkieliset kentät eivät ole pakollisia vaan ne voidaan jättää tyhjäksi, samoin koordinaatit voi jättää tyhjäksi.
Jos täytät koordinaatit vain toisessa muodossa, toisen muodon koordinaatit lasketaan ja täydennetään automaattisesti tuonnissa.

Yhteystiedot

Jos sinulla on ongelmia Xeman kanssa tai löydät ohjelmasta virheen voit ottaa minuun yhteyttä lähettämällä sähköpostia osoitteeseen izero79 (at) gmail.com

Versiohistoria (Android)

v. 1.2.10

Lajilista päivitetty
Tiira serveriasetukset näkyvissä vain jos testi tai dev valittu

v. 1.2.9

Korjaus havaintojen tuontiin

v. 1.2.8

Havainnon jakaminen SMS:llä/sähköpostilla. Tämä tapahtuu painamalla pitkään havaintoa listan syvimmällä tasolla
Nopeutettu ensimmäistä käynnistystä asennuksen/päivittämisen jälkeen
Virhekorjauksia

v. 1.2.7

Havainnon Viety Tiiraan tila voidaan poistaa valikon kautta
Muutoksia internet yhteyden tarkistukseen

v. 1.2.6

Tietojen tuonti korjattu

v. 1.2.5

Tiira palvelut
Eri Googlen karttatilat valittavana
Yhdistyspaikkojen valinta luettelosta
Paikkalista päivitetty
Korjauksia ja parannuksia

v. 1.2.2

Paikan ja linnun paikan tarkkuuden määritys
Vienti eri listatasoilta (kaikki/päivä/päivä ja paikka)
Lisää yhdistyspaikkoja
Asetus oletusyhdistykselle (paikkalistan suodatukseen)
Suora Tiira-vienti poistettu käytöstä (väliaikaisesti)

v. 1.2.1

Tiira toiminnallisuudet näytetään vain kun käyttäjä on kirjautunut sisään ja omaa csv-latausoikeudet palveluun.

v. 1.2.0

Tuki Tiira palvelulle (www.tiira.fi)
Uudet havaintopaikat (PSLY, PPLY, EKLY, KLY ja PKLY)
Korjauksia ja uusia kenttiä tuontiin ja vientiin
WGS84/YKJ koordinaattivalinta vientiin
Usean oletusnimen asettaminen uusiin havaintoihin

v. 1.1.0

Linnun paikan voi määrittää kartalta
Paikan koordinaatit voi määrittää kartalta
Korjauksia tuontiin ja aikakenttien käsittelyyn
Lajilistan valinta suomi/wp
Oletusmaan valinta ja paikkalistan näytön rajoitus sen perusteella
Viennissä voi valita kaikki maat/oletusmaan
Laji- ja paikkalistalle näppäimistö näkyviin heti kun listan avaa uusi havainto näkymästä
Lajilista lajitellaan ensin kategorian mukaan jos hakukentässä on jotain

v. 1.0.1

Listoja voi muokata uuden havainnon syötön aikana painamalla pitkään kohdetta
Korjattu uuden rivin lisäys vanhemmilla Android-versioilla

v. 1.0.0

Ensimmäinen versio Google Play Storessa

Versiohistoria (Nokia)

v. 1.2.5

Tiira-palvelut

v. 1.2.0

Yhdistyspaikkojen valinta luettelosta
Paikkalista päivitetty

v. 1.1.1

Paikan ja linnun paikan tarkkuuden määritys
Vienti eri listatasoilta (kaikki/päivä/päivä ja paikka)
Lisää yhdistyspaikkoja

v. 1.1.0

Karttatoiminnot
Lajilistan valinta suomi/wp
Oletusmaan valinta ja paikkalistan karsinta sen perusteella
CSV:ssä on lajinimet myös muilla kielillä
WGS84/YKJ valinta viennissä
Parannuksia käyttöliittymään
Mahdollista asettaa useampi oletusnimi
Vieraskieliset kentät piilotettu
Paikoissa yhdistyskentät
Korjauksia tuontiin ja vientiin

v. 1.0.2

Euroopan kattava lajilista
Korjauksia käyttöliittymään
Paikkalistan gps-suodatus korjattu
Paikkatiedoissa maa-kenttä
Linnun paikan syöttömahdollisuus
Tietojen tuontiin ja vientiin tehty korjauksia
Kompassi linnun paikan syötössä
Tiedostomuodot korjattu yhteensopiviksi Android version kanssa

v. 1.0.1

Koordinaattimuunnos YKJ<->WGS tapahtuu samantien paikkaa muokatessa
Selvästi virheellisiä koordinaatteja ei viedä csv-tiedostoon
lajilistaan korjaus: hii-ääninen Tiltaltti PHYCOLHIIT (ei PHYCOLHII)
csv-tiedostossa Id sarake vaihdettu Rivi-ID:ksi Tiiraa varten

v. 1.0.0

Ensimmäinen versio Nokia Storessa

Suomeksi

Description

Xema is a diary app for birdwatchers. Xema is approved by BirdLife Finland to be used with Tiira service. Xema runs on latests Android devices, Symbian devices, and Nokia N9 device.

News

Latest Xema news can be found from Xema's Facebook page

Videos

Entering record and sending to Tiira

Setting location of Bird and entering multiple records

Supported devices:

Xema works with latest Android devices (version 2.2 and up) Nokia Symbian devices and N9.

Download

You can find Xema from Google Play

Free Xema Lite version from Google Play

Lite version is identical to full version except you cannot export your records to csv-file or to Tiira service.

Free download for older Nokia devices.

Versio 1.2.5, for Nokia N9

Nokian Symbian-laitteille (^3 and higher)

Updating Xema downloaded from Nokia Storesta to the latest version

Nokia N9

Follow these steps

Open Xema
Choose Export - All - All - ;
Open settings - Export own lists
Choose clear history
Close Xema
Uninstall Xema
Open device settings
Choose Applications - Installations - Allow installations from non-Store sources
Download new .deb file to the device and install it by opening it
Copy all .csv files from MyDocs/xema/exported folder to MyDocs/xema/imported folder
Open Xema
Choose import

Symbian devices

Follow these steps

Open Xema
Choose Export - All - All - ;
Open settings - Export own lists
Close Xema
Uninstall Xema
Download new .sis file to the device and install it by opening it (Note: installer warns about untrusted application as it is not from Nokia Store)
Copy all .csv files from E:\xema\exported (or from C: drive) folder to E:\xema\imported folder (or to C: drive)
Open Xema
Open settings - Import own lists
Return to main view
Choose import

Instructions

Tips

You can share a record with SMS, email or for example with Whatsapp. Choose a record from the list and select 'Share' from the context menu that opens by long pressing.

You can find items in list fast by typing to search field part of the name or abbreviation. For example Common magpie is found from records and species list by typing picpic.

In locations list you can use gps to show only near by places.

You can back all the Xema data by exporting records to csv file and other data from settings to own csv files. If you for some reason lost your Xema, you can restore everything by importing list data from settings and the records from records view.

Export & Import

Xema's records historys and added&modified data can be exported to .csv format. This way you can make backup of your data and save those for example to your PC.

Export

Observers, locations, species and statuses can be exported from settings view. Export generates own files for each of these and puts them to exported folder. In Android devices this folder is located in memory card or in internal memory at location Android/data/fi.iki.z7.xema/files. Exported folder's location in Symbian devices is in E: or C: drive under xema folder. In case of N9 the xema folder resides under MyDocs folder.

Records history can be exported from records view. You can choose whether to export all records or just new records that haven't been exported (or imported) earlier. You can also choose which delimiter character to use, # or ; . Also this file will be found under exported folder.

Import

The files you want to import needs to be .csv or .txt files that has list of entries, delimited with character # or ; . Files' first line can be header row, if it follows the same format the same format that export uses.

Records history

Records history can be imported from records view. Filename must include word history, record or _csv_. File header can have following fields:

Rivi-ID;Laji;Pvm1;Pvm2;Kello_hav_1;Kello_hav_2;Kunta;Paikka;X-koord;Y-koord;Paikan_tark;X-koord-linnun;Y-koord-linnun;Linnun_tark;Paikannettu;Lisätietoja;Atlaskoodi;Tallentaja;Tallennusaika;
Havainnoijat;Salattu;Koontihavainto;Kuuluu havaintoon;Määrä;Kello_lintu_1;Kello_lintu_2;Sukupuoli;Puku;Ikä;Tila;Lisätietoja_2;Parvi;Bongattu;Pesintä;Epäsuora havainto;Sää;Maa;Koord_tyyppi;Species_en;Species_sv;Species_sc;Species_fi;Tiira_csv;NotToTiira

example:

3;PARMAJ;06.08.2012;06.08.2012;13:10;13:15;Oulu;Peltola;3371168;7120210;;;;;;l2;2;;;Tero Siironen;X;;;2;13:10;13:15;n;eijp;pm;m;l1;1;X;X;;Aurinkoinen;Suomi;YKJ;Great Tit;Talgoxe;Parus Major;Talitiainen;;X

Download example file

Note! Xema doesn't use all these fields, but those are included for interoperability reasons.
Id can be any interger.
Instead of true/false character X is used to mark field as true and empty field as false (for example in nesting). If first column in the header is 'Havainto id' Xema assumes that the records have been exported from Tiira and marks them exported. Other column name options are 'Rivi-ID' and 'ID'.

When you are importing records, Xema automatically creates missing locations and observers that are found from records.

Observers

Observers like other list data can be imported from settings view. Filename must include word person or people and format is following:

firstname;lastname;registered;default;saver

Meaning: First name;Last name;Registered (to Tiira);Default name;Saver + new line

example:

Tero;Siironen;true;true;true

Download example file

Note! List should include only one saver.

Statuses

Filename must include word status and format is following:

abbrev;status_fi;status_sv;status_en

Meaning: Abbreviation;Status in finnish;Status in swedish;Status in english + new line

example:

p;Paikallinen;Stationär;Stationary

Download example file

Note! It is not mandatory to fill swedish and finnish fields.

Species

Filename must include word birds or species, and information should be in following format:

Meaning: Id;Group in finnish;Group in english;Scientific group name;Species name in finnish;Species name in swedish;Abbreviation;Scientific name;Category;Species name in english;Group in swedish + new line

example:

393;Lokit;Gulls;Laridae;Tiiralokki;Tärnmås;XEMSAB;Xema sabini;A;Sabine's Gull;Måsfåglar

Download example file

Note! It is not mandatory to fill swedish and finnish fields.
Id can be any integer.

Locations

Filename must include word location and the information should be in following format:

town_fi;place_fi;wgs;ykj;town_sv;place_sv;town_en;place_en;country_fi;country_sv;country_en;organization;org_abbrev

Meaning: Town in finnish;place in finnish;WGS coordinates;YKJ coordinates;Town in swedish;place in swedish;Town in english;place in english;country in finnish;country in swedish;country in english;Association;Association's abbreviation + new line

example:

Kokkola;Isokari;63.8307:23.0335;7087180:3305004;Karleby;Stora Enskär;;;Suomi;Finland;Finland;Keskipohjanmaan Lintutieteellinen Yhdistys;KPLY

Download example file

Note! It is not mandatory to fill swedish and finnish fields. Also using coordinates is optional.
If you fill only another set of coordinates the other set is converted automatically.

Contact me

If you have problems or found a bug you can contact me by sending a mail to izero79 (at) gmail.com

Version history (Android)

v. 1.2.10

Species list updated
Tiira server settings visible only if dev or testi selected

v. 1.2.9

Fix for record import

v. 1.2.8

Share record with SMS/email etc. This can be done with long pressing record in the third level of the record list
Speed up first start after install/update
Bug fixes

v. 1.2.7

Allows removing 'Exported to Tiira' status
Fixes to internet connection check

v. 1.2.6

Fixed data importing

v. 1.2.5

Tiira service
Googlen map modes
Association locations selection from list
Location list updated
Fixes and improvements

v. 1.2.2

Bird location and location accuracy set for record
Export to csv from different list levels (all/day/day+location)
More default locations
Setting for default associaty (for location filtering)
Tiira export disabled (temporarily)

v. 1.2.1

Tiira functionality is shown only when user has logged in and has csv upload rights.

v. 1.2.0

Support for Tiira service (www.tiira.fi)
New set of locations (finnish bird associations: PSLY, PPLY, EKLY, KLY and PKLY)
Fixes and new items in import & export
WGS84/YKJ coordinate selection for record export
Multiple default names for new record input

v. 1.1.0

Place of bird can be set from map
Coordinates of the location can be set from map
Fixes to import and time fields
Birdlist selection Finland/Western Palearctic
Definition for default country and filter for locations based on the default country
Export can be selected to be done for default country
Show keyboard by default when selecting species or location
Species list is sorted by category first if filter text is set

v. 1.0.1

Lists can be modified during new record input by long pressing item
Fixed new record row adding in older Android versions

v. 1.0.0

First version Google Play Store

Version history (Nokia)

v. 1.2.5

Tiira services

v. 1.2.0

Association places selection from list
Location list updated

v. 1.1.1

Accuracy field for location and bird location
Record export from different list levels (all/date/date & place)
More default locations

v. 1.1.0

Map functionalities
User Interface improvements
Species list selection Finland/WP
Default country settings
Coordinate selection for export
Fixes to import and export
Multiple default names

v. 1.0.2

Species list covers whole Europe
Fixes to user interface
GPS filtering fixed in location list
Country field in locations
Bird place input field
Fixes to import and export
Compass in bird place input
Dataformats fixed to be compatible with Android version

v. 1.0.1

Coordinate conversion YKJ<->WGS done in real time while editing location
Clearly wrong coordinates not included in exported csv file
Fix in species list: hii-calling Common Chiffchaff PHYCOLHIIT (not PHYCOLHII)
exported csv file: Id column renamed to "Rivi-ID" to be compatible with Tiira

v. 1.0.0

First version in Nokia Store