Difference between revisions of "Cpclean"
m (typo) |
m (Add -p and -w options) |
||
| Line 1: | Line 1: | ||
'''cpclean''' is a command-line tool that implements the 'bad' [[control points]] pruning available within the [[Hugin]] GUI. It is similar conceptually to [[apclean]], but with some extra functionality. Both tools use a statistical filter to remove points with an error above a statistical threshold. | '''cpclean''' is a command-line tool that implements the 'bad' [[control points]] pruning available within the [[Hugin]] GUI. It is similar conceptually to [[apclean]], but with some extra functionality. Both tools use a statistical filter to remove points with an error above a statistical threshold. | ||
| − | The idea is to remove all non-credible control points. To do this it optimises each pair of photos one at a time and deletes all points that can't be made to fit | + | The idea is to remove all non-credible control points. To do this it uses a two step process to remove bad control points. |
| + | |||
| + | ===Step 1=== | ||
| + | optimises each pair of photos one at a time and deletes all points that can't be made to fit. | ||
| + | |||
| + | ===Step 2=== | ||
| + | optimises the whole project together using more conservative assumptions and deletes another round of points. | ||
| + | |||
| + | ===result=== | ||
| + | The .pto project file is returned unoptimised, the only change is that there are less control points, this means the project doesn't have to be optimised before you start. | ||
By using this optimisation step '''cpclean''' is able to look not just at the current project settings and find 'bad' points, but is able to find points that are 'bad' under a range of circumstances. | By using this optimisation step '''cpclean''' is able to look not just at the current project settings and find 'bad' points, but is able to find points that are 'bad' under a range of circumstances. | ||
| + | ===usage=== | ||
A typical usage would be: | A typical usage would be: | ||
cpclean -o output.pto project.pto | cpclean -o output.pto project.pto | ||
| + | ===Options=== | ||
Vary the threshold with the -n parameter (defaults to 2, i.e. points with a distance error greater than twice the standard deviation are deleted): | Vary the threshold with the -n parameter (defaults to 2, i.e. points with a distance error greater than twice the standard deviation are deleted): | ||
cpclean -n 1 -o output.pto project.pto | cpclean -n 1 -o output.pto project.pto | ||
| + | |||
| + | Do only pairwise optimisation (skip step 2): | ||
| + | |||
| + | cpclean -p -o output.pto project.pto | ||
| + | |||
| + | Do only whole panorama optimasation (skip step 1): | ||
| + | |||
| + | cpclean -w -o output.pto project.pto | ||
| + | |||
'''cpclean''' is based on [[ptoclean]]. | '''cpclean''' is based on [[ptoclean]]. | ||
Revision as of 23:33, 26 May 2011
cpclean is a command-line tool that implements the 'bad' control points pruning available within the Hugin GUI. It is similar conceptually to apclean, but with some extra functionality. Both tools use a statistical filter to remove points with an error above a statistical threshold.
The idea is to remove all non-credible control points. To do this it uses a two step process to remove bad control points.
Step 1
optimises each pair of photos one at a time and deletes all points that can't be made to fit.
Step 2
optimises the whole project together using more conservative assumptions and deletes another round of points.
result
The .pto project file is returned unoptimised, the only change is that there are less control points, this means the project doesn't have to be optimised before you start.
By using this optimisation step cpclean is able to look not just at the current project settings and find 'bad' points, but is able to find points that are 'bad' under a range of circumstances.
usage
A typical usage would be:
cpclean -o output.pto project.pto
Options
Vary the threshold with the -n parameter (defaults to 2, i.e. points with a distance error greater than twice the standard deviation are deleted):
cpclean -n 1 -o output.pto project.pto
Do only pairwise optimisation (skip step 2):
cpclean -p -o output.pto project.pto
Do only whole panorama optimasation (skip step 1):
cpclean -w -o output.pto project.pto
cpclean is based on ptoclean.