appraisermetrics_report_service 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+Gemfile.lock
+*.pdf
+/todo.txt

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,78 @@
+appraisermetrics-report-service
+===============================
+
+Report Service app for AM app.
+
+
+
+## gem dependencies
+* prawn - https://github.com/prawnpdf/prawn - license: choice of GPLv2 or GPLv3
+* prawn/table - https://github.com/prawnpdf/prawn-table - license: choice of GPLv2 or GPLv3
+* money - https://github.com/RubyMoney/money - license: https://github.com/RubyMoney/money/blob/master/LICENSE
+* rspec for tests
+* pdf-reader (for specs) - https://github.com/yob/pdf-reader - license: MIT
+* the Date ruby module, should be included in any standard ruby app
+
+
+## usage
+
+```ruby
+# will need a deploy key
+gem 'appraisermetrics_report_service', git: 'https://github.com/StackPointCloud/appraisermetrics-report-service.git' 
+```
+
+```ruby
+require 'appraisermetrics_report_service'
+```
+
+## ClosedSale
+```ruby
+c = ClosedSale.new do
+	write_content(ruby_hash_object, images, office_logo) # => returns ClosedSaleObject which inherits from Prawn::Document
+end
+
+# ruby_hash_object is identical to Comp document, with references to the Mongo Shell removed (ISODate, ObjectID) 
+# images takes an array of image paths. [0] should be the profile image for the property
+# office_logo takes a file path
+```
+
+## EvalReport
+```ruby
+# generate an eval report
+r = EvalReport.new do
+	write_content(subject, comparables, images, logo) # images is a hash, subject is a hash, comparables is an array, logo is a filepath
+end
+
+# image hash construction: {subject_photos: [], regional_maps: [], topo_maps: [], ag_sales_map: String}
+```
+
+## Output
+```ruby
+# render it to file
+r.render_file("some_name.pdf") => local directory pdf called "some_name" with extension .pdf
+```
+
+```ruby
+# stringIO
+StringIO.new(r.render) => <StringIO>
+
+
+```
+## Testing/Dev
+* Rspec suite covers table methods invidually, as well as helper methods.
+* The `pdf-reader` gem is used in specs to read content into tests
+* The `Sampler` class is used to generate sample ruby objects to be used in specs.
+
+To generate test pdf reports:
+
+```ruby
+irb
+
+load './spec/test_data/sampler'
+
+# closed sale
+Sampler.test_closed_sale
+
+# eval report
+Sampler.test_eval_report
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/appraisermetrics_report_service.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'appraisermetrics_report_service/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "appraisermetrics_report_service"
+  spec.version       = AppraisermetricsReportService::VERSION
+  spec.authors       = ["StackPoint"]
+  spec.email         = ["fletcher.wilkens1@gmail.com"] # feel free to change this
+  spec.summary       = ["A service to generate pdf reports"]
+  spec.homepage      = ""
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pdf-reader"
+  spec.add_dependency "prawn-table"
+  spec.add_dependency "prawn"
+  spec.add_dependency "money"
+end

data/config/static_text.yml

@@ -0,0 +1,44 @@
+transmittal:
+  "In fulfillment of our agreement and under XI of FDIC Appraisal and Evaluation Guidelines setting forth circumstances under which evaluations of real property are allowed:
+  The Agencies’ appraisal regulations permit an institution to obtain an appropriate evaluation of real property collateral in lieu of an appraisal for transactions that qualify for certain exemptions. These exemptions include a transaction that: 
+  \n \n
+  • Has a transaction value equal to or less than the appraisal threshold of $250,000. 
+  \n \n
+  • Is a business loan with a transaction value equal to or less than the business loan threshold of $1 million, and is not dependent on the sale of, or rental income derived from, real estate as the primary source of repayment. 
+  \n \n
+  • Involves an existing extension of credit at the lending institution, provided that: 
+  \n \n
+  There has been no obvious and material change in market conditions or physical aspects of the property that threaten the adequacy of the institution’s real estate collateral protection after the transaction, even with the advancement of new monies; or 
+  \n \n
+  There is no advancement of new monies other than funds necessary to cover reasonable closing costs. 
+  \n \n
+  I hereby submit the attached report which contains the FDIC Evaluation Content Requirements identified in the scope of work section."
+
+scope_of_work1:
+  "This Evaluation is presented in a concise report format, is intended to comply with the reporting requirements outlined under the Interagency Appraisal and Evaluation Guidelines issued on December 10, 2010, as previously set forth.
+  \n \nThe scope of this evaluation required collecting primary and secondary data relevant to the subject property, including its current and projected use.
+  \n \nThe evaluation provides an estimate of the property’s market value in its actual physical condition, use and zoning designation as of the effective date of the evaluation (the date that the analysis was completed) with any limiting conditions.
+  \n \nSale data have been selected based on similar significant variables thoroughly analyzed and confirmed by qualified professionals, including certified real estate appraisers, county assessors, buyers, sellers and Realtors, and are believed to be reliable qualifying market data and have been appropriately sourced.    
+  \n \nA physical inspection of the subject property was made by the person signing this report based on the following research:"
+
+scope_of_work2:
+  "From the research gathered, the person signing this report has completed and following analysis:"
+
+scope_of_work3:
+  "The review and description of the area (neighborhood) including general and local market conditions have been provided. 
+  \nThis evaluation employs only the Sales Comparison Approach.  Any inclusion of income projections are for internal purposes and do not infer a net operating income from which a value can be derived."
+
+valuation_process:
+  "The subject property has been valued “as-is” as of the effective date of the Evaluation.  The analysis of value that follows is based on a relative comparison of the subject’s primary property type and secondary property type.  This is accomplished by identifying the same property classifications on sales of similar-type properties located in the subject’s immediate vicinity that were being used in a similar manner to the subject when they sold.  This analysis does not include an analysis of highest and best use because the evaluator is not an appraiser and because this evaluation in not an appraisal.  
+  \n \nSimilar property types have been selected in order to represent a reasonably supported value of the subject property by indicators derived from recent sales of similar properties.  This method employs generally accepted procedures and methods used to conclude an estimate of value, however should not be construed to meet appraisal standards, guidelines, and methodologies."
+
+comp_method:
+  "An opinion of value has been developed by comparing the subject property to similar, recently sold properties in the surrounding or competing area. This approach relies on the idea that when a property is replaceable in the market its value tends to be set at the cost of acquiring an equally desirable substitute property, assuming that no costly delay is encountered in making the substitution.
+  \n \nBy analyzing sales with similar physical and economic properties that qualify as arm’s-length transactions between willing and knowledgeable buyers and sellers, we can identify value ranges and price trends."
+
+val_method:
+  "This evaluation includes an estimate of value by direct comparison.  The opinions and conclusion set forth herein are limited to the Client’s use and may not be understood without additional information contained in my work file or an expanded scope of work or a complete appraisal analysis which may produce a different result."
+
+assumptions_conditions:
+  "THIS IS AN EVALUATION AND SHOULD NOT BE CONSIDERED TO BE AN APPRAISAL. This report complies with the Interagency Appraisal and Evaluation Guidelines Final Guidance that became effective on December 10, 2010, the date it was published in the Federal register, jointly by the Comptroller of the Currency, the Board of Governors of the Federal Reserve System, the Federal Deposit Insurance Corporation, the Department of the Treasury Office of Thrift Supervision and the National Credit Union Administration (“Federal Guidelines”). Accordingly this Report may be relied upon by Customer in accordance with the Federal Guidelines.
+  \n \nThis is an agricultural Evaluation Report. As such, it presents only brief discussions or statements of the data and analysis used to estimate the value conclusion. The scope of the assignment and report content is specific to the needs of the client and for the intended use as stated by the client.  The Evaluator(s) listed below are not responsible for unauthorized use of this report."

data/lib/appraisermetrics_report_service.rb

@@ -0,0 +1,8 @@
+module AppraisermetricsReportService
+	require 'prawn'
+	require 'prawn/table'
+	require 'money'
+	require 'report_utils'
+	require 'closed_sale'
+	require 'eval_report'
+end

data/lib/appraisermetrics_report_service/version.rb

@@ -0,0 +1,3 @@
+module AppraisermetricsReportService
+  VERSION = "0.0.1"
+end

data/lib/closed_sale.rb

@@ -0,0 +1,706 @@
+class ClosedSale < Prawn::Document
+	require 'prawn'
+	require 'prawn/table'
+	require 'date'
+
+	include ReportUtils
+
+	def initialize()
+		super()
+	end
+
+	def write_content(report_doc, images, office_logo) # the call to add content to pdf
+		font_size 6
+		@rep = report_doc
+		@property_images = images
+		@office_logo = office_logo
+		
+		## page 1 ##
+
+		# render office logo image if present
+		render_logo
+
+		# rendering bounding boxes and tables
+		meta_data
+		property_class
+		profile_image
+		property_type_and_address
+		transaction_summary
+		land_classification
+		physical_overview
+		cash_flow
+		income_expense
+
+		start_new_page
+
+		## page 2 ##
+		comments
+		legal_transaction
+		# move to full width table
+		transaction_history
+		utilities
+		improvements
+		water_rights
+
+		start_new_page
+		## page 3 ##
+		water_distribution
+		crop_yield
+		estimated_productivity
+		perm_plantings
+		externalities
+
+		start_new_page
+		## page 4 ##
+		additional_images
+
+
+	end
+
+	def render_logo
+		if @office_logo
+			image @office_logo, height: 25
+		end
+	end
+
+
+	def meta_data
+		bounding_box([0, 690], width: 270, height: 55) do
+			meta_data = [
+				["Record Number:", @rep[:sequence]], 
+				["Record Created By:", @rep[:record_created_by]],
+				["Date Created or Last Modified:", datemaker(@rep[:record_edited])]
+			]
+			
+			table(meta_data) do # record meta data table with image
+				columns(0..1).width = 135
+				columns([0]).style(font_style: :bold)
+				cells.style(border_width: 0)
+				cells.padding = [1, 2.5]
+			end
+			stroke_bounds
+		end
+	end
+
+	def profile_image
+		bounding_box([0, 635], width: 270, height: 275) do
+			if @property_images && @property_images.any?
+				image "#{@property_images.first}", width: 265
+			else
+				text "No Image"
+			end
+			stroke_bounds
+		end
+	end
+
+	def land_classification
+		bounding_box([0, 360], width: 270, height: 180) do
+			classification_data = [
+				[{content: "Land Classification Breakdown", colspan: 4}],
+				["Land Class:", "Acres:", "$/Acre:", "Total:"],
+			]
+
+			land_classes = @rep[:landclassifications]
+			if land_classes # node could be nil
+
+				total_acres = 0 # value to add to in loop
+				total_dollar = 0
+
+				land_classes.each do |l|
+					if l # array could be empty
+						if l[:priceperacre] # priceperacre could be nil, avoid nomethod errors below by checking
+							m = Money.new(l[:priceperacre][:cents], l[:priceperacre][:currency_iso])
+							per_acre_string = m.format(no_cents: true)
+							total_string = (m * l[:numacres]).format(no_cents: true)
+
+							total_acres += no_nil_number(l[:numacres]) # add to total
+							total_dollar += m.to_f * l[:numacres]
+
+							classification_data.push(
+								[
+									l[:landclass], 
+									'%.2f' % no_nil_number(l[:numacres]), # => adds .00 to acres
+									per_acre_string,
+									total_string
+								]
+							)
+						end
+					end
+				end # end block
+
+				total_dollar_string = Money.new(total_dollar * 100, 'USD').format(no_cents: true)
+				total_per_acre = Money.new((total_dollar / total_acres) * 100, 'USD')
+				total_per_acre_string = total_per_acre.format(no_cents: true)
+				
+				# push totals into table
+				classification_data.push(
+					["", "", "", ""], # line space
+					["Totals", '%.2f' % total_acres, total_per_acre_string, total_dollar_string]
+				)
+
+				if @rep[:imprv_unitprice]
+					improv_alloc = Money.new(@rep[:imprv_unitprice][:cents], 'USD')
+				else
+					improv_alloc = Money.new(0, 'USD')
+				end
+
+				classification_data.push([
+					"Total $ to Imprv", moneymaker(@rep[:total_imprv_budget], true), 
+					"Imprv $/AC Alloc", improv_alloc.format(no_cents: :true)],
+					[{content: "Total Land and Improvement $/AC", colspan: 3}, (total_per_acre + improv_alloc).format(no_cents: :true)])
+			end
+
+			table(classification_data) do # land classification breakdown table
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns(1..3).style(align: :right)
+				cells.style(border_width: 0)
+				cells.padding = [1, 2.5]
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row(1).style(align: :right, font_style: :bold, border_bottom_width: 0.5)
+				row(-3).style(border_bottom_width: 0.5, font_style: :bold)
+			end
+			stroke_bounds
+		end
+	end
+
+	def cash_flow
+		bounding_box([0, 180], width: 270, height: 180) do
+			cash_flow_data = [
+				[{content: "Cash Flow - Production Analysis", colspan: 4}],
+				["Income Source", "Stable $/Unit", "Stablilized Yield/Unit", "No. of Source, i.e. AC"]
+			]
+
+			incomes = @rep[:incomes]
+
+			if incomes # node could be nil
+				incomes.each do |i|
+					if i # array could be nil
+						cash_flow_data.push(
+							[
+								i[:incomesrc],
+								moneymaker(i[:stabcashperunit], false),
+								'%.2f' % i[:stabilizedyield],
+								'%.2f' % i[:totalunits]
+							]
+						)
+					end
+				end
+			end
+
+			table(cash_flow_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns(1..3).style(align: :right, font_style: :bold)
+				column(0).style(align: :left, font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8)
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, align: :center, font_style: nil)
+				cells.padding = [1, 2.5]
+			end
+			stroke_bounds
+		end
+	end
+
+	def comments
+		bounding_box([0, 690], width: 270, height: 125) do
+			comments_data = [
+				["Comments"],
+				[@rep[:general_comments]]
+			]
+
+			table(comments_data) do
+				row(0).style align: :center
+				column(0).width = 270
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+			end
+			stroke_bounds
+		end
+	end
+
+	def property_class
+		bounding_box([270, 690], width: 270, height: 55) do
+			property_data = [
+				["Property Classification:", @rep[:land_use_zone]],
+				["Transaction Type:", @rep[:type_of_transaction]],
+				["Property Name:", @rep[:property_name]]
+			]
+
+			table(property_data) do
+				column(0).style(align: :right)
+				column([1]).style(font_style: :bold)
+				columns(0..1).width = 135
+				cells.style(border_width: 0)
+				cells.padding = [1, 2.5]
+			end
+			stroke_bounds
+		end
+	end
+
+	def property_type_and_address
+		bounding_box([270, 635], height: 145, width: 270) do
+			pos = @rep[:position] # lat and long
+			if pos
+				lat, long = pos[0], pos[1]
+			else
+				lat, long = " ", " "
+			end
+
+			property_inclusions = no_nil_array(@rep[:property_inclusions]).join(" ")
+			type_and_address_data = [
+				[{content: "Property Type and Address", colspan: 4}],
+				["Property Name:", @rep[:property_name], "Primary Land Use:", @rep[:primary_ag_use]],
+				["What does this property include?", 
+					{content: property_inclusions, colspan: 3}],
+				["Address:", {content: "#{@rep[:property_address_number]}" + " #{@rep[:street_or_road_name]}", colspan: 3}],
+				["City:", @rep[:city], "County:", @rep[:ordinance_authority]],
+				["State:", no_nil_string(@rep[:county_state]).strip.chars.last(2).join(""), "Zip Code:", @rep[:zip_code]],
+				["Township/Range:","#{@rep[:townshipINT]}" + "#{@rep[:rangeINT]}", "Section(s):", @rep[:legal_description]],
+				["Latitude:", lat, "Longitude:", long],
+				[{content: "Property Location and Directions:" + "#{@rep[:directions_or_ownership_comments]}", colspan: 4}]
+			]
+
+			table(type_and_address_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns([0, 2]).style(align: :right)
+				columns([1, 3]).style(font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+			end
+			stroke_bounds
+		end
+	end
+
+	def transaction_summary
+		bounding_box([270, 490], height: 130, width: 270) do
+			price = moneymaker(@rep[:sale_price], true)
+			adjustment = moneymaker(@rep[:sale_adjustment], true)
+			ce_sale_price = moneymaker(@rep[:cesaleprice], true)
+			transaction_data = [
+				[{content: "Transaction Summary", colspan: 4}],
+				["Sale Price $:", price, "Sale Date:", datemaker(@rep[:sale_date])],
+				["Cond. Adjust $:", '(' + adjustment +')', "Adj. CE Sale $:", ce_sale_price],
+				["Unit Description:", @rep[:unit], "No. of Units:", '%.2f' % no_nil_number(@rep[:num_of_units])],
+				["Instrument No.:", @rep[:public_rec_ref_numer], "$/Unit:", moneymaker(@rep[:cesaleunitprice], true)],
+				["Seller:", @rep[:grantor], "Buyer:", @rep[:grantee]],
+				["Extent of Verification:", {content: no_nil_array(@rep[:verifications]).join(', '), colspan: 3}],
+				[{content: "#{@rep[:grantor]}" + " #{@rep[:information_source_contact]}", 
+					colspan: 2}, "Date Inspected:", datemaker(@rep[:date_inspected])
+				]
+			]
+
+			table(transaction_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns([0, 2]).style align: :right
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				columns([1, 3]).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+			end
+			stroke_bounds
+		end
+	end
+
+	def physical_overview
+		bounding_box([270, 360], height: 180, width: 270) do
+			overview_data = [
+				[{content: "Physical Overview", colspan: 4}],
+				["Farming Practice:", @rep[:farming_practices], {content: "Predominant Soil Type and Description:", colspan: 2}],
+				["Ann. Rainfall-Inches:", @rep[:avg_precipitation], {content: @rep[:soils], colspan: 2, rowspan: 3}],
+				["Avg Frost Free Days:", @rep[:growing_season]],
+				["Elevation(Range):", @rep[:elevation]],
+				["Predom Top Slope:", @rep[:topography], "Legal Access:", {content: @rep[:legal_access], rowspan: 2}],
+				["Corn Suitability Rating:", @rep[:CSR2]],
+				["Land Use Zone:", @rep[:land_use_zone], "Physical Access:", @rep[:physical_access]],
+				["Flood Zone:", no_nil_array(@rep[:flood_zone]).join(", "), "Wetlands:", @rep[:wetlands]],
+				[{content: "Land Development Potential, Change or Use, or Limitations Comments:", colspan: 4}],
+				[{content: "#{@rep[:development_potential]}" , colspan: 4}]
+			]
+
+			table(overview_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns([0, 2]).style(align: :right)
+				columns([1, 3]).style(font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row(9).style(align: :left)
+			end
+			stroke_bounds
+		end
+	end
+
+	def income_expense
+		bounding_box([270, 180], height: 180, width: 270) do
+
+			income = Money.new(no_nil_number(@rep[:eff_gross_income]) * 100, 'USD')
+			expense = Money.new(no_nil_number(@rep[:total_expenses]) * 100, 'USD')
+			noi = income - expense
+			noi_string = noi.format(no_cents: :true)
+			expense_ratio = "#{((expense / income) * 100).round(2)}" + "%"
+
+			income_expense_data = [
+				[{content: "Income/Expense Information", colspan: 4}],
+				["Total Farm Income:", income.format(no_cents: true), "Total Income to LL:", income.format(no_cents: true)],
+				["Total Farm Expenses:", expense.format(no_cents: true), "Total Exp pd by LL:", expense.format(no_cents: true)],
+				["NOI:", noi_string, "Expense Ratio:", expense_ratio],
+				["Cap Rate or OAR", "#{@rep[:overall_capitalization_rate]}%", " ", " "],
+				[{content: "Cash Flow Comments:", colspan: 4}],
+				[{content: @rep[:income_comments], colspan: 4}],
+				["Annual Water $/Acre:", moneymaker(@rep[:irrig_cost_per_acre], true)],
+				["Annual Pumping $/Acre:", moneymaker(@rep[:pumping_cost_per_acre], true)]
+			]
+
+			table(income_expense_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns(0..3).style(align: :right)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				columns([1, 3]).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row([5, 6]).style(align: :left)
+			end
+			stroke_bounds
+		end
+	end
+
+	def legal_transaction
+		bounding_box([270, 690], height: 125, width: 270) do
+
+			taxes = @rep[:taxes]
+			if taxes # node could be nil
+				if taxes[0] # array could be empty
+					tax_parcel_no = taxes[0][:tax_parcel_no]
+					assessed_value = moneymaker(taxes[0][:assessed_value], true)
+					real_estate_taxes = moneymaker(taxes[0][:RET], true)
+				end
+			else # deal with nil values to avoid no method errors
+				tax_parcel_no, assessed_value, real_estate_taxes = "", "", ""
+			end
+
+			legal_transaction_data = [
+				[{content: "Legal/Transaction Detail", colspan: 4}],
+				["Tax Parcel ID(s)", tax_parcel_no, " ", " "],
+				[" ", " ", " ", " "],
+				["Year of Assessment:", @rep[:year_of_assessment], "Year of RE Taxes:", @rep[:year_of_real_estate_taxes]],
+				["Assessed Value:", assessed_value, "RE Taxes", real_estate_taxes],
+				["Financing:", @rep[:financing_type], "Property Rights:", @rep[:property_rights]],
+				["At Market Trans?:", @rep[:atmarket_trans], "Days on Market:", @rep[:exposure_period]],
+				[{content: "Transaction History Comments:", colspan: 4}],
+				[{content: @rep[:listing_comments], colspan: 4}]
+			]
+
+			table(legal_transaction_data) do
+				columns(0..1).width = 68
+				columns(2..3).width = 67
+				columns([1, 3]).style(font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+			end
+			stroke_bounds
+		end
+	end
+
+	def transaction_history
+		bounding_box([0, 565], height: 125, width: 540) do
+			transaction_history_data = [
+				[{content: "Transaction History", colspan: 4}],
+				["Historic Transaction Type", "Transaction Description", "Date", "Sale Price, List Price, or List Price"]
+			]
+
+			transactions = @rep[:historyrecords]
+
+			if transactions # node could be nil
+				transactions.each do |t|
+					if t # array could be nil
+						transaction_history_data.push(
+							[t[:transType], t[:transDescr], datemaker(t[:transDate]), moneymaker(t[:price], true)]
+						)
+					end
+				end
+			end
+
+			table(transaction_history_data) do
+				columns(0..3).width = 135
+				columns(0..3).style(align: :right, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+			stroke_bounds
+		end
+	end
+
+	def utilities
+		bounding_box([0, 440], height: 125, width: 540) do
+			utilities_data = [
+				[{content: "Description of Utilities", colspan: 4}],
+				["Utility Description", "Service Availability", "Service Provider", "Comments"]
+			]
+
+			utilities = @rep[:utilities]
+			if utilities # node could be nil
+				utilities.each do |u|
+					if u # array could be empty
+						utilities_data.push(
+							[u[:description], u[:availbility], u[:provider], u[:comments]]
+						)
+					end
+				end
+			end
+
+			table(utilities_data) do
+				columns(0..3).width = 135
+				columns(0..3).style(align: :right, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+			stroke_bounds
+		end
+	end
+
+	def improvements
+		bounding_box([0, 315], height: 220, width: 540) do
+
+			improvements_array = @rep[:improvements]			
+			
+			sorted_array = flip_improvements_array(improvements_array)
+
+			table(sorted_array) do
+				columns(0..7).width = 67.5
+				columns(1..7).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end 
+			stroke_bounds
+		end
+	end
+
+	def water_rights
+		bounding_box([0, 95], height: 95, width: 540) do
+
+			water_rights_data = [
+				[{content: "Water Rights", colspan: 8}],
+				["Water Right No.", "Water Right", "Water Source", "Priority Date", "Beneficial Use", "No. Acres Irrigated", "Annual Volume Ac-Ft", "Period of Use"]
+			]
+
+			rights = @rep[:waterrights]
+			if rights # node could be nil
+				rights.each do |r|
+					if r # array could be empty
+						water_rights_data.push(
+							[r[:waterrightNum], r[:waterRight], r[:waterSrc], datemaker(r[:priorityDate]), r[:purpose], r[:numIrrAcres], r[:annVolume]]
+						)
+					end
+				end
+			end
+
+			table(water_rights_data) do
+				columns(0..7).width = 67.5
+				columns(0..7).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+
+			stroke_bounds
+		end
+	end
+
+	def water_distribution
+		bounding_box([0, 690], height: 100, width: 540) do
+
+			distribution_data = [
+				[{content: "Water Distribution System", colspan: 8}],
+				["Water Distrib. Equip.", "Manuf.", "Make/Brand", "Type", "Description", "Yr. Manufactured", "Remaining Ec. Life", "No. Acres Irrigated"]
+			]
+
+			distributions = @rep[:waterdistributions]
+
+			if distributions # node could be nil
+				distributions.each do |d|
+					if d # array could be empty
+						distribution_data.push(
+							[d[:waterdistrEq], d[:manufacturer], d[:brand], d[:eqType], d[:descr], d[:yearManuf], d[:remainingEcLife], d[:irrAcres]]
+						)
+					end
+				end
+			end
+
+			table(distribution_data) do
+				columns(0..7).width = 67.5
+				columns(0..7).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+
+			stroke_bounds
+		end
+	end
+
+	def crop_yield
+		bounding_box([0, 590], height: 135, width: 540) do
+
+			crops = @rep[:crops]
+
+			crop_data = [
+				[{content: "Crop Yield Summary", colspan: 7}],
+				["Crop Year", "Commodity Identified", "Unit of Measure", "Average Yield", " ", " ", ", "]
+			]
+
+			if crops # node could be nil
+				crops.each do |c|
+					if c # array could be empty
+						crop_data.push(
+							[c[:year], c[:commodity], c[:unit], c[:avgyield]]
+						)
+					end
+				end
+			end
+
+			table(crop_data) do
+				column(0).width = 135
+				columns(1..6).width = 67.5
+				columns(0..6).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+			stroke_bounds
+		end
+	end
+
+	def estimated_productivity
+		bounding_box([0, 455], height: 120, width: 540) do
+			estimatedproductivity = @rep[:estimatedproductivity]
+
+			production_data = [
+				[{content: "Estimated Productivity", colspan: 4}],
+				["Commodity Identification", "Unit Measure", "Estimated Yield", " "]
+			]
+
+			if estimatedproductivity && estimatedproductivity.any?
+				estimatedproductivity.each do |p|
+					production_data.push(
+						["#{p[:commodity]}", "#{p[:unit]}", "#{p[:estmtdyield]}"]
+					)
+				end
+			end
+
+			table(production_data) do
+				columns(0..3).width = 135
+				columns(0..3).style(font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+
+			stroke_bounds
+		end
+	end
+
+	def perm_plantings
+		bounding_box([0, 335], height: 135, width: 540) do
+			planting_data = [
+				[{content: "Permanent Plantings", colspan: 8}],
+				["Planting", "Variety", "Ac. Type", "No. of Acres", "Average Age", "Plants/Acre", "Unit Description", "Average Yield"]
+			]
+
+			plantings = @rep[:plantings]
+
+			if plantings # node could be nil
+				plantings.each do |p|
+					if p # array could be empty
+						planting_data.push(
+							[p[:planting], p[:variety], p[:acres], p[:numacres], p[:avgage], p[:plantsacre], p[:unitdescr1], p[:avgproduction]]
+						)
+					end
+				end
+			end
+
+			table(planting_data) do
+				columns(0..7).width = 67.5
+				columns(0..7).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+				row(1).style(border_bottom_width: 0.5, font_style: nil)
+			end
+			
+			stroke_bounds
+		end
+	end
+
+	def externalities
+		bounding_box([0, 200], height: 200, width: 540) do
+			
+			extern_data = ReportUtils.conditional_externs_array(@rep) # instance method to populate dynamic array
+			table(extern_data) do
+				columns(0..3).width = 135
+				columns([1, 3]).style(font_style: :bold)
+				row(0).style(align: :center, background_color: 'd7d7d7', font_size: 8, font_style: :bold)
+				cells.padding = [1, 2.5]
+				cells.style(border_width: 0)
+			end
+
+			stroke_bounds
+		end
+	end
+
+	def additional_images
+		if @property_images && @property_images.any?
+			if @property_images[1]
+				bounding_box([0, 690], height: 330, width: 250) do
+					image @property_images[1], width: 240
+				end
+			end
+
+			if @property_images[2]
+				bounding_box([270, 690], height: 330, width: 250) do
+					image @property_images[2], width: 240
+				end
+			end
+
+			if @property_images[3]
+				bounding_box([0, 340], height: 330, width: 250) do
+					image @property_images[3], width: 240
+				end
+			end
+
+			if @property_images[4]
+				bounding_box([270, 340], height: 330, width: 250) do
+					image @property_images[4], width: 240
+				end
+			end
+		end
+	end
+end
+
+# misc. notes
+
+# the first page of the report is split into two columns using bounding boxes, each is 270 p wide
+
+##### tables ######
+# - 4 column layout [68, 67, 67, 68]
+# - 3 column tables can be used if needed [90, 90, 90]
+# - 2 column layout [135, 135]
+# - for dynamic layouts within an existing layout, pass colspan and content to data array like so: 
+# - {content: "double span", colspan: 2} => spans two columns with content