---
name: "sc_DistSymmSCMatrix"
section: "3"
platform: "linux"
package: "libsc-doc"
version: "2.3.1-22"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/sc_DistSymmSCMatrix"
---

# sc\_DistSymmSCMatrix(3)

## NAME

sc::DistSymmSCMatrix

## SYNOPSIS

Inherits **sc::SymmSCMatrix**.

### Public Member Functions

**DistSymmSCMatrix** (const **RefSCDimension** &, **DistSCMatrixKit** \*)\
 double **get\_element** (int, int) const\
 Return or modify an element.  void **set\_element** (int, int, double)\
 void **accumulate\_element** (int, int, double)\
 **SCMatrix** \* **get\_subblock** (int, int, int, int)\
 Return a subblock of this.  **SymmSCMatrix** \* **get\_subblock** (int, int)\
 void **assign\_subblock** (**SCMatrix** \*, int, int, int, int)\
 Assign m to a subblock of this.  void **assign\_subblock** (**SymmSCMatrix** \*, int, int)\
 void **accumulate\_subblock** (**SCMatrix** \*, int, int, int, int)\
 Sum m into a subblock of this.  void **accumulate\_subblock** (**SymmSCMatrix** \*, int, int)\
 **SCVector** \* **get\_row** (int i)\
 Return a row of this.  void **assign\_row** (**SCVector** \*v, int i)\
 Assign v to a row of this.  void **accumulate\_row** (**SCVector** \*v, int i)\
 Sum v to a row of this.  void **accumulate\_product\_rr** (**SCMatrix** \*, **SCMatrix** \*)\
 void **accumulate** (const **SymmSCMatrix** \*)\
 Sum m into this.  double **invert\_this** ()\
 Invert this.  double **solve\_this** (**SCVector** \*)\
 double **trace** ()\
 Return the trace.  double **determ\_this** ()\
 Return the determinant of this. this is overwritten.  void **gen\_invert\_this** ()\
 void **diagonalize** (**DiagSCMatrix** \*, **SCMatrix** \*)\
 Diagonalize this, placing the eigenvalues in d and the eigenvectors in m.  void **accumulate\_symmetric\_sum** (**SCMatrix** \*)\
 Sum into this the products of various vectors or matrices.  void **element\_op** (const **Ref**\< **SCElementOp** \> &)\
 Perform the element operation op on each element of this.  void **element\_op** (const **Ref**\< **SCElementOp2** \> &, **SymmSCMatrix** \*)\
 void **element\_op** (const **Ref**\< **SCElementOp3** \> &, **SymmSCMatrix** \*, **SymmSCMatrix** \*)\
 virtual void **convert\_accumulate** (**SymmSCMatrix** \*)\
 **Ref**\< **SCMatrixSubblockIter** \> **local\_blocks** (SCMatrixSubblockIter::Access)\
 Returns iterators for the local (rapidly accessible) blocks used in this matrix.  **Ref**\< **SCMatrixSubblockIter** \> **all\_blocks** (SCMatrixSubblockIter::Access)\
 Returns iterators for the all blocks used in this matrix.  **Ref**\< **DistSCMatrixKit** \> **skit** ()\

### Protected Member Functions

void **init\_blocklist** ()\
 double \* **find\_element** (int i, int j) const\
 int **element\_to\_node** (int i, int j) const\
 int **block\_to\_node** (int, int) const\
 **Ref**\< **SCMatrixBlock** \> **block\_to\_block** (int, int) const\
 void **error** (const char \*msg)\

### Protected Attributes

**Ref**\< **SCMatrixBlockList** \> **blocklist**\

### Friends

class **DistSCMatrix**\
 class **DistDiagSCMatrix**\
 class **DistSCVector**\

## Member Function Documentation

### void sc::DistSymmSCMatrix::accumulate (const SymmSCMatrix \* m)` [virtual]`

Sum m into this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::accumulate\_element (int, int, double)` [virtual]`

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::accumulate\_row (SCVector \* v, int i)` [virtual]`

Sum v to a row of this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::accumulate\_subblock (SCMatrix \* m, int, int, int, int)` [virtual]`

Sum m into a subblock of this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::accumulate\_subblock (SymmSCMatrix \*, int, int)` [virtual]`

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::accumulate\_symmetric\_sum (SCMatrix \*)` [virtual]`

Sum into this the products of various vectors or matrices.

Implements **sc::SymmSCMatrix**.

### Ref\< SCMatrixSubblockIter \> sc::DistSymmSCMatrix::all\_blocks (SCMatrixSubblockIter::Access)` [virtual]`

Returns iterators for the all blocks used in this matrix.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::assign\_row (SCVector \* v, int i)` [virtual]`

Assign v to a row of this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::assign\_subblock (SCMatrix \* m, int, int, int, int)` [virtual]`

Assign m to a subblock of this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::assign\_subblock (SymmSCMatrix \*, int, int)` [virtual]`

Implements **sc::SymmSCMatrix**.

### virtual void sc::DistSymmSCMatrix::convert\_accumulate (SymmSCMatrix \*)` [virtual]`

Reimplemented from **sc::SymmSCMatrix**.

### double sc::DistSymmSCMatrix::determ\_this ()` [virtual]`

Return the determinant of this. this is overwritten.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::diagonalize (DiagSCMatrix \* d, SCMatrix \* m)` [virtual]`

Diagonalize this, placing the eigenvalues in d and the eigenvectors in m.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::element\_op (const Ref\< SCElementOp \> &)` [virtual]`

Perform the element operation op on each element of this.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::element\_op (const Ref\< SCElementOp2 \> &, SymmSCMatrix \*)` [virtual]`

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::element\_op (const Ref\< SCElementOp3 \> &, SymmSCMatrix \*, SymmSCMatrix \*)` [virtual]`

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::gen\_invert\_this ()` [virtual]`

Implements **sc::SymmSCMatrix**.

### double sc::DistSymmSCMatrix::get\_element (int, int) const` [virtual]`

Return or modify an element.

Implements **sc::SymmSCMatrix**.

### SCVector \* sc::DistSymmSCMatrix::get\_row (int i)` [virtual]`

Return a row of this.

Implements **sc::SymmSCMatrix**.

### SymmSCMatrix \* sc::DistSymmSCMatrix::get\_subblock (int, int)` [virtual]`

Implements **sc::SymmSCMatrix**.

### SCMatrix \* sc::DistSymmSCMatrix::get\_subblock (int br, int er, int bc, int ec)` [virtual]`

Return a subblock of this. The subblock is defined as the rows starting at br and ending at er, and the columns beginning at bc and ending at ec.

Implements **sc::SymmSCMatrix**.

### double sc::DistSymmSCMatrix::invert\_this ()` [virtual]`

Invert this.

Implements **sc::SymmSCMatrix**.

### Ref\< SCMatrixSubblockIter \> sc::DistSymmSCMatrix::local\_blocks (SCMatrixSubblockIter::Access)` [virtual]`

Returns iterators for the local (rapidly accessible) blocks used in this matrix.

Implements **sc::SymmSCMatrix**.

### void sc::DistSymmSCMatrix::set\_element (int, int, double)` [virtual]`

Implements **sc::SymmSCMatrix**.

### double sc::DistSymmSCMatrix::solve\_this (SCVector \*)` [virtual]`

Implements **sc::SymmSCMatrix**.

### double sc::DistSymmSCMatrix::trace ()` [virtual]`

Return the trace.

Implements **sc::SymmSCMatrix**.

## Author

Generated automatically by Doxygen for MPQC from the source code.