Skip to content

Demo: Simulating Singlet Fission Dynamics with Tensor Networks - #1828

Open
stephendiadamo wants to merge 39 commits into
PennyLaneAI:masterfrom
stephendiadamo:singlet-fission-tensor-networks
Open

Demo: Simulating Singlet Fission Dynamics with Tensor Networks#1828
stephendiadamo wants to merge 39 commits into
PennyLaneAI:masterfrom
stephendiadamo:singlet-fission-tensor-networks

Conversation

@stephendiadamo

Copy link
Copy Markdown

Summary

Simulates the vibronic dynamics quantum algorithm from arXiv:2411.13669 using GPU-accelerated MPS tensor networks via PennyLane and Maestro.

What this demo covers

  • 60-qubit, 19-mode anthracene dimer singlet fission simulation
  • Bond dimension convergence analysis (χ = 32, 64, 128, 256)
  • CPU vs GPU benchmarks (up to 6.2× speedup on A100)
  • Full population dynamics showing S₁ → ¹TT singlet fission

Files

  • demo.py — template placeholder (content in notebook)
  • blog.ipynb — full demo as Jupyter notebook for collaborative editing
  • metadata.json — demo metadata
  • requirements.in — pennylane-maestro dependency
  • 3 figures in _static/demonstration_assets/singlet_fission_tensor_networks/

Notes

  • Written as a Jupyter notebook per Catalina's suggestion for collaborative editing
  • The notebook can be converted to reST demo.py format once content is finalized
  • Ready for science review

A joint demo by Qoro Quantum and Xanadu

Simulates the vibronic dynamics quantum algorithm from arXiv:2411.13669
using GPU-accelerated MPS tensor networks via PennyLane and Maestro.

- 60-qubit, 19-mode anthracene dimer singlet fission simulation
- Bond dimension convergence analysis (chi=32-256)
- CPU vs GPU benchmarks (up to 6.2x speedup on A100)
- Full population dynamics at chi=256

Co-authored with Xanadu. Notebook included for collaborative editing.
@stephendiadamo
stephendiadamo requested review from a team as code owners July 5, 2026 16:45
@github-actions

github-actions Bot commented Jul 5, 2026

Copy link
Copy Markdown

👋 Hey, looks like you've updated some demos!

🐘 Don't forget to update the dateOfLastModification in the associated metadata files so your changes are reflected in Glass Onion (search and recommendations).

Please hide this comment once the field(s) are updated. Thanks!

# 3. A **backward half-step** of potential + coupling (reversed)
#

from vibronic_utils import load_hamiltonian, build_pauli_hamiltonian, DATA_FILE

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi @stephendiadamo ! I'm excited to see your demo! The demo cannot build because the vibronic_utils package is not defined. If it's a new external package on PyPI, then update the requirements.in file with that package.

However, if vibronics_util is a local module that was not included here, but would ordinarily reside alongside demo.py, please copy the module into the demo itself. We want demos to be self-contained code-wise. Can a PennyLane method do what you want?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Hello, thank you. I've made a push to put all the code in the demo.py file now. I also had to update a data source.

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

Your preview is ready 🎉!

You can view your changes here

Deployed at: 2026-09-07 06:48:31 UTC

@drdren

drdren commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo ! We didn't realise how many lines of code were in vibronics_util, but copy-and-pasting its contents into the demo is perhaps distracting the reader from the core story that you are presenting. We had an internal discussion about what to do.

We don't normally do this, but in this case, we think that having vibronics_util.py as a separate file in your demo subdirectory and have some language in the demo pointing the reader to check out the GitHub to access vibronics_util.py if they're interested would be the best path forwards. The demo would do as you did before, which is bring methods from vibronics_util.

I will spend some time doing so today and I would appreciate you checking if the split I made was correct.

Comment thread demonstrations_v2/singlet_fission_tensor_networks/demo.py
Comment thread demonstrations_v2/singlet_fission_tensor_networks/demo.py Outdated
@drdren

drdren commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo , I've separated demo.py from the utility functions as mentioned above. I also made sure the images actually render. The demo works!

Please do check if the demo is as you expected now that I have extracted the same utility methods. Thanks!

@stephendiadamo

Copy link
Copy Markdown
Author

Thank you! I read it over and it looks great.

@drdren

drdren commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Thanks @stephendiadamo !

Comment thread demonstrations_v2/singlet_fission_tensor_networks/demo.py Outdated

@drdren drdren left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi @stephendiadamo , thank you so much for the latest updates! The demo is really taking shape, and I know the community is going to love learning from this. I’ve left a few notes on this latest round. I've also cc'd @CatalinaAlbornoz so she can give it a look soon for some additional feedback. Thank you again for all your continued hard work and patience on this!

stephendiadamo and others added 3 commits July 22, 2026 21:31
Co-authored-by: drdren <104710745+drdren@users.noreply.github.com>
Co-authored-by: drdren <104710745+drdren@users.noreply.github.com>
@drdren

drdren commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

I will also work with you to create a thumbnail for this demo, @stephendiadamo . We can have our illustrator create it in the PennyLane style. I wanted to firstly ask: Do you have any particular ideas already, or any must-have elements? If not, then we can brainstorm. Thanks!

@stephendiadamo

Copy link
Copy Markdown
Author

If a GPU and tensor network can be visualized that could be nice. Maybe the physics + the computational representation can be visualized somehow.

@drdren

drdren commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Thanks @stephendiadamo , how about a photon coming in that splits into two (singlet fission) at the end of an MPS chain? The MPS chain can start from this fission and end at a GPU.

@stephendiadamo

Copy link
Copy Markdown
Author

@drdren Nice, that sounds good!

@drdren

drdren commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo , I did whip up a simple concept (see attached image), but our illustrator said that it's trying to convey too much simultaneously. Our thumbnails, as you can see from https://pennylane.ai/demonstrations, are very small, so they can only convey one idea.

I think there are 3 stories we can use a thumbnail to playfully tell:

  1. Singlet fission (a photon is split into two by a prism and maybe the two have trajectories like the population dynamics plot in the demo)
  2. "Maestro" (a conductor's baton hovers over vibrating waves or over a music sheet)
  3. GPUs + Qoro accelerate simulations (A rocket [maybe with the Qoro logo or a GPU] taking off with a MPS chain below. PS: This may be still too complex)
Qoro_demo_thumbnail_1

@stephendiadamo

Copy link
Copy Markdown
Author

GPUs + Qoro accelerate simulations (A rocket [maybe with the Qoro logo or a GPU] taking off with a MPS chain below. PS: This may be still too complex)

This one seems the best to me, but I'm OK with anything really

@drdren

drdren commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Thanks @stephendiadamo ! I whipped up a sketch involving a rocket. Our illustrator says that the GPU can be on the rocket. Maybe we can put the Qoro logo on it, depending on the space. We may make the MPS chain shorter and it's possible the overall picture below may be rotated clockwise by 90 degrees to become a thumbnail.

I would appreciate any feedback!

Qoro_demo_thumbnail_4

@stephendiadamo

Copy link
Copy Markdown
Author

Looks good! Our logo on the rocket would be great.

@drdren

drdren commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Thanks @stephendiadamo ! If it becomes the case that we cannot fit both the GPU pictogram and the Qoro logo, which would you prefer be on the rocket?

@stephendiadamo

Copy link
Copy Markdown
Author

The logo would be better I'd say.

@drdren

drdren commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Thanks @stephendiadamo , I know you mentioned it implicitly in our conversation, but I now need an explicit approval for us to redraw the Qoro logo in the PennyLane style. So, formally:

Do we have your approval to draw the Qoro logo in the PennyLane style for the thumbnail of this current demo that we are working on?

@stephendiadamo

Copy link
Copy Markdown
Author

Yes, you have my approval

@drdren

drdren commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Fantastic! Thank you so much @stephendiadamo ! I will get the ball rolling on this thumbnail with the Qoro logo below (do you prefer a different version?). Meanwhile, a technical review will be underway, overseen by @CatalinaAlbornoz !

137703241

@stephendiadamo

Copy link
Copy Markdown
Author

Ok sounds good. There was one made in the past when we submitted the device. Maybe it's still around...

I had a copy but I will have to find it

The logo is fine though, in any case

@CatalinaAlbornoz

Copy link
Copy Markdown
Contributor

@drdren we already have the PennyLane version of the Qoro logo. I'll send it to you.

@CatalinaAlbornoz

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo, our team should be able to review next week or the week after.

@CatalinaAlbornoz

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo, our reviewer for your demo will need one or two extra weeks. I expect that the review should be done by the last week of August. We'll keep you updated. Thank you for your patience.

@drdren

drdren commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Hi @stephendiadamo , our illustrator whipped up a thumbnail as per our discussion. Do you have any feedback?
Screenshot 2026-08-04 at 15 04 57

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants