Depricate PauliBasis

Author: akirakyle

CHANGELOG.md

@@ -1,5 +1,9 @@
 # News
 
+## v0.3.10 - 2025-04-06
+
+- Deprecate `PauliBasis` as it is identical to `SpinBasis(1//2)^N` but without the compatibility with `CompositeBasis`.
+
 ## v0.3.9 - 2025-04-03
 
 - Deprecate `equal_bases`.

src/bases.jl

@@ -289,25 +289,6 @@ end
 Base.:(==)(b1::NLevelBasis, b2::NLevelBasis) = b1.N == b2.N
 
 
-"""
-    PauliBasis(num_qubits::Int)
-
-Basis for an N-qubit space where `num_qubits` specifies the number of qubits.
-The dimension of the basis is 2²ᴺ.
-"""
-struct PauliBasis{S,B} <: Basis
-    shape::S
-    bases::B
-    function PauliBasis(num_qubits::T) where {T<:Integer}
-        shape = [2 for _ in 1:num_qubits]
-        bases = Tuple(SpinBasis(1//2) for _ in 1:num_qubits)
-        return new{typeof(shape),typeof(bases)}(shape, bases)
-    end
-end
-
-Base.:(==)(pb1::PauliBasis, pb2::PauliBasis) = length(pb1.bases) == length(pb2.bases)
-
-
 """
     SpinBasis(n)
 

src/deprecated.jl

@@ -10,3 +10,17 @@ function equal_bases(a, b)
     end
     return true
 end
+
+struct PauliBasis{S,B} <: Basis
+    shape::S
+    bases::B
+    function PauliBasis(num_qubits::T) where {T<:Integer}
+        Base.depwarn("`PauliBasis` is currently not the Pauli operator basis and its behavior will be changed in future versions.", :PauliBasis)
+        shape = [2 for _ in 1:num_qubits]
+        bases = Tuple(SpinBasis(1//2) for _ in 1:num_qubits)
+        return new{typeof(shape),typeof(bases)}(shape, bases)
+    end
+end
+
+Base.:(==)(pb1::PauliBasis, pb2::PauliBasis) = length(pb1.bases) == length(pb2.bases)
+