add changelog and polish documentation/tests

Author: Fe-r-oz

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Introduce `Lanczos` solver for `spectrum`. ([#476])
 - Add Bloch-Redfield master equation solver. ([#473])
+- Implement Bloch Sphere rendering. ([#472])
 
 ## [v0.31.1]
 Release date: 2025-05-16
@@ -231,5 +232,6 @@ Release date: 2024-11-13
 [#455]: https://github.com/qutip/QuantumToolbox.jl/issues/455
 [#456]: https://github.com/qutip/QuantumToolbox.jl/issues/456
 [#460]: https://github.com/qutip/QuantumToolbox.jl/issues/460
+[#472]: https://github.com/qutip/QuantumToolbox.jl/issues/472
 [#473]: https://github.com/qutip/QuantumToolbox.jl/issues/473
 [#476]: https://github.com/qutip/QuantumToolbox.jl/issues/476

docs/src/users_guide/plotting_the_bloch_sphere.md

@@ -135,9 +135,9 @@ fig, ax = render(b);
 fig
 ```
 
-The color and shape of the data points is varied automatically by [`Bloch`](@ref). Notice how the color and point markers change for each set of data. Again, we have had to call add_points twice because adding more than one set of multiple data points is not supported by the add_points function.
+The color and shape of the data points is varied automatically by [`Bloch`](@ref). Notice how the color and point markers change for each set of data.
 
-What if we want to vary the color of our points. We can tell [`Bloch`](@ref) to vary the color of each point according to the colors listed in the `point_color` attribute..
+What if we want to vary the color of our points. We can tell [`Bloch`](@ref) to vary the color of each point according to the colors listed in the `point_color` attribute.
 
 ```@example Bloch_sphere_rendering
 clear!(b)

src/visualization.jl

@@ -140,7 +140,7 @@ A structure representing a Bloch sphere visualization for quantum states.
     point_default_color::Vector{String} = ["blue", "red", "green", "orange"]
     point_color::Vector{Union{Nothing,String}} = Union{Nothing,String}[]
     point_marker::Vector{Symbol} = [:circle, :rect, :diamond, :utriangle]
-    point_size::Vector{Float64} = [5.0, 6.0, 7.0, 8.0]
+    point_size::Vector{Float64} = [6.0, 7.0, 8.0, 9.0]
     point_style::Vector{Symbol} = Symbol[]
     point_alpha::Vector{Float64} = Float64[]
     sphere_alpha::Float64 = 0.4

test/ext-test/cpu/makie/makie_ext.jl

@@ -86,7 +86,7 @@ end
     b = Bloch()
     add_points!(b, [0.0, 0.0, 1.0])
     @test length(b.points) == 1
-    @test b.points[1] ≈ [0.0 0.0; 0.0 0.0; 1.0 1.0]
+    @test b.points[1] ≈ [0.0, 0.0, 1.0] 
 
     pts = [[1.0, 0.0, 0.0], [0.0, 1.0, 0.0]]
     add_points!(b, hcat(pts...))