CS2CS¶
过滤两个坐标参考系之间的变换。
简介¶
cs2cs [-eEfIlrstvwW [args]][[--area <name_or_code>] | [--bbox <west_long,south_lat,east_long,north_lat>] ][--authority <name>] [--no-ballpark] [--accuracy <accuracy>] [--3d]( [+opt[=arg] *...][+至 +选项 [=arg] *...]|{源_CRS}{TARGET_CRS})文件。。。其中{sourceu crs}或{targetu crs}是
proj_create()
,前提是它表达一个CRS
项目字符串,
一根WKT弦,
目标代码(如“EPSG:4326", "骨灰盒:ogc:定义:crs:EPSG::4326“,”骨灰盒:ogc:定义:协调操作:EPSG::1671“),
对象名。e、 “北纬84米”区域。在这种情况下,由于不保证唯一性,将应用启发式方法来确定适当的最佳匹配。
组合复合坐标系参考的OGC URN(例如骨灰盒:ogc:定义:crs,电子稳定程序:crs::2393,crs:EPSG公司:5717“或自定义缩写语法”EPSG:2393+5717"),
OGC URN结合了投影或衍生CR的参考,例如投影3D CR的参考“UTM区域31N/WGS 84(3D)”:骨灰盒:ogc:定义:crs,电子稳定程序:crs:4979,cs:PROJ::ENh,坐标操作:EPSG::16031" ( 在6.2中添加 )
一个OGC URN,用于合并串联操作的引用(例如骨灰盒:ogc:定义:协调操作,坐标操作:EPSG●3895,坐标操作:EPSG::1618")
PROJJSON字符串。Json架构位于https://proj.org/schemas/v0.4/projjson.schema.json( 在6.2中添加 )
由两个用“+”分隔的对象名组成的复合CRS。e、 g.“WGS 84+EGM96高度”( 在7.1中添加 )
6.0.0 新版功能.
备注
在7.0.1之前,添加文件名时需要在{sourceu crs}和{targetu crs}之间添加+to
描述¶
cs2cs 在一组输入点上执行源地图坐标系和目标地图坐标系之间的转换。坐标参考系转换可以包括投影坐标和地理坐标之间的转换以及基准偏移的应用。
以下控制参数可以按任意顺序出现:
- -I¶
方法指定反向转换,从 +to 坐标系到定义的主坐标系。
- -t<a>¶
哪里 a 指定用作第一个字符的字符,以表示要通过而不进行处理的控制线。此选项仅适用于ASCII输入。(#是默认值)。
- -d <n>¶
5.2.0 新版功能.
指定输出中的小数位数。
- -e <string>¶
哪里 字符串 在数据转换过程中检测到错误时要输出的任意字符串。默认值为三个字符的字符串:
*\t*
。
- -E¶
在打印转换后的值之前,将输入坐标复制到输出行。
- -l<[=id]>¶
列出可以使用 +项目 .
cs2cs -l=id
给出投影的扩展描述 id ,例如cs2cs -l=merc
.
- -lp¶
可用于的所有投影id的列表 +项目 参数。相当于
cs2cs -l
.
- -lP¶
可用于的所有投影的扩展描述 +项目 参数。
- -le¶
可以使用 +ELLP公司 参数。
- -lu¶
可以使用选择的所有距离单位的列表 +单位 参数。
- -r¶
此选项将前两个预期输入的顺序从CRS指定的顺序反转为相反的顺序。第三个坐标,通常是高度,仍然是第三个坐标。
- -s¶
此选项将前两个预期输出的顺序从CRS指定的顺序反转为相反的顺序。第三个坐标,通常是高度,仍然是第三个坐标。
- -f <format>¶
哪里 格式化 是一个printf格式的字符串,用于控制输出值的形式。对于反向投影,当使用此选项时,输出将以度为单位。如果为反向投影指定了格式,则输出数据将以十进制度为单位。默认格式为
"%.2f"
用于正投影,DMS用于逆投影。
- -w<n>¶
哪里 n 是用于秒输出的有效小数位数(当未指定选项时,
-w3
是假定的)。
- -W<n>¶
哪里 n 用于秒输出的有效小数位数。什么时候
-W
则这些字段的宽度将恒定,并带有前导零。
- -v¶
导致在输入数据之前打印程序测试和使用的制图控制参数列表。
- --area <name_or_code>¶
8.0.0 新版功能.
指定一个感兴趣的区域,以在研究两个CR之间的坐标运算时限制结果。感兴趣的区域可以指定为名称(例如“丹麦-陆上”)或权限:代码(爱普生:3237)
此选项与
--bbox
.
- --bbox <west_long,south_lat,east_long,north_lat>¶
8.0.0 新版功能.
指定一个感兴趣的区域,以在研究两个CR之间的坐标运算时限制结果。感兴趣的区域被指定为具有地理坐标的边界框,在未指定的地理坐标系中以度表示。 west_long 和 east_long 应该在 [-180,180] 范围,和 south_lat 和 north_lat 在 [-90,90] . west_long 一般低于 east_long ,除非感兴趣的区域穿过反地磁线。
- --no-ballpark¶
8.0.0 新版功能.
不允许任何是或包含 Ballpark transformation
- --accuracy <accuracy>¶
8.0.0 新版功能.
为候选坐标操作设置所需的最小精度。
- --authority <name>¶
8.0.0 新版功能.
此选项可用于限制在数据库中查找的坐标操作的权限。未指定时,将搜索来自任何机构的协调操作,并在中设置限制
authority_to_authority_preference
与源/目标CRS本身的权限相关的数据库表。如果权限设置为any
,则如果authority是不同的非空字符串,则将搜索来自任何authority的协调操作any
,则只在该权限命名空间中搜索协调操作(例如EPSG
)此选项与
--bbox
.
- --3d¶
9.1 新版功能.
使用基本大地测量CRS的椭球体,将2D CRS提升到其3D版本,其中垂直轴是以米为单位的椭球体高度。根据项目版本和所涉及的CRS的确切性质,特别是在Proj9.1之前,2D和3D CRS的混合可能会导致2D或3D转换。从Proj 9.1开始,这两个CR都需要是3D的,才能进行垂直变换。
这个 +opt 运行线参数与制图参数相关联。用法因投影而异,有关完整的说明,请参阅 projection pages .
这个 cs2cs 程序需要两个坐标参考系(CRS)定义。第一个(或第一个)是基于在 +to 争论。显示在 +to 参数被认为是第二个CRS的定义。如果没有定义第二个CRS,则假定基于源CRS的基准面和椭球面的地理CRS。注意,源和目的地CRS可以具有相同或不同的性质(地理、投影、复合CRS),或者每个CRS中的一个,并且可以具有相同或不同的基准。
使用WKT定义或权限:代码,将强制执行CRS的轴顺序。例如,如果使用EPSG:4326,第一个期望值(或返回值)将是纬度。
内部, cs2cs 使用 proj_create_crs_to_crs()
函数来计算相应的坐标运算,因此该函数的实现细节直接影响程序返回的结果。
环境参数 PROJ_LIB
为资源文件(数据库、基准移动网格等)建立目录
一个或多个文件(按从左到右的顺序处理)指定要转换的数据源。A -
将指定处理标准输入的位置。如果没有指定文件,则假定输入来自stdin。对于输入数据,两个数据值必须位于前两个空格分隔的字段中,并且当输入和输出都是ASCII时,输入行的所有尾随部分都附加到输出行。
输入的地理数据(经纬度)必须采用DMS或十进制度数格式,输入的笛卡尔数据必须采用与椭球体长轴或球体半径单位一致的单位。输出地理坐标通常采用DMS格式(使用 -f %.12f
对于带有12个小数位的十进制度数),而投影(笛卡尔)坐标将采用线性(米,英尺)单位。
远程电网的使用¶
7.0.0 新版功能.
如果 PROJ_NETWORK
环境变量设置为 ON
, cs2cs 将尝试使用存储在CDN(Content Delivery Network)存储上的远程网格,但这些网格在本地不可用。
更多详细信息请参见 网络能力 部分。
实例¶
使用项目字符串¶
下面的脚本
cs2cs +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27 -r <<EOF
45°15'33.1" 111.5W
45d15.551666667N -111d30
+45.25919444444 111d30'000w
EOF
将输入的NAD83地理坐标转换为UTM投影中的NAD27坐标,选择区域10。本例中的地理值是等效的,并表示为各种形式的DMS输入的示例。x-y输出数据将显示为三行:
1402293.44 5076292.68 0.00
使用EPSG-CRS码¶
从WGS 84纬度/经度(按该顺序)转换到UTM区域31N/WGS 84
cs2cs EPSG:4326 EPSG:32631 <<EOF
45N 2E
EOF
输出
421184.70 4983436.77 0.00
使用EPSG CRS名称¶
从具有EGM96高度的WGS 84纬度/经度(按该顺序)转换为具有WGS84椭球高度的UTM区域31N/WGS 84
echo 45 2 0 | cs2cs "WGS 84 + EGM96 height" "WGS 84 / UTM zone 31N"
输出
421184.70 4983436.77 50.69