proptax 0.0.1 → 0.0.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +38 -4
  3. data/lib/proptax/version.rb +1 -1
  4. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 6dc77c2e564347a1bf8b2efb16fe57c1bb0dc551
4
- data.tar.gz: cd89de94ba9ca334fcbd8225167f10f135f2957e
3
+ metadata.gz: 7b3c8f9309c215e5aeda33f145e82ba4afa4ad42
4
+ data.tar.gz: df2346c9387f9955cea76ebb9992e3a9b3cd3614
5
5
  SHA512:
6
- metadata.gz: 653113a33d9501a650541a6fa13effb72a80865f97191cd71f4c12f4f78f32e692163582b66fe3af60a055aaf00d4b0944c6b695619494ae98efa0b6288d09b8
7
- data.tar.gz: 393d3e9942e077299fa670370e8ccf12a43888c039f39312317deec2cbdaa3cad8030ca4e6f444216703c3b7f547ca0561c0732a1529c4352da74ead7ff686f0
6
+ metadata.gz: c7799f96bb99a50f0d2e1c3c926d06a62f9aad49732135d9b4b5c40a50dfef70bf33de0fa3c7f4f785eab11c547495f1789a217a0ef090435b6240da07a46179
7
+ data.tar.gz: 5d49a332bc6c98f330527510997097498756294cd052957f40272c81c45b393ca53772f7bbfb9f9cf4fe3b2212662d93a72c52a00103def682cc34773a72b7ff
data/README.md CHANGED
@@ -20,7 +20,7 @@ This software automatically generates the reports I submit as evidence before th
20
20
  4. `pandoc`
21
21
  5. `R`
22
22
 
23
- The following commands will install all third party dependencies:
23
+ The following commands will install all third party dependencies on Ubuntu 16.04:
24
24
 
25
25
  ```
26
26
  sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
@@ -31,7 +31,7 @@ sudo apt install -y ghostscript tesseract-ocr enscript pandoc r-base r-base-dev
31
31
 
32
32
  ### R
33
33
 
34
- `R` does the bulk of the data processing. It has some dependencies that are not available from Ubuntu 16.04 (Xenial) PPAs. They need to be installed into the `R` environment directly.
34
+ `R` does the bulk of the data processing. It has some dependencies that are not available from Ubuntu PPAs. They need to be installed into the `R` environment directly.
35
35
 
36
36
  Execute the following to open the `R` command prompt:
37
37
 
@@ -54,7 +54,7 @@ Assuming successful installation, you can exit `R` by holding `Ctrl-D`.
54
54
 
55
55
  `proptax` is a `ruby` program. As such, you need to [install ruby](https://www.digitalocean.com/community/tutorials/how-to-install-ruby-on-rails-with-rbenv-on-ubuntu-16-04).
56
56
 
57
- You install the latest release of `proptax` like this:
57
+ Assuming `ruby`, et al, are installed, you install the latest release of `proptax` like this:
58
58
 
59
59
  ```
60
60
  gem install proptax
@@ -66,7 +66,41 @@ gem install proptax
66
66
 
67
67
  Last year I made a whole series of super-boring [YouTube tutorials](https://www.youtube.com/playlist?list=PLkQAXLFkBnmiB8O06C2oGAoarBCVO7M9J) on how to collect and process your property data. The collection process has changed slightly, but [the first video](https://www.youtube.com/watch?v=m0zzsL0DYlI&list=PLkQAXLFkBnmiB8O06C2oGAoarBCVO7M9J&index=2) should point you in the right direction. You only get 50 reports per year for some reason, so use 'em all up (and send them to me)!
68
68
 
69
- TODO: More usage instructions to come...
69
+ ## Analyze your immediate neighbours
70
+
71
+ I collect reports for all the houses on my street - from one corner to the next - and save them into their own folder. I live on a very long street, so I collect 18 reports. You can do the same, or you can pick the houses against which you want to draw comparisons (see _cherry picking_ below). This is handy for when the City provides their own sales comparison reports as evidence before the ARB.
72
+
73
+ Suppose all my reports are saved in `~/prop-reports-2018`. From the command line, I execute the following:
74
+
75
+ ```
76
+ proptax auto ~/prop-reports-2018
77
+ ```
78
+
79
+ This is as basic as you can get. You'll see the software's progress on the screen. Once completed, execute:
80
+
81
+ ```
82
+ ls -l ~/prop-reports-2018/reports/*.pdf
83
+ ```
84
+
85
+ You'll see the same property analysis for every house on your street. Find the one labelled with your address and see how you stack up against your neighbours. There are several related files in the newly-generated `reports/` directory. The PDFs are the ones I submit as evidence in my property tax appeals. I also submit `consolidated.csv`. It's from this CSV data that the reports are generated.
86
+
87
+ ## Cherry-picked analysis
88
+
89
+ Supposing you submit your PDF as evidence in your hearing before the ARB, the City will likely submit the houses against which they assessed your own house. These houses will probably be in your neighbourhood, but won't be all on your street. This requires a special `--template` command line option.
90
+
91
+ Again, having saved your property reports in their own folder (e.g., `~/prop-reports-2018-cp`), execute:
92
+
93
+ ```
94
+ proptax auto ~/prop-reports-2018-cp --template cherry-picked
95
+ ```
96
+
97
+ The analysis is identical, only the language contained in the reports changes. Developers, create any report template you like and submit a pull request!
98
+
99
+ As with the example above, your report and the reports for all the houses analyzed can be found here:
100
+
101
+ ```
102
+ ls -l ~/prop-reports-2018-cp/reports/*.pdf
103
+ ```
70
104
 
71
105
  # Development
72
106
 
@@ -1,3 +1,3 @@
1
1
  module Proptax
2
- VERSION = "0.0.1"
2
+ VERSION = "0.0.2"
3
3
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: proptax
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.1
4
+ version: 0.0.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Daniel Bidulock