Skip to content

Jupyter Visualization: Native AMReX Plotting via yt #215

@jameslehoux

Description

@jameslehoux

Labels: documentation, visualization, phase:0-polish
Priority: High (Quick Win)

Description

OpenImpala solves on multi-billion voxel domains, which makes loading the entire output into local RAM for visualization impossible for most users. Because OpenImpala uses the AMReX backend, our output plotfiles are natively supported by the yt project, a Python package built explicitly for out-of-core astrophysical AMR data.

We need to document how users can use yt directly in their Jupyter notebooks to explore massive OpenImpala datasets without triggering Out-Of-Memory (OOM) errors.

Acceptance Criteria

  • Add a new tutorial: notebooks/visualization_yt.ipynb.
  • Demonstrate how to load an OpenImpala AMReX plotfile using yt.load().
  • Show how to generate a 2D yt.SlicePlot of the computed tortuosity flux field.
  • Show how to generate a 1D yt.ProfilePlot (e.g., average flux along the Z-axis).
  • Add yt to the [project.optional-dependencies.docs] section of pyproject.toml so it builds correctly in Sphinx.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions