Minor fixes for docs

[YigitElma]

• Fixes 3D plot issue in use_outputs.ipynb
• Adds VMECIO.load example
• Renames some notebooks
• Refactors documentation main titles for easy access

We have many tutorials but our search engine is not good enough for finding stuff quickly. I renamed some notebooks and divided tutorials section of docs into 3 main parts, namely Guides (general stuff like installation, performance hints, using outputs etc.), Equilibrium Solve Tutorials and Optimization Tutorials. Technically, we treat equilibrium solve as optimization but I think we need some subsections in our tutorials and this separation was the best I could find.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

dpanici commented on 2025-01-02T01:43:46Z
----------------------------------------------------------------

add a note that this is only a fit and not a true equilibrium, and one must run eq.solve or solve_continuation_automatic

also that it will fit the iota profile with a spline by default, and which profile it uses (current or iota) is changed with the profile kwarg of VMECIO.load

[dpanici]

make requested change in notebook

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

dpanici commented on 2025-01-03T20:41:42Z
----------------------------------------------------------------

It is not that you have to specify the profile, it works perfectly fine if you don't specify bc it defaults to iota. It is just good practice to to ensure you know what profile you are fixing. Also put that the profile specified will be created by spline-fitting the profile from the .nc file.

[dpanici]

change VMEC load part again

[f0uriest]

Can we do this after #1425

[YigitElma]

Note about kernel stuff: The important name of the environment for CI tests to pass is the name not display_name. As long as the name in kernel_spec is python3, it is fine, whatever the display_name is.

This problem probably arise from the difference between VS Code's jupyter notebook extension and jupyter lab. VS-CODE doesn't change the name only changes display_name so it works.