totalopenstation-gui - 云端在线

程序：

您的姓名

totalopenstation - 总开放站 0.3.0

用于 USERS

操作系统需求
TotalOpenStation 是使用 Python 语。 因此你需要有一个工作
安装您选择的 Python 的当前版本。

在这些页面中，我们将参考标准 Python 分布。

显然，我们不会重新发明轮子，所以我们选择使用一些 Python
一些特定任务的库：

· 这 序列号 图书馆

· 蟒蛇 特金特 GUI 库，随标准 Python 设置一起提供

pySerial 需要从串口下载数据（甚至通过 串行USB
适配器).

Tkinter 目前负责图形用户界面。 这可能会改变
Total Open Station 的未来版本。

得到 Python
如果您使用的是 GNU/Linux 或最新的 Mac OSX，那么您的计算机上应该已经安装了 Python
系统，所以你只需要获得提到的库。

在 Windows 上，您可以从 Python 主网站获取安装程序，位于 download
部分。

得到 库
一般来说，参考 序列号 官网.

GNU / Linux的
使用你的包管理器（apt-get的, 百胜) 并查找名为的包 蟒蛇系列 or
串行 并安装它。 要测试安装是否顺利，请打开一个终端，
启动python解释器 蟒蛇 并在提示输入 进口 串行 然后返回。
它应该什么都不说，像这样：

>>> 导入序列

如果它抱怨，就出了问题：

>>> 导入序列
追溯（最近一次通话）：
文件 ” "，第 1 行，在
导入错误：没有名为串行的模块

并且您需要检查您的分发包管理器和错误报告系统。

Mac OSX
最简单的方法可能是安装 setuptools 并使用：

easy_install -U pyserial

Microsoft Windows
pySerial 网站具有适用于此操作的各种版本的可执行安装程序
系统。 正如 pySerial 的文档所说，您还需要 pywin32 马克图书馆
哈蒙德。

安装
安装 Total Open Station 有几种不同的方法，具体取决于您的操作
系统。 如果你使用的是 GNU/Linux 或 Mac OSX，你应该已经安装了 Python
你的系统。 Microsoft Windows 的说明如下。

运用 点子
直到您操作系统的打包工具（例如 根据 or 百胜) 允许您安装 Total
与其他程序一起打开 Station，推荐的安装方式是使用 点子， 喜欢：

pip 安装 totalopenstation

这也将安装所有其他必需的 Python 包。 点子 是互补的
- 的virtualenv，并且鼓励您使用 virtualenv 来隔离您的
安装：

pip -E tops 安装 totalopenstation

协调 -E 上着 创建一个名为的虚拟环境 上着 并将 totalopenstation 安装到
它。

阅读更多关于 点子 at http://pip.openplans.org/ 和
http://guide.python-distribute.org/pip.html .

用户手册 安装 - 设置文件
如果您从 PyPI 或 mercurial 手动下载源分发文件
存储库，首先确保您已安装所有 必须 包. 那么，只要 cd
进入解压目录，然后：

python setup.py安装

同样，强烈建议避免系统范围的安装。 用 的virtualenv.

Windows
有一个二进制安装程序可用 的PyPI. 这需要您安装一个 Python
发行版（最新可用的是 2.7.1 ‒ 不要安装 Python 3，因为我们不支持它
还），以及 串行 和 设置工具 模块。

得到 样品 data
即使您的设备未在受支持的设备中列出，Total Open Station 仍然可以
有用，特别是对于：

1. 找到合适的 串行 地都 参数 来自未知设备。 你可以玩
使用 8 个选项并在文本区域中查看结果。 一旦下载的结果看起来
很好，您几乎可以确定您使用了正确的参数，我们可以添加
测试模型参数到程序数据库；

2. 检索 样品 data 来自未知模型并提交它们以允许支持那些
程序未来版本中的模型。

为此，您只需使用主 Total Open Station 可执行文件即可。

警告：
请记住：Total Open Station 不是向导，您必须调整串行端口选项
使用您对全站仪的先验知识（例如阅读随附的手册）
它，看看其他程序的选项）。

术语库
输入 格式
输入格式是从全站仪下载的数据的编码方式。 这个
可能包括 X、Y 和 Z 坐标的默认顺序，特定方式
用一些独特的文本字符串和其他特征为每个点添加前缀。 每个
输入格式是唯一的，它需要一个专用的模块。 输入格式不是
通用CAD或GIS软件包可读，导出是TOPS的工作
他们。 这些格式有一个标准名称，由制造商或
TOPS 开发团队。

模型 当我们提到一个 模型 我们的意思是所有具有相同品牌名称的全站仪
和制造商（例如所有标有“Trimble Geodimeter 600”的产品）。

产量 格式
一种可由 GIS、CAD 或任何类型的常用软件（如 CSV 或 DXF）读取的格式。

串行USB 适配器
虽然大多数全站仪都有串行接口（端口和电缆），但现代 PC 和
笔记本电脑往往只有 USB 端口。 在这种情况下，可以使用
串行 USB 适配器电缆，使您能够将全站仪连接到其中一个
你的 USB 端口。 根据您的平台，设备可能被标识为
/开发/ttyUSB0 or COM5.

用户 of 合计 可选 站
目前为止，Total Open Station 已成功应用于：

· 锡耶纳大学， 分部 di 考古 e 历史 的 ARTI，为
Gortyna 和 Vignale 的发掘

· 牛津 考古学，对于实地考察，使用 打开Moko 移动平台

· Arke_Geomatica 已经写了关于 TOPS 的博客

· 弧队：在 Arc-Team 发送给我们之后，我们增加了对 Trimble“区域”格式的支持
一些样本数据

· 帕多瓦大学

如果您有满意的用户数量，请告诉我们。

用于 开发商

型号
常规 概念
这里关于模型和抽象类的一般概念。

莱卡_tcr_1205 -- 徕卡 TCR 1205
描述
这是一个相当新的全站仪。 数据由牛津大学的约瑟夫·里夫斯提供
考古学。

连接升级包
波特率
高于19200

字节大小
8

/1/否

时间 格式
数据格式是ASCII，很简单。

唯一需要注意的是数据转储包含相对和绝对度量。

其他 笔记
nikon_npl_350 -- Nikon NPL-350
下载为 ASCII 格式。

就算是蛮横的方法 猫 /开发/ttyS0 > 文件 创建一个 ASCII 文件没有任何问题，所以
大概是串口的默认参数就OK了。

蔡司_elta_r55 -- 蔡司 尔塔 R55
描述
这是一个相当古老的设备，在锡耶纳大学使用。 TOPS的第一步
发展是通过它实现的。

连接升级包
波特率
9600

字节大小
7

平价 没有

输出 格式
蔡司Elta R55全站仪可以输出四种不同格式的数据，其中只有一种
目前支持：

· if_zeiss_rec_500

·蔡司R-4

·蔡司R-5

·蔡司RE

其他 笔记
硬件接口由串行 RS232 电缆组成，该电缆也适用于普通的
串行USB 适配器 .

其他 模型
未实现 模型 可以添加到 TotalOpenStation。

将您的模型包含在 TotalOpenStation 下一版本中的最佳方法是
在错误跟踪器中提交支持请求并附上一些通过以下方式获得的示例数据转储
助手应用程序。

如果你会写 Python 代码，你也可以使用现有的模块自己编写
作为指南。 如果您编写一个模块，我们将很高兴收到并包含它
在 TotalOpenStation 源代码树中。

SEE 另外：
这个 贡献 页面了解如何加入项目并积极参与
发展。

输入 格式
0.2 新版功能：Total Open Station 支持多种输入数据格式，分别是
与设备处理机器分开实现（即从您的设备下载数据）
全站仪）。 这是因为一台设备可以输出多种格式，并且在
同时同一格式可以被多个设备使用（特别是这是
同一制造商的不同型号的情况）。

An 简介 关于 输入 data 格式
一般来说，数据格式可以分为两大类：

1. 带有极坐标的“原始”现场数据

2. 处理后的数据，带有 XY(Z) 直角坐标

后者更容易处理，因为它们不需要任何计算
测量。

XYZ 格式
这些格式是 Total Open Station 支持的第一种测量数据格式。

笛卡尔坐标只需要从 ASCII 数据中提取

徕卡 TCR 1205
模块作者
斯特凡诺·科斯塔

模块作者
卢卡·比安科尼

Leica TCR 1205（和其他类似设备）使用这种格式，并且包含
极坐标和笛卡尔坐标。 目前，仅使用笛卡尔坐标
获取导出的数据。

致谢
感谢 OA Digital 的 Joseph Reeves 添加了对这种格式的支持。

Nikon 未处理 格式 V2.00
作者 斯特凡诺·科斯塔

此格式包含极坐标数据。 它是 Total Open 支持的第一个 polar 格式
站。

数据基本上是逗号分隔的值，但每一行可以有不同的格式和
字段数。 记录点位于以 SS 字符串，虽然固定
基点以 ST 字符串。

CO,Nikon RAW 数据格式 V2.00
CO,FATE2010
一氧化碳，说明：
CO，客户：
CO，评论：
CO,Downloaded 08-Feb-2010 11:17:17
CO，软件：预安装版本：1.02
CO，仪器：Nikon NPL-352
CO,Dist 单位：米
CO，角度单位：Gons
CO，零方位角：北
CO，零 VA：天顶
CO，坐标顺序：NEZ
CO,HA 原始数据：方位角
CO，倾斜校正：VA:ON HA:ON
CO, FATE2010 创建于 04 年 2010 月 13 日 41:40:XNUMX
MP,1,,0.000,0.000,0.000,ST
CO，温度：20C 压力：760mmHg 棱镜：0 04-Feb-2010 13:47:08
ST,1,,,,1.430,0.0000,0.0000
F1,,1.500,,0.0000,110.5344,13:47:08
SS,2,1.500,8.986,107.9916,102.3376,14:00:04,P
SS,3,1.500,7.706,110.4894,103.4372,14:00:51,P
SS,4,1.500,7.620,105.5898,104.3960,14:01:30,P
SS,5,1.700,7.162,105.5474,103.7754,14:02:48,P
SS,6,1.500,8.539,105.0304,107.6552,14:04:43,P
SS,7,0.000,8.318,111.0776,109.4876,14:06:02,P
SS,8,1.500,7.085,108.6492,101.0370,14:38:22,P
SS,9,1.500,7.592,112.1108,100.0146,14:38:58,P
SS,10,1.500,7.616,114.3392,98.3016,14:40:03,P
SS,11,1.500,8.227,118.5482,97.8578,14:40:53,P
SS,12,1.500,8.364,111.9586,96.9256,14:41:44,P
SS,13,1.500,8.233,120.1832,93.9826,14:47:20,P
SS,14,1.500,7.438,116.4324,95.2816,14:48:15,P
SS,15,1.500,7.266,115.0854,99.0626,14:49:59,P
SS,16,1.500,6.622,112.4368,99.6468,14:50:19,P
SS,17,1.500,7.957,121.7916,93.7194,14:52:29,P
SS,18,1.500,7.956,134.1078,93.9716,14:53:09,P
SS,19,1.500,7.515,126.2412,94.4298,14:54:15,P
SS,20,1.500,6.711,130.6606,96.5976,14:55:03,P
SS,21,1.500,6.857,118.6338,96.0578,14:56:00,P
SS,22,1.500,6.433,117.1546,100.2926,14:56:52,P
SS,23,0.000,8.399,127.3100,103.7122,14:58:30,P
SS,24,0.000,8.351,128.5522,100.1180,14:59:08,P
SS,25,0.000,8.270,134.3588,101.1110,14:59:55,P
SS,26,0.000,8.274,133.8002,104.4368,15:00:26,P
SS,27,1.500,6.511,124.0842,99.5534,15:03:09,P
SS,28,1.500,5.974,122.1514,101.6522,15:04:23,P
SS,29,0.000,8.962,137.1236,98.3588,15:07:38,P
SS,30,0.000,8.934,136.3310,102.4348,15:08:05,P
SS,31,0.000,9.184,144.2620,103.4046,15:08:31,P
SS,32,0.000,9.387,149.0120,103.4142,15:08:59,P
SS,33,0.000,9.362,148.7352,99.7136,15:09:30,P
SS,34,0.000,9.219,144.4228,99.5388,15:09:53,P
SS,35,0.000,7.001,138.7436,114.7446,15:11:07,P
SS,36,1.500,5.851,131.9558,102.5750,15:22:52,P
SS,37,1.500,6.328,133.0952,101.2756,15:23:32,P
SS,38,1.500,5.808,135.2582,104.2262,15:24:29,P
SS,39,1.500,6.923,134.4702,99.9614,15:25:18,P
SS,40,1.500,6.879,139.7302,100.1380,15:25:55,P
SS,41,1.500,7.486,140.0246,98.6866,15:26:40,P
SS,42,1.500,7.661,135.3510,97.9216,15:28:03,P
SS,43,1.500,8.199,135.9068,96.7188,15:28:54,P
SS,44,1.500,8.225,143.5888,97.0652,15:29:50,P
SS,45,1.500,7.827,145.0258,97.5600,15:31:08,P
SS,46,1.500,7.860,147.3556,97.3464,15:31:44,P
SS,47,1.500,8.662,147.2374,95.8390,15:32:27,P
SS,48,1.500,8.568,144.4556,95.8270,15:33:11,P
SS,49,1.500,8.729,143.4210,93.5904,15:34:01,P
SS,50,1.500,8.339,136.3862,93.3592,15:34:38,P
SS,51,1.500,7.429,141.7392,102.7698,15:36:02,P
SS,52,1.500,6.913,140.8836,104.3052,15:36:41,P
SS,53,1.500,7.479,149.9490,103.0626,15:37:25,P
SS,54,1.500,6.938,149.6110,104.9004,15:38:12,P
SS,55,1.700,6.718,143.6064,104.5304,15:39:06,P
SS,56,1.700,6.734,138.1288,104.4754,15:39:44,P
CO,HT 在 PT=56 时发生变化 旧 HT=1.500m
CO，旧=56 X-3.787 Y5.548 Z-0.543
CO,HT 在 PT=55 时发生变化 旧 HT=1.500m
CO，旧=55 X-4.239 Y5.190 Z-0.548
SS,57,1.500,6.132,137.6602,109.0124,15:42:43,P
SS,58,1.500,8.966,150.7654,93.9858,15:44:05,P
SS,59,1.500,9.739,151.4094,93.7238,15:44:39,P
SS,60,1.500,9.919,155.4866,95.0466,15:45:26,P
SS,61,1.500,8.980,152.3926,95.1246,15:46:14,P
SS,62,1.500,9.107,155.8314,95.5764,15:47:06,P
SS,63,1.850,9.150,156.6374,93.9602,15:50:12,P
SS,64,0.000,9.292,157.4092,107.9238,15:52:21,P
SS,65,1.500,10.059,160.4978,95.4160,15:54:36,P
SS,66,1.500,9.330,161.8984,97.0678,15:55:51,P
SS,67,1.500,9.997,161.8576,99.2174,15:56:34,P
SS,68,1.500,10.786,167.3566,98.9458,15:57:09,P
SS,69,1.500,10.240,167.1484,99.9180,15:57:48,P
SS,70,1.780,9.705,169.0404,99.2786,15:59:17,P
CO,HT 在 PT=70 时发生变化 旧 HT=1.500m
CO，旧=70 X-8.579 Y4.536 Z0.040
SS,71,1.500,9.408,162.8840,100.4778,16:00:34,P
SS,72,1.750,9.183,163.3532,99.4422,16:02:31,P
SS,73,1.775,9.027,160.3550,99.1590,16:04:06,P
SS,74,1.900,8.753,160.1354,99.1978,16:05:45,P
SS,75,1.900,8.437,165.1502,99.4756,16:06:43,P
SS,76,1.900,8.230,159.7622,99.0878,16:07:33,P
SS,77,1.500,8.092,155.4420,102.0228,16:08:38,P
SS,78,1.500,7.861,150.3918,102.1856,16:09:31,P
SS,79,1.500,8.676,149.3206,100.1448,16:10:12,P
SS,80,1.500,8.841,154.4180,100.2618,16:11:07,P
SS,800,1.500,20.726,178.2156,91.7976,16:13:27,P
SS,801,1.500,21.722,179.8802,92.3712,16:14:05,P
SS,802,2.550,20.961,179.9716,92.2336,16:18:03,P

致谢
感谢锡耶纳大学的 Cynthia Mascione，增加了对这种格式的支持。

天宝 国家 / 地区 格式
模块作者
斯特凡诺·科斯塔

模块作者
卢卡·比安科尼

模块作者
亚历山德罗·贝齐

蔡司_rec_500 -- 蔡司 REC 500
这是 Total Open Station 支持的第一种格式。 由于历史原因，其
文档比其他格式的文档扩展得多。 分步程序
对于任何想要破解 TOPS 本身的人来说都很有用。

一步步 download 程序
在我进行第一次测试时，我发现收集所有步骤很有用。 这
程序会自动通过它们：

>>> 导入序列
>>> ser = serial.Serial('/dev/ttyUSB0', \
波特率=9600，字节大小=serial.SEVENBITS，超时=0，\
奇偶校验=串行。PARITY_NONE，rtscts=1)
>>> ser.open()

此时，您必须从设备菜单开始下载。 当这个操作
已完成，最好控制是否实际收到任何数据：

>>> ser.inWaiting()
648L

非零结果表示已下载某些内容。 够好了。

这个数字可以保存到一个变量中并作为参数传递给 读（） 命令：

>>> n = ser.inWaiting()
>>> 结果 = ser.read(n)

这个 导致 object 是一个包含我们数据的字符串：

>>> 打印（结果）
0001 或.COOR
0002 0S X 0.000 Y 0.000 Z 0.000
0003 嗡 397.0370
0004极地
0005 输入 th 1.500 ih 0.000
0006 输入 th 0.000 ih 0.000 Z 0.000
0007 1 X -0.472 Y 1.576 Z 0.004
END

到目前为止，我们可以说下载的文件包含以下信息：

· 或COOR: 但我不知道这条线是否也可以采用其他值

· 起源 点 由...定义 OS 字符串后跟它的 X, Y, Z 坐标

· 取向 角度 Om: 这些是渐变吗？

· POLAR: 但我不知道这条线是否也可以采用其他值

· INPUT: 总是有两个 INPUT 线？

· th

· ih

· Z

· 点数，表示为 N （从1开始）， X, Y, Z

· END: 在这行之后没有更多的数据

其他 格式
未实现 格式 可以添加到 Total Open Station。

将您的格式包含在 TotalOpenStation 下一版本中的最佳方法是
在错误跟踪器中提交支持请求并附上一些通过以下方式获得的示例数据转储
助手应用程序。

如果你会写 Python 代码，你也可以使用现有的模块自己编写
作为指南。 如果您编写一个模块，我们将很高兴收到并包含它
在 TotalOpenStation 源代码树中。

SEE 另外：
这个 贡献 页面了解如何加入项目并积极参与
发展。

添加 a 新 输入 格式
有数百种调查数据格式。 我们会一一添加
进入 Total Open Station。 这是定义一些最低要求的一般过程
在实施新格式时。

文件记录
始终为该格式编写文档。 在文件夹中添加一个新文档 文档/输入格式/
带有裸描述的源树目录，包括：

· 原始（极坐标）或处理（笛卡尔）格式

· 基于固定位置或流体——这改变了解析器的工作方式

· 哪些设备或制造商使用这种格式

· 贡献者姓名

格式暴露的Total Open Station缺点不应该被隐藏，而是应该被隐藏
在代码和文档中都进行了明确。

样本 data
永远不要在不包含相关示例数据的情况下提交对新格式的支持
样本数据 目录。 一般来说，样本数据文件应该遵循这些简单的
规则：

· 质量胜于数量，所以更喜欢有许多不同角落的小文件
案例而不是包含大量普通数据的更大文件

· 多个文件是可以的，如果它们用于显示不同的问题
格式

· 文件名应与实现
格式，使用 。最高额 扩展，比如 topcon_gts.tops 对于在 a 中实现的格式
模块命名 topcon_gts.py -- 这将允许简单的自动化测试

代码
完成前两个任务后，就可以开始编写代码（或至少
你应该假装这样做）。 新代码总是比旧代码好，因为你有
学习了更好的编程技术，或者因为您对 Total Open 更有信心
车站。 为您的代码编写测试（目前）不是必需的，但强烈鼓励这样做。
不要打破目前的做法。

所有实现新格式的代码都不应破坏现有的 API。 更改 API
应该在整个图书馆的规模上完成，以考虑到许多不同的
每种格式和解析器的需求。 全开放站的发展并不稳定
形状，因此预计 API 在未来版本中会发生变化。 但是，请理解，
新格式解析器不适合这样做。

欢迎实验。 Mercurial 允许轻松分支：鼓励您克隆
我们的存储库并为新功能和格式而疯狂。

特约
Total Open Station 是免费软件，在 GNU 下发布 常规 公共 执照 v3 or
（您可以选择）任何更高版本。

开发跟踪 水银，一个快速的去中心化版本控制系统。
安装 水银 除非你想参与TOPS开发，否则不需要，但是
请 do it. 主要开发存储库位于 到位桶 很容易分叉的地方
自己实验的源代码。

建议的贡献方式是使用 Mercurial 发送补丁 补丁炸弹
扩展到 发展 邮件 名单.

编码 标准
我们尽量遵循 PEP-8,

路线图
演讲与演出
Total Open Station 版本为 0.2，这是一个 阿尔法 释放。

近 未来
Total Open Station 0.3 将于 2011 年 XNUMX 月发布。计划的功能包括：

· 响应更快的下载对话框

· 更扎实的内部数据格式

未来
我们的 Total Open Station 计划侧重于不同的用户体验领域和
开发实践。 我们设想基于以下概念的未来版本：

· 与地理空间数据软件无缝集成

· 专供密集调查使用的布局

· 增强的移动体验

· 始终支持更多设备和格式

如果您对 Total Open Station 的外观有什么不可思议的想法，请告诉我们！

指数 AND TABLES

· 基因索引

· 修改索引

· 搜索、

版权

2008-2011，斯蒂法诺·科斯塔、卢卡·比安科尼

使用 onworks.net 服务在线使用 totalopenstation-gui