Skip to content

docs: add repository citation guidance and metadata - #146

Merged
jake-arkinstall merged 3 commits into
mainfrom
ks-add-citation-file
Apr 6, 2026
Merged

jake-arkinstall merged 3 commits into
mainfrom
ks-add-citation-file

Conversation

@qartik

@qartik qartik commented Mar 30, 2026

Copy link
Copy Markdown
Member

Summary

  • add a top-level CITATION.cff for GitHub citation support
  • add a Citation section to README.md with a BibTeX example for repository-level citation
  • align the project description wording in pyproject.toml with the citation metadata

Resolves #145

Comment thread CITATION.cff Outdated
message: "If you use Selene in your work, please cite it using the metadata from this file."
title: "Selene"
type: software
abstract: "Quantinuum's open source emulator for hybrid quantum computation."

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I believe we are deprecating the use of the word 'hybrid' for this purpose as it is in conflict with the use of the same phrase for HPC-Quantum.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

It was copied over from pyproject.toml, I will update that as well. Though you may need to edit it in the About section of the repo.

@qartik qartik Mar 30, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Updated in both places: I changed the CFF abstract and the pyproject description to use "quantum computation" rather than "hybrid quantum computation" so the metadata stays aligned and does not regress.

Comment thread README.md
Comment on lines +48 to +55
@software{selene,
title = {Selene},
author = {Arkinstall, Jake and {TKET development team}},
year = {2025},
organization = {Quantinuum},
url = {https://github.com/Quantinuum/selene},
license = {Apache-2.0},
}

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

the backwards-compatible version would be:

@misc{selene,
  title = {Selene},
  author = {Arkinstall, Jake and {TKET development team}},
  year = {2025},
  howpublished = {\url{https://github.com/Quantinuum/selene}},
}

but I prefer the modern version.

@qartik
qartik requested a review from jake-arkinstall March 30, 2026 14:25
@qartik qartik changed the title chore: add repository citation metadata docs: add repository citation guidance and metadata Mar 30, 2026
@ss2165
ss2165 removed their request for review March 31, 2026 09:40
@qartik

qartik commented Apr 6, 2026

Copy link
Copy Markdown
Member Author

@jake-arkinstall I believe this is ready to merge, the CI failures are unrelated to this PR.

@jake-arkinstall
jake-arkinstall merged commit 880a58b into main Apr 6, 2026
8 of 23 checks passed
@jake-arkinstall
jake-arkinstall deleted the ks-add-citation-file branch April 6, 2026 18:37
jake-arkinstall pushed a commit that referenced this pull request Apr 10, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.2.13](selene-sim-v0.2.12...selene-sim-v0.2.13)
(2026-04-10)


### Features

* Build improvements
([#142](#142))
([12f399b](12f399b))
* test on QIS instead of relying on the upper stack
([#150](#150))
([b80a9c4](b80a9c4))
* Use mingw instead of msvc for windows wheels
([#143](#143))
([3d91514](3d91514))


### Documentation

* add repository citation guidance and metadata
([#146](#146))
([880a58b](880a58b)),
closes [#145](#145)

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
jake-arkinstall added a commit that referenced this pull request Jun 12, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.3.0-alpha.1](selene-sim-v0.3.0-alpha.0...selene-sim-v0.3.0-alpha.1)
(2026-06-12)


### ⚠ BREAKING CHANGES

* Use struct exports for all plugin types, separate error model and
simulator ([#169](#169))
* Add handling for an additional gateset
([#119](#119))

### Features

* Add __version__ attributes
([#137](#137))
([379ae01](379ae01))
* Add event hook which records measurement results
([#104](#104))
([01300ee](01300ee)),
closes [#103](#103)
* Add handling for an additional gateset
([#119](#119))
([5180b80](5180b80))
* Add simulate_delay functionality
([#139](#139))
([cca97fa](cca97fa))
* Add support for object files provided as bytes
([#94](#94))
([c4cfac6](c4cfac6))
* add timing to builtin runtimes and batching options to softrz runtime
([#158](#158))
([049e123](049e123))
* Better exception handling for parse_shots=False
([#70](#70))
([3caf530](3caf530))
* Build improvements
([#142](#142))
([12f399b](12f399b))
* Bump selene-core dependency and relax guppylang testing dependency
([#120](#120))
([6375791](6375791))
* Cleanup error'd processes before log collection
([#98](#98))
([77e698e](77e698e))
* **compiler:** Bump tket version; add wasm + gpu to the hugr-qis
registry
([c69155d](c69155d))
* correct shot end strategy and error processing
([#91](#91))
([93eaeb0](93eaeb0))
* Emit a nicer error when trying to emulate unsupported pytket ops
([#72](#72))
([d88a28a](d88a28a))
* Fine-grained timeout configuration
([#69](#69))
([072842e](072842e))
* Interactive use of Selene from python
([#135](#135))
([db3028d](db3028d))
* Make interfaces shared, add ArgReader
([#171](#171))
([143e742](143e742))
* QIR support using QIR-QIS
([#114](#114))
([70ab294](70ab294))
* Quest performance improvements
([#133](#133))
([af640e9](af640e9))
* random_advance ([#55](#55))
([974b496](974b496))
* Record simulated delays in event hooks
([#154](#154))
([608884a](608884a))
* Result stream handling refactor
([#93](#93))
([607a55e](607a55e))
* Stim improvements (more ops + state printing)
([#115](#115))
([867d5e5](867d5e5))
* Support state-dump passthrough on quantum replay simulator
([#108](#108))
([1b01a01](1b01a01))
* test on QIS instead of relying on the upper stack
([#150](#150))
([b80a9c4](b80a9c4))
* Test on QIS snapshots
([#134](#134))
([c4d58ab](c4d58ab))
* Traces for analytics
([#160](#160))
([24b9978](24b9978))
* update to tket-qsystem 0.20
([#66](#66))
([7191b07](7191b07))
* Use mingw instead of msvc for windows wheels
([#143](#143))
([3d91514](3d91514))
* Use SeleneStartupError for errors before shot_start
([#170](#170))
([85c2907](85c2907))
* Use struct exports for all plugin types, separate error model and
simulator ([#169](#169))
([c44a5c9](c44a5c9))


### Bug Fixes

* add `___barrier` to Helios QIS for QIR emulation
([#136](#136))
([dfbc4c3](dfbc4c3))
* Add ENDING to allowed shot state on receiving meta information
([#100](#100))
([fc4d673](fc4d673))
* Add numpy dependency back
([#127](#127))
([c9a01eb](c9a01eb))
* avoid using qir_major_version string for QIR detection
([#123](#123))
([deaa0dc](deaa0dc))
* classify lowered qir-qis bitcode as helios
([#157](#157))
([67fca60](67fca60))
* **compiler:** error when entrypoint has arguments
([#84](#84))
([604b131](604b131))
* **compiler:** update tket-qystem to fix CZ bug
([#78](#78))
([3991f11](3991f11))
* correct post_runtime duration metric
([#74](#74))
([0bef66a](0bef66a))
* make qir-qis optional and stabilize CI
([#164](#164))
([e52c0b2](e52c0b2))


### Documentation

* add repository citation guidance and metadata
([#146](#146))
([880a58b](880a58b)),
closes [#145](#145)
* Correct URL to guppy repository
([#121](#121))
([27ded00](27ded00))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: Jake Arkinstall <65358059+jake-arkinstall@users.noreply.github.com>
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.

Add citation/bibtex file

2 participants