Add Publication List

[singh-jaydeep]

• Creates file pubs_list.rst listing publications which use DESC (up to 9/8/25)
• Adds pubs_list.rst to the table of contents in index.rst

Resolves #1838

[github-actions]

Memory benchmark result

|               Test Name                |      %Δ      |    Master (MB)     |      PR (MB)       |    Δ (MB)    |    Time PR (s)     |  Time Master (s)   |
| -------------------------------------- | ------------ | ------------------ | ------------------ | ------------ | ------------------ | ------------------ |
  test_objective_jac_w7x                 |    7.06 %    |     3.782e+03      |     4.049e+03      |    266.94    |       34.35        |       31.12        |
  test_proximal_jac_w7x_with_eq_update   |    0.99 %    |     6.794e+03      |     6.861e+03      |    67.33     |       159.40       |       158.11       |
  test_proximal_freeb_jac                |    0.24 %    |     1.318e+04      |     1.321e+04      |    31.29     |       78.23        |       77.22        |
  test_proximal_freeb_jac_blocked        |    0.57 %    |     7.603e+03      |     7.647e+03      |    43.70     |       70.31        |       68.38        |
  test_proximal_freeb_jac_batched        |   -0.07 %    |     7.560e+03      |     7.555e+03      |    -5.54     |       71.21        |       68.58        |
  test_proximal_jac_ripple               |   -1.53 %    |     7.647e+03      |     7.530e+03      |   -117.07    |       69.81        |       68.91        |
  test_proximal_jac_ripple_spline        |   -1.50 %    |     3.498e+03      |     3.445e+03      |    -52.59    |       71.12        |       72.73        |
  test_eq_solve                          |    0.38 %    |     2.050e+03      |     2.058e+03      |     7.78     |       124.15       |       124.37       |

For the memory plots, go to the summary of Memory Benchmarks workflow and download the artifact.

[rahulgaur104]

Thanks for doing this, Jaydeep!
Could you also add the following preprint to the list?
https://arxiv.org/abs/2505.04211

[singh-jaydeep]

Thanks for doing this, Jaydeep! Could you also add the following preprint to the list? https://arxiv.org/abs/2505.04211

Yes, will do! I'll check to see if there are other papers I've missed.

[dpanici]

couple more:
https://pubs.aip.org/aip/pop/article/32/4/043906/3344075/Verification-of-the-Shafranov-shift-in-free

https://dx.doi.org/10.1088/1741-4326/ada56a

https://dx.doi.org/10.1088/1741-4326/ada56d

https://dx.doi.org/10.1088/1741-4326/ada56c

https://www.cambridge.org/core/journals/journal-of-plasma-physics/article/infinity-two-fusion-pilot-plant-baseline-plasma-physics-design/EFAA8FF6D37C95272E9F53AEFFE087A7

https://iopscience.iop.org/article/10.1088/1361-6587/adf6e1

There are maybe a couple more which cite DESC but these are ones which cite and talk about it a bit or use it for the analysis in the paper. I could be missing some but these are the last I remember

[rahulgaur104]

Did the Type One paper actually use DESC?

Also, I think it would be even better if we can put a link to the publication list in README.rst and/or the docs.
Otherwise, it would be left to be explored by the users.

[f0uriest]

Agree about adding the list to the readme, maybe just as a direct ..include? or maybe formatted as a table like the one shorter list there now?

Also wondering if we want to split the list into "papers about desc" ie ones by us that describe new features being added, vs "papers that use desc" to get other results but don't really add anything new to the code.

papers about desc, numbered from the existing list: 1, 3-10, 12, 13, 15, 19

[dpanici]

read the docs seems to be failing?

[singh-jaydeep]

Hmm...I think the list formatting was causing an error. Will see if this works.

[YigitElma]

FYI, sometimes debugging the docs build locally is faster (you don't wait for the runner to pick up, etc). You can follow https://github.com/PlasmaControl/DESC/tree/master/docs#readme to build docs locally.

[singh-jaydeep]

Oh makes sense, thanks!