1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en" lang=
"en">
6 <meta name=
"generator" content=
"HTML Tidy for Linux/x86 (vers 12 April 2005), see www.w3.org" />
7 <title>Hash-List
"Multimap" Text Memory Use Test with Small
8 Average Secondary-Key to Primary-Key Ratio
</title>
9 <meta http-equiv=
"Content-Type" content=
"text/html; charset=us-ascii" />
13 <h1>"Multimap" Text Memory Use 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
100 distinct primary keys, and the ratio of secondary keys
25 to primary keys ranges to about
20.
</p>
26 <p>The test measures the memory use as a function of the number
27 of values inserted.
</p>
28 <p>(The test was executed with
<a href=
"../../../../testsuite/performance/ext/pb_ds/multimap_text_insert_mem_usage.cc"><tt>multimap_text_insert_mem_usage_test
</tt></a>
29 thirty_years_among_the_dead_preproc.txt
100 3 4 4)
</p>
30 <h2><a name=
"purpose" id=
"purpose">Purpose
</a></h2>
31 <p>The test checks the memory scalability of different
32 "multimap" designs (see
<a href=
"motivation.html#assoc_mapping_semantics">Motivation::Associative
33 Containers::Mapping Semantics
</a>).
</p>
34 <h2><a name=
"results" id=
"results">Results
</a></h2>
35 <p>Figures
<a href=
"#NTG">NTG
</a>,
<a href=
"#NTM">NTM
</a>, and
36 <a href=
"#NTL">NTL
</a> show the results for
"multimaps" which
37 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
38 <a href=
"assoc_performance_tests.html#local"><u>local
</u></a>,
39 respectively; Figures
<a href=
"#NHG"></a>NHG,
<a href=
"#NHM">NHM
</a>, and
<a href=
"#NHL">NHL
</a> show the results for
40 "multimaps" which use a hash-based container for primary keys,
41 in
<a href=
"assoc_performance_tests.html#gcc"><u>g++
</u></a>,
42 <a href=
"assoc_performance_tests.html#msvc"><u>msvc++
</u></a>,
43 and
<a href=
"assoc_performance_tests.html#local"><u>local
</u></a>,
45 <div id=
"NTG_res_div">
47 <div id=
"NTG_multimap_text_insert_mem_usage_test_small_s2p_tree">
49 <div id=
"NTG_Native_and_primary_tree-based_multimap_types_mem_usage_test"><div style=
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NTG" id=
"NTG"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_tree_gcc.png" alt=
"no image" /></a></h6>NTG: Native and primary tree-based multimap types mem usage 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>
52 rb_tree_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
53 <a href=
"tree.html"><tt>tree
</tt></a>
54 with
<tt>Tag
</tt> =
<a href=
"rb_tree_tag.html"><tt>rb_tree_tag
</tt></a>
55 , and
<tt>Node_Update
</tt> =
<a href=
"null_tree_node_update.html"><tt>null_tree_node_update
</tt></a>
56 , mapping each key to
<a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
57 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
58 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
59 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
60 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
61 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i></li>
64 <tt>std::multimap
</tt></li>
66 rb_tree_mmap_lu_mtf_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=
"list_update.html"><tt>list_update
</tt></a>
71 with
<tt>Update_Policy
</tt> =
<a href=
"move_to_front_lu_policy.html"><tt>move_to_front_lu_policy
</tt></a>
74 </div><div style=
"width: 100%; height: 20px"></div></div>
79 <div id=
"NTM_res_div">
81 <div id=
"NTM_multimap_text_insert_mem_usage_test_small_s2p_tree">
83 <div id=
"NHM_Native_and_primary_tree-based_multimap_types_mem_usage_test"><div style=
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NTM" id=
"NTM"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_tree_msvc.png" alt=
"no image" /></a></h6>NTM: NHM Native and primary tree-based multimap types mem usage 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>
86 rb_tree_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
87 <a href=
"tree.html"><tt>tree
</tt></a>
88 with
<tt>Tag
</tt> =
<a href=
"rb_tree_tag.html"><tt>rb_tree_tag
</tt></a>
89 , and
<tt>Node_Update
</tt> =
<a href=
"null_tree_node_update.html"><tt>null_tree_node_update
</tt></a>
90 , mapping each key to
<a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
91 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
92 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
93 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
94 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
95 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i></li>
98 <tt>std::multimap
</tt></li>
100 rb_tree_mmap_lu_mtf_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=
"list_update.html"><tt>list_update
</tt></a>
105 with
<tt>Update_Policy
</tt> =
<a href=
"move_to_front_lu_policy.html"><tt>move_to_front_lu_policy
</tt></a>
108 </div><div style=
"width: 100%; height: 20px"></div></div>
113 <div id=
"NTL_res_div">
115 <div id=
"NTL_multimap_text_insert_mem_usage_test_small_s2p_tree">
117 <div id=
"NTL_Native_and_primary_tree-based_multimap_types_mem_usage_test"><div style =
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NTL" id=
"NTL"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_tree_local.png" alt=
"no image" /></a></h6>NTL: Native and primary tree-based multimap types mem usage test -
<a href =
"assoc_performance_tests.html#local">local
</a></div><div style =
"width: 100%; height: 20px"></div></div>
122 <div id=
"NHG_res_div">
124 <div id=
"NHG_multimap_text_insert_mem_usage_test_small_s2p_hash">
126 <div id=
"NHG_Native_and_primary_hash-based_multimap_types_mem_usage_test"><div style=
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NHG" id=
"NHG"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_hash_gcc.png" alt=
"no image" /></a></h6>NHG: Native and primary hash-based multimap types mem usage 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>
129 cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
130 <a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
131 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
132 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
133 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
134 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
135 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i>, mapping each key to
<a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
136 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
137 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
138 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
139 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
140 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i></li>
143 <tt>__gnucxx::hash_multimap
</tt></li>
145 cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_lu_mtf_set-
146 <a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
147 with
<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>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i>, mapping each key to
<a href=
"list_update.html"><tt>list_update
</tt></a>
152 with
<tt>Update_Policy
</tt> =
<a href=
"move_to_front_lu_policy.html"><tt>move_to_front_lu_policy
</tt></a>
155 </div><div style=
"width: 100%; height: 20px"></div></div>
160 <div id=
"NHM_res_div">
162 <div id=
"NHM_multimap_text_insert_mem_usage_test_small_s2p_hash">
164 <div id=
"NHM_Native_and_primary_hash-based_multimap_types_mem_usage_test"><div style=
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NHM" id=
"NHM"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_hash_msvc.png" alt=
"no image" /></a></h6>NHM: Native and primary hash-based multimap types mem usage 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>
167 cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_set-
168 <a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
169 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
170 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
171 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
172 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
173 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i>, mapping each key to
<a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
174 with
<tt>Comb_Hash_Fn
</tt> =
<a href=
"direct_mask_range_hashing.html"><tt>direct_mask_range_hashing
</tt></a>
175 , and
<tt>Resize_Policy
</tt> =
<a href=
"hash_standard_resize_policy.html"><tt>hash_standard_resize_policy
</tt></a>
176 with
<tt>Size_Policy
</tt> =
<a href=
"hash_exponential_size_policy.html"><tt>hash_exponential_size_policy
</tt></a>
177 , and
<tt>Trigger_Policy
</tt> =
<a href=
"hash_load_check_resize_trigger.html"><tt>hash_load_check_resize_trigger
</tt></a>
178 with
<i>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i></li>
181 <tt>stdext::hash_multimap
</tt></li>
183 cc_hash_mask_exp_nea_lc_1div8_1div2_nsth_mmap_lu_mtf_set-
184 <a href=
"cc_hash_table.html"><tt>cc_hash_table
</tt></a>
185 with
<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>α<sub>min
</sub></i> =
<i>1/
8</i> and
<i>α<sub>max
</sub></i> =
<i>1/
2</i>, mapping each key to
<a href=
"list_update.html"><tt>list_update
</tt></a>
190 with
<tt>Update_Policy
</tt> =
<a href=
"move_to_front_lu_policy.html"><tt>move_to_front_lu_policy
</tt></a>
193 </div><div style=
"width: 100%; height: 20px"></div></div>
198 <div id=
"NHL_res_div">
200 <div id=
"NHL_multimap_text_insert_mem_usage_test_small_s2p_hash">
202 <div id=
"NHL__Native_and_primary_hash-based_multimap_types_mem_usage_test"><div style =
"border-style: dotted; border-width: 1px; border-color: lightgray"><h6 class=
"c1"><a name=
"NHL" id=
"NHL"><img src=
"multimap_text_insert_mem_usage_test_small_s2p_hash_local.png" alt=
"no image" /></a></h6>NHL: Native and primary hash-based multimap types mem usage test -
<a href =
"assoc_performance_tests.html#local">local
</a></div><div style =
"width: 100%; height: 20px"></div></div>
207 <h2><a name=
"observations" id=
"observations">Observations
</a></h2>
208 <p>See
<a href=
"assoc_performance_tests.html#msc">Observations::Mapping-Semantics
209 Considerations
</a>.
</p>