~ubuntu-branches/ubuntu/vivid/atlas/vivid

« back to all changes in this revision

Viewing changes to interfaces/blas/F77/src/srot.f

  • Committer: Bazaar Package Importer
  • Author(s): Camm Maguire
  • Date: 2002-04-13 10:07:52 UTC
  • Revision ID: james.westby@ubuntu.com-20020413100752-va9zm0rd4gpurdkq
Tags: upstream-3.2.1ln
ImportĀ upstreamĀ versionĀ 3.2.1ln

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
      SUBROUTINE SROT( N, X, INCX, Y, INCY, C, S )
 
2
*
 
3
*  -- Automatically Tuned Linear Algebra Software (ATLAS)
 
4
*     (C) Copyright 2000 All Rights Reserved
 
5
*
 
6
*  -- ATLAS routine -- F77 Interface -- Version 3.2 -- December 15, 2000
 
7
*
 
8
*  -- Suggestions,  comments,  bugs reports should be sent to the follo-
 
9
*     wing e-mail address: atlas@cs.utk.edu
 
10
*
 
11
*  Author         : Antoine P. Petitet
 
12
*  University of Tennessee - Innovative Computing Laboratory
 
13
*  Knoxville TN, 37996-1301, USA.
 
14
*
 
15
*  ---------------------------------------------------------------------
 
16
*
 
17
*  -- Copyright notice and Licensing terms:
 
18
*
 
19
*  Redistribution  and  use in  source and binary forms, with or without
 
20
*  modification, are  permitted provided  that the following  conditions
 
21
*  are met:
 
22
*
 
23
*  1. Redistributions  of  source  code  must retain the above copyright
 
24
*     notice, this list of conditions and the following disclaimer.
 
25
*  2. Redistributions in binary form must reproduce  the above copyright
 
26
*     notice,  this list of conditions, and the  following disclaimer in
 
27
*     the documentation and/or other materials provided with the distri-
 
28
*     bution.
 
29
*  3. The name of the University,  the ATLAS group,  or the names of its
 
30
*     contributors  may not be used to endorse or promote products deri-
 
31
*     ved from this software without specific written permission.
 
32
*
 
33
*  -- Disclaimer:
 
34
*
 
35
*  THIS  SOFTWARE  IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 
36
*  ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,  INCLUDING,  BUT NOT
 
37
*  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 
38
*  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNIVERSITY
 
39
*  OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,  INDIRECT, INCIDENTAL, SPE-
 
40
*  CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 
41
*  TO,  PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
 
42
*  OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEO-
 
43
*  RY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT  (IN-
 
44
*  CLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 
45
*  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
46
*
 
47
*  ---------------------------------------------------------------------
 
48
*
 
49
*     .. Scalar Arguments ..
 
50
      INTEGER            INCX, INCY, N
 
51
      REAL               C, S
 
52
*     ..
 
53
*     .. Array Arguments ..
 
54
      REAL               X( * ), Y( * )
 
55
*     ..
 
56
*
 
57
*  Purpose
 
58
*  =======
 
59
*
 
60
*  SROT  applies  a  plane  rotation to the two n-vectors x and y.  This
 
61
*  routine computes:
 
62
*
 
63
*     [ x_i ]   [ c  s ] [ x_i ]
 
64
*     [ y_i ] = [ -s c ] [ y_i ]    for all i = 1 .. n.
 
65
*
 
66
*  If n <= 0 or if c = 1 and s = 0, this subroutine returns immediately.
 
67
*
 
68
*  Arguments
 
69
*  =========
 
70
*
 
71
*  N       (input)                       INTEGER
 
72
*          On entry, N specifies the length of the vector x. N  must  be
 
73
*          at least zero. Unchanged on exit.
 
74
*
 
75
*  X       (input/output)                REAL array
 
76
*          On entry,  X  is an incremented array of dimension  at  least
 
77
*          ( 1 + ( n - 1 ) * abs( INCX ) )  that  contains the vector x.
 
78
*          On exit, the entries of the incremented array  X  are rotated
 
79
*          with the entries of the incremented array  Y.
 
80
*
 
81
*  INCX    (input)                       INTEGER
 
82
*          On entry, INCX specifies the increment for the elements of X.
 
83
*          INCX must not be zero. Unchanged on exit.
 
84
*
 
85
*  Y       (input/output)                REAL array
 
86
*          On entry,  Y  is an incremented array of dimension  at  least
 
87
*          ( 1 + ( n - 1 ) * abs( INCY ) )  that  contains the vector y.
 
88
*          On exit, the entries of the incremented array  Y  are rotated
 
89
*          with the entries of the incremented array  X.
 
90
*
 
91
*  INCY    (input)                       INTEGER
 
92
*          On entry, INCY specifies the increment for the elements of Y.
 
93
*          INCY must not be zero. Unchanged on exit.
 
94
*
 
95
*  C       (input)                       REAL
 
96
*          On entry, C specifies the scalar c definiting the plane rota-
 
97
*          tion. Unchanged on exit.
 
98
*
 
99
*  S       (input)                       REAL
 
100
*          On entry, S specifies the scalar s definiting the plane rota-
 
101
*          tion. Unchanged on exit.
 
102
*
 
103
*  Further Details
 
104
*  ===============
 
105
*
 
106
*  For further information on the Level 1 BLAS specification, see:
 
107
*
 
108
*  ``A Proposal for Standard Linear Algebra Subprograms''  by R. Hanson,
 
109
*  F. Krogh and C. Lawson, ACM SIGNUM Newsl., 8(16), 1973,
 
110
*
 
111
*  ``Basic Linear Algebra Subprograms for Fortran Usage''  by C. Lawson,
 
112
*  R. Hanson, D. Kincaid and F. Krogh,  ACM Transactions on Mathematical
 
113
*  Software, 5(3) pp 308-323, 1979.
 
114
*
 
115
*  For further information on the Level 2 BLAS specification, see:
 
116
*
 
117
*  ``An  Extended Set of  FORTRAN  Basic Linear Algebra Subprograms'' by
 
118
*  J. Dongarra,  J. Du Croz,  S. Hammarling and R. Hanson,  ACM Transac-
 
119
*  tions on Mathematical Software, 14(1) pp 1-17, 1988.
 
120
*
 
121
*  ``Algorithm 656: An extended Set of Basic Linear Algebra Subprograms:
 
122
*  Model Implementation and Test Programs''  by J. Dongarra, J. Du Croz,
 
123
*  S. Hammarling and R. Hanson,  ACM  Transactions on Mathematical Soft-
 
124
*  ware, 14(1) pp 18-32, 1988.
 
125
*
 
126
*  For further information on the Level 3 BLAS specification, see:
 
127
*
 
128
*  ``A Set of Level 3 Basic Linear Algebra Subprograms'' by J. Dongarra,
 
129
*  J. Du Croz, I. Duff and S. Hammarling, ACM Transactions on Mathemati-
 
130
*  cal Software, 16(1), pp 1-17, 1990.
 
131
*
 
132
*  =====================================================================
 
133
*
 
134
*     .. External Subroutines ..
 
135
      EXTERNAL           ATL_F77WRAP_SROT
 
136
*     ..
 
137
*     .. Executable Statements ..
 
138
*
 
139
      IF( N.GT.0 ) THEN
 
140
         CALL ATL_F77WRAP_SROT( N, X, INCX, Y, INCY, C, S )
 
141
      END IF
 
142
*
 
143
      RETURN
 
144
*
 
145
*     End of SROT
 
146
*
 
147
      END