x2sys_list

贡献者

周茂


官方文档

x2sys_list

简介

从交叉点计算结果中提取数据

x2sys_list 读取交叉点 ASCII 文件 coedbase.txt (或标准输入),并基于某些条件提取数据,输出结果可以为 ASCII 或二进制文件。该模块输出结果可做为 x2sys_solve 交叉点平差的输入数据。

语法

gmt x2sys_list -Ccolumn -TTAG [ coedbase.txt ] [ -Aasymm_max ] [ -E ] [ -Fflags ] [ -I[list] ] [ -L[corrections] ] [ -Nnx_min[+p] ] [ -Qe|i ] [ -Rregion ] [ -Strack[+b] ] [ -V[level] ] [ -W[list] ] [ -bobinary ] [ --PAR=value ]

必选选项

-Ccolumn

指定要处理的列,列名必须是格式定义文件中已有的列名,见 x2sys_init

-TTAG

指定 x2sys TAG,参见 x2sys_init

coedbase.txt

输入交叉点 ASCII 文件的名称,该文件可由 x2sys_cross 模块生成,也可从标准输入读取

可选选项

-Aasymm_max

指定相对于时间中点的交叉点分布的最大不对称性(如果没有时间,也可用距离)。不对称性的计算公式为 (n_right - n_left)/(n_right + n_left)。如果指定 asymm_max 值,将会排除超过该截止值的轨迹 [默认值为 1,即不排除任何轨迹]。

-E

输出两个轨迹的名称和总的交叉点个数作为头部信息 [默认不写入这些头部信息]

-Fflags

使用 acdhiInNtTvwxyz 的组合来设置输出。这些字符中不能包括空格,而且对大小写敏感。以下为字符的描述:

a 小于 90 度的角度,该角度为轨迹的方位角

c 指定的观测量的交叉点值(见 -C

d 沿轨距离

h 轨迹朝向

i 形成交叉点的两条轨迹在该点的有符号时间间隔

Ii 相同,但是时间间隔是无符号的

n 两条轨迹的名称

N 两条轨迹的 ID number

t 沿轨时间,格式为 dateTclock (不含时间时,输出 NaN)

T 从轨迹开始计算的时间 (不含时间时,设置为 NaN)

v 沿轨速度

w 轨迹的权重

x x 坐标或者经度

y y 坐标或纬度

z 沿轨观测值,见 -C

如果不使用 -Sd,h,n,N,t,T,v 在每列包含两个输出,分别代表两个轨迹。否则,将只输出对应轨迹的结果(除 n,N )。 ci 的符号是由 Value(track_one) - Value(track_two) 决定的。返回的时间间隔和 TIME_UNIT 的设置有关。上面各元素输出的顺序和他们在 flags 中的顺序一致, n 除外,n 选项将放在所有数字列的最后。

-I[list]

list 为轨迹列表文件名,其中包含若干轨迹文件名,这些轨迹将不参与计算 [默认包含所有的轨迹]。

-L[corrections]

对选择观测量进行最优改正,corrections 为改正表,该改正表可以由 x2sys_solve 生成 [默认使用位于 $X2SYS_HOME/TAG 文件夹中的 TAG_corrections.txt]。对于改正表文件的格式,见 x2sys_datalist 的 Corrections 章节

-Nnx_min[+p]

只输出至少含有 nx_min 个交叉点的轨迹的交叉点信息, +p 为相反,即输出少于 nx_min 个交叉点的轨迹的信息 [默认为全部轨迹]

-Qe|i

e 表示外部交叉点,i 表示内部交叉点 [默认为全部交叉点]

-Rxmin/xmax/ymin/ymax[+r][+uunit] (more …)

指定数据范围

-Strack[+b]

指定单轨迹的名称,只输出和这条轨迹相关的交叉点的信息 [默认输出所有轨迹交叉点信息]。添加 +b 以输出包含该轨迹的轨迹对相关的信息。

-W[list]

list 为文本文件,其中包含的信息为轨迹名称列表和用于计算交叉点处权重的权重列表 [默认权重设置为 1]

-V[level] (more …)

设置 verbose 等级 [w]

-bo[ncols][type][w][+l|b] (more …)

设置二进制输出的数据格式

-^-

显示简短的帮助信息,包括模块简介和基本语法信息(Windows下只能使用 -

-++

显示帮助信息,包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

显示完整的帮助信息,包括模块简介、基本语法以及所有选项的说明

--PAR=value

临时修改GMT参数的值,可重复多次使用。参数列表见 配置参数

示例

在以 MGD77 为 TAG 的磁数据的交叉点文件 COE_data.txt 中寻找指定区域的数据,并返回位置,时间和交叉点的值:

gmt x2sys_list COE_data.txt -V -TMGD77 -R180/240/-60/-30 -Cmag -Fxytz > mag_coe.txt

输出和测线 12345678 相关的重力异常交叉点信息,输出时间为以年初为起点的相对时间,使用二进制 double 类型精度:

gmt x2sys_list COE_data.txt -V -TMGD77 -Cfaa -S12345678 -FTz -bod > faa_coe.b

相关模块

x2sys_binlist, x2sys_datalist, x2sys_get, x2sys_init, x2sys_put, x2sys_report, x2sys_solve, x2sys_cross, x2sys_merge