Skip to content

Commit 95b6abf

Browse files
committed
unify comments: homogenize notation for transpose (**T) and conjugate transpose (**H)
This commit completes changes made in: * 457afcf 2021-06-03
1 parent 34c8291 commit 95b6abf

File tree

12 files changed

+63
-82
lines changed

12 files changed

+63
-82
lines changed

TESTING/LIN/ctbt02.f

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,11 @@
2929
*> \verbatim
3030
*>
3131
*> CTBT02 computes the residual for the computed solution to a
32-
*> triangular system of linear equations A*x = b, A**T *x = b, or
33-
*> A**H *x = b when A is a triangular band matrix. Here A**T denotes
34-
*> the transpose of A, A**H denotes the conjugate transpose of A, and
35-
*> x and b are N by NRHS matrices. The test ratio is the maximum over
36-
*> the number of right hand sides of
32+
*> triangular system of linear equations op(A)*X = B, when A is a
33+
*> triangular band matrix. The test ratio is the maximum over the
34+
*> number of right hand sides of
3735
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
38-
*> where op(A) denotes A, A**T, or A**H, and EPS is the machine epsilon.
36+
*> where op(A) = A, A**T, or A**H, and EPS is the machine epsilon.
3937
*> \endverbatim
4038
*
4139
* Arguments:

TESTING/LIN/ctpt02.f

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,11 @@
2828
*> \verbatim
2929
*>
3030
*> CTPT02 computes the residual for the computed solution to a
31-
*> triangular system of linear equations A*x = b, A**T *x = b, or
32-
*> A**H *x = b, when the triangular matrix A is stored in packed format.
33-
*> Here A**T denotes the transpose of A, A**H denotes the conjugate
34-
*> transpose of A, and x and b are N by NRHS matrices. The test ratio
35-
*> is the maximum over the number of right hand sides of
31+
*> triangular system of linear equations op(A)*X = B, when the
32+
*> triangular matrix A is stored in packed format. The test ratio is
3633
*> the maximum over the number of right hand sides of
3734
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
38-
*> where op(A) denotes A, A**T, or A**H, and EPS is the machine epsilon.
35+
*> where op(A) = A, A**T, or A**H, and EPS is the machine epsilon.
3936
*> \endverbatim
4037
*
4138
* Arguments:
@@ -191,7 +188,7 @@ SUBROUTINE CTPT02( UPLO, TRANS, DIAG, N, NRHS, AP, X, LDX, B, LDB,
191188
RETURN
192189
END IF
193190
*
194-
* Compute the 1-norm of A or A**H.
191+
* Compute the 1-norm of op(A).
195192
*
196193
IF( LSAME( TRANS, 'N' ) ) THEN
197194
ANORM = CLANTP( '1', UPLO, DIAG, N, AP, RWORK )

TESTING/LIN/ctrt02.f

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,11 @@
2929
*> \verbatim
3030
*>
3131
*> CTRT02 computes the residual for the computed solution to a
32-
*> triangular system of linear equations A*x = b, A**T *x = b,
33-
*> or A**H *x = b. Here A is a triangular matrix, A**T is the transpose
34-
*> of A, A**H is the conjugate transpose of A, and x and b are N by NRHS
35-
*> matrices. The test ratio is the maximum over the number of right
36-
*> hand sides of
32+
*> triangular system of linear equations op(A)*X = B, where A is a
33+
*> triangular matrix. The test ratio is the maximum over the number of
34+
*> right hand sides of
3735
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
38-
*> where op(A) denotes A, A**T, or A**H, and EPS is the machine epsilon.
36+
*> where op(A) = A, A**T, or A**H, and EPS is the machine epsilon.
3937
*> \endverbatim
4038
*
4139
* Arguments:
@@ -200,7 +198,7 @@ SUBROUTINE CTRT02( UPLO, TRANS, DIAG, N, NRHS, A, LDA, X, LDX, B,
200198
RETURN
201199
END IF
202200
*
203-
* Compute the 1-norm of A or A**H.
201+
* Compute the 1-norm of op(A).
204202
*
205203
IF( LSAME( TRANS, 'N' ) ) THEN
206204
ANORM = CLANTR( '1', UPLO, DIAG, N, N, A, LDA, RWORK )

TESTING/LIN/dtbt02.f

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,11 @@
2828
*> \verbatim
2929
*>
3030
*> DTBT02 computes the residual for the computed solution to a
31-
*> triangular system of linear equations A*x = b or A' *x = b when
32-
*> A is a triangular band matrix. Here A' is the transpose of A and
33-
*> x and b are N by NRHS matrices. The test ratio is the maximum over
34-
*> the number of right hand sides of
31+
*> triangular system of linear equations op(A)*X = B, when A is a
32+
*> triangular band matrix. The test ratio is the maximum over the
33+
*> number of right hand sides of
3534
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
36-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
35+
*> where op(A) = A, A**T, or A**H and EPS is the machine epsilon.
3736
*> The norm used is the 1-norm.
3837
*> \endverbatim
3938
*

TESTING/LIN/dtpt02.f

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,11 @@
2727
*> \verbatim
2828
*>
2929
*> DTPT02 computes the residual for the computed solution to a
30-
*> triangular system of linear equations A*x = b or A'*x = b when
31-
*> the triangular matrix A is stored in packed format. Here A' is the
32-
*> transpose of A and x and b are N by NRHS matrices. The test ratio is
30+
*> triangular system of linear equations op(A)*X = B, when the
31+
*> triangular matrix A is stored in packed format. The test ratio is
3332
*> the maximum over the number of right hand sides of
3433
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
35-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
34+
*> where op(A) = A or A**T, and EPS is the machine epsilon.
3635
*> The norm used is the 1-norm.
3736
*> \endverbatim
3837
*
@@ -51,9 +50,9 @@
5150
*> \verbatim
5251
*> TRANS is CHARACTER*1
5352
*> Specifies the operation applied to A.
54-
*> = 'N': A *x = b (No transpose)
55-
*> = 'T': A'*x = b (Transpose)
56-
*> = 'C': A'*x = b (Conjugate transpose = Transpose)
53+
*> = 'N': A * X = B (No transpose)
54+
*> = 'T': A**T * X = B (Transpose)
55+
*> = 'C': A**H * X = B (Conjugate transpose = Transpose)
5756
*> \endverbatim
5857
*>
5958
*> \param[in] DIAG
@@ -183,7 +182,7 @@ SUBROUTINE DTPT02( UPLO, TRANS, DIAG, N, NRHS, AP, X, LDX, B, LDB,
183182
RETURN
184183
END IF
185184
*
186-
* Compute the 1-norm of A or A'.
185+
* Compute the 1-norm of op(A).
187186
*
188187
IF( LSAME( TRANS, 'N' ) ) THEN
189188
ANORM = DLANTP( '1', UPLO, DIAG, N, AP, WORK )

TESTING/LIN/dtrt02.f

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,11 @@
2828
*> \verbatim
2929
*>
3030
*> DTRT02 computes the residual for the computed solution to a
31-
*> triangular system of linear equations A*x = b or A'*x = b.
32-
*> Here A is a triangular matrix, A' is the transpose of A, and x and b
33-
*> are N by NRHS matrices. The test ratio is the maximum over the
34-
*> number of right hand sides of
31+
*> triangular system of linear equations op(A)*X = B, where A is a
32+
*> triangular matrix. The test ratio is the maximum over the number of
33+
*> right hand sides of
3534
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
36-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
35+
*> where op(A) = A or A**T, and EPS is the machine epsilon.
3736
*> The norm used is the 1-norm.
3837
*> \endverbatim
3938
*
@@ -52,9 +51,9 @@
5251
*> \verbatim
5352
*> TRANS is CHARACTER*1
5453
*> Specifies the operation applied to A.
55-
*> = 'N': A *x = b (No transpose)
56-
*> = 'T': A'*x = b (Transpose)
57-
*> = 'C': A'*x = b (Conjugate transpose = Transpose)
54+
*> = 'N': A * X = B (No transpose)
55+
*> = 'T': A**T * X = B (Transpose)
56+
*> = 'C': A**H * X = B (Conjugate transpose = Transpose)
5857
*> \endverbatim
5958
*>
6059
*> \param[in] DIAG
@@ -193,7 +192,7 @@ SUBROUTINE DTRT02( UPLO, TRANS, DIAG, N, NRHS, A, LDA, X, LDX, B,
193192
RETURN
194193
END IF
195194
*
196-
* Compute the 1-norm of A or A'.
195+
* Compute the 1-norm of op(A).
197196
*
198197
IF( LSAME( TRANS, 'N' ) ) THEN
199198
ANORM = DLANTR( '1', UPLO, DIAG, N, N, A, LDA, WORK )

TESTING/LIN/stbt02.f

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,11 @@
2828
*> \verbatim
2929
*>
3030
*> STBT02 computes the residual for the computed solution to a
31-
*> triangular system of linear equations op(A)*X = B when A is a
32-
*> triangular band matrix. The test ratio is the maximum over the
31+
*> triangular system of linear equations op(A)*X = B, when A is a
32+
*> triangular band matrix. The test ratio is the maximum over the
3333
*> number of right hand sides of
3434
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
35-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
35+
*> where op(A) = A or A**T, and EPS is the machine epsilon.
3636
*> The norm used is the 1-norm.
3737
*> \endverbatim
3838
*

TESTING/LIN/stpt02.f

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,11 @@
2727
*> \verbatim
2828
*>
2929
*> STPT02 computes the residual for the computed solution to a
30-
*> triangular system of linear equations A*x = b or A'*x = b when
31-
*> the triangular matrix A is stored in packed format. Here A' is the
32-
*> transpose of A and x and b are N by NRHS matrices. The test ratio is
30+
*> triangular system of linear equations op(A)*X = B, when the
31+
*> triangular matrix A is stored in packed format. The test ratio is
3332
*> the maximum over the number of right hand sides of
3433
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
35-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
34+
*> where op(A) = A or A**T, and EPS is the machine epsilon.
3635
*> The norm used is the 1-norm.
3736
*> \endverbatim
3837
*
@@ -51,9 +50,9 @@
5150
*> \verbatim
5251
*> TRANS is CHARACTER*1
5352
*> Specifies the operation applied to A.
54-
*> = 'N': A *x = b (No transpose)
55-
*> = 'T': A'*x = b (Transpose)
56-
*> = 'C': A'*x = b (Conjugate transpose = Transpose)
53+
*> = 'N': A * X = B (No transpose)
54+
*> = 'T': A**T * X = B (Transpose)
55+
*> = 'C': A**H * X = B (Conjugate transpose = Transpose)
5756
*> \endverbatim
5857
*>
5958
*> \param[in] DIAG
@@ -183,7 +182,7 @@ SUBROUTINE STPT02( UPLO, TRANS, DIAG, N, NRHS, AP, X, LDX, B, LDB,
183182
RETURN
184183
END IF
185184
*
186-
* Compute the 1-norm of A or A'.
185+
* Compute the 1-norm of op(A).
187186
*
188187
IF( LSAME( TRANS, 'N' ) ) THEN
189188
ANORM = SLANTP( '1', UPLO, DIAG, N, AP, WORK )

TESTING/LIN/strt02.f

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,11 @@
2828
*> \verbatim
2929
*>
3030
*> STRT02 computes the residual for the computed solution to a
31-
*> triangular system of linear equations A*x = b or A'*x = b.
32-
*> Here A is a triangular matrix, A' is the transpose of A, and x and b
33-
*> are N by NRHS matrices. The test ratio is the maximum over the
34-
*> number of right hand sides of
31+
*> triangular system of linear equations op(A)*X = B, where A is a
32+
*> triangular matrix. The test ratio is the maximum over the number of
33+
*> right hand sides of
3534
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
36-
*> where op(A) denotes A or A' and EPS is the machine epsilon.
35+
*> where op(A) = A or A**T, and EPS is the machine epsilon.
3736
*> The norm used is the 1-norm.
3837
*> \endverbatim
3938
*
@@ -52,9 +51,9 @@
5251
*> \verbatim
5352
*> TRANS is CHARACTER*1
5453
*> Specifies the operation applied to A.
55-
*> = 'N': A *x = b (No transpose)
56-
*> = 'T': A'*x = b (Transpose)
57-
*> = 'C': A'*x = b (Conjugate transpose = Transpose)
54+
*> = 'N': A * X = B (No transpose)
55+
*> = 'T': A**T * X = B (Transpose)
56+
*> = 'C': A**H * X = B (Conjugate transpose = Transpose)
5857
*> \endverbatim
5958
*>
6059
*> \param[in] DIAG
@@ -193,7 +192,7 @@ SUBROUTINE STRT02( UPLO, TRANS, DIAG, N, NRHS, A, LDA, X, LDX, B,
193192
RETURN
194193
END IF
195194
*
196-
* Compute the 1-norm of A or A'.
195+
* Compute the 1-norm of op(A).
197196
*
198197
IF( LSAME( TRANS, 'N' ) ) THEN
199198
ANORM = SLANTR( '1', UPLO, DIAG, N, N, A, LDA, WORK )

TESTING/LIN/ztbt02.f

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,11 @@
2929
*> \verbatim
3030
*>
3131
*> ZTBT02 computes the residual for the computed solution to a
32-
*> triangular system of linear equations A*x = b, A**T *x = b, or
33-
*> A**H *x = b when A is a triangular band matrix. Here A**T denotes
34-
*> the transpose of A, A**H denotes the conjugate transpose of A, and
35-
*> x and b are N by NRHS matrices. The test ratio is the maximum over
36-
*> the number of right hand sides of
32+
*> triangular system of linear equations op(A)*X = B, when A is a
33+
*> triangular band matrix. The test ratio is the maximum over the
34+
*> number of right hand sides of
3735
*> norm(b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
38-
*> where op(A) denotes A, A**T, or A**H, and EPS is the machine epsilon.
36+
*> where op(A) = A, A**T, or A**H, and EPS is the machine epsilon.
3937
*> \endverbatim
4038
*
4139
* Arguments:

0 commit comments

Comments
 (0)