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```{rubric} Configure/Build: 13``` 14 15- Make `SYCL` a `devicePackage`, i.e., builds `--with-sycl` now have `PETSC_HAVE_DEVICE` defined 16- Add the option `--with-devicelanguage` to compile `PetscDevice` code using either a C or C++ compiler 17- Add `Caliper`, an instrumentation and performance profiling library that can be used to profile `Hypre`. 18 19```{rubric} Sys: 20``` 21 22- Add `PetscCallHYPRE()` to check HYPRE error codes and print error messages on failure 23 24 25```{rubric} Event Logging: 26``` 27 28- Add two approaches for GPU energy monitoring: `-log_view_gpu_energy` and `-log_view_gpu_energy_meter` 29- Add API `PetscLogGpuEnergy()`, `PetscLogGpuEnergyMeter()`, `PetscLogGpuEnergyMeterBegin()` and `PetscLogGpuEnergyMeterEnd()` for GPU energy monitoring 30 31```{rubric} PetscViewer: 32``` 33 34- Change the final argument of `PetscViewerGLVisSetFields()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 35 36```{rubric} PetscDraw: 37``` 38 39```{rubric} AO: 40``` 41 42```{rubric} IS: 43``` 44 45```{rubric} VecScatter / PetscSF: 46``` 47 48```{rubric} PF: 49``` 50 51```{rubric} Vec: 52``` 53 54```{rubric} PetscSection: 55``` 56 57```{rubric} PetscPartitioner: 58``` 59 60```{rubric} Mat: 61``` 62 63- Change the `destroy()` function argument of `MatShellSetMatProductOperation()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 64- Remove `MatMissingDiagonal()`. Developers should use `MatGetDiagonalMarkers_SeqXXX()` when the functionality is needed 65- 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 66 67```{rubric} MatCoarsen: 68``` 69 70```{rubric} PC: 71``` 72 73- 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 74 75```{rubric} KSP: 76``` 77 78- Remove `KSPHPDDMPrecision` in favor of `PetscPrecision` 79 80```{rubric} SNES: 81``` 82 83- Change the `destroy()` function argument of `SNESSetConvergenceTest()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 84 85```{rubric} SNESLineSearch: 86``` 87 88```{rubric} TS: 89``` 90 91- Add `TSPseudoComputeFunction()` to get nonlinear residual while avoiding recalculation if possible 92- Remove unused `TSPseudoVerifyTimeStepDefault()` 93- Remove `TSPseudoComputeTimeStep()` and `TSPseudoVerifyTimeStep()` 94- Change the `destroy()` function argument of `TSTrajectorySetTransform()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 95- Correct option `-ts_max_reject` to `-ts_max_step_rejections` 96- Correct option `-ts_dt` to `-ts_time_step` 97 98```{rubric} TAO: 99``` 100 101```{rubric} PetscRegressor: 102``` 103 104```{rubric} DM/DA: 105``` 106 107- Change the final argument of `DMShellSetDestroyContext()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 108 109```{rubric} DMSwarm: 110``` 111 112```{rubric} DMPlex: 113``` 114 115- Add `DMPlexVecGetClosureAtDepth()` 116- Add an extra communicator argument to `DMPlexFilter()` to allow extracting local meshes 117 118```{rubric} FE/FV: 119``` 120 121```{rubric} DMNetwork: 122``` 123 124```{rubric} DMStag: 125``` 126 127```{rubric} DT: 128``` 129 130```{rubric} Fortran: 131``` 132