1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".
(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library – Reference Manual: Applying Permutations</title>
<meta name="description" content="GNU Scientific Library – Reference Manual: Applying Permutations">
<meta name="keywords" content="GNU Scientific Library – Reference Manual: Applying Permutations">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Permutations.html#Permutations" rel="up" title="Permutations">
<link href="Reading-and-writing-permutations.html#Reading-and-writing-permutations" rel="next" title="Reading and writing permutations">
<link href="Permutation-functions.html#Permutation-functions" rel="previous" title="Permutation functions">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Applying-Permutations"></a>
<div class="header">
<p>
Next: <a href="Reading-and-writing-permutations.html#Reading-and-writing-permutations" accesskey="n" rel="next">Reading and writing permutations</a>, Previous: <a href="Permutation-functions.html#Permutation-functions" accesskey="p" rel="previous">Permutation functions</a>, Up: <a href="Permutations.html#Permutations" accesskey="u" rel="up">Permutations</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Applying-Permutations-1"></a>
<h3 class="section">9.6 Applying Permutations</h3>
<dl>
<dt><a name="index-gsl_005fpermute"></a>Function: <em>int</em> <strong>gsl_permute</strong> <em>(const size_t * <var>p</var>, double * <var>data</var>, size_t <var>stride</var>, size_t <var>n</var>)</em></dt>
<dd><p>This function applies the permutation <var>p</var> to the array <var>data</var> of
size <var>n</var> with stride <var>stride</var>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fpermute_005finverse"></a>Function: <em>int</em> <strong>gsl_permute_inverse</strong> <em>(const size_t * <var>p</var>, double * <var>data</var>, size_t <var>stride</var>, size_t <var>n</var>)</em></dt>
<dd><p>This function applies the inverse of the permutation <var>p</var> to the
array <var>data</var> of size <var>n</var> with stride <var>stride</var>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fpermute_005fvector"></a>Function: <em>int</em> <strong>gsl_permute_vector</strong> <em>(const gsl_permutation * <var>p</var>, gsl_vector * <var>v</var>)</em></dt>
<dd><p>This function applies the permutation <var>p</var> to the elements of the
vector <var>v</var>, considered as a row-vector acted on by a permutation
matrix from the right, <em>v' = v P</em>. The <em>j</em>-th column of the
permutation matrix <em>P</em> is given by the <em><var>p</var>_j</em>-th column of the
identity matrix. The permutation <var>p</var> and the vector <var>v</var> must
have the same length.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fpermute_005fvector_005finverse"></a>Function: <em>int</em> <strong>gsl_permute_vector_inverse</strong> <em>(const gsl_permutation * <var>p</var>, gsl_vector * <var>v</var>)</em></dt>
<dd><p>This function applies the inverse of the permutation <var>p</var> to the
elements of the vector <var>v</var>, considered as a row-vector acted on by
an inverse permutation matrix from the right, <em>v' = v P^T</em>. Note
that for permutation matrices the inverse is the same as the transpose.
The <em>j</em>-th column of the permutation matrix <em>P</em> is given by
the <em><var>p</var>_j</em>-th column of the identity matrix. The permutation <var>p</var>
and the vector <var>v</var> must have the same length.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fpermute_005fmatrix"></a>Function: <em>int</em> <strong>gsl_permute_matrix</strong> <em>(const gsl_permutation * <var>p</var>, gsl_matrix * <var>A</var>)</em></dt>
<dd><p>This function applies the permutation <var>p</var> to the matrix <var>A</var> from
the right, <em>A' = A P</em>. The <em>j</em>-th column of the
permutation matrix <em>P</em> is given by the <em><var>p</var>_j</em>-th column of the
identity matrix. This effectively permutes the columns of <var>A</var> according
to the permutation <var>p</var>, and so the number of columns of <var>A</var> must
equal the size of the permutation <var>p</var>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fpermutation_005fmul"></a>Function: <em>int</em> <strong>gsl_permutation_mul</strong> <em>(gsl_permutation * <var>p</var>, const gsl_permutation * <var>pa</var>, const gsl_permutation * <var>pb</var>)</em></dt>
<dd><p>This function combines the two permutations <var>pa</var> and <var>pb</var> into a
single permutation <var>p</var>, where <em><var>p</var> = <var>pa</var> * <var>pb</var></em>.
The permutation <var>p</var> is equivalent to applying <var>pb</var> first and
then <var>pa</var>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Reading-and-writing-permutations.html#Reading-and-writing-permutations" accesskey="n" rel="next">Reading and writing permutations</a>, Previous: <a href="Permutation-functions.html#Permutation-functions" accesskey="p" rel="previous">Permutation functions</a>, Up: <a href="Permutations.html#Permutations" accesskey="u" rel="up">Permutations</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
