Move create and filter graph from PCGAMG to AMTAIJ

Provide more documentation on matrix layout meaning
and where matrix entries are stored across ranks (Elemental, SCALAPACK)

Commit-type: docs
/spend 1.5h

Change if () { PetscCall() } three liner and friends to one liners

for i in `git ls-files | grep "\.[ch]$"` ; do sed 's?\$?ZZZ?g' $i | tr '\n' '$' | sed 's?\([ ]*\)if (\([-;,.\*+=a-z0-9A-Z_>]*\)) {\

Change if () { PetscCall() } three liner and friends to one liners

for i in `git ls-files | grep "\.[ch]$"` ; do sed 's?\$?ZZZ?g' $i | tr '\n' '$' | sed 's?\([ ]*\)if (\([-;,.\*+=a-z0-9A-Z_>]*\)) {\$[ ]*PetscCall(\([- ._+=a-z0-9A-Z>*,()]*);\)\$[ ]*}\$?\1if (\2) PetscCall(\3$?g' | tr '$' '\n' | sed 's?ZZZ?$?g' > $i.joe ; mv $i.joe $i ; done

for i in `git ls-files | grep "\.[hc]$"` ; do sed 's?\$?ZZZ?g' $i | tr '\n' '$' | sed 's?\([ }else]*\)if (\([-;,.\*+=a-z0-9A-Z_>]*\)) {\$[ ]*PetscCall(\([- ._+=a-z0-9A-Z>*,()]*);\)\$\([ ]*\)} \([- ._+=a-z0-9A-Z>*,()]*);\)\$?\1if (\2) PetscCall(\3$\4\5$?g' | tr '$' '\n' | sed 's?ZZZ?$?g' > $i.joe ; mv $i.joe $i ; done

Yes, really ugly but Barry still cannot master awk

Commit-type: housekeeping

show more ...

Change matrix factor database options that occur in KSP/PC to always use KSP/PC options prefix

Add MatSetOptionsPrefixFactor() and MatAppendOptionsPrefixFactor() to allow controlling the options pre

Change matrix factor database options that occur in KSP/PC to always use KSP/PC options prefix

Add MatSetOptionsPrefixFactor() and MatAppendOptionsPrefixFactor() to allow controlling the options prefix
used by factors created from this matrix

Change MatSetOptionsPrefix() to no longer affect the options prefix used by factors created from this matrix

As part of the above work the handling of the factor matrix options is now done in code in the factor matrix
not in the code that originates the factor matrix

Update examples output to the new approach where the factored matrix prefix is set from the KSP/PC

Much of this work was performed by Hong Zhang

Commit-type: usability
/spend 5h

show more ...

Add notes to MatDestroy() that destroys of matrices may not
go through this routine.

I wasted several hours debugging a simple memory leak due to this
design.

/spend 3h

MATIS: implement ASM operations

move headers

Minor

Merge branch 'psanan-main-patch-36488' into 'main'

Docs: MatSetNullSpace man page. Note that the user needs to destroy a...

See merge request petsc/petsc!5241

Docs: MatSetNullSpace man page. Note that the user needs to destroy a MatNullSpace, even if using MatSetNullSpace()

remove garbage from makefiles

Including
* unused FLAGS variables
* All: lib that did not work
* stray blank lines etc

Commit-type: housekeeping
/spend 1h