Skip to content

Conversation

@orionarcher
Copy link
Collaborator

@orionarcher orionarcher commented Aug 19, 2025

Update the citation link in the README to point to the arxiv manuscript

Summary by CodeRabbit

  • Documentation
    • Updated README citation guidance to reference the project’s arXiv preprint instead of Zenodo, with a single consistent citation link and wording on how to cite the project in academic work.
    • No code, behavior, API, build, test, installation, or runtime changes.

Signed-off-by: Orion Cohen <27712051+orionarcher@users.noreply.github.com>
@cla-bot cla-bot bot added the cla-signed Contributor license agreement signed label Aug 19, 2025
@orionarcher orionarcher changed the title Update README.md Update citation in README.md Aug 19, 2025
@coderabbitai
Copy link

coderabbitai bot commented Aug 19, 2025

Walkthrough

Documentation-only update: the README's Citation section was edited to replace a Zenodo citation prompt with an arXiv preprint link (https://arxiv.org/abs/2508.06628). No code, API, or exported-entity changes.

Changes

Cohort / File(s) Summary of Changes
Documentation
README.md
Updated Citation section: replaced Zenodo citation text with a link to the arXiv preprint (https://arxiv.org/abs/2508.06628).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • Update citation.cff #225 — Related edits to repository citation metadata and citation.cff fields that align with updating citation targets.

Poem

I twitch my ears at README’s call,
From Zenodo’s warren to arXiv’s hall—
A hop, a link, a tidy cite,
Footnotes nibble, margins light.
Thump! The docs are crisp and bright.

Tip

🔌 Remote MCP (Model Context Protocol) integration is now available!

Pro plan users can now connect to remote MCP servers from the Integrations page. Connect with popular remote MCPs such as Notion and Linear to add more context to your reviews and chats.


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 6dce68d and c630f4d.

📒 Files selected for processing (1)
  • README.md (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (52)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.13_MACE_NVE_non_pbc.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.6_MACE_NVT_Nose_Hoover_temp_profile.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.8_MACE_NPT_Nose_Hoover.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.3_MACE_NVE_cueq.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.4_MACE_NVT_Langevin.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.10_Hybrid_swap_mc.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.2_MACE_NVE.py)
  • GitHub Check: test-examples (examples/scripts/4_High_level_api/4.1_high_level_api.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.9_MACE_NVT_staggered_stress.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.5_MACE_NVT_Nose_Hoover.py)
  • GitHub Check: test-examples (examples/scripts/7_Others/7.3_Batched_neighbor_list.py)
  • GitHub Check: test-examples (examples/scripts/3_Dynamics/3.12_MACE_NPT_Langevin.py)
  • GitHub Check: test-examples (examples/scripts/7_Others/7.6_Compare_ASE_to_VV_FIRE.py)
  • GitHub Check: test-examples (examples/scripts/4_High_level_api/4.2_auto_batching_api.py)
  • GitHub Check: test-examples (examples/scripts/5_Workflow/5.3_Elastic.py)
  • GitHub Check: test-examples (examples/scripts/7_Others/7.2_Stress_autograd.py)
  • GitHub Check: test-examples (examples/scripts/5_Workflow/5.2_In_Flight_WBM.py)
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.1_Lennard_Jones_FIRE.py)
  • GitHub Check: test-examples (examples/scripts/7_Others/7.4_Velocity_AutoCorrelation.py)
  • GitHub Check: test-examples (examples/scripts/5_Workflow/5.1_a2c_silicon_batched.py)
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.3_MACE_Gradient_Descent.py)
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.7_MACE_FrechetCellFilter_FIRE.py)
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.5_MACE_UnitCellFilter_Gradient_Descen...
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.6_MACE_UnitCellFilter_FIRE.py)
  • GitHub Check: test-examples (examples/scripts/2_Structural_optimization/2.4_MACE_FIRE.py)
  • GitHub Check: test-examples (examples/scripts/6_Phonons/6.1_Phonons_MACE.py)
  • GitHub Check: test-examples (examples/scripts/6_Phonons/6.2_QuasiHarmonic_MACE.py)
  • GitHub Check: test-examples (examples/tutorials/using_graphpes_tutorial.py)
  • GitHub Check: test-examples (examples/scripts/6_Phonons/6.3_Conductivity_MACE.py)
  • GitHub Check: test-examples (examples/tutorials/low_level_tutorial.py)
  • GitHub Check: test-examples (examples/tutorials/high_level_tutorial.py)
  • GitHub Check: test-examples (examples/scripts/1_Introduction/1.2_MACE.py)
  • GitHub Check: test-examples (examples/tutorials/hybrid_swap_tutorial.py)
  • GitHub Check: test-examples (examples/tutorials/autobatching_tutorial.py)
  • GitHub Check: test-model (macos-14, 3.12, lowest-direct, graphpes, tests/models/test_graphpes.py)
  • GitHub Check: test-model (macos-14, 3.12, lowest-direct, mace, tests/models/test_mace.py)
  • GitHub Check: test-model (macos-14, 3.11, highest, mace, tests/models/test_mace.py)
  • GitHub Check: test-model (macos-14, 3.11, highest, mace, tests/test_optimizers_vs_ase.py)
  • GitHub Check: test-model (ubuntu-latest, 3.12, lowest-direct, sevenn, tests/models/test_sevennet.py)
  • GitHub Check: test-model (ubuntu-latest, 3.12, lowest-direct, mace, tests/test_optimizers_vs_ase.py)
  • GitHub Check: test-model (ubuntu-latest, 3.12, lowest-direct, fairchem, tests/models/test_fairchem.py)
  • GitHub Check: test-model (ubuntu-latest, 3.12, lowest-direct, orb, tests/models/test_orb.py)
  • GitHub Check: test-model (ubuntu-latest, 3.11, highest, orb, tests/models/test_orb.py)
  • GitHub Check: test-model (ubuntu-latest, 3.12, lowest-direct, mace, tests/test_elastic.py)
  • GitHub Check: test-model (ubuntu-latest, 3.11, highest, sevenn, tests/models/test_sevennet.py)
  • GitHub Check: test-model (ubuntu-latest, 3.11, highest, mace, tests/test_optimizers_vs_ase.py)
  • GitHub Check: test-model (ubuntu-latest, 3.11, highest, mace, tests/test_elastic.py)
  • GitHub Check: test-model (ubuntu-latest, 3.11, highest, fairchem, tests/models/test_fairchem.py)
  • GitHub Check: test-core (macos-14, 3.12, lowest-direct)
  • GitHub Check: test-core (ubuntu-latest, 3.12, lowest-direct)
  • GitHub Check: test-core (ubuntu-latest, 3.11, highest)
  • GitHub Check: build-docs
✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch citation_update

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (2)
README.md (2)

137-137: Capitalize “arXiv” and tighten phrasing

Minor editorial fix for correctness and style.

Apply this diff:

-If you use TorchSim in your research, please cite it on [arxiv](https://arxiv.org/abs/2508.06628).
+If you use TorchSim in your research, please cite the [arXiv preprint](https://arxiv.org/abs/2508.06628).

7-10: Clarify relationship between arXiv and Zenodo references

You’ve switched the citation text to arXiv, but the README still prominently displays a Zenodo badge and reference. If both are intended (common pattern: cite the paper via arXiv and reference specific software releases via Zenodo DOI), make that explicit to avoid confusion.

Optionally expand the Citation section:

-## Citation
-
-If you use TorchSim in your research, please cite the [arXiv preprint](https://arxiv.org/abs/2508.06628).
+## Citation
+
+If you use TorchSim in your research, please cite:
+
+- the arXiv preprint: [arXiv:2508.06628](https://arxiv.org/abs/2508.06628)
+- and, for specific software versions, the corresponding release on [Zenodo][zenodo]

If Zenodo is no longer desired, consider removing the badge and link reference at Lines 7–10 to keep signals consistent.

Also applies to: 135-138

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between cd0b0a0 and 6dce68d.

📒 Files selected for processing (1)
  • README.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
README.md

[grammar] ~137-~137: There might be a mistake here.
Context: ...rxiv](https://arxiv.org/abs/2508.06628).

(QB_NEW_EN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: test-model (macos-14, 3.11, highest, sevenn, tests/models/test_sevennet.py)
  • GitHub Check: test-model (macos-14, 3.11, highest, orb, tests/models/test_orb.py)
  • GitHub Check: test-model (macos-14, 3.11, highest, fairchem, tests/models/test_fairchem.py)
  • GitHub Check: build-docs
🔇 Additional comments (1)
README.md (1)

135-138: Add BibTeX snippet to README and CITATION.cff for citation

Including the official BibTeX entry in the README and a CITATION.cff file improves discoverability and ensures proper attribution.

  • In README.md (lines 135–142), append this under the existing Citation section:
 ## Citation
 If you use TorchSim in your research, please cite it on [arXiv](https://arxiv.org/abs/2508.06628).
+
+#### BibTeX
+
+```bibtex
+@article{TorchSim2025,
+  title         = {TorchSim: An efficient atomistic simulation engine in PyTorch},
+  author        = {Orion Cohen and Janosh Riebesell and Rhys Goodall and Adeesh Kolluru and Stefano Falletta and Joseph Krause and Jorge Colindres and Gerbrand Ceder and Abhijeet S. Gangan},
+  journal       = {arXiv preprint arXiv:2508.06628},
+  year          = {2025},
+  archivePrefix = {arXiv},
+  eprint        = {2508.06628},
+  primaryClass  = {physics.comp-ph}
+}
+```
  • Create a new file CITATION.cff at the repo root with the following content:
cff-version: "1.2.0"
title: "TorchSim: An efficient atomistic simulation engine in PyTorch"
authors:
  - family-names: Cohen
    given-names: Orion
  - family-names: Riebesell
    given-names: Janosh
  - family-names: Goodall
    given-names: Rhys
  - family-names: Kolluru
    given-names: Adeesh
  - family-names: Falletta
    given-names: Stefano
  - family-names: Krause
    given-names: Joseph
  - family-names: Colindres
    given-names: Jorge
  - family-names: Ceder
    given-names: Gerbrand
  - family-names: Gangan
    given-names: Abhijeet S.
date-released: "2025-08-??"
url: "https://arxiv.org/abs/2508.06628"
# doi: <ZENODO_DOI>  # uncomment or add your Zenodo DOI if desired

Please confirm if you’d like to include the Zenodo DOI in CITATION.cff (and provide it), and I’ll update accordingly.

Signed-off-by: Orion Cohen <27712051+orionarcher@users.noreply.github.com>
@orionarcher orionarcher merged commit b251e4c into main Aug 19, 2025
93 checks passed
@orionarcher orionarcher deleted the citation_update branch August 19, 2025 23:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor license agreement signed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant