Differences

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

--- pr0ntools:image_stitching [2016/09/08 12:04] – mcmaster
+++ pr0ntools:image_stitching [2016/12/16 17:44] (current) – mcmaster
@@ Line 7: / Line 7: @@
 ===== Platform =====
-Only supported under Linux.  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
+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
@@ Line 21: / Line 21: @@
 ===== Installing via github =====
-FIXME
+For Ubuntu:
+  - sudo apt-get install -y git hugin
-I don't currently have a nice installer.  $ROOT/lib/pr0ntools must be in your PYTHONPATH.  For example:
+  - cd ~
-export PYTHONPATH=$PYTHONPATH:$HOME/pr0ntools/lib
+  - git clone https://github.com/JohnDMcMaster/pr0ntools.git
+  - export PYTHONPATH=$PYTHONPATH:~/pr0ntools/pr0ntools
-You probably also want to have the executables in your PATH.  Example:
+  - export PATH=$PATH:~/pr0ntools/stitch
-export PATH=$PATH:$HOME/pr0ntools/stitch
+  - alias pr0nstitch=pr0nstitch.py
+  - alias pr0npto=pr0npto.py
+  - alias pr0nhugin=pr0nhugin.py
+  - alias pr0nauto=pr0nauto.py
@@ Line 37: / Line 40: @@
 ===== 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 ======