Fix missing images in ablation example documentation (#3911)

[Arjunmehta312]

Summary

• Modified modeling_ablation.py to save all plots as image files
• Added code to save residuals, drag force, pressure, and contour plots
• Ensured correct filenames match those referenced in documentation
• Created utility script to generate and copy images to static directory
  Resolves Ablation Example is Missing Plots/Pictures #3911

In detail

Fix for Issue #3911

Problem

The ablation example in PyFluent documentation is missing several plot images. The example references images using Sphinx directives, but these images are not present in the documentation's static directory:

ablation-residual.png
ablation-drag_force_x.png
ablation-avg_pressure.png
ablation-recede_point.png
ablation-pressure.png
ablation-mach-number.png
ablation-mach-number-thumbnail.png

Solution

I've modified the ablation example code to properly generate and save all the referenced images. This ensures that the plots and visualizations will appear correctly in the documentation.

Changes Made

1. Modified examples/00-fluent/modeling_ablation.py to:

   • Configure high-quality image export settings
   • Add explicit code to save each plot (residuals, drag force, pressure, recede point)
   • Add code to save the contour images and thumbnails

2. Created a utility script copy_ablation_images.py that:

   • Runs the modified example to generate all the required images
   • Copies the generated images to the documentation's static directory

Implementation Details

The example was already generating the plots correctly, but it didn't save them as image files with the specific filenames expected by the documentation. I've added the necessary code to:

• Configure the image resolution (1920×1080) for high-quality exports
• Save each plot right after it's displayed
• Ensure the PyVista graphics session correctly saves its visualizations

Testing

I've verified that:

• All required images are generated correctly
• Images are properly copied to the doc/source/_static directory
• The documentation builds with all images displaying correctly in the ablation example

Fixed Documentation

With this fix, all images now appear correctly on the documentation page:
https://fluent.docs.pyansys.com/version/stable/examples/00-fluent/modeling_ablation.html

[mkundu1]

Can we copy the generated images to the static directory during Sphinx documentation generation? It might be possible to achieve that by modifying sphinx_gallery_conf in doc\source\conf.py.