Danesfield使用介绍目录
1.介绍
该软件的目标是从卫星图像中重建语义上有意义的建筑物和其他人造结构的3D模型。
该软件设计用于处理多视图卫星图像,目前配置用于处理全色和多光谱WorldView3图像集合,例如公共CORE3D数据集中提供的示例。
参考文献:
M. Leotta, C. Long, B. Jacquet, M. Zins, D. Lipsa, J. Shan, B. Xu, Z. Li, X. Zhang, S. Chang, M. Purri, J. Xue, and K. Dana, “Urban Semantic 3D Reconstruction From Multiview Satellite Imagery,” in The IEEE Conference on Computer Vision and Pattern Recognition (CVPR) Workshops: EarthVision, 2019.
2.安装
2.1 源码安装
2.2 Docker安装
docker pull kitware/danesfield
3.代码主要目录说明
danesfield: danesfield算法模块所在的目录;
tools:包含执行Danesfield算法的命令行工具的目录。
docker run kitware/danesfield:latest ls -l
4.运行Danesfield命令行
4.1 Danesfield基本使用
在上面的目录中,进入danesfield文件夹,得到如下
要想通过python run_danesfield,py,需要进入tools目录
最后,利用python run_danesfield.py -h 查看python运行需要的输入参数,其参数包含必选参数ini_file,以及可选参数
必须提供一个配置文件,以ini结尾,模板如下图所示
[paths]
# Input point cloud; AOI bounds are inferred from the point cloud AOI边界是从点云推断出来的
# unless provided
p3d_fpath = /path/to/p3d.las
dtm_fpath = /path/to/dtm.tif
# A working directory in which to write output files; created if not
# passed
work_dir = /path/to/work_dir
# Imagery source directory; required 图像源目录;必须要求
imagery_dir = /path/to/imagery_dir
# Raytheon corrected RPC file directory 雷神修正RPC文件目录
rpc_dir = /path/to/rpc_dir
# Config file for VisSat
aoi_config = /path/to/config.json
[aoi]
# The name of this AOI, a prefix to output files; required
name = jacksonville
[params]
# Ground sample distancy of output imagery in meters per pixel;
# default is 0.25
gsd = 0.25
[material]
# Section pertaining to parameters for material segmentation portion关于材料分割部分计算参数的部分:必需的
# of calculation; required
model_fpath = /path/to/model/file.tar
# Whether or not to run with CUDA; optional, default is True
cuda = True
# Batch size, which is the number of pixels classified at a time;
# optional
# batch_size = 1024
[roof]
# Section pertaining to parameters for the roof geon extraction有关屋顶类别参数抽取部分的计算;要求
# portion of calculation; required
model_dir = /path/to/model/dir/
model_prefix = dayton_geon
[metrics]
# Section pertaining to parameters for the metric computation step
ref_data_dir = /path/to/reference/data/dir
# Reference data prefix
ref_data_prefix = AOI-D4
由于是利用VisSat运行生成点云,因此还需要一个VisSat运行的config.json文件,因此配置文件至少需要两个,一个是项目的配置文件,以.ini结尾,一个VisSat的参数config.json文件
4.2 示例Demo
在第一层danesfield文件下的demo文件文件中,如下图所示
未完待续