Skip to content

Commit 344a323

Browse files
committed
Update list of changes.
1 parent 623eb01 commit 344a323

File tree

1 file changed

+71
-25
lines changed

1 file changed

+71
-25
lines changed

CHANGES.md

Lines changed: 71 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,25 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
1010
* **Changed**
1111
* ASCII mesh format
1212
* Changed `group` to `vertex-group`; remove `group` `type`.
13-
* Use the VTU (XML) format for VTK files instead of the legacy ASCII format.
1413
* Renamed `VertexGroup` to `BoundaryGroup` in `meshio.gmsh_utils` and changed default behavior to not be recursive (generate "face" groups, not "vertex" groups).
14+
* Use the VTU (XML) format for VTK files instead of the legacy ASCII format.
1515
* Material `description` property is no longer used; a deprecation warning is printed to stdout if it is specified. This feature will be removed in v6.0.
1616
* Internal labels for meshes and fields are now derived from the Pyre component name and identifier.
17-
* Update PETSc to 3.22.3
17+
* Update PETSc to 3.23.1
1818
* **Added**
19-
* Improve documentation for pylith_eqinfo and illustrate its use in examples.
19+
* Improved documentation for `pylith_eqinfo` and illustrate use in `examples/strikdslip-2d`, `examples/crustal-strikeslip-2d`, and `examples/crustal-strikeslip-3d`.
20+
* Add `pylith_convertmesh` for converting Cubit and Gmsh files to the PETSc HDF5 mesh format.
2021
* Add support for specifying boundary conditions using marked boundaries rather than vertices.
2122
* `MeshIOAscii`: Use `face-group` for specifying boundary conditions via cell and `face` vertices.
2223
* `MeshIOCubit`: Read sidesets from ExodusII files (generated by Cubit).
23-
* `Gmsh`: Create physical groups only at the dimension of the boundary.
24-
25-
## Version 4.2.0
24+
* `MeshIOPetsc`
25+
* `Gmsh`: Create physical groups only at the dimension of the boundary.
26+
* Add compatibility for reading PETSc HDF5 format
27+
* **Fixed**
28+
* Account for processes without cells in initial condition patch when verifying configuration.
29+
* Fix pythia import in `pylith_eqinfo`.
30+
31+
## Version 4.2.0 (2025-01-15)
2632

2733
* **Changed**
2834
* Updated `examples/strikeslip-2d` Steps 4-7 to use a more realistic slip distribution and mesh refinement in output.
@@ -40,7 +46,7 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
4046
* Updated `TimeDependentAuxiliaryFactory::updateAuxiliaryField()` to account for some processes potentially not having points in a boundary condition (`auxiliaryFieldArray == NULL_PTR`).
4147
* Updated autoconf numpy macros for compatibility with location of include files in numpy version 2.x.
4248

43-
## Version 4.1.3 (2024/07/31)
49+
## Version 4.1.3 (2024-07-31)
4450

4551
* **Added**
4652
* Expanded the section of the manual discussing mesh generation with Cubit and Gmsh. Added a list of useful functions in the Cubit and Gmsh Python interfaces.
@@ -53,7 +59,7 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
5359
* Include all necessary files from `examples/subduction-3d` in source and binary packages.
5460
* Fix typos in documentation and update Components section of User Guide (sync with code).
5561

56-
## Version 4.1.2 (2024/06/12)
62+
## Version 4.1.2 (2024-06-12)
5763

5864
* **Fixed**
5965
* Fix inconsistency in normal direction on fault surfaces. Orientation was correct but direction was flipped at some locations. This affected local slip direction and the resulting deformation close to the fault.
@@ -65,13 +71,13 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
6571
* Charles Williams ![ORCID iD](/_static/images/ORCIDiD_icon32x32.png){w=16px}[0000-0001-7435-9196](https://orcid.org/0000-0001-7435-9196)
6672
* Grant Block ![ORCID iD](/_static/images/ORCIDiD_icon32x32.png){w=16px}[0009-0003-3402-0923](https://orcid.org/0009-0003-3402-0923)
6773

68-
## Version 4.1.1 (2024/06/09)
74+
## Version 4.1.1 (2024-06-09)
6975

7076
* **Fixed**
7177
* Improved setup of variable block Jacobian preconditioner used for elasticity with faults to reduce runtime.
7278
* Fix several typos and update a few diagrams in the documentation.
7379

74-
## Version 4.1.0 (2024/06/05)
80+
## Version 4.1.0 (2024-06-05)
7581

7682
* **Changed**
7783
* Improved the default preconditioners for poroelasticity for improved scalability.
@@ -103,7 +109,7 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
103109

104110
% =================================================================================================
105111

106-
## Version 4.0.0 (2023/12/14)
112+
## Version 4.0.0 (2023-12-14)
107113

108114
* **User parameters**
109115
* Changed name of fault Lagrange multiplier field for solution component in Python from `lagrange_fault` to `lagrange_multiplier_fault` to match name of solution field in C++.
@@ -140,7 +146,7 @@ The version numbers are in the form `MAJOR.MINOR.PATCH`, where major releases in
140146

141147
% =================================================================================================
142148

143-
## Version 3.0.3 (2022/10/14)
149+
## Version 3.0.3 (2022-10-14)
144150

145151
This is a bug fix release with no new features or changes to the user interface.
146152

@@ -171,7 +177,7 @@ The corresponding Xdmf files reflect this change.
171177

172178
% =================================================================================================
173179

174-
## Version 3.0.2 (2022/08/24)
180+
## Version 3.0.2 (2022-08-24)
175181

176182
This is a bug fix release with no new features or changes to the user interface.
177183

@@ -213,7 +219,7 @@ This is a bug fix release with no new features or changes to the user interface.
213219

214220
% =================================================================================================
215221

216-
## Version 3.0.1 (2022/06/19)
222+
## Version 3.0.1 (2022-06-19)
217223

218224
This is a bug fix release with no new features or changes to the user interface.
219225

@@ -248,7 +254,7 @@ This is a bug fix release with no new features or changes to the user interface.
248254

249255
% =================================================================================================
250256

251-
## Version 3.0.0 (2022/06/08)
257+
## Version 3.0.0 (2022-06-08)
252258

253259
Version 3.0.0 includes major changes to the underlying finite-element formulation and implementation in order to support a more flexible specification of the governing equations and higher order basis functions.
254260
These changes affect how simulations are defined.
@@ -329,7 +335,7 @@ For Linux there are additional libraries that must be installed for Gmsh to run;
329335

330336
% =================================================================================================
331337

332-
## Version 2.2.2 (2019/07/02)
338+
## Version 2.2.2 (2019-07-02)
333339

334340
* Bug fixes
335341
* Fix several typos in the manual.
@@ -369,7 +375,7 @@ For Linux there are additional libraries that must be installed for Gmsh to run;
369375

370376
% =================================================================================================
371377

372-
## Version 2.2.0 (2017/03/28)
378+
## Version 2.2.0 (2017-03-28)
373379

374380
* Added a browser-based parameter viewer for interactive viewing of all PyLith parameters and version information. See Section 4.10 PyLith Parameter Viewer of the PyLith user manual.
375381

@@ -390,7 +396,7 @@ For Linux there are additional libraries that must be installed for Gmsh to run;
390396

391397
% =================================================================================================
392398

393-
## Version 2.1.4 (2016/10/21)
399+
## Version 2.1.4 (2016-10-21)
394400

395401
* Added --version command line argument to display version information for PyLith and its dependencies.
396402

@@ -408,7 +414,7 @@ For Linux there are additional libraries that must be installed for Gmsh to run;
408414

409415
% =================================================================================================
410416

411-
## Version 2.1.3 (2016/07/20)
417+
## Version 2.1.3 (2016-07-20)
412418

413419
* Add `generate_statedb.py` and `postseismic.pvsm` files missing from `examples/2d/gravity`.
414420

@@ -423,7 +429,7 @@ condition nodesets in `examples/meshing/surface_nurbs/subduction`.
423429

424430
% =================================================================================================
425431

426-
## Version 2.1.2 (2016/06/16)
432+
## Version 2.1.2 (2016-06-16)
427433

428434
* Bugfixes for finite-strain formulation.
429435

@@ -455,7 +461,7 @@ condition nodesets in `examples/meshing/surface_nurbs/subduction`.
455461

456462
% =================================================================================================
457463

458-
## Version 2.1.0 (2015/02/19)
464+
## Version 2.1.0 (2015-02-19)
459465

460466
* Station names are required for output at arbitrary points (`OutputSolnPoints`) and are included in a /stations dataset in HDF5 files.
461467

@@ -479,7 +485,7 @@ The points file for `OutputSolnPoints` must now contain station names as the fir
479485

480486
% =================================================================================================
481487

482-
## Version 2.0.3 (2014/08/19)
488+
## Version 2.0.3 (2014-08-19)
483489

484490
### Bug fixes
485491

@@ -501,7 +507,7 @@ The points file for `OutputSolnPoints` must now contain station names as the fir
501507

502508
% =================================================================================================
503509

504-
## Version 2.0.1 (2014/06/22)
510+
## Version 2.0.1 (2014-06-22)
505511

506512
### Bug fixes
507513

@@ -513,7 +519,7 @@ The points file for `OutputSolnPoints` must now contain station names as the fir
513519

514520
% =================================================================================================
515521

516-
## Version 2.0.0 (2014/06/05)
522+
## Version 2.0.0 (2014-06-05)
517523

518524
* Replaced C++ Sieve implementation of finite-element data structures with C DMPlex implementation.
519525

@@ -608,7 +614,9 @@ distributor.partitioner = metis
608614

609615
Buried edges of faults are handled differently in v2.0. A separate nodeset/pset should be created and contain the vertices on the buried edges of the fault. See the Section 6.4.2 of the PyLith manual for more information.
610616

611-
## Version 1.9.0 (2014/05/05)
617+
% =================================================================================================
618+
619+
## Version 1.9.0 (2014-05-05)
612620

613621
### New features
614622

@@ -641,6 +649,8 @@ point.
641649

642650
No changes are needed in .cfg files to switch from v1.8.0 to v1.9.0. Version 1.9.0 does includes some changes to the friction and material model interfaces, so extensions do require changes. See the templates for details.
643651

652+
% =================================================================================================
653+
644654
## Version 1.8.0
645655

646656
### New features
@@ -698,6 +708,8 @@ formulation = pylith.problems.ExplicitTri3
698708
formulation = pylith.problems.ExplicitTet4
699709
```
700710

711+
% =================================================================================================
712+
701713
## Version 1.7.1
702714

703715
### Bug fixes
@@ -707,6 +719,8 @@ formulation = pylith.problems.ExplicitTet4
707719
* Minor updates to the documentation and manual. Added Green's function examples to the manual.
708720

709721

722+
% =================================================================================================
723+
710724
## Version 1.7.0
711725

712726
### New features
@@ -777,6 +791,8 @@ db_initial.label = Initial fault tractions
777791
```
778792

779793

794+
% =================================================================================================
795+
780796
## Version 1.6.3
781797

782798
### Bug fixes
@@ -808,6 +824,8 @@ db_initial.label = Initial fault tractions
808824
* Running simulations with more than a million cells and large faults in parallel can result in severe memory imbalances among processors. Some processors around the fault may use 10x more memory than processors away from the fault. We expect this problem to disappear in v1.7 when we switch to new, more efficient Sieve implementation.
809825

810826

827+
% =================================================================================================
828+
811829
## Version 1.6.2
812830

813831
### Bug fixes
@@ -839,6 +857,8 @@ db_initial.label = Initial fault tractions
839857
The custom line search used with the PETSc nonlinear solver (SNES)has difficulty handling some loading cases. In cases where the direction of the line search tends to be nearly orthogonal to the residual, the rate of convergence in the SNES iterations is extremely slow. In other cases the nonlinear solver gets stuck in a local minimum. We plan to improve the line search algorithm in a future release in order to resolve this issue and improve the rate of convergence in spontaneous rupture simulations.
840858

841859

860+
% =================================================================================================
861+
842862
## Version 1.6.1
843863

844864
* Validation of user input
@@ -870,6 +890,8 @@ The custom line search used with the PETSc nonlinear solver (SNES)has difficulty
870890
* Updated examples/2d/subduction/geometry.jou to use APREPRO functions and variables to store id values.
871891

872892

893+
% =================================================================================================
894+
873895
## Version 1.6.0
874896

875897
### New features
@@ -910,6 +932,8 @@ The custom line search used with the PETSc nonlinear solver (SNES)has difficulty
910932
No changes in parameters are required. Version 1.6.1 does require users to specify descriptive labels for spatial databases and friction models.
911933

912934

935+
% =================================================================================================
936+
913937
## Version 1.5.2
914938

915939
* PyLith 1.5.2 requires FIAT version 0.9.9 or later and an updated PETSc development version. It also requires users to update to the latest spatialdata version for compatibility of the SWIG generated files. These are included in the binary distribution, but users building PyLith from source will need to update FIAT, PETSc, and spatialdata.
@@ -927,6 +951,8 @@ No changes in parameters are required. Version 1.6.1 does require users to speci
927951
* Fixed bug where buffer for output of initial stresses for dynamic (spontaneous) rupture.
928952

929953

954+
% =================================================================================================
955+
930956
## Version 1.5.1
931957

932958
### Bug fixes
@@ -936,6 +962,8 @@ No changes in parameters are required. Version 1.6.1 does require users to speci
936962
* Fixed partitioning of cohesive cells. Cohesive cells were ignored during partitioning of the mesh, so they were randomly distributed among processors.
937963

938964

965+
% =================================================================================================
966+
939967
## Version 1.5.0
940968

941969
* Fault constitutive models
@@ -1021,6 +1049,8 @@ A number of changes to the code require updating old parameter settings for use
10211049
9. The `FixedDOFDB` has been renamed to `ZeroDispDB` in order to better reflect the type of spatial database.
10221050

10231051

1052+
% =================================================================================================
1053+
10241054
## Version 1.3.1
10251055

10261056
* Added stages to PETSc logging (`--petsc.log_summary`) to collect event logging into groups.
@@ -1032,6 +1062,8 @@ A number of changes to the code require updating old parameter settings for use
10321062
* Fixed assembling of Jacobian, residual, and fault sections across processors. This bug caused errors in the computation of the change in tractions over the fault surface.
10331063

10341064

1065+
% =================================================================================================
1066+
10351067
## Version 1.3.0
10361068

10371069
* New time stepping options
@@ -1051,6 +1083,8 @@ A number of changes to the code require updating old parameter settings for use
10511083
The implementation of different options for controlling the time step requires adjusting input parameters from those used with PyLith 1.2. The time stepping is specified under the time-stepping formulation rather than the problem (i.e., one level deeper).
10521084

10531085

1086+
% =================================================================================================
1087+
10541088
## Version 1.2.0
10551089

10561090
* New Sieve implementation
@@ -1083,18 +1117,24 @@ The implementation of different options for controlling the time step requires a
10831117
There are two new features in PyLith version 1.2 that require users to adjust input parameters from those used with PyLith 1.1. A dynamic array of kinematic rupture replaces a single kinematic rupture on a fault. Additionally, the default slip time function is now a step-function. This eliminates the need to specify a peak slip rate for quasi-static simulations. When using PyLith version 1.2 with a problem previously setup for PyLith 1.1, look for warnings about unknown components and settings in the screen output at the beginning of a run.
10841118

10851119

1120+
% =================================================================================================
1121+
10861122
## Version 1.1.2
10871123

10881124
* Fixed bug in output of solution over sub-domain boundary surfaces in parallel.
10891125

10901126
* Fixed Makefile.am files to include documentation files in source distribution.
10911127

10921128

1129+
% =================================================================================================
1130+
10931131
## Version 1.1.1
10941132

10951133
* Fixed Makefile.am files to include files missing from the source distribution.
10961134

10971135

1136+
% =================================================================================================
1137+
10981138
## Version 1.1.0
10991139

11001140
* New boundary conditions
@@ -1152,6 +1192,8 @@ There are two new features in PyLith version 1.2 that require users to adjust in
11521192
There are two new features in PyLith version 1.1 that require users to adjust input parameters from those used with PyLith 1.0. The elimination of containers in favor of the dynamic arrays of components present in the latest version of Pyre requires switching from setting the container to specifying the array of components on the command line or .cfg file. Additionally, the new implementation of output requires a completely new set of parameters. When using PyLith version 1.1 with a problem previously setup for PyLith 1.0, look for warnings about unknown components and settings in the output at the beginning of a run.
11531193

11541194

1195+
% =================================================================================================
1196+
11551197
## Version 1.0.2
11561198

11571199
* Performance optimizations have significantly reduced runtime and memory use relative to version 1.0.1. The default quadrature order for tetrahedral cells is now 1, which is appropriate for the default basis functions.
@@ -1173,6 +1215,8 @@ There are two new features in PyLith version 1.1 that require users to adjust in
11731215
* Fault "up" and "normal" directions remained as string arrays when passed to the module, instead of being converted to float arrays.
11741216

11751217

1218+
% =================================================================================================
1219+
11761220
## Version 1.0.1
11771221

11781222
### Bug fixes
@@ -1184,6 +1228,8 @@ There are two new features in PyLith version 1.1 that require users to adjust in
11841228
* Parallel importing of meshes from LaGrit and Cubit lacked guards against all processors reading the files.
11851229

11861230

1231+
% =================================================================================================
1232+
11871233
## Version 1.0.0
11881234

11891235
* Code now includes both dynamic and quasi-static solutions.

0 commit comments

Comments
 (0)