xref: /petsc/doc/changes/dev.md (revision 67f8b36aacbb118c07b73fff3c623c6ecbd9c0da)
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
18```{rubric} Sys:
19```
20
21```{rubric} Event Logging:
22```
23
24- Add two approaches for GPU energy monitoring:  `-log_view_gpu_energy` and `-log_view_gpu_energy_meter`
25- Add API `PetscLogGpuEnergy()`, `PetscLogGpuEnergyMeter()`, `PetscLogGpuEnergyMeterBegin()` and `PetscLogGpuEnergyMeterEnd()` for GPU energy monitoring
26
27```{rubric} PetscViewer:
28```
29
30```{rubric} PetscDraw:
31```
32
33```{rubric} AO:
34```
35
36```{rubric} IS:
37```
38
39```{rubric} VecScatter / PetscSF:
40```
41
42```{rubric} PF:
43```
44
45```{rubric} Vec:
46```
47
48```{rubric} PetscSection:
49```
50
51```{rubric} PetscPartitioner:
52```
53
54```{rubric} Mat:
55```
56
57```{rubric} MatCoarsen:
58```
59
60```{rubric} PC:
61```
62
63- 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
64
65```{rubric} KSP:
66```
67
68- Remove `KSPHPDDMPrecision` in favor of `PetscPrecision`
69
70```{rubric} SNES:
71```
72
73```{rubric} SNESLineSearch:
74```
75
76```{rubric} TS:
77```
78
79```{rubric} TAO:
80```
81
82```{rubric} PetscRegressor:
83```
84
85```{rubric} DM/DA:
86```
87
88```{rubric} DMSwarm:
89```
90
91```{rubric} DMPlex:
92```
93
94- Add `DMPlexVecGetClosureAtDepth()`
95
96```{rubric} FE/FV:
97```
98
99```{rubric} DMNetwork:
100```
101
102```{rubric} DMStag:
103```
104
105```{rubric} DT:
106```
107
108```{rubric} Fortran:
109```
110