SDAPS
*****

.. highlight:: bash

data acquisition with paper-based surveys

http://sdaps.org/

irc #sdaps on freenode

Sample
======

Download :download:`misc/assessment.tex` to see examples of ``vspace``,
circular checkboxes, ``noinfo``, questionnaire ID, ``stamp`` and fixed height
text boxes.

Dev
===

::

  git clone https://github.com/sdaps/sdaps.git
  cd sdaps

  sudo apt-get install python-distutils-extra
  sudo apt-get install python-cairo-dev
  sudo apt-get install libtiff5-dev
  sudo apt-get install python-zbar

  mkvirtualenv --system-site-packages sdaps

  workon sdaps
  python ./setup.py build

  # download 'example.tex' from http://sdaps.org/Documentation/Tutorial
  # to the source folder.

  workon sdaps
  mkdir ~/repo/temp/sdaps

  python sdaps.py ~/repo/temp/sdaps/example setup_tex example.tex
  # if the command fails, remove the temp folder each time
  # rmdir ~/repo/temp/sdaps/example

  ls ~/repo/temp/sdaps/example/
  evince ~/repo/temp/sdaps/example/questionnaire.pdf

  # download 'example.tif' from http://sdaps.org/Documentation/Tutorial
  # to the source folder.

  python sdaps.py ~/repo/temp/sdaps/example add example.tif
  python sdaps.py ~/repo/temp/sdaps/example recognize
  python sdaps.py ~/repo/temp/sdaps/example gui
  python sdaps.py ~/repo/temp/sdaps/example report

Session 2 (using GIMP to answer the questions)::

  python sdaps.py ~/repo/temp/sdaps/001 setup_tex 001.tex
  pdftoppm -tiff  ~/repo/temp/sdaps/001/questionnaire.pdf answer
  gimp answer-1.tif
  convert -monochrome answer-1.tif a1.tif
  python sdaps.py ~/repo/temp/sdaps/001 add a1.tif
  python sdaps.py ~/repo/temp/sdaps/001 recognize
  python sdaps.py ~/repo/temp/sdaps/001 gui

Session 3 (create unique stamp or pupil ID for each questionnaire)::

  mkdir ~/repo/dev/wip/marking/
  cd ~/repo/dev/wip/marking/
  mkvirtualenv --system-site-packages dev_marking
  touch README.rst
  add2virtualenv ../../../src/sdaps/
  cp ~/repo/src/sdaps/001.tex 002.tex
  # Uncomment 'print_questionnaire_id,'
  vim 002.tex
  python ~/repo/src/sdaps/sdaps.py 002 setup_tex 002.tex
  # Simple list of number... one per line
  vim pupils.txt
  python ~/repo/src/sdaps/sdaps.py 002 stamp -f pupils.txt
  evince 002/stamped_1.pdf

Session 4 (combine a unique stamp with using GIMP to answer)::

  python ~/repo/src/sdaps/sdaps.py 004 stamp -f pupils.txt
  pdftoppm -tiff 004/stamped_1.pdf out
  gimp out-1.tif
  # export from gimp to out-1-answer.tif
  convert -monochrome out-1-answer.tif out-1-answer-mono.tif
  python ~/repo/src/sdaps/sdaps.py 004 add out-1-answer-mono.tif
  python ~/repo/src/sdaps/sdaps.py 004 recognize
  python ~/repo/src/sdaps/sdaps.py 004 gui
  python ~/repo/src/sdaps/sdaps.py 004 report
  evince 004/report_1.pdf

Tips
====

Convert PDF to image::

  pdftoppm -tiff questionnaire.pdf prefix

Convert image to monochrome tiff::

  convert -monochrome prefix-1.tif questionnaire.tif