ofac 1.2.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,8 @@
1
+ == 1.2.1 2010-12-21
2
+
3
+ * 1 enhancement:
4
+ * changed require 'activerecord' to 'active_record'.
5
+
1
6
  == 1.2.0 2010-12-14
2
7
 
3
8
  * 1 enhancement:
@@ -1,4 +1,5 @@
1
1
  ---
2
2
  :major: 1
3
3
  :minor: 2
4
- :patch: 0
4
+ :patch: 1
5
+ :build:
@@ -1,4 +1,4 @@
1
- require 'activerecord'
1
+ require 'active_record'
2
2
 
3
3
  class OfacSdn < ActiveRecord::Base
4
4
 
@@ -1,5 +1,5 @@
1
1
  require 'net/http'
2
- require 'activerecord'
2
+ require 'active_record'
3
3
  require 'active_record/connection_adapters/mysql_adapter'
4
4
 
5
5
  class OfacSdnLoader
@@ -0,0 +1,7 @@
1
+ file.reference.ofac-lib=lib
2
+ file.reference.ofac-test=test
3
+ main.file=
4
+ platform.active=Ruby_0
5
+ source.encoding=UTF-8
6
+ src.dir=${file.reference.ofac-lib}
7
+ test.src.dir=${file.reference.ofac-test}
@@ -0,0 +1,15 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project xmlns="http://www.netbeans.org/ns/project/1">
3
+ <type>org.netbeans.modules.ruby.rubyproject</type>
4
+ <configuration>
5
+ <data xmlns="http://www.netbeans.org/ns/ruby-project/1">
6
+ <name>ofac</name>
7
+ <source-roots>
8
+ <root id="src.dir"/>
9
+ </source-roots>
10
+ <test-roots>
11
+ <root id="test.src.dir"/>
12
+ </test-roots>
13
+ </data>
14
+ </configuration>
15
+ </project>
@@ -1,72 +1,71 @@
1
1
  # Generated by jeweler
2
- # DO NOT EDIT THIS FILE
3
- # Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
2
+ # DO NOT EDIT THIS FILE DIRECTLY
3
+ # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
4
4
  # -*- encoding: utf-8 -*-
5
5
 
6
6
  Gem::Specification.new do |s|
7
7
  s.name = %q{ofac}
8
- s.version = "1.2.0"
8
+ s.version = "1.2.1"
9
9
 
10
10
  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
11
  s.authors = ["Kevin Tyll"]
12
- s.date = %q{2010-12-14}
12
+ s.date = %q{2010-12-21}
13
13
  s.description = %q{Attempts to find a hit on the Office of Foreign Assets Control's Specially Designated Nationals list.}
14
14
  s.email = %q{kevintyll@gmail.com}
15
15
  s.extra_rdoc_files = [
16
16
  "LICENSE",
17
- "README.rdoc"
17
+ "README.rdoc"
18
18
  ]
19
19
  s.files = [
20
20
  ".document",
21
- ".gitignore",
22
- "History.txt",
23
- "LICENSE",
24
- "PostInstall.txt",
25
- "README.rdoc",
26
- "Rakefile",
27
- "VERSION.yml",
28
- "generators/ofac_migration/.DS_Store",
29
- "generators/ofac_migration/ofac_migration_generator.rb",
30
- "generators/ofac_migration/templates/.DS_Store",
31
- "generators/ofac_migration/templates/migration.rb",
32
- "lib/ofac.rb",
33
- "lib/ofac/models/ofac.rb",
34
- "lib/ofac/models/ofac_sdn.rb",
35
- "lib/ofac/models/ofac_sdn_loader.rb",
36
- "lib/ofac/ofac_match.rb",
37
- "lib/ofac/ruby_string_extensions.rb",
38
- "lib/tasks/ofac.rake",
39
- "nbproject/project.properties",
40
- "nbproject/project.xml",
41
- "ofac.gemspec",
42
- "pkg/ofac-0.1.0.gem",
43
- "pkg/ofac-1.0.0.gem",
44
- "rdoc/classes/Ofac.html",
45
- "rdoc/classes/OfacMatch.html",
46
- "rdoc/classes/OfacSdn.html",
47
- "rdoc/classes/OfacSdnLoader.html",
48
- "rdoc/classes/String.html",
49
- "rdoc/created.rid",
50
- "rdoc/files/README_rdoc.html",
51
- "rdoc/files/lib/ofac/models/ofac_rb.html",
52
- "rdoc/files/lib/ofac/models/ofac_sdn_loader_rb.html",
53
- "rdoc/files/lib/ofac/models/ofac_sdn_rb.html",
54
- "rdoc/files/lib/ofac/ofac_match_rb.html",
55
- "rdoc/files/lib/ofac/ruby_string_extensions_rb.html",
56
- "rdoc/files/lib/ofac_rb.html",
57
- "rdoc/fr_class_index.html",
58
- "rdoc/fr_file_index.html",
59
- "rdoc/fr_method_index.html",
60
- "rdoc/index.html",
61
- "rdoc/rdoc-style.css",
62
- "test/files/test_address_data_load.pip",
63
- "test/files/test_alt_data_load.pip",
64
- "test/files/test_sdn_data_load.pip",
65
- "test/files/valid_flattened_file.csv",
66
- "test/mocks/test/ofac_sdn_loader.rb",
67
- "test/ofac_sdn_loader_test.rb",
68
- "test/ofac_test.rb",
69
- "test/test_helper.rb"
21
+ "History.txt",
22
+ "LICENSE",
23
+ "PostInstall.txt",
24
+ "README.rdoc",
25
+ "Rakefile",
26
+ "VERSION.yml",
27
+ "generators/ofac_migration/.DS_Store",
28
+ "generators/ofac_migration/ofac_migration_generator.rb",
29
+ "generators/ofac_migration/templates/.DS_Store",
30
+ "generators/ofac_migration/templates/migration.rb",
31
+ "lib/ofac.rb",
32
+ "lib/ofac/models/ofac.rb",
33
+ "lib/ofac/models/ofac_sdn.rb",
34
+ "lib/ofac/models/ofac_sdn_loader.rb",
35
+ "lib/ofac/ofac_match.rb",
36
+ "lib/ofac/ruby_string_extensions.rb",
37
+ "lib/tasks/ofac.rake",
38
+ "nbproject/project.properties",
39
+ "nbproject/project.xml",
40
+ "ofac.gemspec",
41
+ "pkg/ofac-0.1.0.gem",
42
+ "pkg/ofac-1.0.0.gem",
43
+ "rdoc/classes/Ofac.html",
44
+ "rdoc/classes/OfacMatch.html",
45
+ "rdoc/classes/OfacSdn.html",
46
+ "rdoc/classes/OfacSdnLoader.html",
47
+ "rdoc/classes/String.html",
48
+ "rdoc/created.rid",
49
+ "rdoc/files/README_rdoc.html",
50
+ "rdoc/files/lib/ofac/models/ofac_rb.html",
51
+ "rdoc/files/lib/ofac/models/ofac_sdn_loader_rb.html",
52
+ "rdoc/files/lib/ofac/models/ofac_sdn_rb.html",
53
+ "rdoc/files/lib/ofac/ofac_match_rb.html",
54
+ "rdoc/files/lib/ofac/ruby_string_extensions_rb.html",
55
+ "rdoc/files/lib/ofac_rb.html",
56
+ "rdoc/fr_class_index.html",
57
+ "rdoc/fr_file_index.html",
58
+ "rdoc/fr_method_index.html",
59
+ "rdoc/index.html",
60
+ "rdoc/rdoc-style.css",
61
+ "test/files/test_address_data_load.pip",
62
+ "test/files/test_alt_data_load.pip",
63
+ "test/files/test_sdn_data_load.pip",
64
+ "test/files/valid_flattened_file.csv",
65
+ "test/mocks/test/ofac_sdn_loader.rb",
66
+ "test/ofac_sdn_loader_test.rb",
67
+ "test/ofac_test.rb",
68
+ "test/test_helper.rb"
70
69
  ]
71
70
  s.homepage = %q{http://github.com/kevintyll/ofac}
72
71
  s.post_install_message = %q{For more information on ofac, see http://kevintyll.github.com/ofac/
@@ -80,15 +79,14 @@ Gem::Specification.new do |s|
80
79
 
81
80
  * The OFAC data is not updated with any regularity, but you can sign up for email notifications when the data changes at
82
81
  http://www.treas.gov/offices/enforcement/ofac/sdn/index.shtml.}
83
- s.rdoc_options = ["--charset=UTF-8"]
84
82
  s.require_paths = ["lib"]
85
83
  s.rubygems_version = %q{1.3.6}
86
84
  s.summary = %q{Attempts to find a hit on the Office of Foreign Assets Control's Specially Designated Nationals list.}
87
85
  s.test_files = [
86
+ "test/mocks/test/ofac_sdn_loader.rb",
88
87
  "test/ofac_sdn_loader_test.rb",
89
- "test/ofac_test.rb",
90
- "test/test_helper.rb",
91
- "test/mocks/test/ofac_sdn_loader.rb"
88
+ "test/ofac_test.rb",
89
+ "test/test_helper.rb"
92
90
  ]
93
91
 
94
92
  if s.respond_to? :specification_version then
@@ -101,3 +99,4 @@ Gem::Specification.new do |s|
101
99
  else
102
100
  end
103
101
  end
102
+
Binary file
Binary file
@@ -0,0 +1,411 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: Ofac</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Class</strong></td>
53
+ <td class="class-name-in-header">Ofac</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../files/lib/ofac/models/ofac_rb.html">
59
+ lib/ofac/models/ofac.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ <tr class="top-aligned-row">
66
+ <td><strong>Parent:</strong></td>
67
+ <td>
68
+ Object
69
+ </td>
70
+ </tr>
71
+ </table>
72
+ </div>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+
77
+
78
+
79
+ <div id="contextContent">
80
+
81
+
82
+
83
+ </div>
84
+
85
+ <div id="method-list">
86
+ <h3 class="section-bar">Methods</h3>
87
+
88
+ <div class="name-list">
89
+ <a href="#M000007">db_hit?</a>&nbsp;&nbsp;
90
+ <a href="#M000005">new</a>&nbsp;&nbsp;
91
+ <a href="#M000008">possible_hits</a>&nbsp;&nbsp;
92
+ <a href="#M000006">score</a>&nbsp;&nbsp;
93
+ </div>
94
+ </div>
95
+
96
+ </div>
97
+
98
+
99
+ <!-- if includes -->
100
+
101
+ <div id="section">
102
+
103
+
104
+
105
+
106
+
107
+
108
+
109
+
110
+ <!-- if method_list -->
111
+ <div id="methods">
112
+ <h3 class="section-bar">Public Class methods</h3>
113
+
114
+ <div id="method-M000005" class="method-detail">
115
+ <a name="M000005"></a>
116
+
117
+ <div class="method-heading">
118
+ <a href="#M000005" class="method-signature">
119
+ <span class="method-name">new</span><span class="method-args">(identity)</span>
120
+ </a>
121
+ </div>
122
+
123
+ <div class="method-description">
124
+ <p>
125
+ Accepts a hash with the identity&#8216;s demographic information
126
+ </p>
127
+ <pre>
128
+ Ofac.new({:name =&gt; 'Oscar Hernandez', :city =&gt; 'Clearwater', :address =&gt; '123 somewhere ln'})
129
+ </pre>
130
+ <p>
131
+ <tt>:name</tt> is required to get a <a href="Ofac.html#M000006">score</a>.
132
+ If <tt>:name</tt> is missing, an error will not be thrown, but a <a
133
+ href="Ofac.html#M000006">score</a> of 0 will be returned.
134
+ </p>
135
+ <p>
136
+ You can pass a string in for the full name:
137
+ </p>
138
+ <pre>
139
+ Ofac.new(:name =&gt; 'Victor De La Garza')
140
+ </pre>
141
+ <p>
142
+ Or you can specify the last and first names
143
+ </p>
144
+ <pre>
145
+ Ofac.new(:name =&gt; {:first_name =&gt; 'Victor', :last_name =&gt; 'De La Garza'})
146
+ </pre>
147
+ <p>
148
+ The first method will build a larger list of names for ruby to parse
149
+ through and more likely to find similar names. The second method is
150
+ quicker.
151
+ </p>
152
+ <p>
153
+ The more information provided, the higher the <a
154
+ href="Ofac.html#M000006">score</a> could be. A <a
155
+ href="Ofac.html#M000006">score</a> of 100 would mean all fields were passed
156
+ in, and all fields were 100% matches. If only the name is passed in without
157
+ an address, it will be impossible to get a <a
158
+ href="Ofac.html#M000006">score</a> of 100, even if the name matches
159
+ perfectly.
160
+ </p>
161
+ <p>
162
+ Acceptable hash keys and their weighting in <a
163
+ href="Ofac.html#M000006">score</a> calculation:
164
+ </p>
165
+ <ul>
166
+ <li><tt>:name</tt> (weighting = 60%) (required) This can be a person, business,
167
+ or marine vessel
168
+
169
+ </li>
170
+ <li><tt>:address</tt> (weighting = 10%)
171
+
172
+ </li>
173
+ <li><tt>:city</tt> (weighting = 30%)
174
+
175
+ </li>
176
+ </ul>
177
+ <p><a class="source-toggle" href="#"
178
+ onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
179
+ <div class="method-source-code" id="M000005-source">
180
+ <pre>
181
+ <span class="ruby-comment cmt"># File lib/ofac/models/ofac.rb, line 28</span>
182
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">identity</span>)
183
+ <span class="ruby-ivar">@identity</span> = <span class="ruby-identifier">identity</span>
184
+ <span class="ruby-keyword kw">end</span>
185
+ </pre>
186
+ </div>
187
+ </div>
188
+ </div>
189
+
190
+ <h3 class="section-bar">Public Instance methods</h3>
191
+
192
+ <div id="method-M000007" class="method-detail">
193
+ <a name="M000007"></a>
194
+
195
+ <div class="method-heading">
196
+ <a href="#M000007" class="method-signature">
197
+ <span class="method-name">db_hit?</span><span class="method-args">()</span>
198
+ </a>
199
+ </div>
200
+
201
+ <div class="method-description">
202
+ <p><a class="source-toggle" href="#"
203
+ onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
204
+ <div class="method-source-code" id="M000007-source">
205
+ <pre>
206
+ <span class="ruby-comment cmt"># File lib/ofac/models/ofac.rb, line 89</span>
207
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">db_hit?</span>
208
+ <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@identity</span>[<span class="ruby-identifier">:name</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">blank?</span>
209
+
210
+ <span class="ruby-comment cmt">#first get a list from the database of possible matches by name</span>
211
+ <span class="ruby-comment cmt">#this query is pretty liberal, we just want to get a list of possible</span>
212
+ <span class="ruby-comment cmt">#matches from the database that we can run through our ruby matching algorithm</span>
213
+ <span class="ruby-identifier">possible_sdns</span> = []
214
+ <span class="ruby-identifier">name_array</span> = <span class="ruby-identifier">process_name</span>
215
+
216
+ <span class="ruby-identifier">name_array</span>.<span class="ruby-identifier">delete_if</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">n</span><span class="ruby-operator">|</span> <span class="ruby-identifier">n</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">2</span>}
217
+ <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">name_array</span>.<span class="ruby-identifier">empty?</span>
218
+ <span class="ruby-identifier">sql_name_partial</span> = <span class="ruby-identifier">name_array</span>.<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">partial_name</span><span class="ruby-operator">|</span> [<span class="ruby-value str">&quot;name like ?&quot;</span>, <span class="ruby-node">&quot;%#{partial_name}%&quot;</span>]}
219
+ <span class="ruby-identifier">sql_alt_name_partial</span> = <span class="ruby-identifier">name_array</span>.<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">partial_name</span><span class="ruby-operator">|</span> [<span class="ruby-value str">&quot;alternate_identity_name like ?&quot;</span>, <span class="ruby-node">&quot;%#{partial_name}%&quot;</span>]}
220
+
221
+ <span class="ruby-identifier">name_conditions</span> = <span class="ruby-identifier">sql_name_partial</span>.<span class="ruby-identifier">transpose</span>
222
+ <span class="ruby-identifier">name_values</span> = <span class="ruby-identifier">name_conditions</span>.<span class="ruby-identifier">second</span>
223
+ <span class="ruby-identifier">name_conditions</span> = [<span class="ruby-identifier">name_conditions</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' and '</span>)]
224
+ <span class="ruby-identifier">alt_name_conditions</span> = <span class="ruby-identifier">sql_alt_name_partial</span>.<span class="ruby-identifier">transpose</span>
225
+ <span class="ruby-identifier">alt_name_values</span> = <span class="ruby-identifier">alt_name_conditions</span>.<span class="ruby-identifier">second</span>
226
+ <span class="ruby-identifier">alt_name_conditions</span> = [<span class="ruby-identifier">alt_name_conditions</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' and '</span>)]
227
+ <span class="ruby-identifier">conditions</span> = [<span class="ruby-node">&quot;(#{name_conditions}) or (#{alt_name_conditions})&quot;</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">name_values</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">alt_name_values</span>
228
+
229
+ <span class="ruby-identifier">possible_sdns</span> = <span class="ruby-constant">OfacSdn</span>.<span class="ruby-identifier">find_all_by_sdn_type</span>(<span class="ruby-value str">'individual'</span>,<span class="ruby-identifier">:select</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">'name, alternate_identity_name, address, city'</span>, <span class="ruby-identifier">:conditions</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">conditions</span>)
230
+
231
+ <span class="ruby-keyword kw">end</span>
232
+ <span class="ruby-keyword kw">end</span>
233
+ <span class="ruby-operator">!</span><span class="ruby-identifier">possible_sdns</span>.<span class="ruby-identifier">empty?</span>
234
+ <span class="ruby-keyword kw">end</span>
235
+ </pre>
236
+ </div>
237
+ </div>
238
+ </div>
239
+
240
+ <div id="method-M000008" class="method-detail">
241
+ <a name="M000008"></a>
242
+
243
+ <div class="method-heading">
244
+ <a href="#M000008" class="method-signature">
245
+ <span class="method-name">possible_hits</span><span class="method-args">()</span>
246
+ </a>
247
+ </div>
248
+
249
+ <div class="method-description">
250
+ <pre>
251
+ Returns an array of hashes of records in the OFAC data that found partial matches with that record's score.
252
+
253
+ Ofac.new({:name =&gt; 'Oscar Hernandez', :city =&gt; 'Clearwater', :address =&gt; '123 somewhere ln'}).possible_hits
254
+ </pre>
255
+ <p>
256
+ returns
257
+ </p>
258
+ <pre>
259
+ [{:address=&gt;&quot;123 Somewhere Ln&quot;, :score=&gt;100, :name=&gt;&quot;HERNANDEZ, Oscar|GUAMATUR, S.A.&quot;, :city=&gt;&quot;Clearwater&quot;}, {:address=&gt;&quot;123 Somewhere Ln&quot;, :score=&gt;100, :name=&gt;&quot;HERNANDEZ, Oscar|Alternate Name&quot;, :city=&gt;&quot;Clearwater&quot;}]
260
+ </pre>
261
+ <p><a class="source-toggle" href="#"
262
+ onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
263
+ <div class="method-source-code" id="M000008-source">
264
+ <pre>
265
+ <span class="ruby-comment cmt"># File lib/ofac/models/ofac.rb, line 124</span>
266
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">possible_hits</span>
267
+ <span class="ruby-ivar">@possible_hits</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">retrieve_possible_hits</span>
268
+ <span class="ruby-keyword kw">end</span>
269
+ </pre>
270
+ </div>
271
+ </div>
272
+ </div>
273
+
274
+ <div id="method-M000006" class="method-detail">
275
+ <a name="M000006"></a>
276
+
277
+ <div class="method-heading">
278
+ <a href="#M000006" class="method-signature">
279
+ <span class="method-name">score</span><span class="method-args">()</span>
280
+ </a>
281
+ </div>
282
+
283
+ <div class="method-description">
284
+ <p>
285
+ Creates a <a href="Ofac.html#M000006">score</a>, 1 - 100, based on how well
286
+ the name and address match the data on the SDN (Specially Designated
287
+ Nationals) list.
288
+ </p>
289
+ <p>
290
+ The <a href="Ofac.html#M000006">score</a> is calculated by adding up the
291
+ weightings of each part that is matched. So if only name is matched, then
292
+ the max <a href="Ofac.html#M000006">score</a> is the weight for
293
+ <tt>:name</tt> which is 60
294
+ </p>
295
+ <p>
296
+ It&#8216;s possible to get partial matches, which will add partial weight
297
+ to the <a href="Ofac.html#M000006">score</a>. If there is not a match on
298
+ the element as it is passed in, then each word element gets broken down and
299
+ matches are tried on each partial element. The weighting is distrubuted
300
+ equally for each partial that is matched.
301
+ </p>
302
+ <p>
303
+ If exact matches are not made, then a sounds like match is attempted. Any
304
+ match made by sounds like is given 75% of it&#8216;s weight to the <a
305
+ href="Ofac.html#M000006">score</a>.
306
+ </p>
307
+ <p>
308
+ Example:
309
+ </p>
310
+ <p>
311
+ If you are trying to match the name Kevin Tyll and there is a record for
312
+ Smith, Kevin in the database, then we will try to match both Kevin and Tyll
313
+ separately, with each element Smith and Kevin. Since only Kevin will find a
314
+ match, and there were 2 elements in the searched name, the <a
315
+ href="Ofac.html#M000006">score</a> will be added by half the weighting for
316
+ <tt>:name</tt>. So since the weight for <tt>:name</tt> is 60, then we will
317
+ add 30 to the <a href="Ofac.html#M000006">score</a>.
318
+ </p>
319
+ <p>
320
+ If you are trying to match the name Kevin Gregory Tyll and there is a
321
+ record for Tyll, Kevin in the database, then we will try to match Kevin and
322
+ Gregory and Tyll separately, with each element Tyll and Kevin. Since both
323
+ Kevin and Tyll will find a match, and there were 3 elements in the searched
324
+ name, the <a href="Ofac.html#M000006">score</a> will be added by 2/3 the
325
+ weighting for <tt>:name</tt>. So since the weight for <tt>:name</tt> is 60,
326
+ then we will add 40 to the <a href="Ofac.html#M000006">score</a>.
327
+ </p>
328
+ <p>
329
+ If you are trying to match the name Kevin Tyll and there is a record for
330
+ Kevin Gregory Tyll in the database, then we will try to match Kevin and
331
+ Tyll separately, with each element Tyll and Kevin and Gregory. Since both
332
+ Kevin and Tyll will find a match, and there were 2 elements in the searched
333
+ name, the <a href="Ofac.html#M000006">score</a> will be added by 2/2 the
334
+ weighting for <tt>:name</tt>. So since the weight for <tt>:name</tt> is 60,
335
+ then we will add 60 to the <a href="Ofac.html#M000006">score</a>.
336
+ </p>
337
+ <p>
338
+ If you are trying to match the name Kevin Tyll, and there is a record for
339
+ Teel, Kevin in the database, then an exact match will be found for Kevin,
340
+ and a sounds like match will be made for Tyll. Since there were 2 elements
341
+ in the searched name, and the weight for <tt>:name</tt> is 60, then each
342
+ element is worth 30. Since Kevin was an exact match, it will add 30, and
343
+ since Tyll was a sounds like match, it will add 30 * .75. So the
344
+ <tt>:name</tt> portion of the search will be worth 53.
345
+ </p>
346
+ <p>
347
+ If data is in the database for city and or address, and you pass data in
348
+ for these elements, the <a href="Ofac.html#M000006">score</a> will be
349
+ reduced by 10% of the weight if there is no match or sounds like match. So
350
+ if you get a match on name, you&#8216;ve already got a <a
351
+ href="Ofac.html#M000006">score</a> of 60. So if you don&#8216;t pass in an
352
+ address or city, or if you do, but there is no city or address info in the
353
+ database, then your final <a href="Ofac.html#M000006">score</a> will be 60.
354
+ But if you do pass in a city, say Tampa, and the city in the Database is
355
+ New York, then we will deduct 10% of the weight (30 * .1) = 3 from the <a
356
+ href="Ofac.html#M000006">score</a> since 30 is the weight for
357
+ <tt>:city</tt>. So the final <a href="Ofac.html#M000006">score</a> will be
358
+ 57.
359
+ </p>
360
+ <p>
361
+ If were searching for New York, and the database had New Deli, then there
362
+ would be a match on New, but not on Deli. Since there were 2 elements in
363
+ the searched city, each hit is worth 15. So the match on New would add 15,
364
+ but the non-match on York would subtract (15 * .1) = 1.5 from the <a
365
+ href="Ofac.html#M000006">score</a>. So the <a
366
+ href="Ofac.html#M000006">score</a> would be (60 + 15 - 1.5) = 74, due to
367
+ rounding.
368
+ </p>
369
+ <p>
370
+ Only <tt>:city</tt> and <tt>:address</tt> subtract from the <a
371
+ href="Ofac.html#M000006">score</a>, No match on name simply returns 0.
372
+ </p>
373
+ <p>
374
+ Matches for name are made for both the name and any aliases in the OFAC
375
+ database.
376
+ </p>
377
+ <p>
378
+ Matches for <tt>:city</tt> and <tt>:address</tt> will only be added to the
379
+ <a href="Ofac.html#M000006">score</a> if there is first a match on
380
+ <tt>:name</tt>.
381
+ </p>
382
+ <p>
383
+ We consider a <a href="Ofac.html#M000006">score</a> of 60 to be reasonable
384
+ as a hit.
385
+ </p>
386
+ <p><a class="source-toggle" href="#"
387
+ onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
388
+ <div class="method-source-code" id="M000006-source">
389
+ <pre>
390
+ <span class="ruby-comment cmt"># File lib/ofac/models/ofac.rb, line 85</span>
391
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">score</span>
392
+ <span class="ruby-ivar">@score</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">calculate_score</span>
393
+ <span class="ruby-keyword kw">end</span>
394
+ </pre>
395
+ </div>
396
+ </div>
397
+ </div>
398
+
399
+
400
+ </div>
401
+
402
+
403
+ </div>
404
+
405
+
406
+ <div id="validator-badges">
407
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
408
+ </div>
409
+
410
+ </body>
411
+ </html>