Differences

This shows you the differences between two versions of the page.

--- pr0ntools:pr0nts [2012/02/18 08:38] – mcmaster
+++ pr0ntools:pr0nts [2016/06/27 15:03] (current) – [BBB/machinekit] mcmaster
@@ Line 4: / Line 4: @@
   * Single: cut up a single input image
   * Project:
+====== Input files ======
+I think there is an artificial requirement that the input images be tagged with row and col information (ex: y0123_x031.jpg).  I believe the stitcher either doesn't use this information (it relies on nona to do the clipping) or could easily be worked around as a slightly less optimized version.  If you are interested in using this tool but this is in your way talk to me and I can probably remove this requirement without too much effort.
 ====== Configuration ======
@@ Line 50: / Line 54: @@
     --ignore-errors       skip broken tile stitches (advanced)
+====== Choosing optimial supertile size ======
+The ideal supertile is the entire output panorama.  That is you stich a single image from all of the source images and then chop it up.  Unfortunately, this image may be too big to fit into your system or at least force you into swapping and result in abysmal performance.
+I'd like to add an option that tries to optimize based on how much memory you feed it but nothing like that exists as of today.
+On my production machine I have 12 GB of memory.  2 GB is plenty fine to run the system so I allocate 10 GB for stitching.  A 6 X 6 3264 X 2448 image takes up 90% of 12 GB or 9.6 GB on my system.  However, its important to generate as few supertiles as possible so yo might be better off sacrificing width for high or vice versa, especially if you have an oddly shaped image.  Take advantage of the pre-stitch dry run to play around with the image dimensions to cut down on stitching type.  Even by guess and check you should be able to cut significant time off of the stitch if you are creating an extra supertile row or col and could slightly trim it.
 ====== Examples ======
@@ Line 63: / Line 75: @@
 pr0nts --clip-width 3264 --clip-height 2448 --stw=$[3264 * 5] --sth=$[2448 * 6] out.pto --merge --ignore-errors
-Note my camera takes 3264 X 2448 images.  Don't stitch 3264 x units on each side overlapping another image and 2448 in the y direction.  Supertiles should be 16320 X 14688 pixels.  Use out.pto to determine stitch parameters and merge with the existing output.  If a command fails skip that supertile and try the next.
+Note my camera takes 3264 X 2448 images.  Don't stitch 3264 x units on each side overlapping another image and 2448 in the y direction.  Supertiles should be 16320 X 14688 pixels.  Use out.pto to determine stitch parameters and merge with the existing output.  If a command fails skip that supertile and try the next.  Note that the supertile dimensions don't have anything to do with the input image dimensions, its just a good heuristic that's easy to visualize.  In practice you should be able to fit quite a few more images in that space than raw image size due to overlap.
@@ Line 72: / Line 84: @@
 {{gallery>:pr0ntools:stitch:poor_opt.png?200}}
-Changes are your project is poorly optimized.  You should be able to get an RMS error of < 5 without too much trouble and for good results it should be < 1.
+Chances are your project is poorly optimized.  You should be able to get an RMS error of < 5 without too much trouble and for good results it should be < 1.  In the above example there are two errors: tiles don't line up and seams appear within tiles.  The second occurs because images are conflicting and enblend can't chose a good seam.  The first error occurs because these poor seems may be chosen differently between supertiles.  You might be able to mitigate this by choosing a larger clip size but you should really fix your optimization.
@@ Line 82: / Line 94: @@
+===== Enblend fails =====
+Usually enblend will fail from out of memory.  Try reducing the supertile size.  nona only uses as much memory as your largest single image so it shouldn't be a problem.
+====== Tile size ======
+I chose 250x250 because that's what Google maps default is.  I think I put in command line to change that as needed but its not well tested.
+====== BBB/machinekit ======
+<code>
+echo >>~/.ssh/config <<EOF
+Host mk
+User machinekit
+EOF
+sudo tee -a /etc/hosts <<EOF
+.168.7.2     mk
+EOF
+# TODO: how to set static network config auto?
+# Need 192.168.7.1 / 30 IIRC
+</code>