You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Fixed an error in solvePoisson.m. Added a new folder documentation/figures_from_the_paper, with live scripts for a few figures. Updated the readme with a new section explaining where to find code to produce each figure created using QGLAB.
Copy file name to clipboardExpand all lines: readme.md
+27-4Lines changed: 27 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,18 +24,41 @@ This will open up a project window. This does three things that allow you to run
24
24
25
25
In December, 2023, we submitted a paper describing the algorithms underlying QGLAB to a journal for publication. A slightly-modified version has been posted to the [arXiv](https://arxiv.org/abs/2401.00561).
26
26
27
-
28
27
#### Documentation
29
28
30
-
Basic instructions are in a matlab live script `quantumGraphRoutines.mlx`, which has also been saved as an [html file](quantumGraphRoutines.html).
29
+
Basic instructions are in a Matlab live script quantumGraphRoutines.mlx, which has also been saved as an HTML file](quantumGraphRoutines.html).
31
30
32
31
Many additional examples are presented in live scripts in directories `source/examples` and its subdirectories, and in `documentation`.
33
32
34
33
A wide variety of graphs are implemented in `source/templates`. These are demonstrated in `source/templates/templateGallery.mlx`.
35
34
36
35
If it doesn't make sense, just ask me.
37
36
38
-
#### QGLAB in action
37
+
#### Reproducibility
38
+
39
+
There is a live script to reproduce every figure in the preprint that was produced using QGLAB. Some of the figures were edited interactively for clarity after being created by a script so that formatting may differ slightly. The following table lists the figures (numbered as on the arXiV while the paper remains under review).
| 2.2 | Layout and Laplacian matrix ($\mathbf{L}_{\mathrm{VC}}$) nonzero pattern for lollipop graph |`documentation/figures_from_the_paper/figure2p2.mlx`|
44
+
| 2.4 | Same as 2.2 but for Chebyshev and includes interpolation matrix $\mathbf{V}_0$ |`documentation/figures_from_the_paper/figure2p4.mlx`|
45
+
| 2.5 and A.1 | Four eigenfunctions and spectral determinant for a Y-shaped graph |`documentation/figures_from_the_paper/figure2p5.mlx`|
46
+
| 2.6 | Stationary NLS solutions on dumbbell and spiderweb graphs |`documentation/figures_from_the_paper/figure2p6.mlx`|
47
+
| 2.7 & A.6 | Continuation study of NLS solutions on the necklace graph and two eigenfunctions |`source/examples/stationary/necklaceBifurcationDiagram.mlx`|
48
+
| 2.8 and A.9 | Soliton solutions colliding with a vertex on balanced and unbalanced star graphs. |`source/examples/evolution/NLSOnBalancedStar23t.mlx` and `source/examples/evolution/NLSOnUnbalancedStar23t.mlx`|
49
+
| 2.9 | KPP equation on a honeycomb |`source/examples/evolution/KPPonHoneycomb.mlx`|
50
+
| 3.1 | Function plotting on graphs with 2D and 3D layout |`documentation/figures_from_the_paper/figure3p1.mlx`|
51
+
| A.2 | QGLAB log (ground state of L-shaped quantum graph) | In `/documentation/templateGallery.mlx`|
52
+
| A.3 | Solution of Poisson equation on a 3-node graph |`source/examples/stationary/poissonExample.mlx` and `source/examples/chebyshev/poissonExampleChebyshev.mlx`|
53
+
| A.4 | Cubic NLS continuation study on a dumbbell graph |`documentation/continuationInstructions.mlx` contains these images and many more useful plotting routines for continuation studies |
54
+
| A.5 | Cubic-Quintic NLS continuation on a dumbbell graph |`source/examples/stationary/dumbbellContinuation35.mlx`|
55
+
| A.7 | Heat equation solution on dumbbell |`source/examples/evolution/heatOnDumbbell.mlx` also see `source/examples/evolution/heatOnDumbbellTestOrder.mlx` for convergence study |
56
+
| A.8 | sine-Gordon equation on tetrahedron (flattened to Mercedes-Benz logo for plotting) |`source/examples/evolution/sineGordonOnTetra.mlx`|
57
+
| B.2 | Visualization of a function defined on a random graph using `plot` and `pcolor`| Code in text |
58
+
| B.3 | The "bubble tower" graph | Code in text |
59
+
60
+
#### QGLAB in action
61
+
39
62
This package (or earlier versions) has been used in the following papers:
40
63
41
64
* Goodman, R. H., [NLS bifurcations on the bowtie combinatorial graph and the dumbbell metric graph](http://doi.org/10.3934/dcds.2019093). *Discrete & Continuous Dynamical Systems - A*, *39*(4), 2203–2232, (2019).
@@ -53,7 +76,7 @@ and in the [2022 doctoral dissertation](https://cdr.lib.unc.edu/concern/disserta
53
76
* More advanced IMEX time-steppers
54
77
* More general vertex conditions
55
78
56
-
We are happy to consider adding features and/or to merge in contributions.
79
+
We are happy to consider adding features and/or merging contributions.
57
80
58
81
If you use the package for published work, please cite it as
0 commit comments