1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>Class cartesian_topology</title> 6<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css"> 7<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 8<link rel="home" href="../../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> 9<link rel="up" href="../../mpi/reference.html#header.boost.mpi.cartesian_communicator_hpp" title="Header <boost/mpi/cartesian_communicator.hpp>"> 10<link rel="prev" href="cartesian_dimension.html" title="Struct cartesian_dimension"> 11<link rel="next" href="is_mpi_da_1_3_27_7_3_2_1_4.html" title="Struct is_mpi_datatype<cartesian_dimension>"> 12</head> 13<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 14<table cellpadding="2" width="100%"><tr> 15<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td> 16<td align="center"><a href="../../../../index.html">Home</a></td> 17<td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td> 18<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 19<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 20<td align="center"><a href="../../../../more/index.htm">More</a></td> 21</tr></table> 22<hr> 23<div class="spirit-nav"> 24<a accesskey="p" href="cartesian_dimension.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../mpi/reference.html#header.boost.mpi.cartesian_communicator_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="is_mpi_da_1_3_27_7_3_2_1_4.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a> 25</div> 26<div class="refentry"> 27<a name="boost.mpi.cartesian_topology"></a><div class="titlepage"></div> 28<div class="refnamediv"> 29<h2><span class="refentrytitle">Class cartesian_topology</span></h2> 30<p>boost::mpi::cartesian_topology — Describe the topology of a cartesian grid. </p> 31</div> 32<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2> 33<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"><span class="comment">// In header: <<a class="link" href="../../mpi/reference.html#header.boost.mpi.cartesian_communicator_hpp" title="Header <boost/mpi/cartesian_communicator.hpp>">boost/mpi/cartesian_communicator.hpp</a>> 34 35</span> 36<span class="keyword">class</span> <a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">:</span> <span class="keyword">private</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <span class="identifier">cartesian_dimension</span> <span class="special">></span> <span class="special">{</span> 37<span class="keyword">public</span><span class="special">:</span> 38 <span class="comment">// <a class="link" href="cartesian_topology.html#boost.mpi.cartesian_topologyconstruct-copy-destruct">construct/copy/destruct</a></span> 39 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_5-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">delete</span><span class="special">;</span> 40 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_6-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">default</span><span class="special">;</span> 41 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_8-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&&</span><span class="special">)</span><span class="special">;</span> 42 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_11-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="keyword">int</span><span class="special">)</span><span class="special">;</span> 43 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_12-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> 44 <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> InitArr<span class="special">></span> <span class="keyword">explicit</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_13-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="identifier">InitArr</span><span class="special">)</span><span class="special">;</span> 45 <span class="keyword">explicit</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_14-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">initializer_list</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span><span class="special">)</span><span class="special">;</span> 46 <span class="keyword">template</span><span class="special"><</span><span class="keyword">int</span> NDIM<span class="special">></span> <span class="keyword">explicit</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_15-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a><span class="special">(</span><span class="special">&</span><span class="special">)</span><span class="special">)</span><span class="special">;</span> 47 <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> DimRg<span class="special">,</span> <span class="keyword">typename</span> PerRg<span class="special">></span> 48 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_16-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="identifier">DimRg</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">,</span> <span class="identifier">PerRg</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> 49 <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> DimIter<span class="special">,</span> <span class="keyword">typename</span> PerIter<span class="special">></span> 50 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_17-bb"><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="identifier">DimIter</span><span class="special">,</span> <span class="identifier">PerIter</span><span class="special">,</span> <span class="keyword">int</span><span class="special">)</span><span class="special">;</span> 51 <a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_7-bb"><span class="keyword">operator</span><span class="special">=</span></a><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">default</span><span class="special">;</span> 52 <a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_9-bb"><span class="keyword">operator</span><span class="special">=</span></a><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&&</span><span class="special">)</span><span class="special">;</span> 53 <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_10-bb"><span class="special">~</span><span class="identifier">cartesian_topology</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span> 54 55 <span class="comment">// <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_4-bb">public member functions</a></span> 56 <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="special">&</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_4_1-bb"><span class="identifier">stl</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span> 57 <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="keyword">const</span> <span class="special">&</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_4_2-bb"><span class="identifier">stl</span></a><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span> 58 <span class="keyword">void</span> <a class="link" href="cartesian_topology.html#id-1_3_27_7_3_2_1_3_4_3-bb"><span class="identifier">split</span></a><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <span class="keyword">int</span> <span class="special">></span> <span class="special">&</span><span class="special">,</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <span class="keyword">bool</span> <span class="special">></span> <span class="special">&</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span> 59<span class="special">}</span><span class="special">;</span></pre></div> 60<div class="refsect1"> 61<a name="id-1.3.27.7.4.6.4"></a><h2>Description</h2> 62<p>Behave mostly like a sequence of <code class="computeroutput"><a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a></code> with the notable exception that its size is fixed. This is a lightweight object, so that any constructor that could be considered missing could be replaced with a function (move constructor provided when supported). </p> 63<div class="refsect2"> 64<a name="id-1.3.27.7.4.6.4.3"></a><h3> 65<a name="boost.mpi.cartesian_topologyconstruct-copy-destruct"></a><code class="computeroutput">cartesian_topology</code> 66 public 67 construct/copy/destruct</h3> 68<div class="orderedlist"><ol class="orderedlist" type="1"> 69<li class="listitem"><pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_5-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">delete</span><span class="special">;</span></pre></li> 70<li class="listitem"><pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_6-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">default</span><span class="special">;</span></pre></li> 71<li class="listitem"><pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_8-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&&</span> other<span class="special">)</span><span class="special">;</span></pre></li> 72<li class="listitem"> 73<pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_11-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="keyword">int</span> ndim<span class="special">)</span><span class="special">;</span></pre>Create a N dimension space. Each dimension is initialized as non periodic of size 0. </li> 74<li class="listitem"> 75<pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_12-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="keyword">const</span> <span class="special">&</span> dims<span class="special">)</span><span class="special">;</span></pre>Use the provided dimensions specification as initial values. </li> 76<li class="listitem"> 77<pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> InitArr<span class="special">></span> <span class="keyword">explicit</span> <a name="id-1_3_27_7_3_2_1_3_13-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="identifier">InitArr</span> dims<span class="special">)</span><span class="special">;</span></pre>Use dimensions specification provided in the sequence container as initial values. #param dims must be a sequence container. </li> 78<li class="listitem"> 79<pre class="literallayout"><span class="keyword">explicit</span> <a name="id-1_3_27_7_3_2_1_3_14-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">initializer_list</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> dims<span class="special">)</span><span class="special">;</span></pre>Use dimensions specification provided in the initialization list as initial values. #param dims can be of the form { dim_1, false}, .... {dim_n, true}. </li> 80<li class="listitem"> 81<pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">int</span> NDIM<span class="special">></span> <span class="keyword">explicit</span> <a name="id-1_3_27_7_3_2_1_3_15-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a><span class="special">(</span><span class="special">&</span><span class="special">)</span> dims<span class="special">)</span><span class="special">;</span></pre>Use dimensions specification provided in the array. #param dims can be of the form { dim_1, false}, .... {dim_n, true}. </li> 82<li class="listitem"> 83<pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> DimRg<span class="special">,</span> <span class="keyword">typename</span> PerRg<span class="special">></span> 84 <a name="id-1_3_27_7_3_2_1_3_16-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="identifier">DimRg</span> <span class="keyword">const</span> <span class="special">&</span> dim_rg<span class="special">,</span> <span class="identifier">PerRg</span> <span class="keyword">const</span> <span class="special">&</span> period_rg<span class="special">)</span><span class="special">;</span></pre>Use dimensions specification provided in the input ranges The ranges do not need to be the same size. If the sizes are different, the missing values will be complete with zeros of the dim and assumed non periodic. <p> 85</p> 86<div class="variablelist"><table border="0" class="variablelist compact"> 87<colgroup> 88<col align="left" valign="top"> 89<col> 90</colgroup> 91<tbody><tr> 92<td><p><span class="term">Parameters:</span></p></td> 93<td><div class="variablelist"><table border="0" class="variablelist compact"> 94<colgroup> 95<col align="left" valign="top"> 96<col> 97</colgroup> 98<tbody> 99<tr> 100<td><p><span class="term"><code class="computeroutput">dim_rg</code></span></p></td> 101<td><p>the dimensions, values must convert to integers. </p></td> 102</tr> 103<tr> 104<td><p><span class="term"><code class="computeroutput">period_rg</code></span></p></td> 105<td><p>the periodicities, values must convert to booleans. #param dims can be of the form { dim_1, false}, .... {dim_n, true} </p></td> 106</tr> 107</tbody> 108</table></div></td> 109</tr></tbody> 110</table></div> 111</li> 112<li class="listitem"> 113<pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> DimIter<span class="special">,</span> <span class="keyword">typename</span> PerIter<span class="special">></span> 114 <a name="id-1_3_27_7_3_2_1_3_17-bb"></a><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="identifier">DimIter</span> dit<span class="special">,</span> <span class="identifier">PerIter</span> pit<span class="special">,</span> <span class="keyword">int</span> n<span class="special">)</span><span class="special">;</span></pre>Iterator based initializer. Will use the first n iterated values. Both iterators can be single pass. <p> 115</p> 116<div class="variablelist"><table border="0" class="variablelist compact"> 117<colgroup> 118<col align="left" valign="top"> 119<col> 120</colgroup> 121<tbody><tr> 122<td><p><span class="term">Parameters:</span></p></td> 123<td><div class="variablelist"><table border="0" class="variablelist compact"> 124<colgroup> 125<col align="left" valign="top"> 126<col> 127</colgroup> 128<tbody> 129<tr> 130<td><p><span class="term"><code class="computeroutput">dit</code></span></p></td> 131<td><p>dimension iterator, value must convert to integer type. </p></td> 132</tr> 133<tr> 134<td><p><span class="term"><code class="computeroutput">pit</code></span></p></td> 135<td><p>periodicity iterator, value must convert to booleans.. </p></td> 136</tr> 137</tbody> 138</table></div></td> 139</tr></tbody> 140</table></div> 141</li> 142<li class="listitem"><pre class="literallayout"><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&</span> <a name="id-1_3_27_7_3_2_1_3_7-bb"></a><span class="keyword">operator</span><span class="special">=</span><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="special">=</span> <span class="keyword">default</span><span class="special">;</span></pre></li> 143<li class="listitem"><pre class="literallayout"><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&</span> <a name="id-1_3_27_7_3_2_1_3_9-bb"></a><span class="keyword">operator</span><span class="special">=</span><span class="special">(</span><a class="link" href="cartesian_topology.html" title="Class cartesian_topology">cartesian_topology</a> <span class="special">&&</span> other<span class="special">)</span><span class="special">;</span></pre></li> 144<li class="listitem"><pre class="literallayout"><a name="id-1_3_27_7_3_2_1_3_10-bb"></a><span class="special">~</span><span class="identifier">cartesian_topology</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre></li> 145</ol></div> 146</div> 147<div class="refsect2"> 148<a name="id-1.3.27.7.4.6.4.4"></a><h3> 149<a name="id-1_3_27_7_3_2_1_3_4-bb"></a><code class="computeroutput">cartesian_topology</code> public member functions</h3> 150<div class="orderedlist"><ol class="orderedlist" type="1"> 151<li class="listitem"> 152<pre class="literallayout"><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="special">&</span> <a name="id-1_3_27_7_3_2_1_3_4_1-bb"></a><span class="identifier">stl</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre> 153<p>Export as an stl sequence. </p> 154</li> 155<li class="listitem"> 156<pre class="literallayout"><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <a class="link" href="cartesian_dimension.html" title="Struct cartesian_dimension">cartesian_dimension</a> <span class="special">></span> <span class="keyword">const</span> <span class="special">&</span> <a name="id-1_3_27_7_3_2_1_3_4_2-bb"></a><span class="identifier">stl</span><span class="special">(</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre> 157<p>Export as an stl sequence. </p> 158</li> 159<li class="listitem"> 160<pre class="literallayout"><span class="keyword">void</span> <a name="id-1_3_27_7_3_2_1_3_4_3-bb"></a><span class="identifier">split</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <span class="keyword">int</span> <span class="special">></span> <span class="special">&</span> dims<span class="special">,</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special"><</span> <span class="keyword">bool</span> <span class="special">></span> <span class="special">&</span> periodics<span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre> 161<p>Split the topology in two sequences of sizes and periodicities. </p> 162</li> 163</ol></div> 164</div> 165</div> 166</div> 167<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 168<td align="left"></td> 169<td align="right"><div class="copyright-footer">Copyright © 2005-2007 Douglas Gregor, 170 Matthias Troyer, Trustees of Indiana University<p> 171 Distributed under the Boost Software License, Version 1.0. (See accompanying 172 file LICENSE_1_0.txt or copy at <ulink url="http://www.boost.org/LICENSE_1_0.txt"> 173 http://www.boost.org/LICENSE_1_0.txt </ulink>) 174 </p> 175</div></td> 176</tr></table> 177<hr> 178<div class="spirit-nav"> 179<a accesskey="p" href="cartesian_dimension.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../mpi/reference.html#header.boost.mpi.cartesian_communicator_hpp"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="is_mpi_da_1_3_27_7_3_2_1_4.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a> 180</div> 181</body> 182</html> 183
