1# Changes: Development 2 3% STYLE GUIDELINES: 4% * Capitalize sentences 5% * Use imperative, e.g., Add, Improve, Change, etc. 6% * Don't use a period (.) at the end of entries 7% * If multiple sentences are needed, use a period or semicolon to divide sentences, but not at the end of the final sentence 8 9```{rubric} General: 10``` 11 12- Change behavior of `-options_left` when set to `true`: it no longer triggers a call to `PetscOptionsView()` 13- Change $PETSC_DIR/lib/petsc/bin/petscfreesharedmemory to $PETSC_DIR/lib/petsc/bin/petscfreesharedmemory.sh 14 15```{rubric} Configure/Build: 16``` 17 18- Make `SYCL` a `devicePackage`, i.e., builds `--with-sycl` now have `PETSC_HAVE_DEVICE` defined 19- Add the option `--with-devicelanguage` to compile `PetscDevice` code using either a C or C++ compiler 20- Add `Caliper`, an instrumentation and performance profiling library that can be used to profile `Hypre`. 21- Add typing stubs for the Python extension module `petsc4py.PETSc`. 22 23```{rubric} Sys: 24``` 25 26- Add `PetscCallHYPRE()` to check HYPRE error codes and print error messages on failure 27- Add `PetscBTCountSet()` to count set bits in `PetscBT` 28 29 30```{rubric} Event Logging: 31``` 32 33- Add two approaches for GPU energy monitoring: `-log_view_gpu_energy` and `-log_view_gpu_energy_meter` 34- Add API `PetscLogGpuEnergy()`, `PetscLogGpuEnergyMeter()`, `PetscLogGpuEnergyMeterBegin()` and `PetscLogGpuEnergyMeterEnd()` for GPU energy monitoring 35 36```{rubric} PetscViewer: 37``` 38 39- Change the final argument of `PetscViewerGLVisSetFields()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 40 41```{rubric} PetscDraw: 42``` 43 44```{rubric} AO: 45``` 46 47```{rubric} IS: 48``` 49 50```{rubric} VecScatter / PetscSF: 51``` 52 53```{rubric} PF: 54``` 55 56```{rubric} Vec: 57``` 58 59```{rubric} PetscSection: 60``` 61 62- Add `PetscSectionMigrateData()`, akin to `DMPlexDistributeData()` 63 64```{rubric} PetscPartitioner: 65``` 66 67```{rubric} Mat: 68``` 69 70- Change the `destroy()` function argument of `MatShellSetMatProductOperation()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 71- Remove `MatMissingDiagonal()`. Developers should use `MatGetDiagonalMarkers_SeqXXX()` when the functionality is needed 72- Change `MatSetOption(A, MAT_HERMITIAN, PETSC_TRUE)` for `MatSBAIJ` to no longer automatically set the option `MAT_SYMMETRIC` to `PETSC_FALSE`. It is now the duty of the user to call `MatSetOption(A, MAT_SYMMETRIC, PETSC_FALSE)` if a `MatSBAIJ` is Hermitian but not symmetric 73- Deprecate `-matmatmult_Bbn` in favor of `-matproduct_batch_size` 74 75```{rubric} MatCoarsen: 76``` 77 78```{rubric} PC: 79``` 80 81- Add multi-precision support for MUMPS. One could use `-pc_precision <single, double>` to set the precision to be used by MUMPS, which can be different from `PetscScalar`'s precision 82- Add support for MUMPS out-of-core facility with the option `-mat_mumps_ooc_tmpdir <dir>` and new functions `MatMumpsSetOocTmpDir()`, `MatMumpsGetOocTmpDir()` 83 84```{rubric} KSP: 85``` 86 87- Remove `KSPHPDDMPrecision` in favor of `PetscPrecision` 88 89```{rubric} SNES: 90``` 91 92- Change the `destroy()` function argument of `SNESSetConvergenceTest()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 93- Add `SNESSetObjectiveDomainError()` 94- Change `SNES_DIVERGED_FNORM_NAN` to `SNES_DIVERGED_FUNCTION_NANORINF` 95- Add `SNES_DIVERGED_OBJECTIVE_NANORINF` 96- Add `SNES_DIVERGED_OBJECTIVE_DOMAIN` 97- Add developer functions `SNESCheckFunctionDomainError()`, `SNESLineSearchCheckFunctionDomainError()`, `SNESCheckObjectiveDomainError()`, `SNESLineSearchCheckObjectiveDomainError()`, `SNESCheckJacobianDomainError()`, and `SNESLineSearchCheckJacobianDomainError()` 98 99```{rubric} SNESLineSearch: 100``` 101 102```{rubric} TS: 103``` 104 105- Add `TSPseudoComputeFunction()` to get nonlinear residual while avoiding recalculation if possible 106- Remove unused `TSPseudoVerifyTimeStepDefault()` 107- Remove `TSPseudoComputeTimeStep()` and `TSPseudoVerifyTimeStep()` 108- Change the `destroy()` function argument of `TSTrajectorySetTransform()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 109- Correct option `-ts_max_reject` to `-ts_max_step_rejections` 110- Correct option `-ts_dt` to `-ts_time_step` 111 112```{rubric} TAO: 113``` 114 115```{rubric} PetscRegressor: 116``` 117 118```{rubric} DM/DA: 119``` 120 121- Change the final argument of `DMShellSetDestroyContext()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 122- Add `DMLabelGetValueISGlobal()` to get globally consistent `IS` of values in a `DMLabel` 123 124```{rubric} DMSwarm: 125``` 126 127```{rubric} DMPlex: 128``` 129 130- Add `DMPlexVecGetClosureAtDepth()` 131- Add an extra communicator argument to `DMPlexFilter()` to allow extracting local meshes 132- Add `DMPlexGetLETKFLocalizationMatrix` to compute localization weight matrix for LETKF 133- Change `verticesAdjSaved` parameter in `DMPlexCreateFromCell*Parallel*()` functions to be allocated by function rather than by user 134 135```{rubric} FE/FV: 136``` 137 138```{rubric} DMNetwork: 139``` 140 141```{rubric} DMStag: 142``` 143 144```{rubric} DT: 145``` 146 147```{rubric} Fortran: 148``` 149 150- Replace `./configure` option `--with-mpi-f90module-visibility` with `--with-mpi-ftn-module=<mpi or mpi_f08>` 151- Add `PETSC_INT_KIND` and `PETSC_MPIINT_KIND` 152- Fortran code should now use `MPIU_Comm` instead of `MPI_Comm`, and similarly for other MPI types, see section "Fortran and MPI" in the users guide 153- Fortran interface definitions are now automatically generated for all functions that take context variable arguments, represented in the C source code with a type of `PetscCtx`, allowing the use of any Fortran derived type (or PETSc object) as the context 154- For all PETSc functions `XXXGetYYY()` that return a context variable as an argument, represented in the C source code with an argument type of `PetscCtxRt`, a macro is generated used with `Interface_XXXGetYYY(AppCtx)` which tells the Fortran compiler that a pointer to that derived type `type(AppCtx)` is returned from the Fortran version of `XXXGetYYY()`. See src/snes/tutorials/ex5f90.F90` 155 156