Add beginner-friendly explanatory comments (educational use case)

[TheDataHokage]

Hi 👋,

I used Learning mesh-based simulation with Graph Networks code as part of my scientific machine learning final project, and while working through it, I added some inline comments for myself to better understand the flow, assumptions, and math behind the implementation.

These comments don’t change functionality — they’re purely explanatory — but they helped me significantly in building intuition, and I believe they could be useful for other beginners or students using this code for learning.

This isn’t addressing a listed issue, so I wanted to ask first: would you be open to a PR that adds optional beginner-friendly comments?

Happy to:
• keep comments concise
• follow the project’s style
• limit changes strictly to documentation/comments

Thanks for maintaining this project!

[Haseebasif7]

@evansenter I can work on this if you assign

[priyanshumishra610]

Hi @TheDataHokage 👋

This sounds like a helpful improvement, especially for people using the code to build intuition around mesh-based simulations and graph networks. I’ve been working through this codebase recently and would be happy to take this up and prepare a small, comments-only PR if the maintainers are okay with it.

I’d keep the changes minimal, beginner-friendly, and aligned with the existing style — no functional changes at all.

Let me know if that works, and I can take ownership of this.

[FaryalRizwaan]

Hi 👋
I’d like to work on this issue by adding concise, beginner-friendly explanatory comments while keeping changes strictly non-functional and aligned with the project’s style.

If no one is assigned yet, I’m happy to take ownership and submit a small PR. Please let me know if that works.

[nsrawat0333]

Hey @TheDataHokage,

I went ahead and added educational comments to the core Learning to Simulate files. Tried to cover the main concepts that helped me understand the codebase:

• The encode-process-decode pipeline
• Why we use graphs for particle interactions
• Message passing and how info propagates
• Physics stuff like Euler integration and normalization
• The KD-tree trick for finding neighbors efficiently

Kept everything non-functional as you suggested. Let me know if any explanations could be clearer or if I missed something important.

PR: #681