gvec.plotting.plots3d#

gvec.plotting.plots3d.plot_3d_surface(state: State, quantity: str = 'mod_B', rho: float | ndarray | list = 1.0, ntheta: int = 41, nzeta: int = 51, period: Literal['single', 'half', 'full'] = 'single', to_file: str | None = None, surface_kwargs: dict = {})#

Generate a 3D surface plot with the quantity provided by quantity on it at a given rho position and poloidal and toroidal resolution ntheta and nzeta per field period.

Parameters:

  • state (GVEC state object)

  • quantity (str, optional) – Equilibrium quantity to plot on the surface. Default is "mod_B".

  • rho (float, optional) – Radial position of the surface. Default 1.0.

  • ntheta (int) – Poloidal resolution. Default 41.

  • nzeta (int) – Toroidal resolution, per field period Default 51.

  • period (str) – Plot the "full" surface, a "single" field period or "half" a field period. Default "single"

  • surface_kwargs (dict, optional) – Keyword arguments for the surface plot. i.e. dict(opacity=0.5)

  • to_file (str) – If a string, will automatically save the plot to a file with the given input in the current working directory. Recommended to use this if the plots don’t display. Default is None

Return type:

plotly.plot object