.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "GEOCPSET ""1"""
.TH GEOCPSET "1" "2022-09-16" """Version: 2021.0.0""" "HUGIN"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
geocpset \- adds control points based on geometric position
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBgeocpset\fR [\fI\-o output.pto\fR] \fIinput.pto\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBgeocpset\fR is a tool for panoramas which contains featureless images, e.g.
sky images. In this images a control point detector does not find control
points. \fBgeocpset\fR analyses the positions of the images in project files.
Then it adds control points to these images which are not connected by
control points. The control points are set only be the geometric positions
of the images and not by the image content. So \fBgeocpset\fR should only
used with projects which have assigned rough image positions.
.SH "USAGE"
.IX Header "USAGE"
.IP " \fBgeocpset\fR \fI\-o output.pto\fR \fIinput.pto\fR" 4
.IX Item " geocpset -o output.pto input.pto"
.PP
If the \fI\-\-output/\-o\fR switch is missing then the suffix \*(L"_geo\*(R" is added to
the filename.
.PP
The indented workflow is
.IP "#1 First create project file" 4
.IX Item "#1 First create project file"
pto_gen \-o project.pto *.jpg
.IP "#2 Then assign rough positions to images" 4
.IX Item "#2 Then assign rough positions to images"
pto_var \-\-set y=i*20\-40,p=0,r=0 \-o project.pto project.pto
.ie n .IP "#3 Now run a ""normal"" control point detector, e.g. only on overlapping images" 4
.el .IP "#3 Now run a ``normal'' control point detector, e.g. only on overlapping images" 4
.IX Item "#3 Now run a normal control point detector, e.g. only on overlapping images"
cpfind \-\-prealigned \-o project.pto project.pto
.IP "#4 And finally connect all unconnected images" 4
.IX Item "#4 And finally connect all unconnected images"
geocpset \-o project.pto project.pto
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-o|\-\-output\fR \fIoutput.pto\fR" 4
.IX Item "-o|--output output.pto"
Output a pto file with the given filename. If not given it will append
\&\*(L"_geo\*(R" to the input filename.
.IP "\fB\-e|\-\-each\-overlap\fR" 4
.IX Item "-e|--each-overlap"
By default \fBgeocpset\fR adds only control points to unconnected images.
With this switch you can force to add a geometric control point to each
overlap, which is not connect by control points or linked with image
positions.
.IP "\fB\-\-min\-overlap=NUM\fR" 4
.IX Item "--min-overlap=NUM"
By default \fBgeocpset\fR takes only image pairs into account which overlap
more than 10 %. If you have very narrow overlaps you can decrease this
value to take also such small overlaps into account, e.g.
\&\fB\-\-min\-overlap=1\fR
.IP "\fB\-h|\-\-help\fR" 4
.IX Item "-h|--help"
Display help.
.SH "AUTHORS"
.IX Header "AUTHORS"
\&\fBgeocpset\fR was written by Thomas Modes. This manpages was generated by
converting the wiki-page on <http://wiki.panotools.org/> to pod-format by
Andreas Metzler.