Differences

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

--- pr0ntools:image_stitching [2012/12/27 21:36] – mcmaster
+++ pr0ntools:image_stitching [2016/12/16 17:44] (current) – mcmaster
@@ Line 1: / Line 1: @@
+FIXME: need to update this page.  In particular:
+  * autopanoaj is no longer used
 ====== Prereqs ======
 ===== Platform =====
-This currently only runs under Linux from a combination of some autopanoaj magic I do and sloppy path construction.  Most things probably run under any UNIX with Python
+Only supported under Linux (tested under Ubuntu 14).  If you find minor tweaks to make it work with others (ie Windows), I'll take them.  But I'm not interested in a large rewrite
 ===== Software =====
@@ Line 12: / Line 17: @@
 Stitching:
   * ImageMagik
-  * WINE
-  * autopanoaj (see section)
-===== autopanoaj =====
-I use Andrew Jenny's control point finder since it gives me a lot better results than autopano-sift-c.  symlink autopanoaj to autopano.exe and make it available in your path.  Use the Windows version through WINE.  The Linux ones are older and I think they had some problem.  In any case tools currently assume that they have to patch up WINE stuff so use the Windows version.
+===== Installing via github =====
+For Ubuntu:
+  - sudo apt-get install -y git hugin
+  - cd ~
+  - git clone https://github.com/JohnDMcMaster/pr0ntools.git
+  - export PYTHONPATH=$PYTHONPATH:~/pr0ntools/pr0ntools
+  - export PATH=$PATH:~/pr0ntools/stitch
+  - alias pr0nstitch=pr0nstitch.py
+  - alias pr0npto=pr0npto.py
+  - alias pr0nhugin=pr0nhugin.py
+  - alias pr0nauto=pr0nauto.py
-===== Installing =====
-I don't currently have a nice installer.  $ROOT/lib/pr0ntools must be in your PYTHONPATH.  For example:
+===== Installing via pip =====
-export PYTHONPATH=$PYTHONPATH:$HOME/pr0ntools/lib
-You probably also want to have the executables in your PATH.  Example:
+Probably too outdated to be useful.  Don't use
-export PATH=$PATH:$HOME/pr0ntools/stitch
 ===== Assumptions and notes =====
-A lot of this can be done much easier and more intuitively if you have a small project through Hugin.  More than likely you aren't doing this because you have a small project though and so I'll expect you are at least basically familiar with Hugin and can make the judgment call as to if you should just use Hugin for a particular step
+Although these tools are meant for very large stitches, this tutorial uses a small project.  Use this to get familiar with the workflow to avoid (time) costly mistakes in large stitches.
+"$" indicates a command to execute.  For example "$ ls" means type ls followed by enter in the terminal
+====== Quickstart ======
-I will use out.pto as the project name, you can use whatever you want
+Do:
+  - $ Make sure you already setup the tools as indicated above
+  - $ cd ~
+  - Get test data
+    - $ wget https://siliconpr0n.org/map/ad/ad534/ad_ad534_mz_mit20x_raw.tar.bz2
+    - $ tar -xf ad_ad534_mz_mit20x_raw.tar.bz2
+    - $ cd ad_ad534_mz_mit20x_raw.
+  - $ pr0nauto
+  - Hugin GUI
+    - GUI should open on a special reduced project (center will be missing)
+    - Crop and rotate to your desire
+    - TODO: add additional details how to do this
+    - TODO: fix bug / add note about bad pr0nauto
+  - $ pr0nts
+  - Directory outputs
+    * single: a .jpg with of the entire ROI selected in Hugin
+    * st: "supertiles", one more intermediate partial .jpgs.  In this example there will probably be only one
+    * out: Google map tiles that can be ingested by pr0nmap
-pr0npto has the form pr0npto <input> <output>  I'll use the replace version here for simplicity but for safety you might consider creating a new project at each step since previous steps can take some time in case something goes wrong
 ====== Step 1: acquire images ======