Overview

This package provides “low-level” (i.e. the primary implementations do not process data, only facilitate access to the raw commands) Python wrapper functions for controlling various surveying instruments. GeoComPy is primarily based on and uses the GeoCOM ASCII command system (and occasionally the GSI Online commands) of Leica products. Communication is typically through a serial port.

Features

  • Pure Python implementation

  • Serial communication handler

  • Universal data types for communication

  • Automatic serialization and deserialization of parameters

  • Commands implemented from reference manuals

    • DNA

    • LS

    • TPS1000

    • TPS1100

    • TPS1200(+)

    • VivaTPS

Tip

Command line applications are available in a separate package called Instrumentman.

Requirements

Installation

The installed package and subpackages can be imported from the geocompy root package.

Import example
from geocompy import GeoCom

As with any Python package, it might be advisable to install GeoComPy in an isolated enviroment, like a virtual enviroment for more complex projects.

From PyPI

GeoComPy is hosted on PyPI, therefore it can be installed with pip. Package dependencies are automatically handled.

Installing from PyPI
pip install geocompy

From source

Download the release archive from PyPI, or from GitHub releases. Unpack the archive to a suitable place, and enter the geocompy-x.y.z directory. Build and install the package with the following command:

Building and installing locally
python -m pip install .