Unified aero recipe: optional shared reader cache

[coreyjadams]

PhysicsNeMo Pull Request

Description

Wires the optional reader cache into the unified external aerodynamics recipe. A dataloader.cache config block (off by default; the example points disk_dir under $TMPDIR), one shared DatasetCache built in build_dataloaders and passed to every dataset, MeshReaderWithGlobalData routing its external global-data load through it, and per-epoch cache.stats() in the existing benchmark_io mode. Two recipe tests.

This is the branch the I/O benchmark matrix runs on (main / pread / cache / both, benchmark_io=true, epoch-2 throughput).

Checklist

• I am familiar with the Contributing Guidelines.
• New or existing tests cover these changes.
• The documentation is up to date with these changes.
• The CHANGELOG.md is up to date with these changes.
• An issue is linked to this pull request.
• If I am implementing a new model or modifying any existing model, I have followed the Models Implementation Coding Standards.

Stack

#	PR	Base
1	#1939 preadv in the mesh readers (Max Khitrov, from fork)	main
2	#2014 DatasetCache core	io-01-pread
3	#2015 reader integrations	io-02-cache-core
4	#2016 unified aero recipe wiring	io-03-cache-readers
5	#2017 docs	io-04-recipe

Each PR shows only its own commits. Merge bottom-up; after each merge, retarget the next PR to main. Supersedes #1872.

---

🤖 Generated with Claude Code

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[github-actions]

CODEOWNERS review map

Current for commit 5fb0c7211847. An approval covers every file listed for that owner; one owner is sufficient for shared files.

⏳ @coreyjadams — 6 file(s)

• examples/cfd/external_aerodynamics/unified_external_aero_recipe/conf/base.yaml
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/datasets.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/merge_global_data.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/train.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/tests/test_merge_global_data_cache.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/tests/test_reader_cache_wiring.py

⏳ @peterdsharpe — 6 file(s)

• examples/cfd/external_aerodynamics/unified_external_aero_recipe/conf/base.yaml
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/datasets.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/merge_global_data.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/src/train.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/tests/test_merge_global_data_cache.py
• examples/cfd/external_aerodynamics/unified_external_aero_recipe/tests/test_reader_cache_wiring.py

Comment /codeowners-info to refresh.