xref: /petsc/src/mat/impls/transpose/htransm.c (revision 55e7fe800d976e85ed2b5cd8bfdef564daa37bd9)
1 
2 #include <petsc/private/matimpl.h>          /*I "petscmat.h" I*/
3 
4 typedef struct {
5   Mat A;
6 } Mat_HT;
7 
8 PetscErrorCode MatMult_HT(Mat N,Vec x,Vec y)
9 {
10   Mat_HT         *Na = (Mat_HT*)N->data;
11   PetscErrorCode ierr;
12 
13   PetscFunctionBegin;
14   ierr = MatMultHermitianTranspose(Na->A,x,y);CHKERRQ(ierr);
15   PetscFunctionReturn(0);
16 }
17 
18 PetscErrorCode MatMultAdd_HT(Mat N,Vec v1,Vec v2,Vec v3)
19 {
20   Mat_HT         *Na = (Mat_HT*)N->data;
21   PetscErrorCode ierr;
22 
23   PetscFunctionBegin;
24   ierr = MatMultHermitianTransposeAdd(Na->A,v1,v2,v3);CHKERRQ(ierr);
25   PetscFunctionReturn(0);
26 }
27 
28 PetscErrorCode MatMultHermitianTranspose_HT(Mat N,Vec x,Vec y)
29 {
30   Mat_HT         *Na = (Mat_HT*)N->data;
31   PetscErrorCode ierr;
32 
33   PetscFunctionBegin;
34   ierr = MatMult(Na->A,x,y);CHKERRQ(ierr);
35   PetscFunctionReturn(0);
36 }
37 
38 PetscErrorCode MatMultHermitianTransposeAdd_HT(Mat N,Vec v1,Vec v2,Vec v3)
39 {
40   Mat_HT         *Na = (Mat_HT*)N->data;
41   PetscErrorCode ierr;
42 
43   PetscFunctionBegin;
44   ierr = MatMultAdd(Na->A,v1,v2,v3);CHKERRQ(ierr);
45   PetscFunctionReturn(0);
46 }
47 
48 PetscErrorCode MatDestroy_HT(Mat N)
49 {
50   Mat_HT         *Na = (Mat_HT*)N->data;
51   PetscErrorCode ierr;
52 
53   PetscFunctionBegin;
54   ierr = MatDestroy(&Na->A);CHKERRQ(ierr);
55   ierr = PetscFree(N->data);CHKERRQ(ierr);
56   PetscFunctionReturn(0);
57 }
58 
59 PetscErrorCode MatDuplicate_HT(Mat N, MatDuplicateOption op, Mat* m)
60 {
61   Mat_HT         *Na = (Mat_HT*)N->data;
62   PetscErrorCode ierr;
63 
64   PetscFunctionBegin;
65   if (op == MAT_COPY_VALUES) {
66     ierr = MatHermitianTranspose(Na->A,MAT_INITIAL_MATRIX,m);CHKERRQ(ierr);
67   } else if (op == MAT_DO_NOT_COPY_VALUES) {
68     ierr = MatDuplicate(Na->A,MAT_DO_NOT_COPY_VALUES,m);CHKERRQ(ierr);
69     ierr = MatHermitianTranspose(*m,MAT_INPLACE_MATRIX,m);CHKERRQ(ierr);
70   } else SETERRQ(PetscObjectComm((PetscObject)N),PETSC_ERR_SUP,"MAT_SHARE_NONZERO_PATTERN not supported for this matrix type");
71   PetscFunctionReturn(0);
72 }
73 
74 PetscErrorCode MatCreateVecs_HT(Mat N,Vec *r, Vec *l)
75 {
76   Mat_HT         *Na = (Mat_HT*)N->data;
77   PetscErrorCode ierr;
78 
79   PetscFunctionBegin;
80   ierr = MatCreateVecs(Na->A,l,r);CHKERRQ(ierr);
81   PetscFunctionReturn(0);
82 }
83 
84 PetscErrorCode MatHermitianTransposeGetMat_HT(Mat N,Mat *M)
85 {
86   Mat_HT         *Na = (Mat_HT*)N->data;
87 
88   PetscFunctionBegin;
89   *M = Na->A;
90   PetscFunctionReturn(0);
91 }
92 
93 /*@
94       MatHermitianTransposeGetMat - Gets the Mat object stored inside a MATTRANSPOSEMAT
95 
96    Logically collective on Mat
97 
98    Input Parameter:
99 .   A  - the MATTRANSPOSE matrix
100 
101    Output Parameter:
102 .   M - the matrix object stored inside A
103 
104    Level: intermediate
105 
106 .seealso: MatCreateHermitianTranspose()
107 
108 @*/
109 PetscErrorCode MatHermitianTransposeGetMat(Mat A,Mat *M)
110 {
111   PetscErrorCode ierr;
112 
113   PetscFunctionBegin;
114   PetscValidHeaderSpecific(A,MAT_CLASSID,1);
115   PetscValidType(A,1);
116   PetscValidPointer(M,2);
117   ierr = PetscUseMethod(A,"MatHermitianTransposeGetMat_C",(Mat,Mat*),(A,M));CHKERRQ(ierr);
118   PetscFunctionReturn(0);
119 }
120 
121 /*@
122       MatCreateHermitianTranspose - Creates a new matrix object that behaves like A'*
123 
124    Collective on Mat
125 
126    Input Parameter:
127 .   A  - the (possibly rectangular) matrix
128 
129    Output Parameter:
130 .   N - the matrix that represents A'*
131 
132    Level: intermediate
133 
134    Notes:
135     The hermitian transpose A' is NOT actually formed! Rather the new matrix
136           object performs the matrix-vector product by using the MatMultHermitianTranspose() on
137           the original matrix
138 
139 .seealso: MatCreateNormal(), MatMult(), MatMultHermitianTranspose(), MatCreate()
140 
141 @*/
142 PetscErrorCode  MatCreateHermitianTranspose(Mat A,Mat *N)
143 {
144   PetscErrorCode ierr;
145   PetscInt       m,n;
146   Mat_HT         *Na;
147 
148   PetscFunctionBegin;
149   ierr = MatGetLocalSize(A,&m,&n);CHKERRQ(ierr);
150   ierr = MatCreate(PetscObjectComm((PetscObject)A),N);CHKERRQ(ierr);
151   ierr = MatSetSizes(*N,n,m,PETSC_DECIDE,PETSC_DECIDE);CHKERRQ(ierr);
152   ierr = PetscLayoutSetUp((*N)->rmap);CHKERRQ(ierr);
153   ierr = PetscLayoutSetUp((*N)->cmap);CHKERRQ(ierr);
154   ierr = PetscObjectChangeTypeName((PetscObject)*N,MATTRANSPOSEMAT);CHKERRQ(ierr);
155 
156   ierr       = PetscNewLog(*N,&Na);CHKERRQ(ierr);
157   (*N)->data = (void*) Na;
158   ierr       = PetscObjectReference((PetscObject)A);CHKERRQ(ierr);
159   Na->A      = A;
160 
161   (*N)->ops->destroy                    = MatDestroy_HT;
162   (*N)->ops->mult                       = MatMult_HT;
163   (*N)->ops->multadd                    = MatMultAdd_HT;
164   (*N)->ops->multhermitiantranspose     = MatMultHermitianTranspose_HT;
165   (*N)->ops->multhermitiantransposeadd  = MatMultHermitianTransposeAdd_HT;
166   (*N)->ops->duplicate                  = MatDuplicate_HT;
167   (*N)->ops->getvecs                    = MatCreateVecs_HT;
168   (*N)->assembled                       = PETSC_TRUE;
169 
170   ierr = PetscObjectComposeFunction((PetscObject)(*N),"MatHermitianTransposeGetMat_C",MatHermitianTransposeGetMat_HT);CHKERRQ(ierr);
171   ierr = MatSetBlockSizes(*N,PetscAbs(A->cmap->bs),PetscAbs(A->rmap->bs));CHKERRQ(ierr);
172   ierr = MatSetUp(*N);CHKERRQ(ierr);
173   PetscFunctionReturn(0);
174 }
175