<commit_before>PySitra
=======

A Python package for a two-way 2D transformation between old and new
slovenian coordinates system.

About
-----

PySitra is a python written library two-way 2D transformation between
old and new slovenian coordinates system. The project and it's name
(**Py**\ thon **S**\ loven\ **i**\ an **tra**\ nsformation) is inspired
by the popular Slovenian web portal for online point transformation
between old (Gauss-Krüger) and new (Transverse Mercator) coordinate
systems, called `SitraNet.si <www.sitranet.si>`__, and it's C-written
command-line-friendly successor `Geo Coordinate
Converter <http://geocoordinateconverter.tk/indeks.html>`__. Library
comes with a handy command-line utility tool that enables an easy batch
conversion of shapefiles and coma-separated ascii files.

Program supports two most commonly used transformating methods for 2D
point transformations:
- **triangle:** affine 6-parametric 2D triangle
transformation, based on 899 `Slovenian reference
points <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/horizontalni-drzavni-koordinatni-sistem-d96tm/d96tm/transformacijski-parametri/>`__
(best accuracy)
- **24regions:** a simplified 4-parametric 2D
transformation (where parameteres are precalculated for 24 Slovenian
regions (`more
info <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/horizontalni-drzavni-koordinatni-sistem-d96tm/d96tm/transformacijski-parametri/>`__)

Program contains spatailly precalculated regional transformation
parameters, but also allows a manual specification of transformation
parameters for both available methods.

**IMPORTANT NOTICE:** Library is primarily intended and therefore mostly
suitable for slovenian coordinate systems d48GK (espg: 3912) and d96TM
(epsg: 3794)!

For more theoretical background, see the official GURS
`webpage <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/transformacija-v-novi-koordinatni-sistem/>`__.

Installation:
-------------

Library is available on PyPi repository, so it can easily be installed
with pip:

::

    pip install pysitra

Usage:
------

1. Python API
~~~~~~~~~~~~~<commit_msg>readme update<commit_after>PySitra
=======

A Python package for a two-way 2D transformation between old and new
slovenian coordinates system.

About
-----

PySitra is a python written library two-way 2D transformation between
old and new slovenian coordinates system. The project and it's name
(**Py**\ thon **S**\ loven\ **i**\ an **tra**\ nsformation) is inspired
by the popular Slovenian web portal for online point transformation
between old (Gauss-Krüger) and new (Transverse Mercator) coordinate
systems, called `SitraNet.si <www.sitranet.si>`__, and it's C-written
command-line-friendly successor `Geo Coordinate
Converter <http://geocoordinateconverter.tk/indeks.html>`__. Library
comes with a handy command-line utility tool that enables an easy batch
conversion of shapefiles and coma-separated ascii files.

Program supports two most commonly used transformating methods for 2D
point transformations:
* **triangle:** affine 6-parametric 2D triangle
transformation, based on 899 `Slovenian reference
points <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/horizontalni-drzavni-koordinatni-sistem-d96tm/d96tm/transformacijski-parametri/>`__
(best accuracy)
* **24regions:** a simplified 4-parametric 2D
transformation (where parameteres are precalculated for 24 Slovenian
regions (`more
info <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/horizontalni-drzavni-koordinatni-sistem-d96tm/d96tm/transformacijski-parametri/>`__)

Program contains spatailly precalculated regional transformation
parameters, but also allows a manual specification of transformation
parameters for both available methods.

**IMPORTANT NOTICE:** Library is primarily intended and therefore mostly
suitable for slovenian coordinate systems d48GK (espg: 3912) and d96TM
(epsg: 3794)!

For more theoretical background, see the official GURS
`webpage <http://www.e-prostor.gov.si/zbirke-prostorskih-podatkov/drzavni-koordinatni-sistem/transformacija-v-novi-koordinatni-sistem/>`__.

Installation:
-------------

Library is available on PyPi repository, so it can easily be installed
with pip:

::

    pip install pysitra

Usage:
------

1. Python API
~~~~~~~~~~~~~
{'fraction_non_alphanumeric': 0.1018935978358882, 'fraction_numerical': 0.015779981965734897, 'mean_word_length': 5.231741573033708, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 13, 'https://': 0, 'lorem ipsum': 0, 'www.': 8, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6554222', 'n_tokens_mistral': 1481, 'n_tokens_neox': 1346, 'n_words': 433}