Skip to content

Commit 792f031

Browse files
correct time-sift formatting
1 parent 325aefe commit 792f031

File tree

1 file changed

+13
-33
lines changed

1 file changed

+13
-33
lines changed

source/map-accuracy.rst

Lines changed: 13 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -270,10 +270,9 @@ When previously mapped sites need revisited, OpenDroneMap can align multiple ver
270270
Animated gif comparing two separately processed, but aligned digital surface models.
271271

272272
Plugin Time-SIFT
273-
================
273+
----------------
274274

275-
This script does Time-SIFT processing with ODM. Time-SIFT is a method
276-
for multi-temporal analysis without the need to co-registrate the data.
275+
The script at contrib/time-sift in the ODM repository does Time-SIFT processing with ODM. Time-SIFT is a method for multi-temporal analysis without the need to co-registrate the data.
277276

278277
D. Feurer, F. Vinatier, Joining multi-epoch archival aerial images in
279278
a single SfM block allows 3-D change detection with almost
@@ -283,7 +282,7 @@ for multi-temporal analysis without the need to co-registrate the data.
283282
(https://doi.org/10.1016/j.isprsjprs.2018.10.016)
284283

285284
Requirements
286-
------------
285+
============
287286

288287
- ODM ! :-)
289288
- subprocess
@@ -296,13 +295,12 @@ Requirements
296295
- textwrap
297296

298297
Usage
299-
-----
298+
=====
300299

301300
Provided example
302-
~~~~~~~~~~~~~~~~
301+
================
303302

304-
Download or clone `this
305-
repo <https://forge.inrae.fr/Denis.Feurer/timesift-odm-data-example.git>`__
303+
Download or clone `this repo <https://forge.inrae.fr/Denis.Feurer/timesift-odm-data-example.git>`__
306304
to get example data.
307305

308306
Then execute
@@ -311,34 +309,19 @@ Then execute
311309

312310
python Timesift_odm.py datasets --end-with odm_filterpoints
313311

314-
It should make the Time-SIFT processing on the downloaded example data,
315-
stopping after the filtered dense clouds step.
312+
It should make the Time-SIFT processing on the downloaded example data, stopping after the filtered dense clouds step.
316313

317-
In the destination dir, you should obtain new directories, ``0_before``
318-
and ``1_after`` at the same level as the ``time-sift-block`` directory.
319-
These new directories contain all the results natively co-registered.
314+
In the destination dir, you should obtain new directories, ``0_before`` and ``1_after`` at the same level as the ``time-sift-block`` directory. These new directories contain all the results natively co-registered.
320315

321-
You can then use `CloudCompare <https://cloudcompare.org/>`__ to compute
322-
distance between the
323-
``datasets/0_before/odm_filterpoints/point_cloud.ply`` and the
324-
``datasets/1_after/odm_filterpoints/point_cloud.ply`` and obtain this
325-
image showing the difference between the two 3D surfaces. Here, two soil
326-
samples were excavated as can be seen on the image below. |image1|
316+
You can then use `CloudCompare <https://cloudcompare.org/>`__ to compute distance between the ``datasets/0_before/odm_filterpoints/point_cloud.ply`` and the ``datasets/1_after/odm_filterpoints point_cloud.ply`` and obtain this image showing the difference between the two 3D surfaces. Here, two soil samples were excavated as can be seen on the image below. |image1|
327317

328318
Your own data
329319
~~~~~~~~~~~~~
330320

331-
In your dataset directory (usually ``datasets``, but you can have chosen
332-
another name) you have to prepare a Time-SIFT project directory (default
333-
name : ``time-sift-block``, *can be tuned via a parameter*) that
334-
contains : \* ``images/`` : a subdirectory with all images of all
335-
epochs. This directory name is fixed as it is the one expected by ODM \*
336-
``images_epochs.txt`` : a file that has the same format as the file used
337-
for the split and merge ODM function. This file name *can be tuned via a
338-
parameter*.
321+
In your dataset directory (usually ``datasets``, but you can have chosen another name) you have to prepare a Time-SIFT project directory (default name : ``time-sift-block``, *can be tuned via a parameter*) that contains : \* ``images/`` : a subdirectory with all images of all epochs. This directory name is fixed as it is the one expected by ODM \*
322+
``images_epochs.txt`` : a file that has the same format as the file used for the split and merge ODM function. This file name *can be tuned via a parameter*.
339323

340-
The ``images_epochs.txt`` file has two columns, the first column
341-
contains image names and the second contains the epoch name as follows
324+
The ``images_epochs.txt`` file has two columns, the first column contains image names and the second contains the epoch name as follows
342325

343326
::
344327

@@ -358,10 +341,7 @@ Your directory, before running the script, should look like this :
358341
├── images/
359342
└── images_epochs.txt
360343

361-
At the end of the script you obtain a directory by epoch (at the same
362-
level as the Time-SIFT project directory). Each directory is processed
363-
with images of each epoch and all results are natively co-registered due
364-
to the initial sfm step done with all images.
344+
At the end of the script you obtain a directory by epoch (at the same level as the Time-SIFT project directory). Each directory is processed with images of each epoch and all results are natively co-registered due to the initial sfm step done with all images.
365345

366346
::
367347

0 commit comments

Comments
 (0)