photo-utils 0.2

data/lib/photo_utils/tools/dof.rb

@@ -0,0 +1,42 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class DOF < Tool
+
+      def run(args)
+
+        cameras = []
+        cameras << Camera[/Bronica/]
+        cameras << Camera[/Leica/]
+        cameras << Camera[/Hasselblad/]
+
+        cameras.each do |camera|
+
+          puts "#{camera.name}"
+
+          scene = Scene.new
+          scene.camera = camera
+          scene.camera.shutter = 1.0 / 125
+          scene.subject_distance = 30.feet
+          dof = 1.feet
+          aperture = scene.aperture_for_depth_of_field(scene.subject_distance - (dof / 2), scene.subject_distance + (dof / 2))
+          scene.camera.lens.aperture = [aperture, camera.lens.max_aperture].max
+          scene.sensitivity = 1600
+          scene.set_exposure
+
+          puts "\t" + "FOV: #{scene.field_of_view(scene.subject_distance).to_s(:imperial)}"
+          puts "\t" + "DOF: #{scene.total_depth_of_field.to_s(:imperial)} (-#{scene.near_distance_from_subject.to_s(:imperial)}/+#{scene.far_distance_from_subject.to_s(:imperial)})"
+          puts
+
+          scene.print_exposure
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/tools/dof_table.rb

@@ -0,0 +1,45 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class DOFTable < Tool
+
+      def run(args)
+        scene = Scene.new
+        scene.camera = Camera[/Eastman/]
+
+        puts
+        scene.print_camera
+        puts
+
+        # Av equivalents of f/4 -- f/64
+        apertures = (4..12).map { |av| Aperture.new_from_v(av) }
+
+        first = true
+
+        1.upto(30) do |s|
+          scene.subject_distance = s.feet
+          if first
+            first = false
+            puts (['', ''] + apertures.map { |a| "Av #{a.to_v.to_i}" }).join("\t")
+            puts (['', ''] + apertures.map { |a| a.to_s(:us) }).join("\t")
+            puts (['Distance', 'Field of view'] + apertures).join("\t")
+          end
+          print scene.subject_distance.to_s(:imperial)
+          print "\t" + "#{scene.field_of_view(scene.subject_distance).height.to_s(:imperial)}H x #{scene.field_of_view(scene.subject_distance).width.to_s(:imperial)}W"
+          apertures.each do |a|
+            scene.camera.lens.aperture = a
+            # print "\t" + "%s (%s ~ %s)" % [scene.total_depth_of_field, scene.near_distance_from_subject, scene.far_distance_from_subject].map { |d| d.to_s(:imperial) }
+            print "\t" + "%s" % [scene.total_depth_of_field].map { |d| d.to_s(:imperial) }
+          end
+          puts
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/tools/film_test.rb

@@ -0,0 +1,57 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class FilmTest < Tool
+
+      def run(args)
+        camera = Camera['Hasselblad']
+
+        scene = Scene.new
+        scene.camera = camera
+        scene.sensitivity = 100
+        scene.camera.shutter = 1.0/60
+        scene.camera.lens.aperture = 5.6
+        # scene.description = "film: Acros 100; flash: Metz 60 at 1/128~1/256 power; dev: 11m in HC-110 (H) @ 68"
+
+        scene.print_exposure
+
+        zone_offset_from_mg = -4
+
+        # recommendation from Adams' "The Negative"
+        # steps = [0, -1.0/3, -2.0/3, -1, 1.0/3, 2.0/3, 1]
+        steps = [-2, -1.5, -1, -0.5, 0, 0.5, 1, 1.5, 2]
+
+        scenes = []
+
+        base_fog = Scene.new
+        base_fog.description = "base + fog"
+        scenes << base_fog
+
+        steps.each do |i|
+          scene2 = scene.dup
+          scene2.brightness = PhotoUtils::Brightness.new_from_v(scene.brightness.to_v - zone_offset_from_mg)
+          scene2.sensitivity = Sensitivity.new_from_v(scene.sensitivity.to_v + i)
+          # FIXME: scene2.calculate_best_exposure
+          scene2.description = i.to_s
+          scenes << scene2
+        end
+
+        scenes.each_with_index do |scene2, i|
+          puts "%2d | %5s | %10s | %10s | %12s | %12s" % [
+            i + 1,
+            scene2.description,
+            scene2.sensitivity,
+            scene2.exposure.aperture,
+            scene2.exposure.time,
+          ]
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/tools/focal_length.rb

@@ -0,0 +1,25 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class FocalLength < Tool
+
+      def run(args)
+        from_focal_length, from_format = args.shift.split(':')
+        from_focal_length = from_focal_length.to_i
+        from_format = (Format[from_format || '35'] or raise "Unknown format: #{from_format.inspect}")
+        to_formats = args.first ? args.shift.split(',') : %w{1/1.7 APS-C APS-H 35 6x4.5 6x6 6x7 5x7}
+        to_formats.map { |f| Format[f] or raise "Unknown format: #{f.inspect}" }.each do |to_format|
+          scene = Scene.new
+          scene.format = from_format
+          puts "%10s: %6s" % [to_format.name, scene.format.focal_length_equivalent(from_focal_length, to_format)]
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/tools/reciprocity.rb

@@ -0,0 +1,36 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class Reciprocity < Tool
+
+      def usage
+        %q{
+          -r 1      compute single value
+          -r 2-60   compute values of 2 to 60
+          -r        compute default range of 1-100 secs
+        }
+      end
+
+      def run(args)
+        if args.first
+          r = args.shift.split('-', 2).map { |n| n ? n.to_i : nil }
+        else
+          r = 1..100
+        end
+        range = Range.new(r.first, r.last)
+        ti = range.first
+        until ti > range.last
+          tc = Time.new(ti).reciprocity
+          puts "#{ti} => #{tc.round.to_i}"
+          ti *= 2
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/tools/test.rb

@@ -0,0 +1,91 @@
+require 'photo_utils/tool'
+
+module PhotoUtils
+
+  class Tools
+
+    class Test < Tool
+
+      def run(args)
+
+        # field_of_view = Frame.new(5.feet, 8.feet)
+        subject_distance = 3.feet
+        # subject_distance = nil
+        # depth_of_field = 2.feet
+        depth_of_field = 0.1.feet
+        sensitivity = 1600
+        # brightness = PhotoUtils::Brightness.new_from_lux(2000)
+        # brightness = nil
+        # shutter = 1.0/125
+        shutter = nil
+        # aperture = 4
+
+        header = "%-15.15s | %-15.15s | %-50.50s | %7s | %8s | %14s | %7s | %s"
+
+        puts header % %w{
+          camera
+          format
+          lens
+          35mm
+          dist
+          FOV
+          DOF
+          aperture
+        }
+
+        Camera.cameras.each do |camera|
+          # next unless camera.name =~ /Eastman/
+          # next unless camera.name =~ /Hasselblad|Bronica|Leica/
+          camera.formats.each do |format|
+            # next unless format.name =~ /5x7/
+            puts
+            camera.format = format
+            camera.lenses.sort_by(&:focal_length).each do |lens|
+              # next unless lens.name =~ /12"/
+              camera.lens = lens
+              scene = Scene.new
+              # scene.sensitivity = sensitivity
+              # scene.brightness = brightness
+              scene.camera = camera
+              scene.camera.shutter = shutter
+              scene.subject_distance = subject_distance || scene.subject_distance_for_field_of_view(field_of_view)
+              if depth_of_field
+                aperture = scene.aperture_for_depth_of_field(scene.subject_distance - (depth_of_field / 2), scene.subject_distance + (depth_of_field / 2))
+              end
+              scene.camera.lens.aperture = [aperture, scene.camera.lens.max_aperture].max
+              scene.camera.lens.aperture = [scene.camera.lens.aperture, scene.camera.lens.min_aperture].min
+              scene.set_exposure
+
+              # if scene.working_aperture > 0 && scene.working_aperture < camera.lens.min_aperture
+              #   exp_comp = scene.working_aperture.to_v - camera.lens.aperture.to_v
+              #   exp_comp = (exp_comp * 2).to_i / 2
+              #   exp_comp = if exp_comp < 0
+              #     "-#{exp_comp.abs}"
+              #   elsif exp_comp > 0
+              #     "+#{exp_comp}"
+              #   else
+              #     nil
+              #   end
+              # end
+              exp_comp = nil
+
+              puts header % [
+                scene.camera.name,
+                scene.camera.format.to_s(true),
+                scene.camera.lens,
+                scene.camera.format.focal_length_equivalent(scene.camera.lens.focal_length),
+                scene.subject_distance.to_s(:imperial),
+                scene.field_of_view(scene.subject_distance).to_s(:imperial),
+                scene.total_depth_of_field.to_s(:imperial),
+                scene.camera.lens.aperture,
+              ]
+            end
+          end
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/photo_utils/value.rb

@@ -0,0 +1,37 @@
+require 'delegate'
+
+module PhotoUtils
+
+  class Value < DelegateClass(Float)
+
+    def self.new_from_v(v)
+      raise NotImplementedError, "Subclass has not implemented \#new_from_v"
+    end
+
+    def initialize(n)
+      super(n.to_f)
+    end
+
+    def to_v
+      raise NotImplementedError, "Subclass has not implemented \#to_v"
+    end
+
+    def incr
+      self.class.new_from_v(self.to_v + 1)
+    end
+
+    def decr
+      self.class.new_from_v(self.to_v - 1)
+    end
+
+    def ==(other)
+      self.to_v == self.class.new(other).to_v
+    end
+
+    def <=>(other)
+      self.to_v <=> self.class.new(other).to_v
+    end
+
+  end
+
+end

data/lib/photo_utils/version.rb

@@ -0,0 +1,5 @@
+module PhotoUtils
+
+  VERSION = '0.2'
+
+end

data/photo-utils.gemspec

@@ -0,0 +1,29 @@
+$LOAD_PATH << 'lib'
+
+require 'photo_utils/version'
+
+Gem::Specification.new do |s|
+
+  s.name              = 'photo-utils'
+  s.author            = 'John Labovitz'
+  s.email             = 'johnl@johnlabovitz.com'
+  s.homepage          = 'http://johnlabovitz.com'
+  s.version           = PhotoUtils::VERSION
+  s.summary           = 'Models, formulas, and utilties for photography optics, etc.'
+  s.description = %q{
+    PhotoUtils provides Models, formulas, and utilties for photography optics, etc.
+  }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_path  = 'lib'
+
+  s.add_dependency 'hashstruct'
+  s.add_dependency 'builder'
+  s.add_dependency 'path'
+
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'wrong'
+end

data/test/aperture_test.rb

@@ -0,0 +1,40 @@
+require 'test/unit'
+require 'wrong'
+require 'photo_utils'
+
+class TestAperture < Test::Unit::TestCase
+
+  include Wrong
+  include PhotoUtils
+
+  def setup
+	  @a = Aperture.new(8)
+  end
+
+  def test_zero_value
+    assert { Aperture.new(1).to_v == 0 }
+  end
+
+  def test_has_correct_native_value
+	  assert { @a.to_f == 8 }
+  end
+
+	def test_format_as_string
+	  assert { @a.to_s == 'f/8' }
+	  assert { @a.to_s(:value) == 'Av:6' }
+  end
+
+  def test_converts_to_value
+	  assert { @a.to_v == Aperture.new_from_v(6).to_v }
+  end
+
+  def test_increments_and_decrements
+	  assert { @a.incr.round == Aperture.new(11).round }
+	  assert { @a.decr.round == Aperture.new(5.6).round  }
+  end
+
+  def test_absolute
+	  assert { @a.absolute(50) == 6.25 }
+  end
+
+end

data/test/apex_test.rb

@@ -0,0 +1,28 @@
+require 'test/unit'
+require 'wrong'
+require 'photo_utils'
+
+class TestAPEX < Test::Unit::TestCase
+
+  include Wrong
+  include PhotoUtils
+
+  def setup
+    @exposure = Exposure.new(
+      time: nil,
+      aperture: 8,
+      sensitivity: 200,
+      brightness: Brightness.new_from_v(5))
+  end
+
+	def test_apex
+	  assert { @exposure.ev                 == @exposure.av + @exposure.tv }
+	  assert { @exposure.bv + @exposure.sv  == @exposure.av + @exposure.tv }
+  end
+
+  def test_exposure
+	  assert { @exposure.ev    == 11 }
+	  assert { @exposure.ev100 == 0 }
+  end
+
+end