Fulla

From PanoTools.org Wiki
(Difference between revisions)
Jump to: navigation, search
m (PTLens database lookup: corrected windows)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Glossary|a command line tool to batch correct [[Chromatic aberration]], [[Lens correction model|Lens distortion]] and [[Vignetting]]}}'''fulla''' is a command-line tool distributed with [[hugin]] 0.6 and later. It is suitable for batch correction of:
+
{{Glossary|a command line tool to batch correct [[Chromatic aberration]], [[Lens correction model|Lens distortion]] and [[Vignetting]]}}'''fulla''' is a command-line tool distributed with [[hugin]]. It can correct chromatic aberration, lens distortion, and vignetting.
 +
 
 +
== About fulla ==
 +
fulla is suitable for batch correction of:
  
 
;[[Chromatic aberration]]: See tutorial in [[#External links|external links]].
 
;[[Chromatic aberration]]: See tutorial in [[#External links|external links]].
Line 11: Line 14:
 
   Usage: fulla [options] inputfile(s)
 
   Usage: fulla [options] inputfile(s)
 
   option are:
 
   option are:
       -g a:b:c:d       Radial distortion coefficient for all channels, (a, b, c, d)
+
       --green=db|a:b:c:d Correct radial distortion for all channels
       -b a:b:c:d       Radial distortion coefficients for blue channel, (a, b, c, d)
+
                            Specifiy 'db' for database lookup or
                        this is applied on top of the -g distortion coefficients,
+
                            the 4 coefficients a:b:c:d
                        use for TCA corr
+
       --blue=db|a:b:c:d   Correct radial distortion for blue channel,
       -r a:b:c:d       Radial distortion coefficients for red channel, (a, b, c, d)
+
                            this is applied on top of the --green
                        this is applied on top of the -g distortion coefficients,
+
                            distortion coefficients, use for TCA corr
                        use for TCA corr
+
                            Specifiy 'db' for database lookup or
      -p              Try to read radial distortion coefficients for green
+
                            the 4 coefficients a:b:c:d
                        channel from PTLens database
+
       --red=db|a:b:c:d   Correct radial distortion for red channel,
       -m Canon        Camera manufacturer, for PTLens database query
+
                            this is applied on top of the --green
       -n Camera        Camera name, for PTLens database query
+
                            distortion coefficients, use for TCA corr
       -l Lens         Lens name, for PTLens database query
+
                            Specifiy 'db' for database lookup or
                        if not specified, a list of possible lenses is displayed
+
                            the 4 coefficients a:b:c:d
       -d 50           specify focal length in mm, for PTLens database query
+
       --camera-maker=Maker Camera manufacturer, for database query
       -s              do not rescale the image to avoid black borders.
+
       --camera-model=Cam Camera name, for database query
       -f filename     Vignetting correction by flatfield division
+
       --lensname=Lens   Lens name, for database query
                        I = I / c,   c = flatfield / mean(flatfield)
+
                            Specify --camera-maker and --camera-model
       -c a:b:c:d       radial vignetting correction by division:
+
                            for fixed lens cameras or --lensname
                        I = I / c,    c = a + b*r^2 + c*r^4 + d*r^6
+
                            for interchangeable lenses.
       -a              Correct vignetting by addition, rather than by division
+
       --focallength=50   Specify focal length in mm, for database query
                        I = I + c
+
       --aperture=3.5    Specify aperture for vignetting data database query
       -i value         gamma of input data. used for gamma correction
+
      --dont-rescale    Do not rescale the image to avoid black borders.
                        before and after flatfield correction
+
     
       -t n             Number of threads that should be used during processing
+
       --flatfield=filename Vignetting correction by flatfield division
       -h              Display help (this text)
+
                              I = I / c, c = flatfield / mean(flatfield)
       -o name         set output filename. If more than one image is given,
+
       --vignetting=db|a:b:c:d Correct vignetting (by division)
                        the name will be uses as suffix (default suffix: _corr)
+
                            Specify db for database look up or the
       -v              Verbose
+
                            the 4 coefficients a:b:c:d
 +
                              I = I / ( a + b*r^2 + c*r^4 + d*r^6)
 +
       --linear          Do vignetting correction in linear color space
 +
       --gamma=value     Gamma of input data. used for gamma correction
 +
                          before and after flatfield correction
 +
       --threads=n       Number of threads that should be used
 +
       --help            Display help (this text)
 +
       --output=name     Set output filename. If more than one image is given,
 +
                            the name will be uses as suffix
 +
                            (default suffix: _corr)
 +
       --compression=value Compression of the output files
 +
                            For jpeg output: 0-100
 +
                            For tiff output: PACKBITS, DEFLATE, LZW
 +
      --offset=X:Y      Horizontal and vertical shift
 +
      --verbose          Verbose
 +
 
 +
== Notes ==
 +
Finding the correct lens correction parameters can be done using several approaches (see [[Lens correction model]] and external links for details). Note parameter d for radial distortion (default 1.0) is not available in GUI frontends - the d mentioned in frontends is typically a different parameter related to image shift.
  
 
== Windows batch usage ==
 
== Windows batch usage ==
Line 48: Line 68:
 
* Edit ''properties''
 
* Edit ''properties''
 
* Change the ''target'' to include your correction parameters:
 
* Change the ''target'' to include your correction parameters:
   "C:\Program Files\hugin\fulla.exe" -r 0:0:0.00056:1.00015 -b 0:0:-0.00026:1.0011 -c 1:0.20:-0.51:0.2
+
   "C:\Program Files\hugin\fulla.exe" --red=0:0:0.00056:1.00015 --blue=0:0:-0.00026:1.0011 --vignetting=1:0.20:-0.51:0.2
 
* Rename the shortcut to something descriptive like ''fulla-peleng''
 
* Rename the shortcut to something descriptive like ''fulla-peleng''
 
* Now you can correct photos by dragging and dropping them onto the icon
 
* Now you can correct photos by dragging and dropping them onto the icon
 
Expanding on the above example is to create a batchfile in the hugin directory called "fulla.bat" containing the line:
 
FOR %%I IN (%1) DO C:\Program Files\hugin\fulla.exe -p -v -l Standard %%1
 
Assuming the name of the lens in the PTLens Database (see below) is "Standard" (as most are). Now, upon calling from any directory containing pics you can run "C:\Program Files\hugin\fulla.bat *.jpg" having fulla correcting all pics using the parameters retrieved from the PTLens Database mentioned below (don't forget to SET PTLENS_PROFILE)
 
 
== PTLens database lookup ==
 
 
fulla will look-up your camera in a [[PTLens]] database and try to automatically determine [[Lens correction model|Lens correction parameters]] for your pictures. An older free version of the database is required which can be downloaded from sourceforge (see [[#External links|external links]]).
 
 
Use the PTLENS_PROFILE environment variable to specify the location of the PTLens database, for example on Linux or OS X:
 
 
  PTLENS_PROFILE=$HOME/.ptlens/profile.txt
 
 
On Windows something like this should work for a PTLens standard install:
 
 
  set PTLENS_PROFILE=%ProgramFiles%\PTLens\profile.txt
 
 
otherwise enter the full path.
 
  
 
== External links ==
 
== External links ==
  
 
* [http://hugin.sourceforge.net/tutorials/tca/en.shtml Correcting TCA with hugin and fulla]
 
* [http://hugin.sourceforge.net/tutorials/tca/en.shtml Correcting TCA with hugin and fulla]
* [http://sourceforge.net/project/showfiles.php?group_id=77506&package_id=187932 PTLens database download]
+
* [http://sourceforge.net/project/showfiles.php?group_id=77506&package_id=187932 PTLens database download] (April 2006)
 +
** [http://lensfun.berlios.de/ Lensfun] [http://svn.berlios.de/wsvn/lensfun/trunk/data/db/ SVN] includes parameters for many more lenses
 +
* [http://lensfun.berlios.de/lens-calibration/lens-calibration.html How to determine lens correction parameters] - from Lensfun documentation
  
 
[[Category:Software:Platform:Linux]]
 
[[Category:Software:Platform:Linux]]

Latest revision as of 17:52, 15 May 2014

fulla is a command-line tool distributed with hugin. It can correct chromatic aberration, lens distortion, and vignetting.

Contents

[edit] About fulla

fulla is suitable for batch correction of:

Chromatic aberration
See tutorial in external links.
Lens distortion
Barrel or pincushion distortion can be corrected using the same a, b, c and d parameters as other Panorama Tools derived programs.
Vignetting
Polynomial correction by division, addition or flatfield images. hugin contains a vignetting calculator that can use a series of overlapping photographs to determine the likely polynomial required to correct common vignetting problems.

fulla can work with the same range of image types as nona, including 8bit and 16bit TIFF and 32bit floating-point HDR TIFF data.

[edit] Command-line usage

 Usage: fulla [options] inputfile(s)
  option are:
     --green=db|a:b:c:d  Correct radial distortion for all channels
                           Specifiy 'db' for database lookup or
                           the 4 coefficients a:b:c:d
     --blue=db|a:b:c:d   Correct radial distortion for blue channel,
                           this is applied on top of the --green
                           distortion coefficients, use for TCA corr
                           Specifiy 'db' for database lookup or
                           the 4 coefficients a:b:c:d
     --red=db|a:b:c:d    Correct radial distortion for red channel,
                           this is applied on top of the --green
                           distortion coefficients, use for TCA corr
                           Specifiy 'db' for database lookup or
                           the 4 coefficients a:b:c:d
     --camera-maker=Maker Camera manufacturer, for database query
     --camera-model=Cam Camera name, for database query
     --lensname=Lens    Lens name, for database query
                           Specify --camera-maker and --camera-model
                           for fixed lens cameras or --lensname
                           for interchangeable lenses.
     --focallength=50   Specify focal length in mm, for database query
     --aperture=3.5     Specify aperture for vignetting data database query
     --dont-rescale     Do not rescale the image to avoid black borders.
     
     --flatfield=filename  Vignetting correction by flatfield division
                             I = I / c, c = flatfield / mean(flatfield)
     --vignetting=db|a:b:c:d  Correct vignetting (by division)
                           Specify db for database look up or the
                           the 4 coefficients a:b:c:d
                             I = I / ( a + b*r^2 + c*r^4 + d*r^6)
     --linear           Do vignetting correction in linear color space
     --gamma=value      Gamma of input data. used for gamma correction
                          before and after flatfield correction
     --threads=n        Number of threads that should be used
     --help             Display help (this text)
     --output=name      Set output filename. If more than one image is given,
                           the name will be uses as suffix
                           (default suffix: _corr)
     --compression=value Compression of the output files
                           For jpeg output: 0-100
                           For tiff output: PACKBITS, DEFLATE, LZW
     --offset=X:Y       Horizontal and vertical shift
     --verbose          Verbose

[edit] Notes

Finding the correct lens correction parameters can be done using several approaches (see Lens correction model and external links for details). Note parameter d for radial distortion (default 1.0) is not available in GUI frontends - the d mentioned in frontends is typically a different parameter related to image shift.

[edit] Windows batch usage

Once you have calculated fulla parameters as described above, you can create a custom droplet for batch correcting photos like so:

  • Create a Shortcut to fulla.exe by dragging the fulla icon to another directory in Windows explorer
  • Edit properties
  • Change the target to include your correction parameters:
 "C:\Program Files\hugin\fulla.exe" --red=0:0:0.00056:1.00015 --blue=0:0:-0.00026:1.0011 --vignetting=1:0.20:-0.51:0.2
  • Rename the shortcut to something descriptive like fulla-peleng
  • Now you can correct photos by dragging and dropping them onto the icon

[edit] External links

Personal tools
Namespaces

Variants
Actions
Navigation
tools
Tools