NEON / SEPON KOORDINAATTIMUUNNIN

KÄYNNISTYS WINDOWSISSA
1. Asenna Python 3.11 tai uudempi osoitteesta https://www.python.org/downloads/windows/
   Sisällytä Python launcher ja Tcl/Tk. Jos nämä ovat jo asennettu, ohita tämä.
2. Pura koko ZIP omaan kirjoitettavaan kansioon.
3. Avaa KAYNNISTA.bat. Ensimmäinen käynnistys asentaa pyproj-kirjaston internetistä
   paikalliseen .venv-ympäristöön. Järjestelmänvalvojan oikeuksia ei tarvita.
4. Muunnokset toimivat sen jälkeen ilman internetiä.

OMA EXE
RAKENNA_EXE.bat luo Windowsissa dist/NeonKoordinaatit.exe-tiedoston.
Rakennus tarvitsee internetin. Valmis EXE sisältää Pythonin ja muunnoskirjaston.
Tämä toimitus on lähdekoodipaketti, ei valmiiksi käännetty EXE.

KÄYTTÖ
Valitse lähtömuoto valikosta. Syötä kaksi koordinaattia ja paina Muunna tai Enter.
Tulokset näkyvät rinnakkain. Kopioi yksittäinen muoto tai kaikki tulokset.
Tallenna TXT avaa tallennusikkunan, jossa voit valita kansion ja tiedostonimen.
Avaa kartalla avaa pisteen OpenStreetMapissa. Vain tämä painike lähettää
valitun pisteen verkkopalveluun. Historiaa ei tallenneta automaattisesti.

TUETUT MUODOT
DD (WGS84): leveys 64.225000, pituus 27.7333333333
DDM (WGS84): N 64 13.500 ja E 027 44.000
DMS (WGS84): N 64 13 30 ja E 027 44 00
ETRS-TM35FIN (EPSG:3067): N (pohjoinen) ja E (itä), metreinä.
Kajaanin esimerkkipainike syöttää yllä olevan esimerkkipisteen.

Piste ja pilkku käyvät desimaalierottimiksi. Käytä eri kenttiä leveydelle ja
pituudelle; koko koordinaattiparin liittämistä yhteen kenttään ei tueta.
Aste-, minuutti- ja sekuntimerkit ovat vapaaehtoisia, välilyönnit riittävät.
N/S ja E/W voi kirjoittaa luvun alkuun tai loppuun. N = pohjoinen, S = etelä,
E = itä, W = länsi. Ilman kirjainta positiivinen on N/E, negatiivinen S/W.
Minuutit ja sekunnit ovat välillä 0–59.999..., eivät koskaan 60.
TM35FIN-luvuissa välilyönnit tuhaterottimina käyvät; älä kirjoita yksikköä kenttään.

TARKKUUS JA RAJAUKSET
DD näytetään 7 desimaalilla, DDM 3 minuutin desimaalilla, DMS 2 sekunnin
desimaalilla ja metrit 3 desimaalilla. Pyöristys siirtää 60 minuutiksi tai
sekunniksi pyöristyvän arvon oikein seuraavaan asteeseen/minuuttiin.
Näytettyjen numeroiden määrä ei tarkoita vastaavaa mittaustarkkuutta.
Aste-esitysten välillä muuttuu vain esitystapa. TM35FIN-muunnos käyttää
pyproj/PROJ-kirjastoa, EPSG:4326 ja EPSG:3067, aina longitude/easting ensin
kirjaston rajapinnassa. Käyttöliittymässä leveys/N on ensin, kentät on nimetty.
WGS84:n ja ETRS89:n realisaatioita ja koordinaattien havaintoajankohtaa ei
käsitellä. Näiden järjestelmien ero voi olla metriluokkaa. Tämä on yleiseen
paikannukseen ja geokätköilyyn tarkoitettu työkalu, ei tarkkaan maanmittaukseen.
TM35FIN rajataan käyttöalueen suorakulmioon 19.08–31.59 E, 58.84–70.09 N.
Se ei ole valtakunnan rajatesti. Sen ulkopuolella aste-esitykset toimivat,
mutta TM35FIN-tulosta ei anneta. KKJ/YKJ, muut UTM-kaistat ja korkeudet eivät kuulu
tähän versioon. Karttakoordinaattien järjestelmä on tunnettava ennen muunnosta.

TESTAUS
python -m unittest -v test_coordinates.py
Mukana testit tunnetuille kulmille ja projektiopisteelle, pyöristykselle,
virhesyötteille sekä TM35FIN-edestakaismuunnokselle.
Windows-käyttöliittymää ja EXE-rakennusta ei ole testattu aidossa Windowsissa
tämän toimituksen yhteydessä.

LÄHTEET
https://www.maanmittauslaitos.fi/kartat-ja-paikkatieto/koordinaatit-ja-paikannus/koordinaattijarjestelmat
https://pyproj4.github.io/pyproj/stable/api/transformer.html
