📄
src/feature_extractor.rs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
use std::path::{Path, PathBuf}; use anyhow::{Context, Result}; use image::imageops::FilterType; use ndarray::Array4; use ort::session::Session; use ort::value::TensorRef; use walkdir::WalkDir; use crate::database; use crate::models::{self, Device}; use crate::progress; pub struct FeatureExtractorConfig { pub database_path: PathBuf, pub image_path: PathBuf, pub aliked_model: PathBuf, pub top_k: usize, pub image_size: u32, pub device: Device, } struct Preprocessed { tensor: Array4<f32>, orig_width: u32, orig_height: u32, } const IMAGE_EXTENSIONS: [&str; 3] = ["jpg", "jpeg", "png"]; fn collect_image_paths(root: &Path) -> Result<Vec<PathBuf>> { let mut paths: Vec<PathBuf> = WalkDir::new(root) .into_iter() .filter_map(|e| e.ok()) .filter(|e| e.file_type().is_file()) .filter(|e| { e.path() .extension() .and_then(|s| s.to_str()) .map(|s| IMAGE_EXTENSIONS.iter().any(|ext| ext.eq_ignore_ascii_case(s))) .unwrap_or(false) }) .map(|e| e.path().to_path_buf()) .collect(); // Sorted so image_id assignment order matches filename order, which colmap mapper expects. paths.sort(); Ok(paths) } /// Letterbox-resizes (top-left aligned, matching the ALIKED-LightGlue-ONNX reference /// implementation) into an `image_size` x `image_size` canvas and produces an NCHW RGB /// float32 tensor normalized to [0, 1]. fn preprocess(path: &Path, image_size: u32) -> Result<Preprocessed> { let img = image::open(path) .with_context(|| format!("opening image {}", path.display()))? .into_rgb8(); let (w, h) = img.dimensions(); if w == 0 || h == 0 { anyhow::bail!("image {} has zero dimension", path.display()); } let resize_scale = (image_size as f32 / h as f32).min(image_size as f32 / w as f32); let w_new = ((w as f32 * resize_scale) as u32).clamp(1, image_size); let h_new = ((h as f32 * resize_scale) as u32).clamp(1, image_size); let resized = image::imageops::resize(&img, w_new, h_new, FilterType::Triangle); let size = image_size as usize; let mut tensor = Array4::<f32>::zeros((1, 3, size, size)); for y in 0..h_new { for x in 0..w_new { let px = resized.get_pixel(x, y); for c in 0..3 { tensor[[0, c, y as usize, x as usize]] = px[c] as f32 / 255.0; } } } Ok(Preprocessed { tensor, orig_width: w, orig_height: h, }) } /// (keypoints in normalized [-1,1] canvas coordinates, flat row-major descriptors [n x 128], per-keypoint scores) type AlikedOutput = (Vec<[f32; 2]>, Vec<f32>, Vec<f32>); /// Runs ALIKED on a preprocessed tensor. fn run_aliked(session: &mut Session, tensor: &Array4<f32>) -> Result<AlikedOutput> { let input = TensorRef::from_array_view(tensor)?; let outputs = session.run(ort::inputs![input])?; let kpts_val = outputs .get("keypoints") .ok_or_else(|| models::missing_output_err("keypoints", &outputs))?; let (_kpts_shape, kpts_data) = kpts_val.try_extract_tensor::<f32>()?; let keypoints: Vec<[f32; 2]> = kpts_data.chunks_exact(2).map(|c| [c[0], c[1]]).collect(); let desc_val = outputs .get("descriptors") .ok_or_else(|| models::missing_output_err("descriptors", &outputs))?; let (_desc_shape, desc_data) = desc_val.try_extract_tensor::<f32>()?; let scores_val = outputs .get("scores") .ok_or_else(|| models::missing_output_err("scores", &outputs))?; let (_scores_shape, scores_data) = scores_val.try_extract_tensor::<f32>()?; Ok((keypoints, desc_data.to_vec(), scores_data.to_vec())) } pub fn run(cfg: FeatureExtractorConfig) -> Result<()> { let conn = database::open(&cfg.database_path)?; let mut session = models::load_session(&cfg.aliked_model, cfg.device)?; let paths = collect_image_paths(&cfg.image_path)?; if paths.is_empty() { anyhow::bail!("no images found under {}", cfg.image_path.display()); } println!("Found {} images under {}", paths.len(), cfg.image_path.display()); let pb = progress::new(paths.len() as u64, "images"); for (idx, path) in paths.iter().enumerate() { let rel_name = path .strip_prefix(&cfg.image_path) .unwrap_or(path) .to_string_lossy() .replace('\\', "/"); let pre = preprocess(path, cfg.image_size)?; let camera_id = database::get_or_create_camera(&conn, pre.orig_width, pre.orig_height)?; let image_id = database::insert_image(&conn, &rel_name, camera_id)?; let (keypoints, descriptors_flat, scores) = run_aliked(&mut session, &pre.tensor)?; let n = keypoints.len(); let desc_dim = if n == 0 { 128 } else if descriptors_flat.len() % n == 0 { descriptors_flat.len() / n } else { anyhow::bail!( "{}: descriptor count ({}) doesn't divide evenly by keypoint count ({})", rel_name, descriptors_flat.len(), n ); }; // The ONNX model already caps output count near its export-time top-k; this only // trims further if more keypoints than requested were returned. let keep: Vec<usize> = if n > cfg.top_k { let mut top: Vec<usize> = (0..n).collect(); top.sort_unstable_by(|&a, &b| scores[b].partial_cmp(&scores[a]).unwrap()); top.truncate(cfg.top_k); top.sort_unstable(); top } else { (0..n).collect() }; let max_dim = pre.orig_width.max(pre.orig_height) as f32; let mut kpt_rows = Vec::with_capacity(keep.len()); let mut desc_rows = Vec::with_capacity(keep.len() * desc_dim); for &i in &keep { let [x, y] = keypoints[i]; // ALIKED's exported graph outputs keypoints normalized to [-1, 1] over the padded // square canvas; this maps directly back to original pixel coordinates. let x_orig = (x + 1.0) * max_dim / 2.0; let y_orig = (y + 1.0) * max_dim / 2.0; kpt_rows.push([x_orig, y_orig, 0.0, 0.0]); desc_rows.extend_from_slice(&descriptors_flat[i * desc_dim..(i + 1) * desc_dim]); } if idx == 0 && !kpt_rows.is_empty() { // Diagnostic: print both the raw ALIKED output range and the actual denormalized // pixel-space range this code computes from it, using the real formula/data // (not a hand-derived estimate), to check both the [-1,1] assumption and the // arithmetic against the actual image dimensions. let (mut rx_min, mut rx_max) = (f32::INFINITY, f32::NEG_INFINITY); let (mut ry_min, mut ry_max) = (f32::INFINITY, f32::NEG_INFINITY); for &i in &keep { let [x, y] = keypoints[i]; rx_min = rx_min.min(x); rx_max = rx_max.max(x); ry_min = ry_min.min(y); ry_max = ry_max.max(y); } let (mut px_min, mut px_max) = (f32::INFINITY, f32::NEG_INFINITY); let (mut py_min, mut py_max) = (f32::INFINITY, f32::NEG_INFINITY); for &[x, y, ..] in &kpt_rows { px_min = px_min.min(x); px_max = px_max.max(x); py_min = py_min.min(y); py_max = py_max.max(y); } eprintln!( "[diag] {rel_name}: image size {}x{}, max_dim={max_dim}", pre.orig_width, pre.orig_height ); eprintln!("[diag] raw ALIKED range: x=[{rx_min:.4}, {rx_max:.4}] y=[{ry_min:.4}, {ry_max:.4}]"); eprintln!( "[diag] denormalized pixel range written to DB: x=[{px_min:.1}, {px_max:.1}] y=[{py_min:.1}, {py_max:.1}]" ); } database::write_keypoints(&conn, image_id, &kpt_rows)?; database::write_descriptors(&conn, image_id, keep.len(), desc_dim, &desc_rows)?; pb.inc(1); } pb.finish(); Ok(()) }