mork 0.8.1 → 0.9.0

data/spec/mork/mimage_spec.rb

@@ -4,81 +4,40 @@ module Mork
   describe Mimage do
     let(:qna) { [5] * 100 }
 
-    context 'new age on slanted' do
-      let(:img) { sample_img 'slanted' }
-      let(:mim) { Mimage.new img.filename, qna, GridOMR.new(img.grid_file)  }
+    context 'John Doe' do
+      let(:img) { sample_img 'jdoe1' }
+      let(:fn)  { File.basename(img.image_path) }
+      let(:mim) { Mimage.new img.image_path, [img.nchoices]*img.nitems, GridOMR.new(img.grid_path)  }
       describe 'basics' do
         it 'should be valid' do
-          mim.highlight_rm_centers
-          mim.highlight_rm_areas
-          mim.write 'spec/out/slanted.jpg', false
           expect(mim.valid?).to be_truthy
         end
 
         it 'should return the correct regmark coordinates' do
           [:tl, :tr, :br, :bl].each do |corner|
             crn = mim.rm[corner]
-            expect(crn[:x]).to be_within(2).of(img.info[corner.to_s][0])
-
-          end
-        end
-      end
-    end
-
-    context 'problematic sheets' do
-      let(:mim)  { Mimage.new 'spec/samples/out-1.jpg', qna, GridOMR.new('spec/samples/grid.yml')  }
-      let(:bila) { Mimage.new 'spec/samples/syst/bila0.jpg', qna, GridOMR.new('spec/samples/grid.yml') }
-
-      it 'writes all cell values to a text file', exclude: true do
-        d=Dir['spec/samples/syst/*.jpg']
-        d.each do |f|
-          fn = File.basename f, '.jpg'
-          m = Mimage.new "spec/samples/syst/#{fn}.jpg", qna, GridOMR.new('spec/samples/grid.yml')
-          puts fn
-          File.open("spec/samples/syst/#{fn}.txt",'w') do |f|
-            f.puts "ink:#{m.send :ink_black}"
-            f.puts "drk:#{m.send :darkest_cell_mean}"
-            f.puts "pap:#{m.send :paper_white}"
-            f.puts "cal:#{m.send :cal_cell_mean}"
-            f.puts "cho:#{m.send :choice_threshold}"
-            100.times do |q|
-              5.times do |c|
-                f.puts m.send('choice_cell_averages')[q, c]
-              end
-            end
+            expect(crn[:x]).to be_within(2).of(img.send(corner)[0])
+            expect(crn[:x]).to be_within(2).of(img.send(corner)[0])
           end
         end
-      end
-    end
-
-    context 'Old specs' do
-      let(:sgi) { sample_img 'sample-gray' }
-      let(:sg)  { Mimage.new sgi.filename, qna, GridOMR.new(sgi.grid_file) }
-
-      describe 'basics' do
-        it 'returns the pixels as an array' do
-          expect(sg.send :reg_pixels).to be_a NPatch
-        end
-
-        it 'returns the correct number of pixels' do
-          expect(sg.send(:reg_pixels).length).to eq sgi.width * sgi.height
-        end
-
-        it 'returns the stretched array' do
-          expect(sg.send(:reg_pixels).length).to eq sgi.width * sgi.height
-        end
-      end
 
-      describe 'inspecting' do
-        xit 'writes out average whiteness of choice cells' do
-          qz = sample_img 'silvia'
-          s = Mimage.new qz.filename, [5] * 5, GridOMR.new(qz.grid_file)
-          File.open('spec/out/choices.txt', 'w') do |f|
-            5.times do |q|
-              t = (0..4).collect do |c|
-                s.send(:shade_of, q, c).round
+        xit 'writes all cell values to a text file' do
+          d=Dir['spec/samples/syst/*.jpg']
+          d.each do |f|
+            fname = File.basename f, '.jpg'
+            m = Mimage.new "spec/samples/syst/#{fname}.jpg", qna, GridOMR.new('spec/samples/grid.yml')
+            puts fname
+            File.open("spec/out/text/#{fname}.txt",'w') do |f|
+              f.puts "ink:#{m.send :ink_black}"
+              f.puts "drk:#{m.send :darkest_cell_mean}"
+              f.puts "pap:#{m.send :paper_white}"
+              f.puts "cal:#{m.send :cal_cell_mean}"
+              f.puts "cho:#{m.send :choice_threshold}"
+              100.times do |q|
+                5.times do |c|
+                  f.puts m.send('choice_cell_averages')[q, c]
+                end
               end
-              f.puts "#{q+1}: #{t.join(' ')}"
             end
           end
         end

data/spec/mork/sheet_omr_spec.rb

@@ -3,258 +3,153 @@ require 'fileutils'
 
 module Mork
   describe SheetOMR do
-    context 'basic object generation' do
-      let(:img) { sample_img 'slanted' }
-      let(:omr) { SheetOMR.new img.filename, [5] * 120, img.grid_file }
+    context 'with a valid response sheet' do
+      let(:img) { sample_img 'jdoe1' }
+      let(:fn)  { File.basename(img.image_path) }
+      let(:omr) { SheetOMR.new img.image_path, choices: [img.nchoices]*img.nitems, layout: img.grid_path }
       describe '#new' do
-        it 'raises an error if the provided path is invalid' do
-          expect { SheetOMR.new 'non_existing_file.jpg'}.to raise_error IOError
-        end
-
         it 'creates a SheetOMR object' do
           expect(omr).to be_a SheetOMR
         end
 
-        it 'registers correctly' do
-          expect(omr.valid?).to be_truthy
-        end
-
-        it 'writes out the registration' do
-          omr.write_registration 'spec/out/slanted2.jpg'
+        it 'raises an error if the provided path is invalid' do
+          expect { SheetOMR.new 'non_existing_file.jpg'}.to raise_error IOError
         end
       end
-    end
-    # context 'problematic' do
-    #   let(:shinfo) { sample_img 'bianchi' }
-    #   let(:sheet)  { SheetOMR.new shinfo.filename, shinfo.grid_file }
-    #
-    #   it 'has a status' do
-    #     sheet.status.should == {:tl=>:ok, :tr=>:ok, :br=>:ok, :bl=>:ok, :write=>nil}
-    #   end
-    #
-    #   it 'has a barcode' do
-    #     sheet.barcode.should == shinfo.barcode_int
-    #   end
-    #
-    #   it 'writes the registered and marked image' do
-    #     sheet.cross_marked
-    #     sheet.write 'spec/out/bianchi.jpg'
-    #     sheet.status[:write].should == :fail
-    #   end
-    #
-    #   it 'writes the registration areas' do
-    #     sheet.highlight_registration
-    #     sheet.write_raw 'spec/out/reg_bianchi.jpg'
-    #   end
-    #
-    # end
-    #
-    context 'slanted' do
-      let(:sh) { sample_img 'slanted' }
-      let(:sheet) { SheetOMR.new sh.filename, [5]*120, sh.grid_file }
-
-      it 'gets in trouble' do
-        sheet.write_registration 'spec/out/laurout.jpg'
-      end
-
-      it 'gets more in trouble' do
-        sheet.highlight_marked
-        sheet.write 'spec/out/lauraout2.jpg'
-      end
-
-      it 'should be valid' do
-        expect(sheet.valid?).to be_truthy
-      end
-    end
-
-    context 'highlighting' do
-      # since these specs change the @crop, they must be run in isolation
-      # with the SheetOMR rebuilt each time, even though it is time consuming!
-      let(:shinfo) { sample_img 'sample-gray' }
-      let(:sheet)  { SheetOMR.new shinfo.filename, [5]*120, shinfo.grid_file }
-
-      it 'writes the sheet with registrations highlighted' do
-        sheet.write_registration 'spec/out/sample_gray_registered.jpg'
-      end
-
-      it 'highlights all choice cells' do
-        sheet.highlight_all_choices
-        sheet.write 'spec/out/all_highlights.jpg'
-      end
-
-      it 'highlights marked cells' do
-        sheet.highlight_marked
-        sheet.write 'spec/out/marked_highlights.jpg'
-      end
-
-      it 'crossed marked cells' do
-        sheet.cross_marked
-        sheet.write 'spec/out/marked_crosses.jpg'
-      end
 
-      it 'outlines some responses' do
-        sheet.outline [[1],[1],[2],[2],[3,4],[],[0,1,2,3,4], [],[1],[2],[2],[3,4],[],[0,1,2,3,4]]
-        sheet.write 'spec/out/outlines.jpg'
+      describe '#valid?' do
+        it 'registers correctly' do
+          expect(omr.valid?).to be_truthy
+        end
       end
 
-      it 'cross some responses' do
-        sheet.cross [[1],[1],[2],[2],[3,4],[],[0,1,2,3,4], [],[1],[2],[2],[3,4],[],[0,1,2,3,4]]
-        sheet.write 'spec/out/crosses.jpg'
+      describe '#status' do
+        it 'returns the registration status for each of the four corners' do
+          expect(omr.status).to eq({ tl: :ok, tr: :ok, br: :ok, bl: :ok })
+        end
       end
 
-      it 'outlines some responses in-place (rewriting the source image)' do
-        FileUtils.cp shinfo.filename, 'spec/out/inplace.jpg'
-        tsheet = SheetOMR.new 'spec/out/inplace.jpg', [5]*100, shinfo.grid_file
-        tsheet.outline [[1],[1],[2],[2],[3,4],[],[0,1,2,3,4], [],[1],[2],[2],[3,4],[],[0,1,2,3,4]]
-        tsheet.write
+      describe '#barcode' do
+        it 'returns the integer form of the barcode' do
+          expect(omr.barcode).to eq img.barcode_int
+        end
       end
 
-      it 'highlights marked cells and outline correct responses' do
-        sheet.highlight_marked
-        sheet.outline [[1],[1],[2],[2],[3,4],[],[0,1,2,3,4], [],[1],[2],[2],[3,4],[],[0,1,2,3,4]]
-        sheet.write 'spec/out/marks_and_outs.jpg'
+      describe '#barcode_string' do
+        it 'returns the binary string version of the barcode' do
+          expect(omr.barcode_string).to eq img.barcode_str
+        end
       end
 
-      it 'highlights marked cells of a problematic one' do
-        si = sample_img 'silvia'
-        s = SheetOMR.new si.filename, [5]*100, si.grid_file
-        s.highlight_marked
-        s.write 'spec/out/problem.jpg'
+      describe '#marked?' do
+        it 'returns true if the given cell was marked, false otherwise' do
+          expect(omr.marked?   0, 0).to be_truthy
+          expect(omr.marked?   0, 1).to be_falsy
+          expect(omr.marked? 119, 4).to be_truthy
+          expect(omr.marked? 119, 3).to be_falsy
+        end
       end
 
-      it 'highlights the barcode' do
-        si = sample_img 'sample-gray'
-        s = SheetOMR.new si.filename, [5]*100, si.grid_file
-        s.highlight_barcode
-        s.write 'spec/out/code_bits.jpg'
+      describe '#marked_choices' do
+        it 'returns an array of marked choices as position indices' do
+          expect(omr.marked_choices).to eq standard_mark_array(24)
+        end
       end
-    end
 
-    context 'marking a nicely printed and scanned sheet' do
-      before(:all) do
-        @shinfo = sample_img 'sample-gray'
-        @sheet = SheetOMR.new @shinfo.filename, [5]*120, @shinfo.grid_file
-      end
+      describe '#marked_choices' do
+        it 'returns an array of marked choices as position indexes' do
+          expect(omr.marked_choices ).to eq standard_mark_array(24)
+        end
 
-      describe '#valid?' do
-        it 'returns true' do
-          @sheet.valid?.should be_truthy
+        let(:om2) { SheetOMR.new img.image_path, choices: [5, 4, 3, 2, 1], layout: img.grid_path }
+        it 'returns marked choices only for existing choice cells' do
+          expect(om2.marked_choices).to eq [[0], [1], [2], [], []]
         end
       end
 
-      describe '#marked?' do
-        it 'returns true for some darkened choices' do
-          expect(@sheet.marked?(0,0)).to be_truthy
-          expect(@sheet.marked?(1,1)).to be_truthy
-          expect(@sheet.marked?(2,2)).to be_truthy
+      describe '#marked_logicals' do
+        it 'returns an array of logicals for the marked choices' do
+          expect(omr.marked_logicals).to eq standard_mark_logical_array(24)
         end
+      end
 
-        it 'return false for some blank choices' do
-          expect(@sheet.marked?(0,1)).to be_falsy
-          expect(@sheet.marked?(1,0)).to be_falsy
-          expect(@sheet.marked?(2,3)).to be_falsy
+      describe '#marked_letters' do
+        it 'returns an array of characters for the marked choices' do
+          expect(omr.marked_letters).to eq standard_mark_char_array(24)
         end
+      end
 
-        it 'writes out markedness' do
-          mf = File.open('spec/out/marked.txt', 'w')
-          120.times do |q|
-            x = 5.times.collect do |c|
-              @sheet.marked?(q,c) ? '1' : '0'
-            end
-            mf.puts x.join(' ')
+      it 'writes out markedness' do
+        mf = File.open('spec/out/text/marked.txt', 'w')
+        img.nitems.times do |q|
+          x = 5.times.collect do |c|
+            omr.marked?(q,c) ? '1' : '0'
           end
-          mf.close
+          mf.puts x.join(' ')
         end
+        mf.close
       end
 
-      describe '#mark_array' do
-        it 'should return an array of marked choices for each of the first 5 questions' do
-          @sheet.mark_array(5).should == [[0], [1], [2], [3], [4]]
-        end
-
-        it 'should return an array of marked choices for the specified question set' do
-          @sheet.mark_array([0, 1, 13, 16, 31, 104, 21]).should == [[0], [1], [3,4], [2], [1], [], [0,1,2,3,4]]
+      context 'creating overlays' do
+        it 'registration highlighted' do
+          omr.save_registration "spec/out/registration/#{fn}"
         end
 
-        it 'should return an array of @grid.max_questions length if called without arguments' do
-          @sheet.mark_array.length.should == 120
+        it 'highlights all choice cells' do
+          omr.overlay :highlight, :all
+          omr.save "spec/out/highlight/#{fn}"
         end
-      end
 
-      describe '#mark_logical_array' do
-        it 'should return an array of booleans for each of the first questions' do
-          @sheet.mark_logical_array(5).should == [
-            [true, false, false, false, false],
-            [false, true, false, false, false],
-            [false, false, true, false, false],
-            [false, false, false, true, false],
-            [false, false, false, false, true],
-          ]
+        it 'highlights marked cells' do
+          omr.overlay :highlight, :marked
+          omr.save "spec/out/highlight/marked-#{fn}"
         end
-      end
 
-      describe 'barcodes' do
-        it 'should read the bit string as all ones' do
-          @sheet.barcode_string.should == '1111111111111111111111111111111111111111'
-          @sheet.barcode.should == 1099511627775
+        it 'checks marked cells' do
+          omr.overlay :check, :marked
+          omr.save "spec/out/mark/#{fn}"
         end
 
-        it 'should read another bit string' do
-          barcode_string = '0000000000000000000000000010000110100000'
-          s2 = SheetOMR.new('spec/samples/sample02.jpg', [5]*100)
-          s2.barcode_string.should == barcode_string
-          s2.barcode.should == 8608
+        it 'outlines and crosses marked cells' do
+          omr.overlay :outline, standard_mark_array(24)
+          omr.overlay :check
+          omr.save "spec/out/outline/#{fn}"
         end
 
-        it 'should read the 666 bit string' do
-          sh = sample_img 'code666'
-          s2 = SheetOMR.new sh.filename, [5]*100, sh.grid_file
-          s2.barcode.should == sh.barcode_int
+        it 'highlights the barcode' do
+          omr.overlay :outline, :barcode
+          omr.save "spec/out/barcode/#{fn}"
         end
       end
-
-    end
-
-    context 'marking a problematic sheet' do
-      let(:sheet) { SheetOMR.new 'spec/samples/out-1.jpg', [5]*100, 'spec/samples/grid.yml' }
-
-      it 'highlights the registration' do
-        sheet.write_registration 'spec/out/problematic.jpg'
-      end
-
-      it 'highlights the barcode' do
-        sheet.highlight_barcode
-        sheet.write 'spec/out/barcode.jpg'
-      end
     end
 
-    context 'systematic tests' do
+    context 'systematic tests', exclude: true do
       let(:bila)  { 'CCEBEBCEEACCDCABDBEBCADEADDCCCACCACDBBDAECDDABDEEBCEEDCBAAADEEEEDCADEABCBDECCCCDDDCABBECAADADBBEEABA'.split '' }
-      let(:bila0) { SheetOMR.new 'spec/samples/syst/bila0.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bila1) { SheetOMR.new 'spec/samples/syst/bila1.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bila2) { SheetOMR.new 'spec/samples/syst/bila2.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bila3) { SheetOMR.new 'spec/samples/syst/bila3.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bila4) { SheetOMR.new 'spec/samples/syst/bila4.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
+      let(:bila0) { SheetOMR.new 'spec/samples/syst/bila0.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bila1) { SheetOMR.new 'spec/samples/syst/bila1.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bila2) { SheetOMR.new 'spec/samples/syst/bila2.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bila3) { SheetOMR.new 'spec/samples/syst/bila3.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bila4) { SheetOMR.new 'spec/samples/syst/bila4.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
       let(:dald)  { 'DDDBECAAADBAEEEAEEEBAACAEDBDECDBDCDCDDEDCCDCDBDCADEEDBCCBEBBAADDCDBBECBBBDEABADABADADBABAEABACBDADDA'.split '' }
-      let(:dald0) { SheetOMR.new 'spec/samples/syst/dald0.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:dald1) { SheetOMR.new 'spec/samples/syst/dald1.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:dald2) { SheetOMR.new 'spec/samples/syst/dald2.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:dald3) { SheetOMR.new 'spec/samples/syst/dald3.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:dald4) { SheetOMR.new 'spec/samples/syst/dald4.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
+      let(:dald0) { SheetOMR.new 'spec/samples/syst/dald0.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:dald1) { SheetOMR.new 'spec/samples/syst/dald1.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:dald2) { SheetOMR.new 'spec/samples/syst/dald2.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:dald3) { SheetOMR.new 'spec/samples/syst/dald3.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:dald4) { SheetOMR.new 'spec/samples/syst/dald4.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
       let(:cost)  { 'ABBDDBAEAEBAADEAAECBCDBBDABABADEECCACBCAEDDAEBEABBCDABECAACEEEBADECBBEAADBBBEABDAEBDEEABBABEBEDDAEEC'.split '' }
-      let(:cost0) { SheetOMR.new 'spec/samples/syst/cost0.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:cost1) { SheetOMR.new 'spec/samples/syst/cost1.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:cost2) { SheetOMR.new 'spec/samples/syst/cost2.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:cost3) { SheetOMR.new 'spec/samples/syst/cost3.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:cost4) { SheetOMR.new 'spec/samples/syst/cost4.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
+      let(:cost0) { SheetOMR.new 'spec/samples/syst/cost0.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:cost1) { SheetOMR.new 'spec/samples/syst/cost1.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:cost2) { SheetOMR.new 'spec/samples/syst/cost2.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:cost3) { SheetOMR.new 'spec/samples/syst/cost3.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:cost4) { SheetOMR.new 'spec/samples/syst/cost4.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
       let(:bone)  { 'CECBBABAECADEDCACBBDEECBADBECDCEDECABCAADCBDEDACAEEDCCADBEDCEBCCBBDCCACDEDDAAECEBDBADCBAAEBAEDABCBDC'.split '' }
-      let(:bone0) { SheetOMR.new 'spec/samples/syst/bone0.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bone1) { SheetOMR.new 'spec/samples/syst/bone1.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:bone2) { SheetOMR.new 'spec/samples/syst/bone2.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
+      let(:bone0) { SheetOMR.new 'spec/samples/syst/bone0.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bone1) { SheetOMR.new 'spec/samples/syst/bone1.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:bone2) { SheetOMR.new 'spec/samples/syst/bone2.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
       let(:barr)  { 'ACECAAADDBCECCCDBEBECDEDAECEDDEEDCDEADDCCBCCCBBEACBCAEDEEDDDABBBBABEBDCEADEEDEBCBADBCEDCDBACEBCBDCDA'.split '' }
-      let(:barr0) { SheetOMR.new 'spec/samples/syst/barr0.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:barr1) { SheetOMR.new 'spec/samples/syst/barr1.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
-      let(:barr2) { SheetOMR.new 'spec/samples/syst/barr2.jpg', [5]*100,  'spec/samples/syst_grid.yml'}
+      let(:barr0) { SheetOMR.new 'spec/samples/syst/barr0.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:barr1) { SheetOMR.new 'spec/samples/syst/barr1.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
+      let(:barr2) { SheetOMR.new 'spec/samples/syst/barr2.jpg', choices: [5]*100, layout: 'spec/samples/syst/layout.yml'}
 
       it 'checks bila' do
         expect(bila0.mark_char_array.flatten).to eq(bila)

data/spec/mork/sheet_pdf_spec.rb

@@ -40,8 +40,8 @@ module Mork
     end
 
     it 'creates a basic PDF sheet' do
-      s = SheetPDF.new(content, 'spec/samples/layout.yml')
-      s.save('spec/out/sheet.pdf')
+      s = SheetPDF.new(content)
+      s.save('spec/out/pdf/sheet.pdf')
     end
 
     it 'creates a boxed PDF sheet' do
@@ -52,39 +52,38 @@ module Mork
         signature: 'Signature'
       }
       s = SheetPDF.new(content.merge({header: h}), 'spec/samples/boxy.yml')
-      s.save('spec/out/boxy.pdf')
+      s.save('spec/out/pdf/boxy.pdf')
     end
 
     it 'creates a basic PDF sheet with a code of 15' do
       s = SheetPDF.new(content.merge({barcode: 15}))
-      s.save('spec/out/sheet16.pdf')
+      s.save('spec/out/pdf/sheet16.pdf')
     end
 
     it 'creates a basic PDF sheet with a code of 666666666666' do
       s = SheetPDF.new(content.merge({barcode: 666666666666}))
-      s.save('spec/out/sheet666.pdf')
+      s.save('spec/out/pdf/sheet666.pdf')
     end
 
     it 'creates a PDF sheet with the maximum possible barcode' do
       s = SheetPDF.new(content.merge({barcode: 1099511627775}))
-      s.save('spec/out/maxcode.pdf')
+      s.save('spec/out/pdf/maxcode.pdf')
     end
 
     it 'creates a PDF sheet with 160 items' do
       s = SheetPDF.new(content.merge({choices: [5] * 160}), 'spec/samples/grid160.yml')
-      s.save('spec/out/i160.pdf')
-      # system 'open spec/out/i160.pdf'
+      s.save('spec/out/pdf/i160.pdf')
     end
 
     it 'creates a PDF sheet with unequal choices per item' do
       s = SheetPDF.new(content.merge({choices: [5, 4, 3, 2, 1, 5, 4, 3, 2, 1, 5, 4, 3, 2, 1, 5, 4, 3, 2, 1, 5, 4, 3, 2, 1, 5, 4, 3, 2, 1, 5, 4, 3, 2, 1]}), 'spec/samples/layout.yml')
-      s.save('spec/out/uneq.pdf')
+      s.save('spec/out/pdf/uneq.pdf')
     end
 
     it 'creates 20 PDF sheets' do
       c = content
       s = SheetPDF.new([c,c,c,c,c,c,c,c,c,c,c,c,c,c,c,c,c,c,c,c])
-      s.save('spec/out/p20.pdf')
+      s.save('spec/out/pdf/p20.pdf')
     end
   end
 end

data/spec/out/highlight/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/out/mark/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/out/outline/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/out/pdf/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/out/registration/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/out/text/.gitignore

@@ -0,0 +1,4 @@
+# Ignore everything in this directory
+*
+# Except this file
+!.gitignore

data/spec/samples/grid_omr_layout.yml

@@ -0,0 +1,56 @@
+page_size:             # all measurements in mm
+  width:        210    # width of the paper sheet
+  height:       297    # height of the paper sheet
+reg_marks:
+  margin:        10    # distance from each page border to registration mark center
+  radius:         2.5    # registration mark radius
+  offset:         2    # distance between the search area and each page border (*)
+  crop:          20
+  blur:           2
+  dilate:         5
+header:
+  name:                # ‘name’ is just a label; you can add arbitrary header elements
+    top:          5    # margin relative to registration frame top side
+    left:        15    # margin relative to registration frame left side
+    width:      170    # text will be fitted to this width
+    height:       7    # text will be fitted to this height
+    size:        14    # font size
+  title:
+    top:         15
+    left:        15
+    width:      180
+    height:      12
+    size:        12
+  code:
+    top:          5
+    left:       165
+    width:       20
+    height:      10
+    size:        14
+  signature:
+    top:         30
+    left:         7.5
+    width:      120
+    height:      15
+    size:         7
+    box:       true # header element will be enclosed in a box
+items:
+  top:           55.5 # response area margin, relative to reg frame
+  left:          10.5 # response area margin, relative to reg frame
+  rows:          30 # number of items per column
+  columns:        4 # number of columns
+  column_width:  44 #
+  x_spacing:      7 # horizontal distance between ajacent cell centers
+  y_spacing:      7 # vertical distance between ajacent cell centers
+  cell_width:     6 # width of each choice and calibration cell
+  cell_height:    5 # height of each choice and calibration cell
+  max_cells:      5 # maximum number of choices per item
+  font_size:      9 # size of both the item number and choice cell letter
+  number_width:   8 #
+  number_margin:  2 # margin between
+barcode:
+  bits:          40 # the maximum sheet identifier is 2 to the power or bits
+  left:          15 # distance between registration frame side and the first barcode bit
+  width:          3 # width of each barcode bit
+  height:         2.5 # height of each barcode bit from the registration frame bottom side
+  spacing:        4 # horizontal distance between adjacent barcode bit centers