1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
4<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5<head>
6<meta name="generator" content="HTML Tidy for Linux/x86 (vers 12 April 2005), see www.w3.org" />
7<title>"Multimap" Text Find Timing Test with Small Average
8  Secondary-Key to Primary-Key Ratio</title>
9<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
10</head>
11<body>
12<div id="page">
13<h1>"Multimap" Text Find Timing Test with Small Average
14    Secondary-Key to Primary-Key Ratio</h1>
15<h2><a name="description" id="description">Description</a></h2>
16<p>This test inserts a number of pairs into a container. The
17    first item of each pair is a string from an arbitrary text
18    [<a href="references.html#wickland96thirty">wickland96thirty</a>], and
19    the second is a uniform i.i.d.integer. The container is a
20    "multimap" - it considers the first member of each pair as a
21    primary key, and the second member of each pair as a secondary
22    key (see <a href="motivation.html#assoc_mapping_semantics">Motivation::Associative
23    Containers::Alternative to Multiple Equivalent Keys</a>). There
24    are 400 distinct primary keys, and the ratio of secondary keys
25    to primary keys ranges from 1 to 5.</p>
26<p>The test measures the average find-time as a function of the
27    number of values inserted. For <tt>pb_ds</tt>'s containers, it
28    finds the secondary key from a container obtained from finding
29    a primary key. For the native multimaps, it searches a range
30    obtained using <tt>std::equal_range</tt> on a primary key.</p>
31<p>(The test was executed with <a href="http://gcc.gnu.org/viewcvs/*checkout*/trunk/libstdc%2B%2B-v3/testsuite/performance/ext/pb_ds/multimap_text_find_timing_small.cc"><tt>multimap_text_find_timing_test</tt></a>
32    thirty_years_among_the_dead_preproc.txt 400 1 1 6)</p>
33<h2><a name="purpose" id="purpose">Purpose</a></h2>
34<p>The test checks the find-time scalability of different
35    "multimap" designs (see <a href="motivation.html#assoc_mapping_semantics">Motivation::Associative
36    Containers::Mapping Semantics</a>).</p>
37<h2><a name="results" id="results">Results</a></h2>
38<p>Figures <a href="#NTG">NTG</a>, <a href="#NTM">NTM</a>, and
39    <a href="#NTL">NTL</a> show the results for "multimaps" which
40    use a tree-based container for primary keys, in <a href="assoc_performance_tests.html#gcc"><u>g++</u></a>, <a href="assoc_performance_tests.html#msvc"><u>msvc++</u></a>, and
41    <a href="assoc_performance_tests.html#local"><u>local</u></a>,
42    respectively; Figures <a href="#NHG"></a>NHG, <a href="#NHM">NHM</a>, and <a href="#NHL">NHL</a> show the results for
43    "multimaps" which use a hash-based container for primary keys,
44    in <a href="assoc_performance_tests.html#gcc"><u>g++</u></a>,
45    <a href="assoc_performance_tests.html#msvc"><u>msvc++</u></a>,
46    and <a href="assoc_performance_tests.html#local"><u>local</u></a>,
47    respectively.</p>
48<div id="NTG_res_div">
49<div id="NTG_gcc">
50<div id="NTG_multimap_text_find_timing_test_small_s2p_tree">
51<div id="NTG_assoc">
52<div id="NHG_Native_and_primary_tree-based_multimap_types_find_timing_test"><div style="border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NTG" id="NTG"><img src="multimap_text_find_timing_test_small_s2p_tree_gcc.png" alt="no image" /></a></h6>NTG: NHG Native and primary tree-based multimap types find timing test - <a href="assoc_performance_tests.html#gcc">g++</a><p>In the above figure, the names in the legends have the following meaning:</p>
53<ol>
54<li>
55n_mmap-
56<tt>std::multimap</tt></li>
57<li>
58rb_tree_mmap_lu_mtf_set-
59<a href="tree.html"><tt>tree</tt></a>
60 with <tt>Tag</tt> = <a href="rb_tree_tag.html"><tt>rb_tree_tag</tt></a>
61, and <tt>Node_Update</tt> = <a href="null_tree_node_update.html"><tt>null_tree_node_update</tt></a>
62, mapping each key to <a href="list_update.html"><tt>list_update</tt></a>
63 with <tt>Update_Policy</tt> = <a href="move_to_front_lu_policy.html"><tt>move_to_front_lu_policy</tt></a>
64</li>
65<li>
66rb_tree_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
67<a href="tree.html"><tt>tree</tt></a>
68 with <tt>Tag</tt> = <a href="rb_tree_tag.html"><tt>rb_tree_tag</tt></a>
69, and <tt>Node_Update</tt> = <a href="null_tree_node_update.html"><tt>null_tree_node_update</tt></a>
70, mapping each key to <a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
71with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
72, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
73 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
74, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
75 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
76</ol>
77</div><div style="width: 100%; height: 20px"></div></div>
78</div>
79</div>
80</div>
81</div>
82<div id="NTM_res_div">
83<div id="NTM_msvc">
84<div id="NTM_multimap_text_find_timing_test_small_s2p_tree">
85<div id="NTM_assoc">
86<div id="NHM_Native_and_primary_tree-based_multimap_types_find_timing_test"><div style="border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NTM" id="NTM"><img src="multimap_text_find_timing_test_small_s2p_tree_msvc.png" alt="no image" /></a></h6>NTM: NHM Native and primary tree-based multimap types find timing test - <a href="assoc_performance_tests.html#msvc">msvc++</a><p>In the above figure, the names in the legends have the following meaning:</p>
87<ol>
88<li>
89n_mmap-
90<tt>std::multimap</tt></li>
91<li>
92rb_tree_mmap_lu_mtf_set-
93<a href="tree.html"><tt>tree</tt></a>
94 with <tt>Tag</tt> = <a href="rb_tree_tag.html"><tt>rb_tree_tag</tt></a>
95, and <tt>Node_Update</tt> = <a href="null_tree_node_update.html"><tt>null_tree_node_update</tt></a>
96, mapping each key to <a href="list_update.html"><tt>list_update</tt></a>
97 with <tt>Update_Policy</tt> = <a href="move_to_front_lu_policy.html"><tt>move_to_front_lu_policy</tt></a>
98</li>
99<li>
100rb_tree_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
101<a href="tree.html"><tt>tree</tt></a>
102 with <tt>Tag</tt> = <a href="rb_tree_tag.html"><tt>rb_tree_tag</tt></a>
103, and <tt>Node_Update</tt> = <a href="null_tree_node_update.html"><tt>null_tree_node_update</tt></a>
104, mapping each key to <a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
105with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
106, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
107 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
108, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
109 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
110</ol>
111</div><div style="width: 100%; height: 20px"></div></div>
112</div>
113</div>
114</div>
115</div>
116<div id="NTL_res_div">
117<div id="NTL_local">
118<div id="NTL_multimap_text_find_timing_test_small_s2p_tree">
119<div id="NTL_assoc">
120<div id="NTL_Native_and_primary_tree-based_multimap_types_find_timing_test"><div style = "border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NTL" id= "NTL"><img src="multimap_text_find_timing_test_small_s2p_tree_local.png" alt="no image" /></a></h6>NTL: Native and primary tree-based multimap types find timing test - <a href = "assoc_performance_tests.html#local">local</a></div><div style = "width: 100%; height: 20px"></div></div>
121</div>
122</div>
123</div>
124</div>
125<div id="NHG_res_div">
126<div id="NHG_gcc">
127<div id="NHG_multimap_text_find_timing_test_small_s2p_hash">
128<div id="NHG_assoc">
129<div id="NHG_Native_and_primary_hash-based_multimap_types_find_timing_test"><div style="border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NHG" id="NHG"><img src="multimap_text_find_timing_test_small_s2p_hash_gcc.png" alt="no image" /></a></h6>NHG: Native and primary hash-based multimap types find timing test - <a href="assoc_performance_tests.html#gcc">g++</a><p>In the above figure, the names in the legends have the following meaning:</p>
130<ol>
131<li>
132n_hash_mmap-
133<tt>__gnucxx::hash_multimap</tt></li>
134<li>
135cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_lu_mtf_set-
136<a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
137with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
138, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
139 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
140, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
141 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i>, mapping each key to <a href="list_update.html"><tt>list_update</tt></a>
142 with <tt>Update_Policy</tt> = <a href="move_to_front_lu_policy.html"><tt>move_to_front_lu_policy</tt></a>
143</li>
144<li>
145cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
146<a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
147with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
148, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
149 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
150, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
151 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i>, mapping each key to <a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
152with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
153, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
154 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
155, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
156 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
157</ol>
158</div><div style="width: 100%; height: 20px"></div></div>
159</div>
160</div>
161</div>
162</div>
163<div id="NHM_res_div">
164<div id="NHM_msvc">
165<div id="NHM_multimap_text_find_timing_test_small_s2p_hash">
166<div id="NHM_assoc">
167<div id="NHM_Native_and_primary_hash-based_multimap_types_find_timing_test"><div style="border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NHM" id="NHM"><img src="multimap_text_find_timing_test_small_s2p_hash_msvc.png" alt="no image" /></a></h6>NHM: Native and primary hash-based multimap types find timing test - <a href="assoc_performance_tests.html#msvc">msvc++</a><p>In the above figure, the names in the legends have the following meaning:</p>
168<ol>
169<li>
170n_hash_mmap-
171<tt>stdext::hash_multimap</tt></li>
172<li>
173cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_lu_mtf_set-
174<a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
175with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
176, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
177 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
178, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
179 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i>, mapping each key to <a href="list_update.html"><tt>list_update</tt></a>
180 with <tt>Update_Policy</tt> = <a href="move_to_front_lu_policy.html"><tt>move_to_front_lu_policy</tt></a>
181</li>
182<li>
183cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
184<a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
185with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
186, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
187 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
188, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
189 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i>, mapping each key to <a href="cc_hash_table.html"><tt>cc_hash_table</tt></a>
190with <tt>Comb_Hash_Fn</tt> = <a href="direct_mask_range_hashing.html"><tt>direct_mask_range_hashing</tt></a>
191, and <tt>Resize_Policy</tt> = <a href="hash_standard_resize_policy.html"><tt>hash_standard_resize_policy</tt></a>
192 with <tt>Size_Policy</tt> = <a href="hash_exponential_size_policy.html"><tt>hash_exponential_size_policy</tt></a>
193, and <tt>Trigger_Policy</tt> = <a href="hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger</tt></a>
194 with <i>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
195</ol>
196</div><div style="width: 100%; height: 20px"></div></div>
197</div>
198</div>
199</div>
200</div>
201<div id="NHL_res_div">
202<div id="NHL_local">
203<div id="NHL_multimap_text_find_timing_test_small_s2p_hash">
204<div id="NHL_assoc">
205<div id="NHL__Native_and_primary_hash-based_multimap_types_find_timing_test"><div style = "border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class="c1"><a name="NHL" id= "NHL"><img src="multimap_text_find_timing_test_small_s2p_hash_local.png" alt="no image" /></a></h6>NHL:  Native and primary hash-based multimap types find timing test - <a href = "assoc_performance_tests.html#local">local</a></div><div style = "width: 100%; height: 20px"></div></div>
206</div>
207</div>
208</div>
209</div>
210<h2><a name="observations" id="observations">Observations</a></h2>
211<p>See <a href="assoc_performance_tests.html#msc">Observations::Mapping-Semantics
212    Considerations</a>.</p>
213</div>
214</body>
215</html>
216