renamed values and setvalues!! to realize and realize!!

Author: torfjelde

docs/src/api.md

@@ -81,8 +81,8 @@ AbstractMCMC.chainsstack
 
 To make it a bit easier to interact with some arbitrary sampler state, we encourage implementations of `AbstractSampler` to implement the following methods:
 ```@docs
-AbstractMCMC.values
-AbstractMCMC.setvalues!!
+AbstractMCMC.realize
+AbstractMCMC.realize!!
 ```
 and optionally
 ```@docs
@@ -214,7 +214,7 @@ function AbstractMCMC.step(rng, model::AbstractMCMC.AbstractModel, sampler::Mixt
 end
 ```
 
-Suppose we then wanted to use this with some of the packages which implements AbstractMCMC.jl's interface, e.g. [`AdvancedMH.jl`](https://github.com/TuringLang/AdvancedMH.jl), then we'd simply have to implement `values` and `setvalues!!`:
+Suppose we then wanted to use this with some of the packages which implements AbstractMCMC.jl's interface, e.g. [`AdvancedMH.jl`](https://github.com/TuringLang/AdvancedMH.jl), then we'd simply have to implement `realize` and `realize!!`:
 
 ```julia
 function AbstractMCMC.updatestate!!(::AdvancedMH.Transition, state_prev::AdvancedMH.Transition)

src/AbstractMCMC.jl

@@ -84,27 +84,27 @@ struct MCMCSerial <: AbstractMCMCEnsemble end
 
 Return new instance of `state` using information from `transition_prev` and, optionally, `state_prev`.
 
-Defaults to `setvalues!!(state, values(transition_prev))`.
+Defaults to `realize!!(state, realize(transition_prev))`.
 """
 updatestate!!(state, transition_prev, state_prev) = updatestate!!(state, transition_prev)
-updatestate!!(state, transition) = setvalues!!(state, Base.values(transition))
+updatestate!!(state, transition) = realize!!(state, realize(transition))
 
 """
-    setvalues!!(state, values)
+    realize!!(state, realization)
 
-Update the values of the `state` with `values` and return it.
+Update the realization of the `state` with `realization` and return it.
 
 If `state` can be updated in-place, it is expected that this function returns `state` with updated
-values. Otherwise a new `state` object with the new `values` is returned.
+realize. Otherwise a new `state` object with the new `realization` is returned.
 """
-function setvalues!! end
+function realize!! end
 
-@doc """
-    values(transition)
+"""
+    realize(transition)
 
-Return values in `transition`.
+Return the realization of the random variables present in `transition`.
 """
-Base.values
+function realize end
 
 
 include("samplingstats.jl")