Merge pull request #804 from baagaard-usgs/docs-update-devplan

Update development plan

Author: baagaard-usgs

developer/pdf_to_svg.py

@@ -9,8 +9,16 @@
 
 filename_pdf = sys.argv[1]
 doc = pymupdf.open(filename_pdf) # open a document
-page = doc[0]
+for i_page, page in enumerate(doc):
 
-filename_svg = filename_pdf.replace(".pdf", ".svg")
-with open(filename_svg, "w", encoding="utf-8") as svg_out:
-    svg_out.write(page.get_svg_image())
+    if len(doc) > 1:
+        filename_single = filename_pdf.replace(".pdf", f"-{i_page}.pdf")
+        single_pdf = pymupdf.open()
+        single_pdf.insert_pdf(doc, from_page=i_page, to_page=i_page)
+        print(f"Writing {filename_single}...")
+        single_pdf.save(filename_single)
+
+    filename_svg = filename_pdf.replace(".pdf", ".svg") if len(doc) == 1 else filename_pdf.replace(".pdf", f"-{i_page}.svg")
+    with open(filename_svg, "w", encoding="utf-8") as svg_out:
+        print(f"Writing {filename_svg}...")
+        svg_out.write(page.get_svg_image())

docs/intro/development-plan.md

@@ -6,48 +6,75 @@ Future implementation of features is guided by several target applications, incl
 * Inversion of geodetic data for slow slip events, fault creep, and long-term fault slip rates.
 * Quasistatic and dynamic modeling of fluids and faulting.
 
+We also strive to find the correct balance between adding new features and improving the code internals, performance, and maintainability.
+Short-term priorities focus on reimplementing features in version 2.2 that have not yet been migrated to the current formulations for governing equations and discretization.
+
+:::{figure-md} fig:development:plan
+<img src="figs/development-1.*" alt="Diagram of development priorities."  width="100%"/>
+
+PyLith development priorities by category.
+Information to the right of each feature indicates difficulty (colored icon), the relative amount of effort (lower left), and an estimate of how much is completed (lower right percentage).
+The arrows indicate the order in which some features must be implemented.
+:::
+
+## Anticipated Releases
+
 :::{note}
 Because we strictly follow the [semantic versioning guidelines](https://semver.org/), a minor release may get promoted to a major releases if we make changes to the public API (parameters).
 This can happen if realize that we should modify the parameters to improve maintainability or prepare for future changes.
 :::
 
-## Version 5.0.0 (October 2024)
+## Version 4.3 (April 2025)
+
+* Specify boundary conditions using faces instead of vertices ![expert](images/intermediate.png) [75%]
+* Parallel mesh loading ![expert](images/expert.png) [85%]
+
+## Version 4.4 (June 2025)
+
+* Dynamic prescribed slip with diagonal Jacobian for explicit part of IMEX formulation ![expert](images/expert.png) [80%]
+* Add `examples/barwaves-2d` ![expert](images/expert.png) [25%]
+* Better preconditioner for incompressible elasticity ![expert](images/expert.png) [80%]
+
+## Version 4.5 (October 2025)
+
+* Spontaneous rupture for quasistatic and dynamic simulations ![expert](images/expert.png) [30%]
+
+
+## Version 5.0 (June 2026)
 
-* Better preconditioners ![expert](images/expert.png) [67%]
-  * incompressible elasticity [5%]
-* Parallel mesh loading ![expert](images/expert.png) [15%]
 * Convert from SWIG to pybind11 ![intermediate](images/intermediate.png) [0%]
 * Add support for GeoModelGrids implementation of spatial databases for 3D seismic velocity models. ![intermediate](images/intermediate.png) [0%]
+* Update to current version of Pyre ![difficult](images/difficult.png)
+* Migrate examples to Jupyter notebooks ![intermediate](images/intermediate.png)
 * Update VTK output to use `vtu` files rather than legacy `vtk` files ![easy](images/easy.png) [0%]
 * Improve robustness of HDF5 output by opening/closing at each time step ![easy](images/easy.png)[0%]
 
-## Version 6.0.0 (TBD)
+## Version 6.0 (TBD)
 
 * Output of fault rupture auxiliary subfields ![intermediate](images/intermediate.png) [0%]
 * Improve creation of auxiliary, diagnostic, and derived fields.
-* Dynamic prescribed slip with diagonal Jacobian for explicit part of IMEX formulation ![expert](images/expert.png) [75%]
-* Update to current version of Pyre ![difficult](images/difficult.png)
 * Reimplement Drucker-Prager elastoplastic bulk rheology ![intermediate](images/intermediate.png) [0%]
 
 ## Version 7.0.0 (TBD)
 
-* Add `examples/barwaves-2d` ![expert](images/expert.png) [15%]
-* Migrate examples to Jupyter notebooks ![intermediate](images/intermediate.png)
-* Spontaneous rupture for quasistatic and dynamic simulations ![expert](images/expert.png) [20%]
 * Dirichlet boundary conditions with constraints on normal and tangential components. ![difficult](images/difficult.png) [0%]
 * Integration with libCEED for fast high order residual evaluation ![expert](images/expert.png)\
 * Add ability to output residual field during nonlinear solve for debugging ![easy](images/easy.png) [0%]
 
 ## Features for Future Releases
 
+These features are not yet assigned to a release.
+They may be added to the planned releases based upon further discussion and contributions from the community.
+
+* Adaptive mesh refinement ![expert](images/expert.png)
+* Faults with poroelastic properties ![expert]{images/expert.png} [80%]
 * More flexible specification of time-dependent boundary conditions. ![difficult](images/difficult.png) [0%]
 * Elasticity with self-gravitation ![intermediate](images/intermediate.png) [0%]
 * Coupling of problems with compatible meshes ![difficult](images/difficult.png) [10%]\
     Implement "injectors" for solution and state variables.
 * Reimplementation of small strain formulation for elasticity ![difficult](images/difficult.png) [20%]
-* Moment tensor point sources  [5%]\
+* Moment tensor point sources  [60%]\
   Moment tensor point sources provide a mesh independent deformation source that is better suited for Green's function calculations than slip on a fault surface via cohesive cells.
-* Adaptive mesh refinement ![expert](images/expert.png)
 * Line/point fluid sources in poroelasticity ![expert](images/expert.png) [20%]
 * Consolidate HDF5 output into a single file ![difficult](images/difficult.png)
 * Drucker-Prager bulk rheology with relaxation to yield surface ![intermediate](images/intermediate.png)