用于地理空间数据共注册的软件包
项目描述
CODEM:多模态数字高程模型注册
概述
CODEM
是一个用于将感兴趣区域(AOI)的3D模型注册到更大的3D基础数据源的测试平台应用程序。支持点云、网格和栅格数字地面模型(DSM)数据类型。格式支持限于以下
- 点云:LAS、LAZ、BPF
- 网格:PLY、OBJ
- DSM:GeoTIFF
CODEM
通过以下基本步骤执行共注册
- 从AOI和基础数据源生成归一化DSM。
- 通过匹配从DSM中提取的特征进行粗略注册。
- 通过迭代最近点(ICP)算法进行精细注册。
- 将求解的注册变换应用于AOI数据,保持其原始类型和格式。
安装CODEM
-
克隆仓库
git clone https://github.com/NCALM-UH/CODEM
-
创建并激活包含所需依赖项的Conda环境。在
CODEM
目录内conda env create --file environment.yml
conda activate codem
-
从项目目录安装
CODEM
。pip install .
共注册
运行CODEM
《CODEM》应用程序有两个必需的位置参数和许多选项。必需的位置参数是基础数据文件的文件路径和AOI数据文件的文件路径。在命令行上执行codem的格式如下
codem <foundation_file_path> <aoi_file_path> [-opt option_value]
例如,在demo目录中的某些示例数据文件上运行CODEM
看起来像
codem demo/Foundation-PointCloud.laz demo/AOI-Mesh.ply
可选参数可以放在位置参数之前或之后。例如,我们可以将最小注册管道分辨率设置为新的值(默认值 = 1.0)
codem demo/Foundation-PointCloud.laz demo/AOI-Mesh.ply --min_resolution 2.0
所有选项及其默认值的摘要见docs/configuration.md文档。对于大多数景观,默认选项值应该是足够的。
CODEM生成的输出
所有输出都保存在一个新的目录中,该目录位于AOI文件的位置。目录名称带有执行日期和时间的标签:registration_YYYY-MM-DD_HH-MM-SS
。目录内容包括以下内容
- 已注册的AOI数据文件:注册的AOI文件将与原始AOI文件具有相同的数据类型和文件格式,并将具有相同的名称,名称末尾添加了"
_registered
"。 config.yml
:记录注册中使用的参数。log.txt
:日志文件。registration.txt
:包含解决的粗略和精细注册变换参数和一些统计信息。dsm_feature_matches.png
:粗略注册步骤中使用的匹配特征的图像。
垂直变化检测
运行VCD
除了核心注册功能外,codem还提供基于激光扫描的垂直变化检测功能。
vcd <before_file_path> <after_file_path> [-opt option_value]
VCD生成的输出
生成栅格、网格和点云输出(包括ESRI 3D形状文件),以突出显示地面/非地面特征和垂直变化。
附加信息
有关可用配置选项的信息,更深入地了解CODEM
的工作方式,以及一个简单的示例,该示例使用存储在本存储库demo
目录中的数据文件,均可在docs
目录中找到
联系方式
项目详情
下载文件
下载适合您平台文件的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源分布
codem-0.25.5.tar.gz (47.1 kB 查看散列)
构建分布
codem-0.25.5-py3-none-any.whl (49.7 kB 查看散列)