Differences

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

--- pr0ntools:cfcv:pr0nsweeper [2015/07/13 07:14] – [Grid errors] mcmaster
+++ pr0ntools:cfcv:pr0nsweeper [2015/07/16 06:20] (current) – [Running] mcmaster
@@ Line 3: / Line 3: @@
 This page is about the pr0nsweeper Python GUI that allows a human to quickly review and fix CV results.
-Although this page is public its not advertised.  I would like to keep it low profile for the time being until the suite is more mature.
+Proof of concept stage / not intended for general use.
 ====== Keyboard and mouse quick summary ======
@@ Line 56: / Line 57: @@
 Left clicking is metal oriented: it turns tiles into metal.  if the tile is already metal, it turns it into unknown.  Similarly, right clicking is void oriented.
+You may click on either the grid on the left or the image on the right.
 {{:pr0ntools:cfcv:pr0nsweeper:group-pre.png?100}}
@@ Line 81: / Line 85: @@
 {{:pr0ntools:cfcv:pr0nsweeper:grid_error.png?450}}
-Above: minor grid error visible in the upper left and lower right corner
+Above: Y grid error visible in the upper left and lower right corner
 If the grid is detected incorrectly it will disrupt metal detection.  In the above example, the Y grid offset is very poor (although the pitch is correct).  Correct errors like above by biasing the grid to a particular direction, using the same bias for the entire image.  For example, make the lower unknowns metal and the upper unknowns void.  Suggest using this convention (lower => metal, upper => void) if its unclear which direction the correction should be applied.
@@ Line 102: / Line 106: @@
 There's still a lot that can be done with the computer vision preprocessing.  The current suite is somewhat optimized for the references images: to be seen how well it will apply to other data sets (ex: SEM images).
+====== Running ======
+Ubuntu 12.04x64
+sudo apt-get install -y python-qt4 python-imaging python-pyicu
+git clone https://github.com/JohnDMcMaster/pr0ntools.git
+cd cf/sweeper
+python sweeper.py --host sketchyurl.com
+====== Backend ======
+This is for informational purposes only.  Its not required to use the pr0nsweeper GUI.
+Data is collected using [[mcmaster:tech_inst:k2_ind|my confocal microscope]].  It is not stitched or preprocessed in any way.
+The core CV engine is in cfcv.py.  This basically performs the following steps:
+  * Straighten image
+  * Determine design grid
+  * Calculate metal and void thresholds
+  * Apply thresholds to image
+  * Munge output to try to heuristically correct errors
+cfcv_batch.py is a batch processor around the engine that allows, for example, running jobs in parallel.
+Once cfcv_batch.py completes the output directory is fed into the pr0nsweeper job distribution server, server.py.  When a client requests an image it grabs one from the output directory and feeds it to the client.  The client suggests changes to the image and then sends it back to the server where the results are recorded.