Merge branch 'main' into compathelper/new_version/2025-05-18-01-12-40-990-02575485215

Author: ytdHuang

.github/workflows/CI-Julia-nightly.yml

@@ -58,3 +58,4 @@ jobs:
       - uses: julia-actions/julia-runtest@v1
         env:
           GROUP: ${{ matrix.group }}
+          JULIA_NUM_THREADS: auto

.github/workflows/SpellCheck.yml

@@ -10,4 +10,4 @@ jobs:
       - name: Checkout Actions Repository
         uses: actions/checkout@v4
       - name: Check spelling
-        uses: crate-ci/typos@v1.33.1
+        uses: crate-ci/typos@v1.34.0

.typos.toml

@@ -1,3 +1,4 @@
 [default.extend-words]
 ket = "ket"
 sme = "sme"
+nd  = "nd"

CHANGELOG.md

@@ -7,10 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased](https://github.com/qutip/QuantumToolbox.jl/tree/main)
 
+## [v0.33.0]
+Release date: 2025-07-22
+
+- Implement `EnrSpace` and corresponding functionality. ([#500])
+- Check for orthogonality breakdown in `Lanczos` solver for `spectrum`. ([#501])
+- Store both `times` and `times_states` in time evolution solutions. ([#506], [#504])
+- Fix errors in `Julia v1.12`. ([#507])
+
+## [v0.32.1]
+Release date: 2025-06-24
+
+This is a release just for updating documentation.
+
+## [v0.32.0]
+Release date: 2025-06-23
+
 - Introduce `Lanczos` solver for `spectrum`. ([#476])
 - Add Bloch-Redfield master equation solver. ([#473])
 - Implement Bloch Sphere rendering and align style with qutip. ([#472], [#480], [#485], [#487], [#489])
 - Add `Base.copy` method for `AbstractQuantumObject`. ([#486])
+- Add documentation for Bloch-Redfield master equation. ([#494])
 
 ## [v0.31.1]
 Release date: 2025-05-16
@@ -167,6 +184,9 @@ Release date: 2024-11-13
 [v0.30.1]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.30.1
 [v0.31.0]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.31.0
 [v0.31.1]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.31.1
+[v0.32.0]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.32.0
+[v0.32.1]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.32.1
+[v0.33.0]: https://github.com/qutip/QuantumToolbox.jl/releases/tag/v0.33.0
 [#86]: https://github.com/qutip/QuantumToolbox.jl/issues/86
 [#139]: https://github.com/qutip/QuantumToolbox.jl/issues/139
 [#271]: https://github.com/qutip/QuantumToolbox.jl/issues/271
@@ -241,3 +261,9 @@ Release date: 2024-11-13
 [#486]: https://github.com/qutip/QuantumToolbox.jl/issues/486
 [#487]: https://github.com/qutip/QuantumToolbox.jl/issues/487
 [#489]: https://github.com/qutip/QuantumToolbox.jl/issues/489
+[#494]: https://github.com/qutip/QuantumToolbox.jl/issues/494
+[#500]: https://github.com/qutip/QuantumToolbox.jl/issues/500
+[#501]: https://github.com/qutip/QuantumToolbox.jl/issues/501
+[#504]: https://github.com/qutip/QuantumToolbox.jl/issues/504
+[#506]: https://github.com/qutip/QuantumToolbox.jl/issues/506
+[#507]: https://github.com/qutip/QuantumToolbox.jl/issues/507

Project.toml

@@ -1,7 +1,7 @@
 name = "QuantumToolbox"
 uuid = "6c2fb7c5-b903-41d2-bc5e-5a7c320b9fab"
 authors = ["Alberto Mercurio", "Yi-Te Huang"]
-version = "0.31.1"
+version = "0.33.0"
 
 [deps]
 ArrayInterface = "4fba245c-0d91-5ea0-9b3e-6abc04ee57a9"
@@ -55,7 +55,7 @@ KernelAbstractions = "0.9.2"
 LaTeXStrings = "1.2"
 LinearAlgebra = "1"
 LinearSolve = "2, 3"
-Makie = "0.20, 0.21, 0.22, 0.23"
+Makie = "0.20, 0.21, 0.22, 0.23, 0.24"
 OrdinaryDiffEqCore = "1"
 OrdinaryDiffEqTsit5 = "1"
 Pkg = "1"

README.md

@@ -24,7 +24,7 @@ and [Y.-T. Huang](https://github.com/ytdHuang).
 [license-img]: https://img.shields.io/badge/license-New%20BSD-blue.svg
 [license-url]: https://opensource.org/licenses/BSD-3-Clause
 
-[cite-img]: https://img.shields.io/badge/cite-arXiv%3A2504.21440_(2023)-blue
+[cite-img]: https://img.shields.io/badge/cite-arXiv%3A2504.21440_(2025)-blue
 [cite-url]: https://doi.org/10.48550/arXiv.2504.21440
 
 [download-img]: https://img.shields.io/badge/dynamic/json?url=http%3A%2F%2Fjuliapkgstats.com%2Fapi%2Fv1%2Ftotal_downloads%2FQuantumToolbox&query=total_requests&label=Downloads

docs/make.jl

@@ -59,6 +59,7 @@ const PAGES = [
             "Monte Carlo Solver" => "users_guide/time_evolution/mcsolve.md",
             "Stochastic Solver" => "users_guide/time_evolution/stochastic.md",
             "Solving Problems with Time-dependent Hamiltonians" => "users_guide/time_evolution/time_dependent.md",
+            "Bloch-Redfield master equation" => "users_guide/time_evolution/brmesolve.md",
         ],
         "Intensive parallelization on a Cluster" => "users_guide/cluster.md",
         "Hierarchical Equations of Motion" => "users_guide/HEOM.md",

docs/src/resources/api.md

@@ -18,6 +18,7 @@ end
 
 ```@docs
 Space
+EnrSpace
 Dimensions
 GeneralDimensions
 AbstractQuantumObject
@@ -122,6 +123,8 @@ coherent_dm
 thermal_dm
 maximally_mixed_dm
 rand_dm
+enr_fock
+enr_thermal_dm
 spin_state
 spin_coherent
 bell_state
@@ -152,6 +155,8 @@ QuantumToolbox.momentum
 phase
 fdestroy
 fcreate
+enr_destroy
+enr_identity
 tunneling
 qft
 eye
@@ -312,6 +317,7 @@ PhysicalConstants
 convert_unit
 row_major_reshape
 meshgrid
+enr_state_dictionaries
 ```
 
 ## [Visualization](@id doc-API:Visualization)

docs/src/resources/bibliography.bib

@@ -119,3 +119,23 @@ @article{Hill-Wootters1997
   doi = {10.1103/PhysRevLett.78.5022},
   url = {https://link.aps.org/doi/10.1103/PhysRevLett.78.5022}
 }
+
+@book{Cohen_Tannoudji_atomphoton,
+  address = {New York},
+  author = {{Cohen-Tannoudji}, C. and {Grynberg}, G. and {Dupont-Roc}, J.},
+  publisher = {Wiley},
+  timestamp = {2010-12-01T16:20:40.000+0100},
+  title = {Atom-Photon Interactions: Basic Processes and Applications },
+  year = 1992
+}
+
+@book{breuer2002,
+  title = {The Theory of Open Quantum Systems},
+  author = {Breuer, Heinz-Peter and Petruccione, Francesco},
+  year = {2002},
+  publisher = {Oxford university press},
+  address = {Oxford New York},
+  isbn = {978-0-19-852063-4},
+  langid = {english},
+  lccn = {530.12}
+}

docs/src/users_guide/QuantumObject/QuantumObject.md

@@ -66,14 +66,16 @@ Manually specifying the data for each quantum object is inefficient. Even more s
 
 ### States
 - [`zero_ket`](@ref): zero ket vector
-- [`fock`](@ref) or [`basis`](@ref): fock state ket vector
-- [`fock_dm`](@ref): density matrix of a fock state
+- [`fock`](@ref) or [`basis`](@ref): Fock state ket vector
+- [`fock_dm`](@ref): density matrix of a Fock state
 - [`coherent`](@ref): coherent state ket vector 
 - [`rand_ket`](@ref): random ket vector
 - [`coherent_dm`](@ref): density matrix of a coherent state
 - [`thermal_dm`](@ref): density matrix of a thermal state
 - [`maximally_mixed_dm`](@ref): density matrix of a maximally mixed state
 - [`rand_dm`](@ref): random density matrix
+- [`enr_fock`](@ref): Fock state in the excitation number restricted (ENR) space
+- [`enr_thermal_dm`](@ref): thermal state in the excitation number restricted (ENR) space
 - [`spin_state`](@ref): spin state
 - [`spin_coherent`](@ref): coherent spin state
 - [`bell_state`](@ref): Bell state
@@ -108,6 +110,8 @@ Manually specifying the data for each quantum object is inefficient. Even more s
 - [`spin_J_set`](@ref): a set of Spin-`j` operators ``(S_x, S_y, S_z)``
 - [`fdestroy`](@ref): fermion destruction operator
 - [`fcreate`](@ref): fermion creation operator
+- [`enr_destroy`](@ref): destruction operator in the excitation number restricted (ENR) space
+- [`enr_identity`](@ref): identity operator in the excitation number restricted (ENR) space
 - [`commutator`](@ref): commutator or anti-commutator
 - [`tunneling`](@ref): tunneling operator
 - [`qft`](@ref): discrete quantum Fourier transform matrix