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>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" /> 10</head> 11<body> 12<div id="page"> 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="http://gcc.gnu.org/viewcvs/*checkout*/trunk/libstdc%2B%2B-v3/testsuite/performance/ext/pb_ds/multimap_text_insert_mem_usage_small.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>, 44 respectively.</p> 45<div id="NTG_res_div"> 46<div id="NTG_gcc"> 47<div id="NTG_multimap_text_insert_mem_usage_test_small_s2p_tree"> 48<div id="NTG_assoc"> 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> 50<ol> 51<li> 52rb_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> 57with <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> 62<li> 63n_mmap- 64<tt>std::multimap</tt></li> 65<li> 66rb_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> 72</li> 73</ol> 74</div><div style="width: 100%; height: 20px"></div></div> 75</div> 76</div> 77</div> 78</div> 79<div id="NTM_res_div"> 80<div id="NTM_msvc"> 81<div id="NTM_multimap_text_insert_mem_usage_test_small_s2p_tree"> 82<div id="NTM_assoc"> 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> 84<ol> 85<li> 86rb_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> 91with <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> 96<li> 97n_mmap- 98<tt>std::multimap</tt></li> 99<li> 100rb_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> 106</li> 107</ol> 108</div><div style="width: 100%; height: 20px"></div></div> 109</div> 110</div> 111</div> 112</div> 113<div id="NTL_res_div"> 114<div id="NTL_local"> 115<div id="NTL_multimap_text_insert_mem_usage_test_small_s2p_tree"> 116<div id="NTL_assoc"> 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> 118</div> 119</div> 120</div> 121</div> 122<div id="NHG_res_div"> 123<div id="NHG_gcc"> 124<div id="NHG_multimap_text_insert_mem_usage_test_small_s2p_hash"> 125<div id="NHG_assoc"> 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> 127<ol> 128<li> 129cc_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> 131with <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> 136with <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> 141<li> 142n_hash_mmap- 143<tt>__gnucxx::hash_multimap</tt></li> 144<li> 145cc_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> 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>α<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> 153</li> 154</ol> 155</div><div style="width: 100%; height: 20px"></div></div> 156</div> 157</div> 158</div> 159</div> 160<div id="NHM_res_div"> 161<div id="NHM_msvc"> 162<div id="NHM_multimap_text_insert_mem_usage_test_small_s2p_hash"> 163<div id="NHM_assoc"> 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> 165<ol> 166<li> 167cc_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> 169with <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> 174with <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> 179<li> 180n_hash_mmap- 181<tt>stdext::hash_multimap</tt></li> 182<li> 183cc_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> 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>α<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> 191</li> 192</ol> 193</div><div style="width: 100%; height: 20px"></div></div> 194</div> 195</div> 196</div> 197</div> 198<div id="NHL_res_div"> 199<div id="NHL_local"> 200<div id="NHL_multimap_text_insert_mem_usage_test_small_s2p_hash"> 201<div id="NHL_assoc"> 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> 203</div> 204</div> 205</div> 206</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> 210</div> 211</body> 212</html> 213