totalopenstation-0.5.1/ 0000755 0001750 0001750 00000000000 13607717332 013277 5 ustar mfv mfv totalopenstation-0.5.1/docs/ 0000755 0001750 0001750 00000000000 13607717332 014227 5 ustar mfv mfv totalopenstation-0.5.1/docs/installing.rst 0000644 0001750 0001750 00000013167 13607717037 017137 0 ustar mfv mfv .. _installing:
=============================
Installing Total Open Station
=============================
There are a few different ways to install Total Open Station,
depending on your operating system.
.. warning::
Version 0.4.0 of Total Open Station is the last version built on Python2. |br|
**Thus no support will be done on this version after 0.5 release as Python2 has reached his EOL.** |br|
Version 0.5+ will be Python3 only. |br|
GNU/Linux distributions
=======================
OpenSUSE
--------
Total Open Station is packaged for OpenSUSE. Installing is as easy as::
$ sudo zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.1/ GEO
$ sudo zypper refresh
$ sudo zypper install TotalOpenStation
Change the OpenSUSE version as your wish.
Debian and Ubuntu
-----------------
Total Open Station is included in Debian and Ubuntu, just::
sudo apt-get install totalopenstation
as usual. Please note that the version provided by your distribution may not
be the latest release.
Mac OSX
=======
Download Python3 from the `official website `_,
and follow `this document on the Python.org website `_,
that will help you choosing the correct version of Python to use
(Python 3.7.2+, 3.6.8, or 2.7.16+ have builtin Tcl/Tk).
.. warning::
Do not use the pre-installed Python that comes with the OSX operating system
which has serious bugs that can cause application crashes.
Microsoft Windows
=================
Download the most recent version of Total Open Station from `Github download
`_ and install it.
The Windows version of Total Open Station is portable and everything is
included in the executable.
To upgrade to a newer version, just go to the Github download page again
and install it. |br|
The old version will get overwritten. |br|
No data will be lost!
Install the Prolific PL2032 drivers
-----------------------------------
(optional, but recommended).
Most USB-serial adapters are made with the Prolific chipset. If
plugging the cable gives you errors about missing drivers for your
hardware, drivers for Windows can be downloaded from the `Prolific
website `_.
Using pip
=========
Until your operating system's packaging tools (e.g. apt or
yum) allow you to install Total Open Station along with other
programs, the recommended way to install is using pip_ (a package
manager for Python) and virtualenv_ (which creates isolated
software environments: basically you don't mix packages installed
system-wise with your package manager and user-installed
software). Here follows a detailed step-by-step guide.
.. _pip: http://www.pip-installer.org/
.. _virtualenv: http://pypi.python.org/pypi/virtualenv
Install ``pip`` and ``virtualenv``
----------------------------------
First of all, make sure you have ``pip`` and ``virtualenv``
installed. All major GNU/Linux distributions have them packaged:
- Debian and derivatives (including Ubuntu)::
apt-get install python-pip python-virtualenv
- Fedora::
yum install python-pip python-virtualenv
Create a virtual environment
----------------------------
Creating a virtual environment is as easy as typing in a terminal::
virtualenv tops-environment
A new directory named ``tops-environment`` has been created. It contains a
minimal set of files needed to manage a Python installation that is
isolated from the one installed on your system, helping to keep things
clean.
Now, activate the environment with::
source tops-environment/bin/activate
From now on, all Python-related actions will be executed within the
newly created environment, and not on the system-wide
installation. You terminal should look a bit different when the
virtual environment is active::
(tops-environment)steko@gibreel:$
You can change directory freely, the environment will remain active.
You *deactivate* the environment (that is, you exit from it), with the
``deactivate`` command.
Installing Total Open Station
-----------------------------
Once the virtual environment is *active*, you're ready to install
Total Open Station, with::
pip install totalopenstation
This will automatically download the latest released version from the
Python Package Index (PyPI), and install all the other required Python
packages as well.
Installing development versions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sometimes it is useful to install development versions before they are
released, to help with testing of new features and making sure that
there are no new bugs.
Using the procedure described above it is fairly easy to create
another, separate environment. Once the new environment is *active*,
the command for installing a development version is::
pip install -e git+https://github.com/steko/totalopenstation#egg=totalopenstation
Developers may ask you to install from another repository, but the
concept stays the same. This mechanism is very flexible and allows to
install and test different versions safely.
Running the program
-------------------
When the program is installed, you can use it from the command line or
with a graphical interface (recommended for new users).
From your terminal, type::
totalopenstation-gui.py
and the program should start. Please report any errors to the `bug tracker`_.
The next time you want to run the program, follow these steps:
#. open a terminal
#. ``cd`` to the directory where the virtual environment was created
#. ``source tops-environment/bin/activate`` to enter the virtualenv
#. ``totalopenstation-gui.py`` will start the program
totalopenstation-0.5.1/docs/interfaces/ 0000755 0001750 0001750 00000000000 13607717332 016352 5 ustar mfv mfv totalopenstation-0.5.1/docs/interfaces/gui_main.rst 0000644 0001750 0001750 00000006500 13607717037 020677 0 ustar mfv mfv .. _gui-main:
======================
Total Open Station GUI
======================
Downloading raw data
--------------------
To download raw data, your total station must be connected to the
computer you are using, and the connection parameters must be known
and set in the program. Total Open Station saves certain parameters
across work sessions, but not all of them are saved, yet.
The normal download procedure is a four-step operation:
#. once the right parameters are set, click on the :guilabel:`Connect`
button
#. a small window appears, telling that the program is ready to start
the download
#. start the data transfer from the menu of the total station
#. press the :guilabel:`OK` button in the small window (the order of
these two last steps matters)
Downloaded data will be shown in real-time in the main program
window. A short information dialog will appear at the end of the
transfer. If any error blocks you in this procedure, please send a
detailed description to the mailing list so we can help you.
Saving raw data
---------------
Raw data shown in the main program window can be edited if you need,
and saved to disk clicking the :guilabel:`Save raw data` button. We
highly recommend to save all data to disk before any other action,
because it prevents data loss and it is a very convenient way to have
a backup of your work. Plus, raw data files are generally very small
in size if compared to the exported files.
By default saved files get a :file:`.tops` extension, but it is
absolutely optional to have this extension.
Opening previously saved data
-----------------------------
The :guilabel:`Open file` button lets you open any ASCII file you have on
your disk for processing with Total Open Station, either previously
saved with TOPS itself or not.
Data can be edited in the text area. Editing patterns include:
- removing lines of data that don't need to be processed
- correcting errors in data
- pasting more than one data file together
Please note that if you do not know well the raw data format you are
editing, data may become inconsistent, and it will not be possible to
process them properly later. If you are unsure, do not edit raw data.
Exporting data
--------------
The main purpose of Total Open Station is to export raw data in
formats that are not read by GIS and CAD programs, to common formats
that are easy to import.
To start exporting data, make sure that the text area in the main
program window contains the data you want to export. If this is not
the case, you can either download data from your total station or open
a previously-saved data file.
Click the :guilabel:`Process data` button. A window will appear,
allowing you to choose two processing options:
- the input format
- the output format
Select the input format of the raw data you have (if you are using the
same total station all the time, it will be probably the same -- we
are working on adding a way to save the last used formats across
different working sessions).
Then select the output format you want to use, and proceed with the
:guilabel:`OK` button. You will be asked where you want to save the
exported file.
You can now open your exported data in the GIS or CAD program of
choice for further processing. Should you need to go back to the
original data, you can always repeat the above procedure starting from
the saved raw data file. totalopenstation-0.5.1/docs/interfaces/main.rst 0000644 0001750 0001750 00000003105 13607717037 020031 0 ustar mfv mfv .. _interfaces:
========================
Using Total Open Station
========================
There are two ways to use Total Open Station, from the command line or
as a user-friendly program. Each mode of operation has its drawbacks,
and both are constantly used and tested.
Graphical User Interface
========================
If you followed the guide about :ref:`installing`, you should be able
to start Total Open Station.
The basic usage of Total Open Station is made of the following steps:
#. download raw data from the total station
#. save raw data (optional, but recommended)
#. export raw data to an output format
Saving raw data enables you to open data files even at a later stage
and process them when it's more appropriate.
A complete manual of :ref:`gui-main`
Command-line
============
After :ref:`installing`, there will be three new executable programs
in your path. Two of them are meant for being run in a terminal, and
are extremely useful for batch operations and easy repeating of common
tasks with minimum time effort.
:ref:`cli-connector` and :ref:`cli-parser`
are two command line programs that make the same features of the graphical
interface available to those who prefer working in a terminal. They are well
documented, and they make it possible to process large amounts of data files
via shell scripting, or to drastically reduce the time needed for downloading
raw data.
These two programs also provide a basic but complete example of how to
use Total Open Station as a programming library.
.. toctree::
:maxdepth: 1
cli_connector
cli_parser
gui_main
totalopenstation-0.5.1/docs/interfaces/cli_connector.rst 0000644 0001750 0001750 00000001726 13607717037 021735 0 ustar mfv mfv .. _cli-connector:
================================
Total Open Station CLI Connector
================================
This is a command line application to download raw data from total station
devices.
Synopsis
========
totalopenstation-cli-connector.py [options]
Options
=======
-h, --help show this help message and exit
-m MODEL, --model=MODEL
select input MODEL
-p PORT, --port=PORT select input SERIAL PORT
-o FILE, --outfile=FILE
select output FILE (do not specify for stdout)
Using totalopenstation-cli-connector
------------------------------------
The ``--model`` and ``--port`` options are mandatory.
In most cases the default parameters for serial connection should work, but
you should know how your total station is set, or alternatively you should
be able to set serial parameters on the total station directly.
Output goes to stdout by default, but it is recommended to use the -o option.
totalopenstation-0.5.1/docs/interfaces/cli_parser.rst 0000644 0001750 0001750 00000002707 13607717037 021237 0 ustar mfv mfv .. _cli-parser:
=============================
Total Open Station CLI Parser
=============================
This is a command line application to convert raw data to common formats for
use in CAD or GIS environments.
Synopsis
========
totalopenstation-cli-parser [options]
Options
=======
-h, --help show this help message and exit
-i FILE, --infile=FILE
select input FILE (do not specify for stdin)
-o FILE, --outfile=FILE
select output FILE (do not specify for stdout)
-f FORMAT, --input-format=FORMAT
select input FORMAT
--2d Exclude Z coordinates, output only 2D data
-t FORMAT, --output-format=FORMAT
select input FORMAT
-r, --raw Enhanced parsed file process
--overwrite overwrite existing output file
--list list the available input and output formats
Using totalopenstation-cli-parser
---------------------------------
If no input file is specified, input is read from stdin.
Output goes to stdout by default, but it is recommended to use the -o option.
Raw parsing
-----------
The ``--raw`` option is useful when exporting to CSV for processing in
other programs, and will export all field records found in the raw data from
the total station. It only makes sense for certain input formats where the
original measurements are stored, namely:
- Leica GSI
- Nikon RAW
- Carlson RW5
totalopenstation-0.5.1/docs/input_formats/ 0000755 0001750 0001750 00000000000 13607717332 017121 5 ustar mfv mfv totalopenstation-0.5.1/docs/input_formats/if_carlson_rw5.rst 0000644 0001750 0001750 00000034416 13607717037 022601 0 ustar mfv mfv .. _Carlson website: http://update.carlsonsw.com/kbase_attach/372/
.. _if_carlson_rw5:
===============================================================
:mod:`carlson_rw5` -- Carlson SurvCE Raw Data File Format (RW5)
===============================================================
.. moduleauthor:: Stefano Costa, Filip Kłosowski
.. versionadded:: 0.4
Carlson RW5 is an exchange format used by the Carlson SurvCE software.
The official documentation about the format is provided on the
`Carlson website`_.
RW5 is a rich format for raw data about the entire field operation of total
stations and even GPS.
For example::
OC,OP111,N 16556174.237,E 942130.662,EL 16.404
BK,OP111,BP108,BS0.00000,BC0.00000 LS,HI5.684,HR5.500
SS,OP111,FP108,AR0.00000,ZE0.00017,SD3.3566,--FENCE1
At the moment, a minimal subset of the specification is supported, consisting of
the ``OC``, ``BP``, ``LS`` and ``SS`` record types.
Carlson Record Information
==========================
The format is a comma separated ASCII file containing record types, headers,
recorded data and comments. The format is based on the :ref:`tds` raw data
specification with the exception of angle sets.
Angle sets are recorded as BD, BR, FD and FR records to allow reduction of all
possible data that can be recorded by SurvCE using the “Set Collection”
routine. Essentially, these records are identical to a sideshot record. With
the exception of the aforementioned angle set records, if the :ref:`tds`
specification is modified to provide enhanced functionality, the added or
modified data will reside in comment records to avoid incompatibility with
existing software.
Each record is made of one line of text, with comma-separated fields of ASCII
text format::
AH,DC%s,MA%s,ME%s,RA%s
The first field is a two-letter code of the type of record. All the following
fields are composed with 1- or 2- letter field codes (such as ``OP``, ``N`` or
``FP``) and numeric values called an (ENUM). The “Notes” field is introduced by
the ``--`` code and contains a description of the record.
In practice, each point has a unique number and can be referenced for various
purposes from other records.
*Sideshot* records (``SS``) reference the *Occupy point* record in the``OP``
field.
Record types
------------
+-------------+-----------------------------------------------+-----------------------+
| Record Type | Explanation | Applicable for |
+=============+===============================================+=======================+
| ``--`` * | Note | General Raw Data |
+-------------+-----------------------------------------------+-----------------------+
| JB* | Job | |
+-------------+-----------------------------------------------+-----------------------+
| MO* | Mode Setup | |
+-------------+-----------------------------------------------+-----------------------+
| BD* | Backsight Direct | Conventional Raw Data |
+-------------+-----------------------------------------------+-----------------------+
| BK* | Backsight | |
+-------------+-----------------------------------------------+-----------------------+
| BR* | Backsight Reverse | |
+-------------+-----------------------------------------------+-----------------------+
| FD* | Foresight Direct | |
+-------------+-----------------------------------------------+-----------------------+
| FR* | Foresight Reverse | |
+-------------+-----------------------------------------------+-----------------------+
| GPS | GPS Position in |br| | |
| | Lat: dd.mmss |br| | |
| | Lon: dd.mmss - Negative for West |br| | |
| | WGS84 Ellipsoid Elevation | |
+-------------+-----------------------------------------------+-----------------------+
| GS | Reduced local coordinate from GPS record |br| | |
| | and localization data | |
+-------------+-----------------------------------------------+-----------------------+
| LS* | Line of Sight | |
+-------------+-----------------------------------------------+-----------------------+
| OC* | Occupy Point | |
+-------------+-----------------------------------------------+-----------------------+
| OF | Off Center Shot | |
+-------------+-----------------------------------------------+-----------------------+
| SP* | Store Point | |
+-------------+-----------------------------------------------+-----------------------+
| TR/SS* | Traverse / Sideshot | |
+-------------+-----------------------------------------------+-----------------------+
\* implemented type
Field headers
-------------
+--------------+--------------------------------+----------------+
| Field header | Explanation | Applicable for |
+--------------+--------------------------------+----------------+
| AD | Azimuth Direction |br| | |
| | 0: North |br| | |
| | 1: South | |
+--------------+--------------------------------+----------------+
| AL* | Angle-Left | |
+--------------+--------------------------------+----------------+
| AR* | Angle-Right | |
+--------------+--------------------------------+----------------+
| AU* | Angle Unit |br| | |
| | 0: 360° sexagesimal |br| | |
| | 1: 400 gon | |
+--------------+--------------------------------+----------------+
| AZ* | Azimuth | |
+--------------+--------------------------------+----------------+
| BC* | Back Circle | |
+--------------+--------------------------------+----------------+
| BP* | Back Point | |
+--------------+--------------------------------+----------------+
| BR* | Bearing |br| | |
| | [N123.4500W] | |
+--------------+--------------------------------+----------------+
| BS | Backsight |br| | |
| | when back point is not defined | |
+--------------+--------------------------------+----------------+
| CE* | Change Elevation | |
+--------------+--------------------------------+----------------+
| DL* | Deflection-Left | |
+--------------+--------------------------------+----------------+
| DR* | Deflection-Right | |
+--------------+--------------------------------+----------------+
| DT | Local Date |br| | |
| | [MM-DD-YYYY] | |
+--------------+--------------------------------+----------------+
| E* | Easting |br| | |
| | [E space] | |
+--------------+--------------------------------+----------------+
| EC | Earth Curvature |br| | |
| | 0: off |br| | |
| | 1: on | |
+--------------+--------------------------------+----------------+
| EL* | Elevation | |
+--------------+--------------------------------+----------------+
| EO | EDM Offset | |
+--------------+--------------------------------+----------------+
| FE | Foresight Elevation | |
+--------------+--------------------------------+----------------+
| FP* | Foresight Point | |
+--------------+--------------------------------+----------------+
| HD* | Horizontal Distance | |
+--------------+--------------------------------+----------------+
| HI* | Height of Instrument | |
+--------------+--------------------------------+----------------+
| HR* | Height of Rod | |
+--------------+--------------------------------+----------------+
| N | Northing |br| | |
| | [N space] | |
+--------------+--------------------------------+----------------+
| OC | Occupy Point | |
+--------------+--------------------------------+----------------+
| OP | Occupy Point | |
+--------------+--------------------------------+----------------+
| PN | Point Number | |
+--------------+--------------------------------+----------------+
| SD* | Slope Distance | |
+--------------+--------------------------------+----------------+
| SF | Scale Factor | |
+--------------+--------------------------------+----------------+
| TM | Local Time |br| | |
| | [HH:MM:SS] | |
+--------------+--------------------------------+----------------+
| UN* | Distance Unit |br| | |
| | 0: feet |br| | |
| | 1: meter |br| | |
| | 2: US feet | |
+--------------+--------------------------------+----------------+
| VA* | Vertical Angle | |
+--------------+--------------------------------+----------------+
| ZE* | Zenith | |
+--------------+--------------------------------+----------------+
| ``--`` | Note | |
+--------------+--------------------------------+----------------+
\* Filed implemented
Definitions
===========
Backsight Record
----------------
:Record type: BK
:Field headers:
OP Occupy point |br|
BP Back Point |br|
BS Backsight |br|
BC Back Circle
:Sample(s):
::
BK,OP1,BP2,BS315.0000,BC0.0044
Job Record
----------
:Record type: JB
:Field headers:
NM Job name |br|
DT Date |br|
TM Time
:Sample(s):
::
JB,NMSAMPLE,DT06-27-2003,TM14:21:53
Line of Sight Record
--------------------
:Record type: LS
:Field headers:
HI Height of Instrument |br|
HR Height of Rod
:Sample(s):
::
LS,HI5.000000,HR6.000000
LS,HR4.000000
Mode Setup Record
-----------------
The mode setup will be recorded at the beginning of the raw data file.
:Record type: MO
:Field headers:
AD Azimuth direction |br|
UN Distance unit |br|
SF Scale factor |br|
EC Earth Curvature |br|
EO EDM offset |br|
AU Angle Unit
:Sample(s):
::
MO,AD0,UN0,SF1.00000000,EC1,EO0.0,AU0
Occupy Record
-------------
:Record type: OC
:Field headers:
PN Point number |br|
N Northing |br|
E Easting |br|
EL Elevation |br|
``--`` Note
:Sample(s):
::
OC,OP1,N 5000.00000,E 5000.00000,EL100.000,--CP
Off Center Shot Record
----------------------
:Record type: OF
:Field headers:
AR Angle right |br|
ZE Zenith (actual) |br|
SD Slope Distance
:Sample(s):
::
OF,AR90.3333,ZE90.0000,SD25.550000
OF,ZE90.3333,--Vert Angle Offset
Store Point Record
------------------
:Record type: SP
:Field headers:
PN Point Number |br|
N Northing |br|
E Easting |br|
EL Elevation |br|
``--`` Note
:Sample(s):
::
SP,PN100,N 5002.0000,E 5000.0000,EL100.0000,--PP
Traverse / Sideshot Record / Backsight Direct / Backsight Reverse / Foresight Direct / Foresight Reverse
--------------------------------------------------------------------------------------------------------
:Record type: TR / SS / BD / BR / FD / FR
:Field headers:
OP Occupy Point |br|
FP Foresight Point |br|
(one of the following) |br|
- AZ Azimuth |br|
- BR Bearing |br|
- AR Angle-Right |br|
- AL Angle-Left |br|
- DR Deflection-Right |br|
- DL Deflection-Left
(one of the following) |br|
- ZE Zenith |br|
- VA Vertical angle |br|
- CE Change Elevation |br|
(one of the following) |br|
- SD Slope Distance |br|
- HD Horizontal Distance |br|
``--`` Note
:Sample(s):
::
TR,OP1,FP4,AR90.3333,ZE90.3333,SD25.550000,--CP
SS,OP1,FP2,AR0.0044,ZE86.0133,SD10.313750,--CP
BD,OP1,FP2,AR0.0055,ZE86.0126,SD10.320000,--CP
BR,OP1,FP2,AR180.0037,ZE273.5826,SD10.315000,--CP
FD,OP1,FP3,AR57.1630,ZE89.4305,SD7.393000,--CP
FR,OP1,FP3,AR237.1612,ZE270.1548,SD7.395000,--CP
TOPS is capable of converting raw measurement data into local coordinates, by
performing a sequential processing of all records in their order.
Known limitations
=================
Support for measurements is still incomplete, here is a list of **TODO**:
* add all missing code
* get comments
* add the possibility to customize code
.. seealso::
`Information on Carlson RW5 `_ |br|
`Carlson RW5 format `_ |br|
Documentation for Carlson RW5 from Carlson knowledgebase.
totalopenstation-0.5.1/docs/input_formats/if_trimble_are.rst 0000644 0001750 0001750 00000000326 13607717037 022621 0 ustar mfv mfv .. _if_trimble_are:
=========================================
:mod:`trimble_are` -- Trimble AREA format
=========================================
.. moduleauthor:: Stefano Costa, Luca Bianconi, Alessandro Bezzi
totalopenstation-0.5.1/docs/input_formats/if_leica_tcr_1205.rst 0000644 0001750 0001750 00000000763 13607717037 022735 0 ustar mfv mfv .. _if_leica_tcr_1205:
=======================================
:mod:`leica_tcr_1205` -- Leica TCR 1205
=======================================
.. moduleauthor:: Stefano Costa, Stefano Costa
This format is used by the Leica TCR 1205 (and other similar devices),
and contains both polar and cartesian coordinates. At the moment, only
cartesian coordinates are used to obtain exported data.
Acknowledgements
================
Support for this format was added thanks to Joseph Reeves, OA Digital.
totalopenstation-0.5.1/docs/input_formats/tds.rst 0000644 0001750 0001750 00000165662 13172745060 020461 0 ustar mfv mfv .. _tds:
==================
Tripod Data System
==================
TDS (Tripod Data Systems) is a technique designed to use your handheld devices
as rough as you can to make it compatible with intense external environment.
They also provide the versatility in the range of friendly software for the
mobile computing and for various industries as well.
This format is designed to work with these devices and espacially with Survey Pro software.
The format is a comma separated ASCII file containing record types, headers,
recorded data and comments.
Each record is made of one line of text, with comma-separated fields of ASCII
text format::
AH,DC%s,MA%s,ME%s,RA%s
This format is the base of other formats :
- :ref:`if_carlson_rw5`
Record type
-----------
General Raw Data
________________
+---------------+------------------------------------------+
| Record Type | Explanation |
+===============+==========================================+
| -- | Note |
+---------------+------------------------------------------+
| JB | Job |
+---------------+------------------------------------------+
| MO | Mode Setup |
+---------------+------------------------------------------+
Conventional Raw Data
_____________________
+---------------+------------------------------------------+
| Record Type | Explanation |
+===============+==========================================+
| AP | Adjusted point |
+---------------+------------------------------------------+
| AT | Attributes |
+---------------+------------------------------------------+
| BK | Backsight |
+---------------+------------------------------------------+
| CF | Cut Sheet |
+---------------+------------------------------------------+
| DE | Design point / location |
+---------------+------------------------------------------+
| DL | Define a Location |
+---------------+------------------------------------------+
| DP | Deleted point |
+---------------+------------------------------------------+
| FC | Feature Code |
+---------------+------------------------------------------+
| LS | Line of Sight |
+---------------+------------------------------------------+
| MD | Multiple Distances |
+---------------+------------------------------------------+
| OC | Occupy Point |
+---------------+------------------------------------------+
| OE | Offset delta |
+---------------+------------------------------------------+
| OF | Off Center Shot |
+---------------+------------------------------------------+
| RB | Repeat Backsight |
+---------------+------------------------------------------+
| RD | Repeat Directional |
+---------------+------------------------------------------+
| RE | Remote Elevation |
+---------------+------------------------------------------+
| RF | Repeat Foresight |
+---------------+------------------------------------------+
| RS | Resection |
+---------------+------------------------------------------+
| SD | Deltas |
+---------------+------------------------------------------+
| SK | Stake Out |
+---------------+------------------------------------------+
| SL | Slope Staking |
+---------------+------------------------------------------+
| SP | Store Point |
+---------------+------------------------------------------+
| SR | Slope Staking Reference Offset |
+---------------+------------------------------------------+
| SU | Sun Shot |
+---------------+------------------------------------------+
| TR/SS/OB | Traverse / Sideshot / Observation |
+---------------+------------------------------------------+
GPS Raw Data
____________
+---------------+------------------------------------------+
| Record Type | Explanation |
+===============+==========================================+
| AH | GPS Antenna Height |
+---------------+------------------------------------------+
| BL | GPS Base Line |
+---------------+------------------------------------------+
| BP | Set Base Receiver Position |
+---------------+------------------------------------------+
| CG | COGO settings |
+---------------+------------------------------------------+
| CS | Coordinate System Identity |
+---------------+------------------------------------------+
| CT | Calibration Point |
+---------------+------------------------------------------+
| CV | RMS Covariance of GPS Base Line |
+---------------+------------------------------------------+
| DG | Datum Grid |
+---------------+------------------------------------------+
| DT | Datum |
+---------------+------------------------------------------+
| EE | GPS Edit Point |
+---------------+------------------------------------------+
| EP | Geodetic position |
+---------------+------------------------------------------+
| EQ | Equipment |
+---------------+------------------------------------------+
| ES | Ellipsoid |
+---------------+------------------------------------------+
| GK | GPS stakeout |
+---------------+------------------------------------------+
| GO | GPS Offset Shot |
+---------------+------------------------------------------+
| GP | GPS Point |
+---------------+------------------------------------------+
| GR | GPS adjusted point |
+---------------+------------------------------------------+
| GS | GPS Store Point |
+---------------+------------------------------------------+
| HA | Horizontal Calibration (Adjust) |
+---------------+------------------------------------------+
| PE | Extended Projection |
+---------------+------------------------------------------+
| PJ | Projection |
+---------------+------------------------------------------+
| RP | Local coordinates of calibration point |
+---------------+------------------------------------------+
| RX | Receiver Setup |
+---------------+------------------------------------------+
| ST | Local site settings |
+---------------+------------------------------------------+
| VA | Vertical Calibration (Adjust) |
+---------------+------------------------------------------+
Legacy Raw Data
_______________
+---------------+------------------------------------------+
| Record Type | Explanation |
+===============+==========================================+
| AA | Accumulating Angle-right |br| |
| | not used in SPCE |
+---------------+------------------------------------------+
| BB | Bench level, backsight |br| |
| | not used in SPCE |
+---------------+------------------------------------------+
| BG | Base Point Geoid Model Elevation |br| |
| | no longer supported in SPCE 3.5 |br| |
| | replaced by VA |
+---------------+------------------------------------------+
| BS | Bench level, side shots |br| |
| | not used in SPCE |
+---------------+------------------------------------------+
| BT | Bench level, traverse |br| |
| | not used in SPCE |
+---------------+------------------------------------------+
| HC | Horizontal Control Point |br| |
| | not supported in SPro 3.5 |br| |
| | replaced with CT |
+---------------+------------------------------------------+
| LE | Vertical Ellipsoid Height Setup |
+---------------+------------------------------------------+
| LG | Vertical Geoid Model Setup |br| |
| | no longer supported in SPCE3.5 |
+---------------+------------------------------------------+
| LM | Horizontal Mapping Plane Setup |br| |
| | no longer supported in SPCE3.5 |
+---------------+------------------------------------------+
| LH | Local transforming coefficients |br| |
| | for horizontal |br| |
| | no longer supported in SPCE3.5 |br| |
| | replaced by Horizontal adjustment HA |
+---------------+------------------------------------------+
| LV | Local transforming coefficients |br| |
| | for vertical |br| |
| | no longer supported in SPCE3.5 |br| |
| | replaced by Vertical adjustment VA |
+---------------+------------------------------------------+
| VC | Vertical Control point |br| |
| | not supported in SPro 3.5 |br| |
| | replaced with C |
+---------------+------------------------------------------+
Field headers
-------------
General and Conventional field list
___________________________________
+--------------+-----------------------------------------+
| Field header | Explanation |
+==============+=========================================+
| ``--`` | Note |
+--------------+-----------------------------------------+
| AD | Azimuth Direction |
+--------------+-----------------------------------------+
| AL | Angle Left |
+--------------+-----------------------------------------+
| AR | Angle Right |
+--------------+-----------------------------------------+
| AS | Ahead on station |
+--------------+-----------------------------------------+
| AU | Angle Unit |
+--------------+-----------------------------------------+
| AZ | Azimuth |
+--------------+-----------------------------------------+
| BC | Back Circle |
+--------------+-----------------------------------------+
| BD | Backsight direct |
+--------------+-----------------------------------------+
| BP | Back point |
+--------------+-----------------------------------------+
| BS | Backsight |
+--------------+-----------------------------------------+
| BV | Backsight reverse |
+--------------+-----------------------------------------+
| CE | Change elevation |
+--------------+-----------------------------------------+
| CF | Slope used |
+--------------+-----------------------------------------+
| CR | Circular Reading |
+--------------+-----------------------------------------+
| DE | Declination |
+--------------+-----------------------------------------+
| DS | Design Slope |
+--------------+-----------------------------------------+
| DT | Date (JB Record) |
+--------------+-----------------------------------------+
| DT | Date (SU Record) |br| |
| | [MMDDYYYY] |
+--------------+-----------------------------------------+
| E | Adj. Easting |
+--------------+-----------------------------------------+
| EC | Earth Curvature |
+--------------+-----------------------------------------+
| ED | Delta easting |
+--------------+-----------------------------------------+
| EG | Sun Position |
+--------------+-----------------------------------------+
| EL | Elevation or Adj. Elevation |
+--------------+-----------------------------------------+
| EO | EDM offset |
+--------------+-----------------------------------------+
| FD | Foresight direct |
+--------------+-----------------------------------------+
| FE | Foresight elevation |
+--------------+-----------------------------------------+
| FN | Feature code name |
+--------------+-----------------------------------------+
| FP | Foresight point |
+--------------+-----------------------------------------+
| FV | Foresight reverse |
+--------------+-----------------------------------------+
| GD | Grade |
+--------------+-----------------------------------------+
| GH | Greenwich hour angle |
+--------------+-----------------------------------------+
| HC | Horizontal dist. to center line |
+--------------+-----------------------------------------+
| HD | Horizontal distance |
+--------------+-----------------------------------------+
| HD | Horizontal or relative horizontal dist. |
+--------------+-----------------------------------------+
| HH | Horizontal distance to hinge point |
+--------------+-----------------------------------------+
| HI | Height of Instrument |
+--------------+-----------------------------------------+
| HR | Height of Rod |
+--------------+-----------------------------------------+
| LA | Latitude |
+--------------+-----------------------------------------+
| LD | Delta elevation |
+--------------+-----------------------------------------+
| LO | Longitude |
+--------------+-----------------------------------------+
| LR | Left/Right Offset |
+--------------+-----------------------------------------+
| N | Adj. Northing |
+--------------+-----------------------------------------+
| ND | Delta northing |
+--------------+-----------------------------------------+
| NM | Job Name |
+--------------+-----------------------------------------+
| OB | Observed slope |
+--------------+-----------------------------------------+
| OD | Offset Direction |
+--------------+-----------------------------------------+
| OE | Offset Delta |
+--------------+-----------------------------------------+
| OL | Offset length |
+--------------+-----------------------------------------+
| OP | Occupy point |
+--------------+-----------------------------------------+
| PN | Point name |
+--------------+-----------------------------------------+
| SD | Slope Distance |
+--------------+-----------------------------------------+
| SF | Scale Factor |
+--------------+-----------------------------------------+
| SM | Semi-diameter of Sun |br| |
| | in DMS |
+--------------+-----------------------------------------+
| ST | Station |
+--------------+-----------------------------------------+
| TM | Time (JB – Record) |br| |
| | [HH:MM:SS] |
+--------------+-----------------------------------------+
| TM | Time (EP – Record) |br| |
| | [HHMMSS] |
+--------------+-----------------------------------------+
| TM | Time (SU – Record) |br| |
| | [HH.dddddd] in UTC Time |
+--------------+-----------------------------------------+
| TN | Attribute name |
+--------------+-----------------------------------------+
| TV | Attribute value in string form |
+--------------+-----------------------------------------+
| UN | Distance Unit |
+--------------+-----------------------------------------+
| VC | Vertical distance to center point |
+--------------+-----------------------------------------+
| VD | Vertical or relative vertical distance |
+--------------+-----------------------------------------+
| VH | Vertical distance to hinge point |
+--------------+-----------------------------------------+
| ZD | Zenith Direct |
+--------------+-----------------------------------------+
| ZE | Zenith or Zenith angle |
+--------------+-----------------------------------------+
| ZV | Zenith Reverse |
+--------------+-----------------------------------------+
General and Conventional enumerated field list
______________________________________________
+---------+--------+-----------------------+---------------------+----------------+
| Field | Type | 0 | 1 | 2 |
+=========+========+=======================+=====================+================+
| AD | enum | North | South | |
+---------+--------+-----------------------+---------------------+----------------+
| AU | enum | degree | grads | |
+---------+--------+-----------------------+---------------------+----------------+
| CF | bool | cut | fill | |
+---------+--------+-----------------------+---------------------+----------------+
| EC | enum | off | on | |
+---------+--------+-----------------------+---------------------+----------------+
| OD | int | Center | Right | Left |
+---------+--------+-----------------------+---------------------+----------------+
| UN | enum | Feet | Meter | US Survey Feet |
+---------+--------+-----------------------+---------------------+----------------+
| EG | string | Left Trailing edge | Right Trailing Edge | center |
+---------+--------+-----------------------+---------------------+----------------+
GPS Field List
______________
+--------------+----------------------------------------------+
| Field header | Explanation |
+==============+==============================================+
| ``--`` | Description (Feature Code) |
+--------------+----------------------------------------------+
| AE Location Indicator |
+--------------+----------------------------------------------+
| AF | Azimuth format |
+--------------+----------------------------------------------+
| AI | Antenna Index int (See Antenna.ini File) |
+--------------+----------------------------------------------+
| AN | Antenna Number int (See Antenna.ini File) |
+--------------+----------------------------------------------+
| AO | Azimuth Orientation |
+--------------+----------------------------------------------+
| AT | Antenna Type (name of antenna) |
+--------------+----------------------------------------------+
| AZ | Azimuth double Geodetic Angle |
+--------------+----------------------------------------------+
| CL | Classification |
+--------------+----------------------------------------------+
| CO | Coordinate System Option |
+--------------+----------------------------------------------+
| CT | Origin center |
+--------------+----------------------------------------------+
| DA | Datum Transformation Type |
+--------------+----------------------------------------------+
| DC | Derivation Code |
+--------------+----------------------------------------------+
| DH | HDOP from Rx |
+--------------+----------------------------------------------+
| DM | Dimensions Used |
+--------------+----------------------------------------------+
| DN | Datum name |
+--------------+----------------------------------------------+
| DV | VDOP from Rx |
+--------------+----------------------------------------------+
| DX | Base line Delta X |
+--------------+----------------------------------------------+
| DY | Base line Delta Y |
+--------------+----------------------------------------------+
| DZ | Base line Delta Z |
+--------------+----------------------------------------------+
| E | Easting |
+--------------+----------------------------------------------+
| EL | Elevation |
+--------------+----------------------------------------------+
| EM | Ellipse Name |
+--------------+----------------------------------------------+
| FI | File name |
+--------------+----------------------------------------------+
| FO | File name one |
+--------------+----------------------------------------------+
| FT | File name two |
+--------------+----------------------------------------------+
| GF | Geodetic Flags |
+--------------+----------------------------------------------+
| GM | GPS Measure Method |
+--------------+----------------------------------------------+
| GN | Geoid Model Name |
+--------------+----------------------------------------------+
| GO | Grid Orientation |
+--------------+----------------------------------------------+
| HI | Height of laser at GPS ref. Point |
+--------------+----------------------------------------------+
| HO | Horizontal Offset |
+--------------+----------------------------------------------+
| HP | Horizontal Precision |
+--------------+----------------------------------------------+
| HR | Height of laser target at store offset Pt. |
+--------------+----------------------------------------------+
| HT | Height or Ellipsoid Ht. |
+--------------+----------------------------------------------+
| IF | Ellipse inverse flattening |
+--------------+----------------------------------------------+
| LA | Latitude |
+--------------+----------------------------------------------+
| LN | Longitude |
+--------------+----------------------------------------------+
| LX | Translation x |
+--------------+----------------------------------------------+
| LY | Translation y |
+--------------+----------------------------------------------+
| LZ | Translation z |
+--------------+----------------------------------------------+
| MA | Measured antenna height |
+--------------+----------------------------------------------+
| ME | Measure Method |
+--------------+----------------------------------------------+
| N | Northing |
+--------------+----------------------------------------------+
| OO | Orientation one |
+--------------+----------------------------------------------+
| OT | Orientation two |
+--------------+----------------------------------------------+
| OX | Rotation x |
+--------------+----------------------------------------------+
| OY | Rotation y |
+--------------+----------------------------------------------+
| OZ | Rotation z |
+--------------+----------------------------------------------+
| PN | Point Name |
+--------------+----------------------------------------------+
| PT | GPS Point Type |
+--------------+----------------------------------------------+
| PV | Type of Vertical Adjustment |
+--------------+----------------------------------------------+
| RA | Reduced antenna height |
+--------------+----------------------------------------------+
| RD | Ellipsoid Radius |
+--------------+----------------------------------------------+
| RE | Recording interval |
+--------------+----------------------------------------------+
| RH | Horizontal RMS from Rx |
+--------------+----------------------------------------------+
| RS | Rx Serial Number |
+--------------+----------------------------------------------+
| RT | Rotation about origin |
+--------------+----------------------------------------------+
| RV | Vertical RMS from Rx |
+--------------+----------------------------------------------+
| RX | Rx Type |
+--------------+----------------------------------------------+
| RY | Rectify |
+--------------+----------------------------------------------+
| SA | Slope east |
+--------------+----------------------------------------------+
| SC | Error Scale or Scale Factor |
+--------------+----------------------------------------------+
| SD | Slope Distance |
+--------------+----------------------------------------------+
| SF | Scale factor at origin |
+--------------+----------------------------------------------+
| SG | Setup Group |
+--------------+----------------------------------------------+
| SO | Slope north |
+--------------+----------------------------------------------+
| SP | Scale factor |
+--------------+----------------------------------------------+
| SV | Min. # of SV during obs. |
+--------------+----------------------------------------------+
| TA | Tape Adjustment |
+--------------+----------------------------------------------+
| TE | Translation East |
+--------------+----------------------------------------------+
| TH | Translation North |
+--------------+----------------------------------------------+
| TM | System Time |
+--------------+----------------------------------------------+
| TP | Type of projection |
+--------------+----------------------------------------------+
| TS | Antenna Serial Number |
+--------------+----------------------------------------------+
| VO | Vertical Offset |
+--------------+----------------------------------------------+
| VP | Vertical Precision |
+--------------+----------------------------------------------+
| XX | Variance X |
+--------------+----------------------------------------------+
| XY | Covariance X,Y |
+--------------+----------------------------------------------+
| XZ | Covariance X,Z |
+--------------+----------------------------------------------+
| YY | Variance Y |
+--------------+----------------------------------------------+
| YZ | Covariance Y,Z |
+--------------+----------------------------------------------+
| ZE | Zenith Angle |
+--------------+----------------------------------------------+
| ZG | Zone Group (system) name |
+--------------+----------------------------------------------+
| ZN | Zone name |
+--------------+----------------------------------------------+
| ZZ | Variance Z |
+--------------+----------------------------------------------+
GPS Enumerated Fields List
__________________________
:AE: Location indicator for Denmark projections enum |br|
• 1 = None |br|
• 2 = Zeeland |br|
• 3 = Jutland |br|
• 4 = Bornholm
:AF: Azimuth Format enum |br|
• 0 = Geodetic |br|
• 1 = Grid
:AO: Azimuth Orientation WORD |br|
• 1 = North |br|
• 2 = South
:CL: Classification enum |br|
• 0 = UnknownClass |br|
• 1 = Normal |br|
• 2 = Control |br|
• 3 = AsBuilt |br|
• 4 = Check |br|
• 5 = BackSight |br|
• 6 = Deleted Normal |br|
• 7 = Deleted Control |br|
• 8 = Deleted AsBuilt |br|
• 9 = DeletedCheck |br|
• 10 = DeletedBackSight
:CO: Coordinate System Option WORD |br|
• 1 = None |br|
• 2 = Scale only |br|
• 3 = Keyed in |br|
• 4 = Chosen from library
:CT: Origin Center enum |br|
• 0 = Equator |br|
• 1 = Projection center
:DA: Datum Transformation Type WORD |br|
• 513 = csdMolodenskyDatum |br|
• 514 = csdMultipleRegressionDatum |br|
• 515 = csdSevenParameterDatum |br|
• 516 = csdGridDatum |br|
• 517 = csdWGS84Datum
:DC: Derivation Code enum |br|
• 1 = ModeBase (Base) |br|
• 2 = ModeRover (Rover) |br|
• 3 = ModeGetBase (GetBase) |br|
• 4 = ModeStatic (Static)
:DM: Number of Dimensions Used for a Calibration WORD |br|
• 1 = 0D (None) |br|
• 2 = 1D (Vertical only) |br|
• 3 = 2D (Horizontal only) |br|
• 4 = 3D (Both vertical and horizontal) |br|
• 5 = Any
:GF: Geodetic Flags Bit Flags |br|
• Bit 0 = GPS Base Point |br|
• Bit 1 = GPS Horizontal Control Point |br|
• Bit 2 = GPS Veritcal Control Point |br|
• Bit 3 = GPS Control Point |br|
• Bit 4 = Local Map Plane Origin (Legacy, not used in Survey Pro 3.5 and beyond) |br|
• Bit 5 = GPS Base Coordinate Invalid
:GM: GPS Measure Method enum |br|
• 0 = UnknownMethod |br|
• 1 = UserInput |br|
• 2 = Autonomous |br|
• 3 = RTKFloat |br|
• 4 = RTKFixed |br|
• 5 = CopiedPoint |br|
• 6 = RTCMCode |br|
• 7 = WASS
:GO: Grid Orientation WORD |br|
• 1 = NE |br|
• 2 = SW |br|
• 3 = NW |br|
• 4 = SE
:ME: MeasureMethod enum |br|
• 0 = Unknown |br|
• 1 = True |br|
• 2 = Uncorrected
:PT: GPS Point Type enum |br|
• 1 = Control |br|
• 2 = Check |br|
• 3 = DataCollect |br|
• 4 = Offset |br|
• 5 = RemoteElevation |br|
• 6 = PostProcess |br|
• 7 = UserInput
:PV: Type of Vertical Adj. WORD |br|
• 1 = inclined plane |br|
• 2 = geoid model |br|
• 3 = combined
:TP: Type of Projection WORD |br|
• 2049 = Albers Equal Area Conic |br|
• 2050 = Cassini |br|
• 2051 = Krovak |br|
• 2052 = Lambert Conformal Conic One Parallel |br|
• 2053 = Mercator |br|
• 2054 = New Zealand Map Grid |br|
• 2055 = Oblique Conformal Conic |br|
• 2056 = Oblique Mercator Azimuth |br|
• 2057 = Oblique Stereographic |br|
• 2058 = Plane |br|
• 2059 = Stereographic |br|
• 2060 = RD Stereographic |br|
• 2062 = Transverse Mercator |br|
• 2063 = United Kingdom National Grid |br|
• 2064 = Denmark |br|
• 2065 = Hungarian EOV |br|
• 2066 = Lambert Conformal Conic Two Parallel |br|
• 2067 = Oblique Mercator Two Points |br|
• 2068 = Double Stereographic |br|
• 2069 = Grid
Legacy Field List
_________________
+----------------+----------------------------+
| Field header | Explanation |
+================+============================+
| ``--`` | Description (Feature Code) |
+----------------+----------------------------+
| AR | Angle right |
+----------------+----------------------------+
| Ba | Base Latitude |
+----------------+----------------------------+
| BC | Back circle |
+----------------+----------------------------+
| Bh | Base Ellipsoid Height |
+----------------+----------------------------+
| Bo | Base Longitude |
+----------------+----------------------------+
| CS | Coordinate System |
+----------------+----------------------------+
| DA | Datum |
+----------------+----------------------------+
| EL | Elevation |
+----------------+----------------------------+
| FI | Custome File Name |
+----------------+----------------------------+
| GI | Geoid model index |
+----------------+----------------------------+
| GU | Geoid Undulation at base |
+----------------+----------------------------+
| Ha | Coefficient a |
+----------------+----------------------------+
| Hb | Coefficient b |
+----------------+----------------------------+
| Hc | Coefficient c |
+----------------+----------------------------+
| Hd | Coefficient d |
+----------------+----------------------------+
| HE | Hemisphere |
+----------------+----------------------------+
| HT | Height |
+----------------+----------------------------+
| LA | Latitude |
+----------------+----------------------------+
| LN | Longitude |
+----------------+----------------------------+
| ME | Method |
+----------------+----------------------------+
| PN | Backsight point |
+----------------+----------------------------+
| RT | Rotation |
+----------------+----------------------------+
| SC | Scale |
+----------------+----------------------------+
| SD | Slope Distance |
+----------------+----------------------------+
| Va | Coefficient a |
+----------------+----------------------------+
| Vb | Coefficient b |
+----------------+----------------------------+
| Vc | Coefficient c |
+----------------+----------------------------+
| ZE | Zenith |
+----------------+----------------------------+
| ZO | Zone |
+----------------+----------------------------+
Definitions
-----------
General Raw Data
________________
Note Record
...........
Job Record
..........
:Record type: JB
:Field headers:
NM: Job name |br|
DT: Date |br|
TM: Time
:Sample(s):
::
“JB,NM%s,DT%s,TM%s”
Mode Setup Record
.................
The mode setup will be recorded at the beginning of the raw data file and whenever it is
changed.
:Record type: MO
:Field headers:
AD: Azimuth direction (ENUM) |br|
UN: Distance unit (ENUM) |br|
SF: Scale factor |br|
EC: Earth curvature (ENUM) |br|
EO: EDM offset (inch) (Default string “0.0”) |br|
AU: Angle unit (ENUM)
:Sample(s):
::
“MO,AD%s,UN%s,SF%s,EC%s,EO0.0,AU%s”
Conventional Raw Data
_____________________
Adjusted point record
.....................
:Record type: AP
:Field headers:
PN: Point name |br|
N : Adjusted northing |br|
E : Adjusted easting |br|
EL: Adjusted elevation |br|
``--``: Description
:Sample(s):
::
“AP,PN%s,N %s,E %s,EL%s,--%s”
Attributes
..........
:Record type: AT
:Field headers:
TN: Attribute name |br|
TV: Attribute value in string form
:Sample(s):
::
“AT,TN%s,TV%s”
Backsight Record
................
:Record type: BK
:Field headers:
OP: Occupy point |br|
BP: Back point |br|
BS: Backsight |br|
BC: Back circle
:Sample(s):
::
“BK,OP%s,BP%s,BS%s,BC%s”
Cut Sheet Record
................
:Record type: CF (cut or fill)
For an offset stakeout cut sheet.
:Field headers:
ST: Station |br|
OD: Offset direction (ENUM) |br|
OL: Offset length |br|
EL: Elevation |br|
GD: Grade (design)
:Sample(s):
::
“CF,ST%s,OD%s,OL%s,EL%s,GD%s”
For a point stakeout cut sheet.
:Field headers:
PN: Point number |br|
EL: Elevation |br|
GD: Grade
:Sample(s):
::
“CF,PN%s,EL%s,GD%s”
Note: From Survey Pro CE 3.5, the PN field and description field are removed from CF record for point stake out.
Design point / location record
..............................
:Record type: DE
:Field headers:
PN: Point name (design point, may be blank) |br|
N : Northing |br|
E : Easting |br|
EL: Elevation |br|
``--``: Description (design point description, may be blank)
:Sample(s):
::
“DE,PN%s,N %s,E %s,EL%s,--%s”
Define a Location Record
........................
:Record type: DL
:Field headers:
PN: Point name (POB) |br|
HD: Relative horizontal distance |br|
VD: Relative vertical distance |br|
AZ: Azimuth |br|
``--`` Description of the stored point.
:Sample(s):
::
“DL,PN%s,HD%s,VD%s,AZ%s,--%s”
Deleted point record
....................
:Record type: DP
:Field headers:
PN : Point name
:Sample(s):
::
“DP,PN%s”
Feature Code
............
:Record type: FC
:Field headers:
PN: Point name |br|
FN: Feature code name (may be blank)
:Sample(s):
::
“FC,PN%s,FN%s”
Line of Sight Record
....................
:Record type: LS
:Field headers:
HI: Height of instrument |br|
HR: Height of rod
:Sample(s):
::
“LS,HI%s,HR%s”
Multiple Distance
.................
:Record type: MD
:Field headers:
SD: Slope distance
:Sample(s):
::
“MD,SD %s:%s”
Occupy Point Record
...................
:Record type: OC
:Field headers:
OP: Point number |br|
N : Northing (the header is N space) |br|
E : Easting (the header is E space)
EL: Elevation
``--`` Description
:Sample(s):
::
“OC,OP%s,N %s,E %s,EL%s,--%s”
Offset delta record
...................
:Record type: OE
:Field headers:
ST: Station |br|
OE: Offset delta (actual offset – design offset)
:Sample(s):
::
“OE,ST%s,OE%s”
Off Center Shot Record
......................
:Record type: OF
:Field headers:
AR: Angle right |br|
ZE: Zenith |br|
SD: Slope distance |br|
OL: Offset length |br|
HD: Horizontal distance |br|
VD: Vertical distance |br|
LR: Left/Right Offset
:Sample(s):
::
“OF,AR%s,ZE%s,SD%s”
“OF,ZE%s,--Vert Angle Offset”
“OF,OL%s,--Right Angle Offset”
“OF,HD%s,--Horizontal Distance Offset”
“OF,LR%s,--Left / Right Offset”
“OF,VD%s,--Elevation Offset”
Repeat Backsight
................
:Record type: RB (repeat backsight)
:Field headers:
OP: Occupied point |br|
BP: Backsight point |br|
AR: Angle right |br|
ZE: Zenith angle |br|
SD: Slope distance |br|
HR: Height of rod at the backsight |br|
``--`` Description
:Sample(s):
::
“RB,OP%s,BP%s,AR%s,ZE%s,SD%s,HR%s,--%s”
Repeat Directional
..................
:Record type: RD
:Field headers:
BD: Backsight direct |br|
FD: Foresight direct |br|
ZD: Zenith direct |br|
FV: Foresight reverse |br|
ZV: Zenith reverse |br|
BV: Backsight reverse
:Sample(s):
::
“RD,FD %s:%s”
“RD,FV %s:%s”
“RD,BD %s:%s”
“RD,BV %s:%s”
“RD,ZD %s:%s”
“RD,ZV %s:%s”
The data before the colon (:) is the integer set number and the data after the colon is the angle measurement. See MO record for angle units.
Remote Elevation Record
.......................
:Record type: RE
:Field headers:
OP: Occupied point |br|
FE: Foresight elevation |br|
ZE: Zenith angle |br|
SD: Slope distance |br|
``--`` ( always “Remote elev”)
:Sample(s):
::
“RE,OP%s,FE%s,ZE%s,SD%s,--%s”
Repeat Foresight
................
:Record type: RF (repeat foresight)
:Field headers:
OP: Occupied point |br|
FP: Foresight point |br|
AR: Angle right |br|
ZE: Zenith angle |br|
SD: Slope distance |br|
HR: Height of rod at the foresight |br|
``--`` Description
:Sample(s):
::
“RF,OP%s,FP%s,AR%s,ZE%s,SD%s,HR%s,--%s”
Resection Record
................
:Record type: RS
:Field headers:
PN: Point number |br|
CR: Circular reading |br|
ZE: Zenith (or VA, CE) |br|
SD: Slope distance (or HD)
:Sample(s):
::
“RS,PN%s,CR%s,ZE%s,SD%s” // A resection with angles and distance
“RS,PN%s,CR%s” // A resection with angles only
Deltas record
.............
:Record type: SD
:Field headers:
ND: Delta northing |br|
ED: Delta easting |br|
LD: Delta elevation |br|
:Sample(s):
::
“SD,ND%s,ED%s,LD%s”
Stake Out Record
................
:Record type: SK
:Field headers:
OP: Occupy point |br|
FP: Foresight point |br|
AR: Angle right |br|
ZE: Zenith |br|
SD: Slope distance
:Sample(s):
::
“SK,OP%s,FP%s,AR%s,ZE%s,SD%s,--%s”
Note: FP field used to record design point name. Starting from SPCE3.5, it records the actual point name. It also may be blank if there is no actual point stored.
Slope Staking Record
....................
:Record type: SL
:Field headers:
ST: Station |br|
OD: Offset direction (ENUM) |br|
EL: Actual catch point elevation |br|
GD: Grade (design elevation of the catch point based on the slope line) |br|
AS: Ahead on station (positive when rod is beyond design station, negative when
before station) |br|
HH: Horizontal distance to hinge point (always positive) |br|
VH: Vertical distance to hinge point (positive when rod is above hinge) |br|
HC: Horizontal distance to center line (always positive) |br|
VC: Vertical distance to center point (positive when rod is above center point) |br|
CF: Slope used (ENUM) |br|
DS: Design slope |br|
OB: Observed slope
:Sample(s):
::
“SL,ST%s,OD%s,EL%s,GD%s,AS%s,HH%s,VH%s,HC%s,VC%s,CF%s,DS%s,OB%s”
Store Point Record
..................
:Record type: SP
:Field headers:
PN: Point number |br|
N: Northing |br|
E: Easting |br|
EL: Elevation |br|
``--`` Description
:Sample(s):
::
“SP,PN%s,N %s,E %s,EL%s,--%s”
Slope Staking Reference Offset Record
.....................................
:Record type: SR
:Field headers:
ST: Station |br|
OD: Offset direction (ENUM) |br|
EL: Actual elevation |br|
GD: Grade (design elevation, corresponds to the elevation
of the found catch point) |br|
AS: Ahead on station (positive when rod is beyond design station, negative when
before station) |br|
HH: Horizontal distance to hinge point (always positive). This distance includes the
reference offset. |br|
VH: Vertical distance to hinge point (positive when rod is above hinge) |br|
HC: Horizontal distance to center line (always positive). This distance includes the
reference offset. |br|
VC: Vertical distance to center point (positive when rod is above center point) |br|
CF: Slope used (ENUM) |br|
DS: Design slope |br|
OB: Observed slope at the catch point |br|
OL: Offset length from the catch point
:Sample(s):
::
“SR,ST%s,OD%s,EL%s,GD%s,AS%s,HH%s,VH%s,HC%s,VC%s,CF%s,DS%s,OB%s,OL%s”
Sun Shot Record
...............
:Record type: SU
For a sun shot setup
:Field headers:
GH: Greenwich hour angle (GHA 0) |br|
GH: Greenwich hour angle (GHA 24) |br|
DE: Declination (DECL 0) |br|
DE: Declination (DECL 24) |br|
SM: Semi-diameter of Sun (in DMS) |br|
DT: Local date (See General and Conventional Field List) |br|
TM: Local time (See General and Conventional Field List)
For the actual sun shot
:Field headers:
BD: Backsight direct |br|
FD: Foresight direct |br|
FV: Foresight reverse |br|
BV: Backsight reverse |br|
LA: Latitude |br|
LO: Longitude |br|
EG0: Left trailing edge sun position |br|
EG1: Right trailing edge sun position |br|
EG2: Center sun position
:Sample(s):
::
“SU,GH%s,GH%s,DE%s,DE%s,SM%s”
“SU,DT%02s%02s%04s”
“SU,LA%s,LO%s,EG%s”
“SU,TM%s”
“SU,%s%s%s” // Will write BD,BV or FD,FV with an angle measurement. See MO
record for angle units.
Traverse / Sideshot / Observation Record
........................................
:Record type: TR / SS / OB
:Field headers:
OP: Occupy point |br|
FP: Foresight point |br|
(one of the following) |br|
- AZ: Azimuth |br|
- AR: Angle right |br|
- AL: Angle left |br|
(one of the following pair) |br|
- ZE: Zenith |br|
- SD: Slope distance |br|
(or) |br|
- CE: Change elevation |br|
- HD: Horizontal distance |br|
``--`` Description
:Sample(s):
::
“TR,OP%s,FP%s,AR%s,ZE%s,SD%s,--%s”
“SS,OP%s,FP%s,AR%s,ZE%s,SD%s,--%s”
“OB,OP%s,FP%s,AR%s,ZE%s,SD%s,--%s”
GPS Raw Data Record Definitions
_______________________________
GPS Antenna Height
..................
:Record type: AH
:Field headers:
DC: Derivation Code (ENUM) |br|
MA: Measured antenna height |br|
ME: Measure Method (ENUM) |br|
RA: Reduced antenna height (to phase center)
:Sample(s):
::
“AH,DC%s,MA%s,ME%s,RA%s”
GPS Base Line
.............
:Record type: BL
:Field headers:
DC: Derivation |br|
PN: Point Name |br|
DX: Base line Delta X |br|
DY: Base line Delta Y |br|
DZ: Base line Delta Z |br|
``--``: Description (Feature Code) |br|
GM: GPS Measure Method (ENUM) |br|
CL: Classification |br|
HP: Horizontal Precision |br|
VP: Vertical Precision
:Sample(s):
::
“BL,DC%s,PN%s,DX%s,DY%s,DZ%s,--%s,GM%s,CL%s,HP%s,VP%s”
Set Base Receiver Position
..........................
:Record type: BP
:Field headers:
PN : Point Name |br|
LA: Latitude |br|
LN: Longitude |br|
HT: Ellipsoid Height |br|
SG: Setup Group (default = 0)
:Sample(s):
::
“BP,PN%s,LA%s,LN%s,HT%s,SG%s”
COGO Settings record
....................
:Record type: CG
:Field headers:
AO: Azimuth Orientation (ENUM) |br|
GO: Grid Orientation (ENUM)
:Sample(s):
::
“CG,AO%s,GO%s”
Coordinate System Identity
..........................
:Record type: CS
:Field headers:
CO: Coordinate system option (ENUM) |br|
ZG: Zone group (system) name |br|
ZN: Zone name |br|
DN: Datum name
:Sample(s):
::
“CS,CO%s,ZG%s,ZN%s,DN%s”
Calibration Point
.................
:Record type: CT
:Field headers:
PN: Point Name |br|
DM: Dimensions used (ENUM) |br|
RH: Horizontal residual |br|
RV: Vertical residual
:Sample(s):
::
“CT,PN%s,DM%s,RH%s,RV%s”
RMS Covariance of GPS Position
..............................
:Record type: CV
:Field headers:
DC: Derivation (ENUM) |br|
SV: Minimum number of SV during observation |br|
SC: Error Scale |br|
XX: Variance X |br|
XY: Covariance X,Y |br|
XZ: Covariance X,Z |br|
YY: Variance Y |br|
YZ: Covariance Y,Z |br|
ZZ: Variance Z
:Sample(s):
::
“CV,DC%s,SV%s,SC%s,XX%s,XY%s,XZ%s,YY%s,YZ%s,ZZ%s”
Datum Grid Record
.................
:Record type: DG
:Field headers:
FI: File name
:Sample(s):
::
“DG,FI%s”
Datum Record
............
:Record type: DT
:Field headers:
DA: Type of datum (ENUM) |br|
RD: Ellipsoid radius |br|
IF: Ellipse inverse flattening |br|
OX: Rotation x |br|
OY: Rotation y |br|
OZ: Rotation z |br|
LX: Translation x |br|
LY: Translation y |br|
LZ: Translation z |br|
SP: Scale factor in ppm
:Sample(s):
::
“DT,DA%s,RD%s,IF%s,OX%s,OY%s,OZ%s,LX%s,LY%s,LZ%s,SP%s”
GPS Edit Point Record
.....................
:Record type: EE
:Field headers:
GF: Geodetic Flags (ENUM) |br|
SG: Setup Group
:Sample(s):
::
“EE,GF%s,SG%s”
Geodetic position
.................
When a point is stored, its geodetic position is recorded.
:Record type: EP
:Field headers:
TM: Time |br|
LA: Latitude |br|
LN: Longitude |br|
HT: Ellipsoid Height |br|
RH: Horizontal RMS returned from receiver |br|
RV: Vertical RMS returned from receiver |br|
DH: HDOP if receiver returns this info |br|
DV: VDOP if receiver returns this info |br|
GM: GPS Method (ENUM) |br|
CL: Classification (ENUM)
:Sample(s):
::
“EP,TM%s:%s:%s,LA%s,LN%s,HT%s,RH%s,RV%s,DH%s,DV%s,GM%s,CL%s”
“EP,TM%s:%s:%s,LA%s,LN%s,HT%s,RH%s,RV%s,GM%s,CL%s”
Equipment Record
................
:Record type: EQ
:Field headers:
DC: Derivation Code (ENUM) |br|
RX: Rx Type |br|
RS: Rx Serial Number |br|
AN: Antenna Number (from Antenna.ini) |br|
AI: Antenna Index (measure to index from antenna.ini) |br|
AT: Antenna Type (name of antenna) |br|
TS: Antenna Serial Number |br|
TA: Tape Adjustment |br|
HO: Horizontal Offset |br|
VO: Vertical Offset
:Sample(s):
::
“EQ,DC%s,RX%s,RS%s,AN%s,AI%s,AT%s,TS%s,TA%s,HO%s,VO%s”
Ellipsoid Record
................
:Record type: ES
:Field headers:
RD : a - radius of semi major |br|
IF: 1/f - inverse flattening |br|
EM: Name - ellipse name |br|
:Sample(z:
::
“ES,RD%s,IF%s,EM%s”
GPS stakeout record
...................
:Record type: GK
:Field headers:
PN: Point name (actual point, may be blank) |br|
N : Northing |br|
E : Easting |br|
EL: Elevation |br|
``--`` Description (actual point description, may be blank)
:Sample(s):
::
“GK,PN%s,N %s,E %s,EL%s,--%s”
GPS Offset Shot Record
......................
:Record type: GO
:Field headers:
PN: Point Name |br|
AZ: Azimuth |br|
ZE: Zenith Angle |br|
SD: Slope Distance |br|
HI: Height of laser at GPS reference point |br|
HR: Height of laser target at store offset point |br|
``--`` Description
:Sample(s):
::
“GO,PN%s,AZ%s,ZE%s,SD%s,HI%s,HR%s,--%s”
GPS Point Record
................
:Record type: GP
:Field headers:
PN: Point Name |br|
PT: Point Type (ENUM)
:Sample(s):
::
“GP,PN%s,PT%s”
GPS adjusted point record
.........................
:Record type: GR
:Field headers:
N : Northing |br|
E : Easting |br|
EL: Elevation |br|
``--``: Description
:Sample(s):
::
“GR,PN%s,N %s,E %s,EL%s,--%s”
GPS Store Point
...............
The GS record is similar to the SP record, which records the coordinate of a point.
This record identifies the point is created by GPS.
:Record type: GS
:Field headers:
PN: Point Name |br|
N : Local Northing |br|
E : Local Easting |br|
EL: Local Elevation |br|
``--``: Description
:Sample(s):
::
“GS,PN%s,N%s,E%s,EL%s,--%s”
Horizontal Calibration (Adjust)
...............................
:Record type: HA
:Field headers:
N : Origin north |br|
E : Origin east |br|
TH: Translation north |br|
TE: Translation east |br|
RT: Rotation about origin |br|
SF: Scale factor at origin
:Sample(s):
::
“HA,N %s,E %s,TH%s,TE%s,RT%s,SC%s”
Note: all the fields may be blank if there is no adjustment done.
Extended Projection Record
..........................
:Record type: PE
:Field headers:
TP: Type of projection (ENUM) |br|
LA: Latitude of origin |br|
LN: Longitude of origin |br|
HT: Height of origin |br|
N : Origin north |br|
E : Origin east |br|
EL: Origin elevation |br|
SC: Scale factor |br|
OO: Orientation one |br|
OT: Orientation two |br|
CT: Origin center (ENUM) |br|
AF: Azimuth format (ENUM) |br|
RY: Rectify |br|
AE: Area (ENUM) |br|
FO: File name one |br|
FT: File name two
:Sample(s):
::
“PE,TP%s,LA%s,LN%s,HT%s,N %s,E %s,EL%s,SC%s,OO%s,OT%s, CT%s,AF%s,RY%s,AE%s,FO%s,FT%s”
Projection Record
.................
:Record type: PJ
:Field headers:
TP: Type of projection (ENUM) |br|
LA: Latitude of origin |br|
LN: Longitude of origin |br|
HT: Height of origin |br|
N : Origin north |br|
E : Origin east |br|
EL: Origin elevation |br|
SC: Scale factor |br|
OO: Orientation one |br|
OT: Orientation two
:Sample(s):
::
“PJ,TP%s,LA%s,LN%s,HT%s,N %s,E %s,EL%s,SC%s,OO%s,OT%s”
Local coordinates of calibration point
......................................
:Record type: RP
:Field headers:
N : Northing |br|
E : Easting |br|
EL: Elevation |br|
``--``: Description
:Sample(s):
::
“RP,PN%s,N %s,E %s,EL%s,--%s”
Receiver Setup
..............
:Record type: RX
:Field headers:
DC: Derivation Code (ENUM) |br|
RA: Reduced antenna height (to phase centre) |br|
RE: Recording interval in seconds |br|
FI: Name of post processing file opened
:Sample(s):
::
“RX,DC%s,RA%s,RE%s,FI%s”
Local site settings
...................
:Record type: ST
:Field headers:
LA: Latitude |br|
LN: Longitude |br|
HT: Height |br|
SC: Scale factor |br|
N : Northing offset |br|
E : Easting offset
:Sample(s):
::
“ST,LA%s,LN%s,HT%s,SC%s,N %s,E %s”
Vertical Calibration (Adjust)
.............................
:Record type: VA
:Field headers:
PV: Type of vertical adjustment (ENUM) |br|
N : Origin north (may be blank) |br|
E : Origin east (may be blank) |br|
LZ: Constant adjustment – translation Z (may be blank) |br|
SO: Slope north (may be blank) |br|
SA: Slope east (may be blank) |br|
GN: Geoid Model Name
:Sample(s):
::
“VA,PV%s,N %s,E %s,LZ%s,SO%s,SA%s,GN%s”
Legacy Raw Data Record Definitions
___________________________________
These records are not used in Survey Pro version 3.5 and beyond.
Accumulating Angle-right
........................
:Record type: AA
:Field headers:
BC: Back circle |br|
AR: Angle right |br|
ZE: Zenith |br|
SD: Slope distance
:Sample(s):
::
“AA,BC%s,AR%s,ZE%s,SD%s”
Bench level, backsight
......................
:Record type: BB
:Field headers:
PN: Backsight point |br|
EL: BS elevation |br|
ZE: Zenith |br|
SD: Slope distance |br|
``--``: Description
:Sample(s):
::
“BB,PN%s,EL%s,ZE%s,SD%s,--%s”
Base Point Geoid Model Elevation
................................
Replaced by Vertical adjustment record VA.
:Record type: BG
:Field headers:
PN: Point Name |br|
HT: Ellipsoid Height |br|
GU: Geoid Undulation at base |br|
EL: Elevation of base
:Sample(s):
::
“BG,PN%s,HT%s,GU%s,EL%s”
Bench level, side shots
.......................
:Record type: BS
:Field headers:
PN: FS point |br|
ZE: Zenith |br|
SD: Slope distance |br|
``--``: Description
:Sample(s):
::
“BS,PN%s,ZE%s,SD%s,--%s”
Bench level, traverse
.....................
:Record type: BT
:Field headers:
PN: FS point |br|
ZE: Zenith |br|
SD: Slope distance |br|
``--``: Description
:Sample(s):
::
“BT,PN%s,ZE%s,SD%s,--%s”
Horizontal Control Point
........................
When solving local transformation, each control point’s lat, long and height will be
recorded.
:Record type: HC
:Field headers:
PN: Point Name |br|
LA: Latitude |br|
LN: Longitude |br|
HT: Ellipsoid Height |br|
``--``: Description
:Sample(s):
::
“HC,PN%s,LA%s,LN%s,HT%s,--%s”
Vertical Ellipsoid Height Setup
...............................
Replaced by the vertical adjust record VA.
:Record type: LE
:Field headers:
``--``: Description string
:Sample(s):
::
“LE,--%s”
Vertical Geoid Model Setup
..........................
Replaced by the vertical adjust record VA.
:Record type: LG
:Field headers:
GI: Geoid model index
:Sample(s):
::
“LG,GI%s”
Horizontal Mapping Plane Setup
..............................
Replaced by the projection records (ES,PJ,DT,CS).
:Record type: LM
:Field headers:
ME: Method |br|
CS: Coordinate System |br|
DA: Datum |br|
ZO: Zone |br|
HE: Hemisphere |br|
FI: Custom file name (cs5 or pj5)
:Sample(s):
::
“LM,ME%s,CS%s,DA%s,ZO%s,HE%s,FI%s”
Local transforming coefficients for horizontal
..............................................
Replaced by Horizontal adjustment record HA.
:Record type: LH
:Field headers:
PN: Point Name |br|
Ha: Coefficient a |br|
Hb: Coefficient b |br|
Hc: Coefficient c |br|
Hd : Coefficient d |br|
SC: Scale |br|
RT: Rotation
:Sample(s):
::
“LH,PN%s,Ha%s,Hb%s,Hc%s,Hd%s,SC%s,RT%s”
Local transforming coefficients for vertical
............................................
Replaced by Vertical adjustment record VA.
:Record type: LV
:Field headers:
PN: Point Name |br|
Va: Coefficient a |br|
Vb: Coefficient b |br|
Vc: Coefficient c |br|
Ba: Base Latitude |br|
Bo: Base Longitude |br|
Bh: Base Ellipsoid Height
:Sample(s):
::
“LV,PN%s,Va%s,Vb%s,Vc%s,Ba%s,Bo%s,Bh%s”
Vertical Control point
......................
When solving local transformation, each control point’s lat, long and height will be
recorded.
:Record type: VC
:Field headers:
PN: Control point number |br|
LA: Latitude of control point |br|
LN: Longitude of control point |br|
HT: Ellipsoid height of control point |br|
``--``: Description
:Sample(s):
::
“VC,PN%s,LA%s,LN%s,HT%s,--%s”
totalopenstation-0.5.1/docs/input_formats/main.rst 0000644 0001750 0001750 00000003560 13607717037 020605 0 ustar mfv mfv .. _input_formats:
=============
Input formats
=============
Total Open Station supports a number of input data formats, which
are implemented separately from the device handling machinery
(i.e. downloading data from your total station, see :ref:`models`).
This is because one device can output more than one format, and at
the same time the same format can be used by more than one device
(particularly this is the case for different models by the same manufacturer).
Generally speaking, data formats can be classified into two large
groups:
1. “raw” field data with polar coordinates
2. processed data, with XY(Z) cartesian coordinates
The latter are far more easy to process, because they don't require
any computing of measurements.
XYZ formats
===========
These formats were the first kind of survey data format supported by
Total Open Station.
Cartesian coordinates just need to be extracted from ASCII data.
.. _implemented_if:
Implemented formats
===================
Formats known are :
.. toctree::
:maxdepth: 1
:glob:
if_*
Other formats
=============
The following is an other known format but not implemented.
.. toctree::
:maxdepth: 1
:glob:
tds
Unknown formats
===============
Unimplemented :term:`formats ` can be added to
Total Open Station.
The best way to have your format included in the next version of
Total Open Station is to fill a support request in the `bug tracker`_ and attach
some sample data dumps obtained following :ref:`getting_sample_data`.
If you can write Python code, you can also write a module by yourself using
an existing one as a guide and the :ref:`new` directive.
If you write a module, we will be happy to receive it and include it in the
Total Open Station source tree.
.. seealso::
The :ref:`contributing` page to find out how to join the project and
participate actively to the development.
totalopenstation-0.5.1/docs/input_formats/if_zeiss_r5.rst 0000644 0001750 0001750 00000002343 13607717037 022100 0 ustar mfv mfv ==================================
:mod:`zeiss_r5` -- Zeiss R5 format
==================================
.. moduleauthor:: Stefano Costa
.. versionadded:: 0.4
The R5 format is an evolution of the older R4 format and is similar to the
:py:mod:`zeiss_rec_500` REC 500 format. It can be used for both processed
Cartesian data (Northing, Easting, Elevation) or for raw polar measurements,
but currently we don't have any sample data for the raw variant.
In each line of the data file, fields are separated by the ``|`` character::
For R5|Adr 0008|KR NTR1100|X 21.259 m |Y 59.620 m |Z 11.256 m |
The first field is always ``For R5`` and it indicates the format. Then the
``Adr`` field is a sequential id of the line, but not necessarily a surveyed
point.
The third field is the most important, as it specifies different types of
records with the first two characters, like ``TR`` or ``KR``. Then a space
character separates the next 7 characters, that are actually two separate
pieces of information: the “text code” in the first 3 characters (that can be
used to identify various points from the same feature or structure) and the
point number in the next four characters.
The next fields are the X, Y and Z values.
totalopenstation-0.5.1/docs/input_formats/if_zeiss_rec_500.rst 0000644 0001750 0001750 00000004706 13607717037 022714 0 ustar mfv mfv .. _if_zeiss_rec_500:
=====================================
:mod:`zeiss_rec_500` -- Zeiss REC 500
=====================================
.. moduleauthor:: Stefano Costa
This was the first format supported by Total Open Station. For
historical reasons, its documentation is far more extended than those
of other formats. The step by step procedure is useful for anyone who
wants to hack on TOPS itself.
Step-by-step download procedure
-------------------------------
At the time I was doing the first tests, I found it useful to collect
all steps. The program goes through them automatically::
>>> import serial
>>> ser = serial.Serial('/dev/ttyUSB0', \
baudrate=9600, bytesize=serial.SEVENBITS, timeout=0, \
parity=serial.PARITY_NONE, rtscts=1)
>>> ser.open()
At this point, you have to start the download from the device
menu. When this operation has finished, it's good practice to control
if you have actually received any data::
>>> ser.inWaiting()
648L
A non-zero result means that something has been downloaded. Good enough.
This number can be saved to a variable and passed as parameter to the
``read()`` command::
>>> n = ser.inWaiting()
>>> result = ser.read(n)
The ``result`` object is a string that contains our data::
>>> print(result)
0001 OR.COOR
0002 0S X 0.000 Y 0.000 Z 0.000
0003 Om 397.0370
0004 POLAR
0005 INPUT th 1.500 ih 0.000
0006 INPUT th 0.000 ih 0.000 Z 0.000
0007 1 X -0.472 Y 1.576 Z 0.004
END
So far, we can say that the downloaded file contains this information:
* ``OR.COOR``: but I don't know if this line can take other values too
* **origin point** defined by the ``OS`` string followed by its ``X``, ``Y``,
``Z`` coordinates
* **orientation angle** ``Om``: are these gradiants?
* ``POLAR``: but I don't know if this line can take other values too
* ``INPUT``: are there always two ``INPUT`` lines?
* ``th``
* ``ih``
* ``Z``
* points, expressed as ``N`` (starting from 1), ``X``, ``Y``, ``Z``
* ``END``: after this line no more data
totalopenstation-0.5.1/docs/input_formats/if_nikon_raw_v200.rst 0000644 0001750 0001750 00000010511 13607717037 023067 0 ustar mfv mfv .. _if_nikon_raw:
===============================================
:mod:`nikon_raw_v200` -- Nikon RAW format V2.00
===============================================
.. moduleauthor:: Stefano Costa
.. versionadded:: 0.3.3
This format contains polar data. It is the first polar format
supported by Total Open Station.
Nikon RAW Record Information
============================
Data are basically comma-separated values, but each row can have a
different format and number of fields. Recorded points are in rows
that start with the ``SS`` string, while fixed base points start with
the ``ST`` string.
Definitions
===========
Coordinate records
------------------
+------+---+----+---+---------+---+----------+---+---------+---+-----------+---+------+
| type | , | pt | , | (pt id) | , | northing | , | easting | , | elevation | , | code |
+------+---+----+---+---------+---+----------+---+---------+---+-----------+---+------+
:type: One of the following codes |br|
UP Uploaded point |br|
MP Manually input point |br|
CC Calculated coordinate |br|
RE Resection point
:pt: Point number
:(pt id): (Point ID)
:northing: Northing of the coordinate
:easting: Easting of the coordinate
:elevation: Elevation of the coordinate
:code: Feature code
Station records
---------------
+----+---+-------+---+---------+---+------+---+---------+---+----+---+--------+---+------+
| ST | , | stnpt | , | (stnid) | , | bspt | , | (bs id) | , | hi | , | bsazim | , | bsha |
+----+---+-------+---+---------+---+------+---+---------+---+----+---+--------+---+------+
:ST: Station record identifier (fixed text)
:stnpt: Station point number
:(stn id): (Station ID)
:bspt: Backsight point number
:(bs id): (Backsight ID)
:hi: Height of instrument
:bsazim: Backsight azimuth
:bsha: Backsight horizontal angle
Control point records
---------------------
+----+---+----+---+---------+---+----+---+----+---+----+---+----+---+------+---+------+
| CP | , | pt | , | (pt id) | , | ht | , | sd | , | ha | , | va | , | time | , | code |
+----+---+----+---+---------+---+----+---+----+---+----+---+----+---+------+---+------+
:CP: Control point record identifier (fixed text)
:pt: Point number
:(pt id): (Point ID)
:ht: Height of target
:sd: Slope distance
:ha: Horizontal angle
:va: Vertical angle
:time: 24-hour time stamp
:code: Feature code
Sideshot records
----------------
+----+---+----+---+----+---+----+---+----+---+----+---+------+---+------+
| SS | , | pt | , | ht | , | sd | , | ha | , | va | , | time | , | code |
+----+---+----+---+----+---+----+---+----+---+----+---+------+---+------+
:SS: Sideshot record identifier (fixed text)
:pt: Point number
:ht: Height of target
:sd: Slope distance
:ha: Horizontal angle
:va: Vertical angle
:time: 24-hour time stamp
:code: Feature code
Stakeout records
----------------
+----+---+----+---+--------+---+----+---+----+---+----+---+----+---+------+---+
| SO | , | pt | , | (sopt) | , | ht | , | sd | , | ha | , | va | , | time | , |
+----+---+----+---+--------+---+----+---+----+---+----+---+----+---+------+---+
:SO: Stakeout record identifier (fixed text)
:pt: Recorded point number
:(sopt): (Original number of point staked)
:ht: Height of target
:sd: Slope distance
:ha: Horizontal angle
:va: Vertical angle
:time: 24-hour time stamp
F1 records
----------
+------+---+----+---+----+---+----+---+----+---+----+---+------+
| face | , | pt | , | ht | , | sd | , | ha | , | va | , | time |
+------+---+----+---+----+---+----+---+----+---+----+---+------+
:face: One of the following |br|
F1 Shot taken using Face-1 (fixed text) |br|
Shot taken using Face-1 for Station setup (fixed text) |br|
:pt: Point number
:ht: Height of target
:sd: Slope distance
:ha: Horizontal angle
:va: Vertical angle
:time: 24-hour time stamp
Comment/note records
--------------------
+----+---+------+
| CO | , | text |
+----+---+------+
:CO: Comment record identifier (fixed text)
:text: Comment text
Acknowledgements
================
Support for this format was added thanks to Cynthia Mascione,
Università di Siena.
.. seealso::
`Information on Total Station Nivo Series - Nivo3.M and Nivo5.M manual `_ |br|
`Information on Total Station DTM-322 manual `_ |br|
Documentation for Nikon RAW v2.00 from unofficial sources
totalopenstation-0.5.1/docs/input_formats/if_leica_gsi.rst 0000644 0001750 0001750 00000102400 13607717037 022247 0 ustar mfv mfv .. _if_leica_gsi:
=======================
:mod:`leica_gsi` -- GSI
=======================
.. moduleauthor:: Stefano Costa, Damien Gaignon
.. versionadded:: 0.4
GEO Serial Interface (GSI) is a very popular data format, used by many Leica
total stations (TPS) or Digital Levels (DNA). It is stored as ASCII text, with
one line per measurement.
In each line, there can be several *blocks* of data, with a blank space as a
separation.
There are two variants of GSI:
- GSI8
- GSI16
but they only differ in the size of a single *block*.
GSI is a very rich format, and it can hold both cartesian and polar coordinates
with a detailed recording of all commands executed by the device and with
explicit indication of the measurement units.
GSI variants
============
GSI8
----
GSI8 has data information recorded in 8 bit words.
::
110001+0000A110 81..00+00005387 82..00-00000992
110002+0000A111 81..00+00007586 82..00-00003031
GSI6
----
GSI16 has data information recorded in 16 bit words.
::
110001+000000000PNC0055 21.002+0000000013384650 22.002+0000000005371500
110002+000000000PNC0056 21.002+0000000012802530 22.002+0000000005255000
110003+000000000PNC0057 21.002+0000000011222360 22.002+0000000005433800
110004+000000000PNC0058 21.002+0000000010573550 22.002+0000000005817600
110005+000000000PNC0059 21.002+0000000009983610 22.002+0000000005171400
GSI Block Information
=====================
Datablock structure
-------------------
Each line is a datablock composed in a sequence of data words, ending with
a terminator (CR or CR/LF).
There is two types of datablocks specified by the first data word :
* Block of measurement (beginning usually with 11)
* Block of code (beginning usually with 41)
TPS
---
Data word structure
___________________
Every word starts with two characters specifying the data type within the word.
* Pos.1-3: Word Index (WI)
* Pos.4-6: Information related to data
* Pos.7: Sign
* Pos.8-15/8-23: GSI8/16 data
* Pos.16/24: Blank (=separating character)
+----------+----------------------------------------------+----------------------+
| Position | Explanation | Applicable for |
+==========+==============================================+======================+
| 1-3 | Word Index | All words |
+----------+----------------------------------------------+----------------------+
| 4 | AUTOMATIC INDEX INFORMATION |br| | All words containing |
| | 0: Automatic index OFF |br| | angle information |
| | 1: Automatic index OPERATING |br| | |
| | 3: Automatic index OPERATING | |
+----------+----------------------------------------------+----------------------+
| 5 | INPUT MODE |br| | Measured data |
| | 0: Original measured values transferred | |
| | from the instrument |br| | |
| | 1: Manual input from keyboard |br| | |
| | 2: Measured value, Hz-Correction ON |br| | |
| | 3: Measured value, Hz-Correction OFF |br| | |
| | 4: Result of special function | |
+----------+----------------------------------------------+----------------------+
| 6 | UNITS |br| | Measured data |
| | 0: Meter (last digit: 1mm) |br| | |
| | 1: Feet (last digit: 1/1000ft) |br| | |
| | 2: 400 gon |br| | |
| | 3: 360° decimal |br| | |
| | 4: 360° sexagesimal |br| | |
| | 5: 6400 mil |br| | |
| | 6: Meter (last digit: 1/10mm) |br| | |
| | 7: Feet (last digit: 1/10‘000ft) |br| | |
| | 8: Meter (last digit: 1/100mm) | |
+----------+----------------------------------------------+----------------------+
| 7 | SIGN |br| | Measured data |
| | +: Positive value |br| | |
| | -: Negative value |br| | |
+----------+----------------------------------------------+----------------------+
| 8-15 | DATA |br| | Measured data |
| (8-23) | Data includes a sequence of 8(16) | |
| | numerical or alphanumerical characters. |br| | |
| | Note that certain data words are allowed | |
| | to carry more than 1 value (e.g. PPM/MM). | |
| | Those data are automatically transferred | |
| | with a sign before each single value. | |
+----------+----------------------------------------------+----------------------+
| 16 | SEPARATING CHARACTER |br| | All words |
| (24) | _: Blank | |
+----------+----------------------------------------------+----------------------+
Word Index
__________
+-----+-----------------------------------+----------------------------------+---+---+---+
| WI | FUNCTION | Access/Example | 1 | 2 | 3 |
+=====+===================================+==================================+===+===+===+
| 11* | Pointnumber | 11… .+00000H66 |br| | x | x | x |
| | | PtNo=“H66“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 12 | Serial number | 12....+00640054 |br| | | x | x |
| | | S.No. “640054” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 13 | Instrument type | 13....+00TCR305 |br| | | x | x |
| | | Instr. “TCR305” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 16 | Station Pointnumbe | 16....+00000100” |br| | | x | |
| | | St.No. “100” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 17 | Date |br| | 17....+08022000 |br| | | x | |
| | [DD.MM.YYYY] | “Feb. 8th 2000” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 18 | Year Second |br| | 18....+01130000 | | x | |
| | [YY.SS.mSmSmS] | | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 19 | Time |br| | 19....+02081029 |br| | | x | x |
| | [MM.DD.hh.mm] | “Feb. 8th ; 10:29” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 21* | Horizontal Angle |br| | 21.102+17920860 |br| | x | x | x |
| | Hz | Hz „179.086“ gon | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 22* | Vertical Angle |br| | 22.102+07567500 |br| | x | x | x |
| | V | V: „75.675“ gon | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 25* | Horizontal circle difference |br| | | ? | ? | ? |
| | Hz0 - Hz | | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 31* | Slope distance | 31..00+00003387 |br| | x | x | x |
| | | Sdist: „3.387“ m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 32* | Horizontal distance | 32..00+00003198 |br| | x | x | x |
| | | Hdist: „3.198“ m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 33* | Height difference | 33..00+00001119 |br| | x | x | x |
| | | Hdiff: „1.119“ m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 41* | Code-Block ID | 41....+00000013 |br| | | x | x |
| | | Code: „13“ m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 42* | Information 1 | 42....+000TREES |br| | | x | x |
| | | Info1: „TREES“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 43* | Information 2 | 43....+000004.5 |br| | | x | x |
| | | Info2: „4.5“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 44* | Information 3 | 44....+00CAT.02 |br| | | x | x |
| | | Info3: „CAT.02“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 45* | Information 4 | 45....+000000NN |br| | | x | x |
| | | Info4: „NN“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 46* | Information 5 | 46....+000000NN |br| | | x | x |
| | | Info5: „NN“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 47* | Information 6 | 47....+000000NN |br| | | x | x |
| | | Info6: „NN“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 48* | Information 7 | 48....+000000NN |br| | | x | x |
| | | Info7: „NN“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 49* | Information 8 | 49....+000000NN |br| | | x | x |
| | | Info8: „NN“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 51* | PPM and Prism constant | 51… .+0220+002 |br| | x | | x |
| | | PPM „220“ and Prism const „2“ mm | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 52 | Measurement number | | ? | ? | ? |
| | Standard deviation | | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 53 | Signal power | | ? | ? | ? |
| | | | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 58* | Prism constant | 58..16+00000020 |br| | x | x | x |
| | | Prism „2“ mm | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 59* | PPM | 59..16+02200000 |br| | x | x | x |
| | | PPM „220“ | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 71* | Remark1 |br| | 71....+0000REM1 |br| | | | x |
| | (or Attribute 1) | “REM1” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 72* | Remark2 |br| | 72....+0000REM2 |br| | | | x |
| | (or Attribute 2) | “REM2” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 73* | Remark3 |br| | 73....+0000REM3 |br| | | | x |
| | (or Attribute 3) | “REM13” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 74* | Remark4 |br| | 74....+0000REM4 |br| | | | x |
| | (or Attribute 4) | “REM4” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 75* | Remark5 |br| | 75....+0000REM5 |br| | | | x |
| | (or Attribute 5) | “REM5” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 76* | Remark6 |br| | 76....+0000REM6 |br| | | | x |
| | (or Attribute 6) | “REM6” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 77* | Remark7 |br| | 77....+0000REM7 | | | x |
| | (or Attribute 7) | “REM7” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 78* | Remark8 |br| | 78....+0000REM8 |br| | | | x |
| | (or Attribute 8) | “REM8” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 79* | Remark9 |br| | 79....+0000REM9 |br| | | | x |
| | (or Attribute 9) | “REM9” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 81* | Target Easting (E) | 81..00+01999507 |br| | x | x | x |
| | | E: “1999.507”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 82* | Target Northing (N) | 82..00-00213159 |br| | x | x | x |
| | | N: “-2139.159”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 83* | Target Elevation (H) | 83..00+00032881 |br| | x | x | x |
| | | H: “32.881”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 84* | Station Easting (E0) | 84..11+00393700 |br| | x | x | x |
| | | E: “393.700”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 85* | Station Northing (N0) | 85..11+06561220 |br| | x | x | x |
| | | N: “6561.220”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 86* | Station Height (H0) | 86..11+00065618 |br| | x | x | x |
| | | H: “65.618”m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 87* | Reflector height (hr) | 87..11+00001700 |br| | x | x | x |
| | | hr: “1.700” m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 88* | Instrument height (hi) | 88..11+00001550 |br| | x | x | x |
| | | hi: “1.550” m | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 531 | Atmos. correction: |br| | 531.16+10130000 |br| | | x | |
| | pressure | “1013” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 538 | Coefficient of refraction | 538.16+00001300 |br| | | x | |
| | | 1.300” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 560 | Time: |br| | 560..6+00105018 |br| | | x | |
| | [hh.mm.ss] | “10:50:18” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 561 | Date: |br| | 561..6+00020800 |br| | | x | |
| | [mm.dd] | “2.8.2000” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 562 | Year: |br| | 562...+00002000 |br| | | x | |
| | [yyyy] | year “2000” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 590 | SW-Version: |br| | 590..6+00021000 |br| | | x | |
| | Application | “V2.10” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 591 | SW-Version: |br| | 591..6+00020000 |br| | | x | |
| | Operating system | “V2.00” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 592 | SW-Version: |br| | 592..6+00010000 |br| | | x | |
| | OS interface | “V1.00” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 593 | SW-Version: |br| | 593..6+00022000 |br| | | x | |
| | GEOCOM | “V2.20” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 594 | SW-Version: |br| | 594..6+00010000 |br| | | x | |
| | Gsi communication | “V1.00” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 595 | SW-Version: |br| | 595..6+00011100 |br| | | x | |
| | Edm Device | “V1.11” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 913 | Job | 913...+BLDG.A12 |br| | | x | |
| | | “BLDG.A12” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
| 914 | Operator | 914...+0MM-3519 |br| | | x | |
| | | “MM-3519” | | | |
+-----+-----------------------------------+----------------------------------+---+---+---+
\* implemented WI
1. TPS100 Series:
TC403L, TC600, TC800, |br|
TC605/L, TC805/L TC905/L
2. TPS300/700 Series:
TC302, TC303, TC305, TC307, |br|
TCR302, TCR303, TCR305, TCR307, |br|
TC702, TC703, TC705, |br|
TCR702, TCR703, TCR705, |br|
TC(R)702 auto, TC(R)703 auto, TC(R)705 auto
3. TPS1000/1100 Series:
TC1100/L, TC1500/L, TC1700/L, TC1800/L, |br|
TCM1100/L, TCM1800/L, |br|
TCA1100/L, TCA1800/L· TC1101, TC1102, TC1103, TC1105, |br|
TCR1101, TCR1102, TCR1103, TCR1105, |br|
TCM1101, TCM1102, TCM1103, TCM1105, |br|
TCRM1101, TCRM1102, TCRM1103, TCRM1105, |br|
TCA1101, TCA1102, TCA1103, TCA1105, |br|
TCRA1101, TCRA1102, TCRA1103, TCRA1105
DNA
---
Only for DNA03/DNA10
Data word structure
___________________
Every word starts with two characters specifying the data type within the word.
* Pos.1-3: Word Index (WI)
* Pos.4-6: Information related to data
* Pos.7: Sign
* Pos.8-15/8-23: GSI8/16 data
* Pos.16/24: Blank (=separating character)
+----------+--------------------------------------------------------------------+----------------------+
| Position | Explanation | Applicable for |
+==========+====================================================================+======================+
| 1-3 | Word Index | All words |
+----------+--------------------------------------------------------------------+----------------------+
| 4 | Empty, marked as dot (.) | All words containing |
+----------+--------------------------------------------------------------------+----------------------+
| 5 | Information about the measurement and | Measured data |
| | earth-curvature correction. |br| | |
| | 0 = measured; **without** earth-curvature correction. |br| | |
| | 1 = entered manually; **without** earth-curvature correction. |br| | |
| | 2 = measured; **with** earth-curvature correction. |br| | |
| | 5 = entered manually; **with** earth-curvature correction. | |
+----------+--------------------------------------------------------------------+----------------------+
| 6 | UNITS |br| | Measured data |
| | 0: Meter (last digit: 1mm) |br| | |
| | 1: Feet (last digit: 1/1000ft) |br| | |
| | 6: Meter (last digit: 1/10mm) |br| | |
| | 7: Feet (last digit: 1/10‘000ft) |br| | |
| | 8: Meter (last digit: 1/100mm) | |
+----------+--------------------------------------------------------------------+----------------------+
| 7-15 | DATA |br| | Measured data |
| (7-23) | Data includes a sequence of 8(16) numerical or | |
| | alphanumerical characters. | |
+----------+--------------------------------------------------------------------+----------------------+
| 16 | SEPARATING CHARACTER |br| | All words |
| (24) | _: Blank | |
+----------+--------------------------------------------------------------------+----------------------+
Word Index
__________
+-----+---------------------------------------------------------+
| WI | FUNCTION |
+=====+=========================================================+
| 11 | PointID |
+-----+---------------------------------------------------------+
| 12 | Serial number |
+-----+---------------------------------------------------------+
| 13 | Instrument type |
+-----+---------------------------------------------------------+
| 17 | Date Year |
+-----+---------------------------------------------------------+
| 19 | Day time |
+-----+---------------------------------------------------------+
| 32 | Horizontal distance |
+-----+---------------------------------------------------------+
| 35 | Setting-out difference |
+-----+---------------------------------------------------------+
| 41 | Code-Block ID |
+-----+---------------------------------------------------------+
| 42 | Information 1 |
+-----+---------------------------------------------------------+
| 43 | Information 2 |
+-----+---------------------------------------------------------+
| 44 | Information 3 |
+-----+---------------------------------------------------------+
| 45 | Information 4 |
+-----+---------------------------------------------------------+
| 46 | Information 5 |
+-----+---------------------------------------------------------+
| 47 | Information 6 |
+-----+---------------------------------------------------------+
| 48 | Information 7 |
+-----+---------------------------------------------------------+
| 49 | Information 8 |
+-----+---------------------------------------------------------+
| 71 | Remark |
+-----+---------------------------------------------------------+
| 83 | Ground height (starting point height or measured height |
+-----+---------------------------------------------------------+
| 95 | Instrument temperature [°C] |
+-----+---------------------------------------------------------+
| 330 | Staff reading in "Meas Only" |
+-----+---------------------------------------------------------+
| 331 | Staff reading, backsight or B1 |
+-----+---------------------------------------------------------+
| 332 | Staff reading, foresight or F1 |
+-----+---------------------------------------------------------+
| 333 | Staff reading, intermediate sight |
+-----+---------------------------------------------------------+
| 334 | Staff reading, setting-out sight |
+-----+---------------------------------------------------------+
| 335 | Staff reading, B2 |
+-----+---------------------------------------------------------+
| 336 | Staff reading, F2 |
+-----+---------------------------------------------------------+
| 374 | Setting-out difference of height measurements |
+-----+---------------------------------------------------------+
| 390 | Count of repeated measurements |
+-----+---------------------------------------------------------+
| 391 | Mean mode: Standard deviation of the single measurement |
+-----+---------------------------------------------------------+
| 392 | Mean mode: Spread of measurements |
+-----+---------------------------------------------------------+
| 560 | Time: [hh.mm.ss] |
+-----+---------------------------------------------------------+
| 561 | Date: [mm.dd] |
+-----+---------------------------------------------------------+
| 562 | Year: [yyyy] |
+-----+---------------------------------------------------------+
| 571 | Station difference |
+-----+---------------------------------------------------------+
| 572 | Cumulative station difference |
+-----+---------------------------------------------------------+
| 573 | Distance balance |
+-----+---------------------------------------------------------+
| 574 | Total distance (=line length) |
+-----+---------------------------------------------------------+
| 599 | SoftWare Version |
+-----+---------------------------------------------------------+
Units
=====
The unit in position 6 of the word is used as following :
+----------------------------------+-------------------+-----------+
| Unit | Number of decimal | Exemple |
+==================================+===================+===========+
| 0: Meter (last digit: 1mm) | 3 | 12345.678 |
+----------------------------------+-------------------+-----------+
| 1: Feet (last digit: 1/1000ft) | 3 | 12345.678 |
+----------------------------------+-------------------+-----------+
| 2: 400 gon | 5 | 123.45678 |
+----------------------------------+-------------------+-----------+
| 3: 360° decimal | 5 | 123.45678 |
+----------------------------------+-------------------+-----------+
| 4: 360° sexagesimal | 5 | 123.45678 |
+----------------------------------+-------------------+-----------+
| 5: 6400 mil | 4 | 1234.5678 |
+----------------------------------+-------------------+-----------+
| 6: Meter (last digit: 1/10mm) | 4 | 1234.5678 |
+----------------------------------+-------------------+-----------+
| 7: Feet (last digit: 1/10‘000ft) | 4 | 1234.5678 |
+----------------------------------+-------------------+-----------+
| 8: Meter (last digit: 1/100mm) | 5 | 123.45678 |
+----------------------------------+-------------------+-----------+
Default patterns
================
Most of the time, a GSI file is composed of three type of lines:
* a station point with WI 11 [, 25], 84, 85, 86 [, 87], 88
* a direct point with WI 11, 81, 82, 83
* a measurement with WI 11, 21, 22, 31 or 32 [, 51], 87 [, 88] [, 81, 82, 83]
* a comment with WI 41, [42, 43, 44, 45, 46, 47, 48, 49]
WI in [] are optional.
Known limitations
=================
Support for raw measurements is still incomplete, here is a list of **TODO**:
* get coordinates order (NEZ or ENZ)
* add missing code for TPS (not with an asterisk on the WI list)
* add DNA support
* add an option to link comment(s) to either the previous or the next line
* add an option to link attribut(s) with his point
* add the possibility to customize code
* add specific raise functions
Acknowledgements
================
Support for this format was added thanks to Anna Hodgkinson and Hannah Petten
at the University of Liverpool. Some details of the implementation are based
on the SurveyTools QGIS plugin developed by Stefan Ziegler.
.. seealso::
`GSI Online for Leica TPS `_
Documentation for GSI from Leica.
totalopenstation-0.5.1/docs/input_formats/if_sokkia_sdr33.rst 0000644 0001750 0001750 00000001541 13607717037 022633 0 ustar mfv mfv ====================================
:mod:`sokkia_sdr33` -- Sokkia SDR 33
====================================
.. moduleauthor:: Stefano Costa
.. versionadded:: 0.4
Sokkia SDR33 is a format used by older models such as Sokkia SET 5F.
The format supports is based on fixed-position fields, with one record per
line. SDR33 supports both polar (“raw”) measurements and cartesian
coordinates (Northing, Easting, Elevation).
The first four characters of a line are useful to separate the various
type of measurements:
- prism height is marked by code ``03NM``
- polar measurements are marked by the ``09F1`` code
- cartesian measurements are marked by ``08TP``
- base stations are marked by ``02TP``, because their coordinates are
entered by hand as cartesian coordinates
It is uncommon for polar and cartesian measurements to be found in the
same dataset.
totalopenstation-0.5.1/docs/users.rst 0000644 0001750 0001750 00000002141 12473435271 016117 0 ustar mfv mfv .. _users:
=============================
Users of Total Open Station
=============================
So far, Total Open Station has been successfully used by:
* Università di Siena, Italy `Dipartimento di Archeologia e Storia delle
Arti`_, for the excavations at Gortyna and Vignale
* `Oxford Archaeology`_, UK, for fieldwork, using the OpenMoko_ mobile
platform
* `Arke_Geomática`_, Spain has blogged about TOPS
* Arc-Team_, Italy, we have added support for the Trimble “area” format
after Arc-Team sent us some sample data
* Università di Padova, Italy (excavation in Montegrotto)
* `Gurob Harem Palace Project`_, Egypt
.. _`Dipartimento di Archeologia e Storia delle Arti`: http://www.archeoarti.unisi.it
.. _`Oxford Archaeology`: http://thehumanjourney.net/
.. _OpenMoko: http://blogs.thehumanjourney.net/finds/entry/2
.. _Arke_Geomática: http://arkeox.blogspot.com/2008/10/sistemas-electrnicosdigitales-de.html
.. _Arc-Team: http://www.arc-team.com/
.. _`Gurob Harem Palace Project`: http://www.gurob.org.uk/
If you're in the number of happy users, let us know.
totalopenstation-0.5.1/docs/faq.rst 0000644 0001750 0001750 00000001436 12473435271 015533 0 ustar mfv mfv .. _faq:
================================================
Frequently Asked Questions (and some answers!)
================================================
I cannot connect to the COM port on Windows
===========================================
If you get errors like::
SerialException: could not open port COM4: [Error 5] Access denied
try disabling and enabling again the COM port from the control
panel. Often these errors show a flip-flop behavior: opening a serial
port works fine the first time, but not the second. This is because
serial ports need to be explicitly closed by programs, otherwise they
will remain blocked.
Also, tools like Portmon_ help with troubleshooting problems
with serial ports on Windows.
.. _Portmon: http://technet.microsoft.com/en-us/sysinternals/bb896644
totalopenstation-0.5.1/docs/global.rst 0000644 0001750 0001750 00000000451 13607717037 016223 0 ustar mfv mfv .. |br| raw:: html
.. _`Github`: https://github.com/steko/totalopenstation/
.. _`bug tracker`: https://github.com/steko/totalopenstation/issues
.. _`pull request`: https://github.com/steko/totalopenstation/pulls
.. _`support channel`: https://github.com/steko/totalopenstation/issues
totalopenstation-0.5.1/docs/output_formats/ 0000755 0001750 0001750 00000000000 13607717332 017322 5 ustar mfv mfv totalopenstation-0.5.1/docs/output_formats/of_implemented.rst 0000644 0001750 0001750 00000007303 13607717037 023050 0 ustar mfv mfv ..rubric:: Foreword
In this page, formats are described using labels which are:
+----------+------------------------------+
| Label | Explanation |
+==========+==============================+
| PID | Point number or referenc |
+----------+------------------------------+
| type | Point type (see below) |
+----------+------------------------------+
| angle | Horizontal angle or azimuth |
+----------+------------------------------+
| z_angle | zenithal angle |
+----------+------------------------------+
| distance | Horizontal or slope distance |
+----------+------------------------------+
| th | Target heigh |
+----------+------------------------------+
| ih | Instrument heigh |
+----------+------------------------------+
| circle | Angle on the circle |
+----------+------------------------------+
| station | Station point for reference |
+----------+------------------------------+
| TEXT | Some descriptive text |
+----------+------------------------------+
Point type
+------+---------------------------------------+
| Type | Explanation |
+======+=======================================+
| PT | Simple point with only coordinates |
+------+---------------------------------------+
| ST | Station |
+------+---------------------------------------+
| BS | Backsight point |
+------+---------------------------------------+
| PO | Point with polar coordinates and more |
+------+---------------------------------------+
======================
:mod:`tops_csv` -- CSV
======================
Description
-----------
This is a standard file format for spreadsheet and transfer between softwares. |br|
The file is comma separated.
Data format
-----------
Yet, this format is not parametric and values return are the following::
PID, type, Point Name, x, y, angle, z_angle, distance, th, ih, circle, station
======================
:mod:`tops_dat` -- DAT
======================
Description
-----------
This format is used in Archis software for photorectification, photo mosaic and
photogrammetric survey.
Data format
-----------
Return format is points coordinates::
PID, x, y, z, TEXT
======================
:mod:`tops_dxf` -- DXF
======================
Description
-----------
This format is a standard format for CAD softwares like AutoCAD, QCAD,
LibreCAD...
Data format
-----------
The format is based on the official `DXF R15 (2000) documentation
`_. |br|
Layers can be separated for each point or not. |br|
This format can describe points or lines.
==============================
:mod:`tops_geojson` -- GeoJSON
==============================
Description
-----------
This format follow the GeoJSON standard
`RFC 7946 `_. |br|
Moreover, this format is the internal format used in Total Open Station. |br|
It is supported by numerous mapping and GIS software.
Data format
-----------
GeoJSON features collections.
======================
:mod:`tops_sql` -- SQL
======================
Description
-----------
This format is used by PostGIS which adds support for geographic objects to the
PostgreSQL object-relational database.|br|
`SQL Reference `_
Data format
-----------
Format is points coordinates::
PID, x, y, z, TEXT
======================
:mod:`tops_txt` -- Txt
======================
Description
-----------
A simple ASCII format to export points coordinates.
Data format
-----------
Format is points coordinates::
x, y, z
totalopenstation-0.5.1/docs/output_formats/main.rst 0000644 0001750 0001750 00000002153 13607717037 021003 0 ustar mfv mfv .. _output_formats:
==============
Output formats
==============
Total Open Station supports a number of output formats.
As input formats, data formats can be classified into two groups:
1. "raw" data with polar coordinates and lots of information
2. processed data with cartesian coordinates
.. _implemented_of:
Implemented formats
===================
Output formats are:
.. toctree::
:maxdepth: 1
:glob:
of_*
Unknown formats
===============
Unimplemented :term:`formats