Go to file
Stefano Costa 98dac1e4bd
add tox config file
2024-05-01 15:57:46 +02:00
.github Update pytest.yml 2023-09-11 14:48:13 +02:00
.tx Fix the path of i18n files 2015-02-26 21:59:14 +01:00
data Key "Encoding" in group "Desktop Entry" is deprecated 2015-03-01 16:38:22 +01:00
docs add versionadded to nikon_npl_322plus 2023-09-28 00:05:58 +02:00
locale Update gettext PO template file 2021-09-26 21:28:55 +02:00
sample_data Parser : Add unittest for LandXML input 2020-11-17 22:56:42 +01:00
scripts fix: binary data from download need to be saved as binary 2021-10-24 16:45:57 +02:00
totalopenstation fix #155: remove broken import 2023-10-02 22:59:53 +02:00
.gitignore Fix txt export 2016-01-07 15:04:41 +01:00
.readthedocs.yaml docs: upgrade dependencies and configuration 2021-10-29 21:26:11 +02:00
AUTHORS Update AUTHORS with new translations 2019-11-13 12:35:08 +01:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2019-12-08 10:29:19 +01:00
CONTRIBUTING.md Improve a few paragraphs of the CONTRIBUTING document 2020-01-10 15:42:48 +01:00
COPYING.txt Die, tabs, die! 2013-03-25 23:24:54 +01:00
MANIFEST.in Add the AUTHORS file to the distribution 2015-02-26 22:01:37 +01:00
README.rst fix badges in README.rst 2023-09-17 11:19:54 +02:00
setup.py Add trove classifier for Python 3.8 2020-01-16 10:07:57 +01:00
totalopenstation-gui.spec change module name to nikon_npl_322plus 2023-09-27 23:36:06 +02:00
tox.ini add tox config file 2024-05-01 15:57:46 +02:00

README.rst

====================
 Total Open Station
====================


.. image:: https://github.com/totalopenstation/totalopenstation/actions/workflows/pytest.yml/badge.svg
  :alt: pytest continuous integration 

.. image:: https://img.shields.io/pypi/v/totalopenstation
  :target: https://pypi.org/project/totalopenstation/
  :alt: PyPI

.. image:: https://img.shields.io/readthedocs/totalopenstation
  :target: https://totalopenstation.readthedocs.io/
  :alt: Read the Docs

|

Total Open Station is a program for downloading and processing survey data from total station devices.

.. image:: https://tops.iosa.it/img/totalopenstation-gui.gif

Total Open Station is a good choice if:

- you work with total stations on GNU/Linux (and MacOS, probably)
- you work with old devices that are unsupported by vendors
- you need to process hundreds of data files at once

We think Total Open Station is small but great because:

- it is *free/libre open source software*
- it works on *any* operating system where Python is available
- it is designed to support as many devices and formats as possible, all
  within the same program, opposed to having one program per device
- it works both on the command line and with a graphical interface

Total Open Station uses a modular structure and
keeps the downloading of data logically separated from its processing,
thus enabling exporting data to a variety of output formats, even at a
later moment. Archiving of raw data is made easy by using plain text
files.

Installing
==========

If you're comfortable with the command line:

.. code-block:: bash

    pip install totalopenstation

Windows users can download the portable app from the 
GitHub `releases page <https://github.com/steko/totalopenstation/releases>`_.

GNU/Linux users can find the `totalopenstation` package in some distributions
(OpenSUSE, Debian, Ubuntu). Make sure that `python3-tk` or `python3-tkinter` is
installed on your system, otherwise install it with your package manager (apt, dnf, pacman).

Documentation
=============

Documentation is online at http://totalopenstation.readthedocs.io/ with
an user guide, details on the application structure, supported models
and other interesting stuff.

Development
===========

Total Open Station is developed by @steko, @psolyca and other contributors, including
translators and providers of sample data. We are not professional software developers
but we do our best to follow modern good practice. Feel free to submit a feature request
or a pull request on GitHub.

The application icons are copyright by Lapo Calamandrei 2008, under the
same license as Total Open Station.