Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

doc: Always use alignment-method none with mapprojected data

  • Loading branch information...
commit 34df9992887ca433c2bbe73b4c4c54fcc7891862 1 parent 84c1ab7
@oleg-alexandrov oleg-alexandrov authored
View
35 docs/book/examples.tex
@@ -25,7 +25,7 @@ \section{Guidelines for Selecting Stereo Pairs}
Although images do not need to be map-projected before running the
\texttt{stereo} program, we recommend that you do run {\tt cam2map}
-(or \texttt{cam2map4stereo.py})
+(or \texttt{cam2map4stereo.Hy})
beforehand, especially for image pairs that contain large topographic
variation (and therefore large disparity differences across the
scene, e.g., Valles Marineris). Map-projection is especially necessary
@@ -109,7 +109,7 @@ \subsection{Combating Long Run Times}
The Stereo Pipeline will keep track of how these map-projections affect the camera model, and take them into account when
building up the 3D mesh via triangulation. If you use \texttt{cam2map},
be sure that your \texttt{stereo.default}'s \texttt{alignment-method} is
-set to NONE. Note also that the \texttt{-\/-lat} and \texttt{-\/-lon}
+set to \texttt{none}. Note also that the \texttt{-\/-lat} and \texttt{-\/-lon}
arguments to \texttt{cam2map4stereo.py} can be used to crop your stereo
images, and the \texttt{-\/-resolution} argument can be used to
subsample them.
@@ -259,7 +259,7 @@ \subsubsection*{stereo.default}
The stereo.default example file (appendix \ref{ch:stereodefault})
should apply well to HiRISE. Just set
-\texttt{alignment-method} to \texttt{none} or \texttt{homography} if
+\texttt{alignment-method} to \texttt{none} if
using map-projected imagery. If you are not using map-projected
imagery, set \texttt{alignment-method} to \texttt{homography} or
\texttt{affineepipolar}. The \texttt{corr-kernel} value can usually be
@@ -384,11 +384,10 @@ \subsubsection*{Commands}
\subsubsection*{stereo.default}
-The stereo.default example file (appendix \ref{ch:stereodefault})
-works generally well with all MOC-NA pairs. Just set
-\texttt{alignment-method} to \texttt{homography} or
-\texttt{none} when using projected imagery. If using non-projected use
-\texttt{homography} or \texttt{affineepipolar}.
+The stereo.default example file (appendix \ref{ch:stereodefault}) works
+generally well with all MOC-NA pairs. Just set \texttt{alignment-method}
+to \texttt{none} when using map-projected imagery. If the images are not
+map-projected, use \texttt{homography} or \texttt{affineepipolar}.
\section{Mars Exploration Rovers MER}
@@ -448,7 +447,7 @@ \subsection*{stereo.default}
\begin{center}\begin{minipage}{5.5in}
\begin{Verbatim}[frame=single,fontsize=\small,label=additional settings for MER]
- alignment-method EPIPOLAR
+ alignment-method epipolar
force-use-entire-range
# This deletes points that are too far away
@@ -490,7 +489,7 @@ \subsubsection*{Commands}
\texttt{lronac2mosaic.py} command. This runs \texttt{lronac2isis},
\texttt{lronaccal}, \texttt{lronacecho}, \texttt{spiceinit},
\texttt{noproj}, and \texttt{handmos} to create a stitched unprojected
-image for a single observation. In this example we don't map project
+image for a single observation. In this example we don't map-project
the images as ASP can usually get good results. More aggressive
terrain might require an additional \texttt{cam2map4stereo.py} step.
@@ -504,13 +503,13 @@ \subsubsection*{Commands}
\subsubsection*{stereo.default}
The defaults work generally well with LRO-NAC pairs, so you don't need
-to provide a stereo.default file. Map projecting is optional. When map
-projecting the images use \texttt{alignment-method NONE}, otherwise
-use \texttt{alignment-method AFFINEEPIPOLAR}. Better map project
-results can be achieved by projecting on a higher resolution elevation
-source like the WAC DTM. This is achieved using ISIS command
-\texttt{demprep} and attaching to cube files via \texttt{spiceinit}'s
-SHAPE and MODEL options.
+to provide a stereo.default file. Map-projecting is optional. When
+map-projecting the images use \texttt{alignment-method none}, otherwise
+use \texttt{alignment-method affineepipolar}. Better map-project results
+can be achieved by projecting on a higher resolution elevation source
+like the WAC DTM. This is achieved using the ISIS command \texttt{demprep}
+and attaching to cube files via \texttt{spiceinit}'s SHAPE and MODEL
+options.
\section{Apollo 15 Metric Camera Images}
@@ -737,7 +736,7 @@ \subsubsection*{stereo.default}
\begin{center}\begin{minipage}{5.5in}
\begin{Verbatim}[frame=single,fontsize=\small,label=stereo.default for Cassini ISS]
### PREPROCESSING
- alignment-method None
+ alignment-method none
force-use-entire-range
individually-normalize
View
6 docs/book/outputfiles.tex
@@ -10,7 +10,7 @@ \chapter{Guide to Output Files}
\begin{description}
\item[*.vwip \textnormal{- image feature files}] \hfill \\
- If \texttt{alignment-method homography} is enabled, the Stereo
+ If \texttt{alignment-method} is not \texttt{none}, the Stereo
Pipeline will automatically search for image features to use for
tie-points. Raw image features are stored in \texttt{*.vwip} files;
one per input image. For example, if your images are
@@ -59,7 +59,7 @@ \chapter{Guide to Output Files}
\item[*-align-R.exr \textnormal{- right pre-alignment matrix}] \hfill \\
The $3 \times 3$ affine transformation matrices that are used to warp
the left and right images to roughly align them. These files are only
- generated if \texttt{alignment-method homography} is enabled in the {\tt
+ generated if \texttt{alignment-method} is not \texttt{none} in the {\tt
stereo.default} file. Normally, a single transform is enough to warp one
image to another (for example, the right image to the left). The reason
we use two transforms is the following: after the right image is warped
@@ -84,7 +84,7 @@ \chapter{Guide to Output Files}
been rejected by the sub-pixel matching process.
\item[*-F-corrected.tif \textnormal{- intermediate data product}] \hfill \\
- Only created when \texttt{alignment-method homography} is on.
+ Only created when \texttt{alignment-method} is not \texttt{none}.
This is \texttt{*-F.tif} with effects of interest point alignment removed.
\item[*-F.tif \textnormal{- filtered disparity map}] \hfill \\
View
14 docs/book/tutorial.tex
@@ -91,13 +91,13 @@ \subsection{Loading and Calibrating Images using ISIS}
\subsection{Aligning Images}
\label{sec:AligningImages}
-The images also need to be rectified (or aligned). There are many
-ways to do this (for example, by setting \texttt{alignment-method} in \texttt{stereo}'s
-\texttt{stereo.default} file, as described in section
-\ref{settingoptionsinstereodefault}). The most straightforward
-process is to align the images by map-projecting them in \ac{ISIS}.
-This example continues with the files from above, \texttt{E0201461.cub}
-and \texttt{M010015.cub}.
+The images also need to be rectified (or aligned). There are many ways
+to do this (for example, by setting \texttt{alignment-method} in
+\texttt{stereo}'s \texttt{stereo.default} file, as described in section
+\ref{settingoptionsinstereodefault}). The most straightforward process
+is to align the images by map-projecting them in \ac{ISIS}. This
+example continues with the files from above, \texttt{E0201461.cub} and
+\texttt{M010015.cub}.
This section describes the theory behind doing each of these steps,
but we also provide the \texttt{cam2map4stereo.py} program (page
Please sign in to comment.
Something went wrong with that request. Please try again.