examples/heatmap_and_track: improve CLI argument parsing

[Borda]

This pull request refactors the CLI interface and entrypoint logic for the heatmap and tracking script, making it more robust and flexible. The main function is renamed and documented, and the CLI argument parsing now supports both jsonargparse and a fallback to positional arguments if the package is unavailable. This improves usability and maintainability of the script.

CLI and Entrypoint Refactor:

• Replaced argparse with a conditional import of jsonargparse for CLI parsing, with fallback to positional arguments if jsonargparse is unavailable. This makes the script more flexible for different environments. [1] [2]
• Renamed the main function from heatmap_and_track to main and added a comprehensive docstring describing all parameters for better clarity and maintainability. [1] [2]
• Updated the script's entrypoint to call main directly with parsed arguments, removing the previous manual mapping and improving code readability.

---

Part of #2090

[Copilot]

Pull request overview

This PR refactors the CLI argument parsing for the heatmap and tracking script by replacing argparse with conditional jsonargparse support and a positional argument fallback. The main function is renamed from heatmap_and_track to main and includes comprehensive parameter documentation.

Key Changes:

• Replaced argparse with jsonargparse (with fallback to positional arguments when unavailable)
• Renamed main function to main and added detailed docstring
• Simplified CLI entrypoint using ArgumentParser.add_function_arguments()

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52%. Comparing base (8df7aea) to head (1421b11).
⚠️ Report is 6 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff           @@
##           develop   #2055   +/-   ##
=======================================
  Coverage       52%     52%           
=======================================
  Files           61      61           
  Lines         7077    7076    -1     
=======================================
  Hits          3657    3657           
+ Misses        3420    3419    -1     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.