239 lines
7.4 KiB
HTML
239 lines
7.4 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
|
|
<link rel="stylesheet" href="../../../../boost.css" type="text/css"/>
|
|
<link rel="stylesheet" href="ublas.css" type="text/css" />
|
|
<script type="text/javascript" src="js/jquery-1.3.2.min.js" async="async" ></script>
|
|
<script type="text/javascript" src="js/jquery.toc-gw.js" async="async" ></script>
|
|
<script type="text/x-mathjax-config">
|
|
MathJax.Hub.Config({
|
|
jax: ["input/TeX", "output/HTML-CSS"],
|
|
extensions: ["tex2jax.js"],
|
|
"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], scale: "80" },
|
|
tex2jax: {
|
|
inlineMath: [ ["$", "$"], ["\\(","\\)"] ],
|
|
displayMath: [ ["$$","$$"], ["\\[", "\\]"] ],
|
|
processEscapes: true,
|
|
ignoreClass: "tex2jax_ignore|dno" },
|
|
TeX: { noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } } },
|
|
messageStyle: "none"
|
|
});
|
|
</script>
|
|
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js"></script>
|
|
|
|
<title>Strides</title>
|
|
</head>
|
|
<body>
|
|
<h1><img src="../../../../boost.png" align="middle" />Strides</h1>
|
|
<div class="toc" id="toc"></div>
|
|
<h2><a name="extents"></a>basic_strides<size_type, format_type></h2>
|
|
<h4>Description</h4>
|
|
<p>The template class <code>basic_strides</code> contains weights for a given storage format in order to map multi-indices to scalar memory indices for <a href=
|
|
"../tensor.html#tensor">tensor</a> instances.</p>
|
|
|
|
<h4>Example</h4>
|
|
<pre>
|
|
#include <boost/numeric/ublas/tensor/strides.hpp>
|
|
|
|
int main () {
|
|
<b>using namespace</b> boost::numeric::ublas;
|
|
<b>auto</b> wf = strides<first_order>(shape{4,3,2});
|
|
for (<b>auto</b> i = 0u; i < wf.size(); ++i)
|
|
std::cout << wf.at(i) << std::endl;
|
|
// 1,4,12
|
|
|
|
<b>auto</b> wl = strides<first_order>(shape{4,3,2});
|
|
for (<b>auto</b> i = 0u; i < wl.size(); ++i)
|
|
std::cout << wl.at(i) << std::endl;
|
|
// 6,2,1
|
|
}
|
|
</pre>
|
|
<h4>Definition</h4>
|
|
<p>Defined in the header tensor/strides.hpp.</p>
|
|
|
|
<h4>Public base classes</h4>
|
|
<p>None.</p>
|
|
|
|
<h4>Specialization</h4>
|
|
<p><code><b>template</b><<b>class</b> format_t><br><b>using</b> strides = basic_strides<std::size_t,format_t></code></p>
|
|
|
|
|
|
<h4>Template parameters</h4>
|
|
<table border="1" style="font-size:100%" summary="parameters">
|
|
<tbody style="font-size:100%">
|
|
<tr>
|
|
<th>Parameter</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>size_type</code></td>
|
|
<td>Unsigned integer type.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h4>Member types</h4>
|
|
<table border="1" style="font-size:100%" summary="members">
|
|
<tbody style="font-size:100%" >
|
|
<tr>
|
|
<th>Member type</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>value_type</code></td>
|
|
<td>Type <code>size_type</code> of the strides.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>size_type</code></td>
|
|
<td>Unsigned integer such as <code>std::size_t</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>reference</code></td>
|
|
<td>Reference type which is <code>value_type&</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_reference</code></td>
|
|
<td>Constant reference type which is <code>const value_type&</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>pointer</code></td>
|
|
<td>Pointer type which is <code>value_type*</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_pointer</code></td>
|
|
<td>Constant pointer type which is <code>const value_type*</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>layout_type</code></td>
|
|
<td>Layout type which can be either <code>boost::numeric::ublas::first_order</code> or <code>boost::numeric::ublas::last_order</code>.</td>
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>Member Functions</h4>
|
|
<table border="1" summary="members functions">
|
|
<tbody>
|
|
<tr>
|
|
<th>Member Function</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides ()</code></td>
|
|
<td>Constructs an empty instance of <code>basic_strides</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides (basic_extents<value_type> const& be)</code></td>
|
|
<td>Constructs an instance based on the tensor extents specified by <code>be</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides (std::vector<value_type> const& v)</code></td>
|
|
<td>Constructs an instance copying the content of <code>v</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides (std::vector<value_type> && v)</code></td>
|
|
<td>Constructs an instance moving the content of <code>v</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides (basic_strides const& other)</code></td>
|
|
<td>Constructs an instance from <code>other</code> copying its elements.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides (basic_strides && other)</code></td>
|
|
<td>Constructs an instance from <code>other</code> by moving its elements.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>basic_strides& operator= (basic_strides other)</code></td>
|
|
<td>Assigns the elements of <code>other</code> to this instance.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_pointer data() const</code></td>
|
|
<td>Returns a <code>const_pointer</code> to the first element.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_reference operator[](size_type i) const</code></td>
|
|
<td>Returns a <code>const_reference</code> to the <code>i</code>-th element.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_reference at(size_type i) const</code></td>
|
|
<td>Returns a <code>const_reference</code> to the <code>i</code>-th element.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bool empty()</code></td>
|
|
<td>Returns true if the container has no elements.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>size_type size() const</code></td>
|
|
<td>Returns the number of elements.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>void clear()</code></td>
|
|
<td>Erases all elements.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bool operator==(basic_strides const& b) const</code></td>
|
|
<td>Returns true if all elements are equal.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>bool operator!=(basic_strides const& b) const</code></td>
|
|
<td>Returns true if some elements are not equal.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_iterator begin() const</code></td>
|
|
<td>Returns an <code>const_iterator</code> pointing to the first element.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>const_iterator end() const</code></td>
|
|
<td>Returns a <code>const_iterator</code> pointing to an element passed the last element.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>std::vector<size_type> base() const</code></td>
|
|
<td>Returns the private member sequence container holding all elements.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
|
|
<h4>Non-Member Functions</h4>
|
|
<table border="1" summary="members functions">
|
|
<tbody>
|
|
<tr>
|
|
<th>Function</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>access(std::vector<size_type> const& i, strides<layout_type> w)</code></td>
|
|
<td>Returns relative memory location depending on the multi-index vector <code>i</code> and strides <code>w</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>access(size_type sum, strides<layout_type> w, size_type i, size_types ... is)</code></td>
|
|
<td>Returns relative memory location depending on the indices <code>i</code>, <code>is ... </code> and stride vector <code>w</code> (recursive function).</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
<hr />
|
|
<p>
|
|
Copyright (©) 2018 Cem Bassoy<br />
|
|
Use, modification and distribution are subject to the
|
|
Boost Software License, Version 1.0.
|
|
(See accompanying file LICENSE_1_0.txt
|
|
or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">
|
|
http://www.boost.org/LICENSE_1_0.txt
|
|
</a>).
|
|
</p>
|
|
<script type="text/javascript">
|
|
(function($) {
|
|
$('#toc').toc();
|
|
})(jQuery);
|
|
</script>
|
|
</body>
|
|
</html>
|