Zenn
🔎

pycolmapのIncrementalPipelineOptionsパラメータ

に公開
colmap
sfm
pycolmap
tech

pycolmap.IncrementalPipelineOptions()

このドキュメントは、pycolmap.incremental_mapping で使用できるオプションを一覧にしたものです。

出典元:

注意点:
正確な情報や各オプションの詳細は、COLMAPの公式ドキュメントや pycolmap のソースコードを参照することを推奨します。

オプション一覧

オプション名 型 デフォルト値 説明
min_num_matches int 15 2つの画像間の最小マッチ数。
ignore_watermarks bool false 透かしを無視するかどうか。
multiple_models bool true 複数のモデルを構築を許可するかどうか。
max_num_models int 50 構築する最大モデル数。
max_model_overlap int 20 モデル間の最大重複率。
min_model_size int 10 最小モデルサイズ（画像の数）。
init_image_id1 int -1 初期ペアの最初の画像ID。-1の場合は自動選択。
init_image_id2 int -1 初期ペアの2番目の画像ID。-1の場合は自動選択。
init_num_trials int 200 初期ペア選択の試行回数。
extract_colors bool true ポイントクラウドから色を抽出するかどうか。
num_threads int -1 使用するスレッド数。-1の場合は自動設定。
min_focal_length_ratio float 0.1 最小焦点距離比率。
max_focal_length_ratio float 10.0 最大焦点距離比率。
max_extra_param float 1.0 最大追加パラメータ値。
ba_refine_focal_length bool true バンドル調整で焦点距離を最適化するかどうか。
ba_refine_principal_point bool false バンドル調整で主点を最適化するかどうか。
ba_refine_extra_params bool true バンドル調整で追加のカメラパラメータを最適化するかどうか。
ba_min_num_residuals_for_cpu_multi_threading int 50000 マルチスレッド化のための最小残差数。
ba_local_num_images int 6 ローカルバンドル調整に含まれる画像の数。
ba_local_function_tolerance double 0.0 ローカルバンドル調整のCeres solver関数許容誤差。
ba_local_max_num_iterations int 25 ローカルバンドル調整の最大イテレーション数。
ba_global_images_ratio float 1.1 グローバルバンドル調整を行う画像の追加比率。
ba_global_points_ratio float 1.1 グローバルバンドル調整を行うポイントの追加比率。
ba_global_images_freq int 500 グローバルバンドル調整を行う画像の追加頻度。
ba_global_points_freq int 250000 グローバルバンドル調整を行うポイントの追加頻度。
ba_global_function_tolerance double 0.0 グローバルバンドル調整のCeres solver関数許容誤差。
ba_global_max_num_iterations int 50 グローバルバンドル調整の最大イテレーション数。
ba_local_max_refinements int 2 ローカルバンドル調整の最大リファインメント回数。
ba_local_max_refinement_change float 0.001 ローカルバンドル調整の最大リファインメント変更量。
ba_global_max_refinements int 5 グローバルバンドル調整の最大リファインメント回数。
ba_global_max_refinement_change float 0.0005 グローバルバンドル調整の最大リファインメント変更量。
snapshot_path string "" スナップショットの保存パス。
snapshot_images_freq int 0 スナップショットを保存する画像の追加頻度。
image_names set<string> (空) 再構築する画像の名前リスト。指定しない場合は全ての画像。
fix_existing_images bool false 既存の画像を固定してバンドル調整を行うかどうか。

mapper: IncrementalMapperOptions

オプション名 型 デフォルト値 説明
init_min_num_inliers int 100 初期ペアの最小インライア数。
init_max_error float 4.0 初期化の最大エラー。
init_max_forward_motion float 0.95 初期化の最大前方移動量。
init_min_tri_angle float 16.0 初期化の最小三辺測量角度。
init_max_reg_trials int 2 初期登録の最大試行回数。
abs_pose_max_error float 12.0 絶対姿勢推定の最大エラー。
abs_pose_min_num_inliers int 30 絶対姿勢推定の最小インライア数。
abs_pose_min_inlier_ratio float 0.25 絶対姿勢推定の最小インライア比率。
abs_pose_refine_focal_length bool true 絶対姿勢推定で焦点距離を最適化するかどうか。
abs_pose_refine_extra_params bool true 絶対姿勢推定で追加のカメラパラメータを最適化するかどうか。
local_ba_num_images int 6 ローカルバンドル調整に含まれる画像の数。
local_ba_min_tri_angle float 6.0 ローカルバンドル調整の最小三辺測量角度。
min_focal_length_ratio float 0.1 最小焦点距離比率。
max_focal_length_ratio float 10.0 最大焦点距離比率。
max_extra_param float 1.0 最大追加パラメータ値。
filter_max_reproj_error float 4.0 フィルタリングの最大再投影エラー。
filter_min_tri_angle float 1.5 フィルタリングの最小三辺測量角度。
max_reg_trials int 3 登録の最大試行回数。
fix_existing_images bool false 既存の画像を固定してバンドル調整を行うかどうか。
num_threads int -1 使用するスレッド数。-1の場合は自動設定。
image_selection_method enum MIN_UNCERTAINTY 画像選択方法。

triangulation: IncrementalTriangulatorOptions

オプション名 型 デフォルト値 説明
max_transitivity int 1 三辺測量の最大推移回数。
create_max_angle_error float 2.0 三辺測量作成の最大角度エラー。
continue_max_angle_error float 2.0 三辺測量継続の最大角度エラー。
merge_max_reproj_error float 4.0 三辺測量マージの最大再投影エラー。
complete_max_reproj_error float 4.0 三辺測量完了の最大再投影エラー。
complete_max_transitivity int 5 完了した三辺測量の最大推移回数。
re_max_angle_error float 5.0 再三辺測量の最大角度エラー。
re_min_ratio float 0.2 再三辺測量の最小比率。
re_max_trials int 1 再三辺測量の最大試行回数。
min_angle float 1.5 最小三辺測量角度。
ignore_two_view_tracks bool true 2ビューのトラックを無視して三辺測量を行うかどうか。
min_focal_length_ratio float 0.1 最小焦点距離比率。
max_focal_length_ratio float 10.0 最大焦点距離比率。
max_extra_param float 1.0 最大追加パラメータ値。

Discussion