xref: /petsc/doc/changes/233.md (revision b11d9968bc79904c690b122f9399be46447eb113)

# Changes: 2.3.3

```{rubric} General:
```

- PetscInitialize() will now also check for options in .petscrc
  unless -skip_petscrc is used (note that since the file options are
  checked before the command line you cannot pass -skip_petscrc on
  the command line it must be passed in the file passed into
  PetscInitialize().
- When a filename is passed into PetscInitialize() ~/.petscrc and
  .petscrc are checked ALSO (they used to be skipped when a filename
  was passed in) unless -skip_petscrc is passed in the input file
- PetscMapInitialize() has been split into PetscMapInitialize() that
  is called before the Map is ever used and then PetscMapSetUp()
  which is called after the blocksize and local or global size is
  set and determines the ranges etc.
- When a filename is passed into PetscInitialize() ~/.petscrc and
  .petscrc are checked ALSO (they used to be skipped when a filename
  was passed in) unless -skip_petscrc is passed in the input file
- PetscMapInitialize() has been split into PetscMapInitialize() that
  is called before the Map is ever used and then PetscMapSetUp()
  which is called after the blocksize and local or global size is
  set and determines the ranges etc.
- Changed the use of mpirun throughout the source to mpiexec; this
  includes petscmpirun -> petscmpiexec. Of course, PETSc will still
  work fine with MPI implementations that use mpirun.
- Add fortran interface to PetscBag routines

```{rubric} config/configure.py:
```

- F90 interface is now enabled by default [if the compiler is
  detected to be a f90 compiler]. i.e --with-f90-interface options
  is not required. The f90 interface impl used is a new universal
  one. However if you wish to use the old compiler specific one,
  then specify --with-f90-interface=nof90src [for configure to
  autodetect] or specify the appropriate one - like:
  --with-f90-interface=intel8

```{rubric} IS:
```

- changed IS_COLORING_LOCAL to IS_COLORING_GLOBAL

```{rubric} Vec:
```

```{rubric} VecScatter:
```

- Change prototype for VecScatterBegin() and VecScatterEnd() [now
  the first argument is VecScatter]

```{rubric} Mat:
```

- moved most of SNESMF implementation into mat/impls/mffd
- MatMFFD is now a regular matrix type registered in
  MatRegisterAll()
- changed SNESMF to MFFD for all previous SNESMF routines, except
  MatCreateSNESMF()
- -snes_mf_option changed to -mat_mffd_option except for -snes_mf
  and -snes_mf_operator
- SNES_KSP_EW... changed to SNESKSPWE... and SNES_KSP_EW_ConvCtx to
  SNESKSPEW
- MatGetRowIJ(), MatGetColumnIJ(), MatRestoreRowIJ(),
  MatRestoreColumnIJ() now take an extra argument

```{rubric} PC:
```

- changed PCMGSetCycles() and PCMGSetCyclesOnLevel() to
  PCMGSetCycleType() and PCMGSetCycleTypeOnLevel() that take a
  PCMGCycleType as argument and changed -pc_mg_cycles 1 or 2 to
  -pc_mg_cycle_type v or w
- added PCMGMultiplicativeSetCycles() and
  -pc_mg_multiplicative_cycles
- PCMGSetInterpolate() --> PCMGSetInterpolation()
- added PCREDUNDANT type, PCRedundantSetNumber() and
  -pc_redundant_number

```{rubric} KSP:
```

- Changed KSPNormTypes to have consistent naming , i.e

  - KSP_NO_NORM -> KSP_NORM_NO
  - KSP_PRECONDITIONED_NORM -> KSP_NORM_PRECONDITIONED
  - KSP_UNPRECONDITIONED_NORM -> KSP_NORM_UNPRECONDITIONED
  - KSP_NATURAL_NORM -> KSP_NORM_NATURAL

- The following function names are changed to be consistent:

  - KSPSetMonitor -> KSPMonitorSet
  - KSPClearMonitor -> KSPMonitorCancel
  - KSPSingularValueMonitor -> KSPMonitorSingularValue
  - KSPDefaultMonitor -> KSPMonitorDefault
  - KSPTrueMonitor -> KSPMonitorTrueResidualNorm
  - KSPDefaultSMonitor -> KSPMonitorDefaultShort
  - KSPVecViewMonitor -> KSPMonitorSolution
  - KSPGMRESKrylovMonitor -> KSPGMRESMonitorKrylov
  - KSPLGMonitorCreate -> KSPMonitorLGCreate
  - KSPLGMonitor -> KSPMonitorLG
  - KSPLGMonitorDestroy -> KSPMonitorLGDestroy
  - KSPLGTrueMonitorCreate -> KSPMonitorLGTrueResidualNormCreate
  - KSPLGTrueMonitor -> KSPMonitorLGTrueResidualNorm
  - KSPLGTrueMonitorDestroy -> KSPMonitorLGTrueResidualNormDestroy

- Following names are changed

  - KSP_CONVERGED_STCG_NEG_CURVE -> KSP_CONVERGED_CG_NEG_CURVE
  - KSP_CONVERGED_STCG_CONSTRAINED -> KSP_CONVERGED_CG_CONSTRAINED

```{rubric} SNES:
```

```{rubric} TS:
```

- TSSetRHSMatrix() and TSSetLHSMatrix() were replaced by
  TSSetMatrices()
- TSGetRHSMatrix() was replaced by TSGetMatrices()

```{rubric} DA:
```

```{rubric} DMMG:
```

```{rubric} SYS:
```

```{rubric} AO:
```

- AOData object and corresponding functionality is now removed for
  PETSc

```{rubric} Sieve:
```

- Added support for 2D and 3D mesh generation and refinement
- Added support for mesh partitioning and distribution
- Added support for partitioning based upon arbitrary dimensional
  entities, e.g. vertices, faces, etc.
- Added support for FIAT element generation
- Added support for higher order elements
- Added Poisson problem example in separate repository

```{rubric} Fortran:
```

```{rubric} ExternalPackages:
```

- Hypre interface is updated to use version 2.0.0
- Mumps interface is updated to use version 4.7.3
- fftw interface is updated to use v3.2alpha2