l4/pkg/libstdc++-v3/contrib/libstdc++-v3-4.4/doc/html/ext/pb_ds/multimap_text_insert_mem_usage_test_small.html

   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>
  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>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
  62 <li>
  63 n_mmap-
  64 <tt>std::multimap</tt></li>
  65 <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>
  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>
  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>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
  96 <li>
  97 n_mmap-
  98 <tt>std::multimap</tt></li>
  99 <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>
 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>
 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>&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>
 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>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
 141 <li>
 142 n_hash_mmap-
 143 <tt>__gnucxx::hash_multimap</tt></li>
 144 <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>&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>
 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>
 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>&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>
 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>&alpha;<sub>min</sub></i> = <i>1/8</i> and <i>&alpha;<sub>max</sub></i> = <i>1/2</i></li>
 179 <li>
 180 n_hash_mmap-
 181 <tt>stdext::hash_multimap</tt></li>
 182 <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>&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>
 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>