{-# LANGUAGE RankNTypes #-} -- | -- Module : Control.Monad.Bayes.Traced.Basic -- Description : Distributions on full execution traces of full programs -- Copyright : (c) Adam Scibior, 2015-2020 -- License : MIT -- Maintainer : leonhard.markert@tweag.io -- Stability : experimental -- Portability : GHC module Control.Monad.Bayes.Traced.Basic ( Traced, hoist, marginal, mhStep, mh, ) where import Control.Applicative (liftA2) import Control.Monad.Bayes.Class ( MonadDistribution (random), MonadFactor (..), MonadMeasure, ) import Control.Monad.Bayes.Density.Free (Density) import Control.Monad.Bayes.Traced.Common ( Trace (..), bind, mhTrans', scored, singleton, ) import Control.Monad.Bayes.Weighted (Weighted) import Data.Functor.Identity (Identity) import Data.List.NonEmpty as NE (NonEmpty ((:|)), toList) -- | Tracing monad that records random choices made in the program. data Traced m a = Traced { -- | Run the program with a modified trace. model :: Weighted (Density Identity) a, -- | Record trace and output. traceDist :: m (Trace a) } instance Monad m => Functor (Traced m) where fmap f (Traced m d) = Traced (fmap f m) (fmap (fmap f) d) instance Monad m => Applicative (Traced m) where pure x = Traced (pure x) (pure (pure x)) (Traced mf df) <*> (Traced mx dx) = Traced (mf <*> mx) (liftA2 (<*>) df dx) instance Monad m => Monad (Traced m) where (Traced mx dx) >>= f = Traced my dy where my = mx >>= model . f dy = dx `bind` (traceDist . f) instance MonadDistribution m => MonadDistribution (Traced m) where random = Traced random (fmap singleton random) instance MonadFactor m => MonadFactor (Traced m) where score w = Traced (score w) (score w >> pure (scored w)) instance MonadMeasure m => MonadMeasure (Traced m) hoist :: (forall x. m x -> m x) -> Traced m a -> Traced m a hoist f (Traced m d) = Traced m (f d) -- | Discard the trace and supporting infrastructure. marginal :: Monad m => Traced m a -> m a marginal (Traced _ d) = fmap output d -- | A single step of the Trace Metropolis-Hastings algorithm. mhStep :: MonadDistribution m => Traced m a -> Traced m a mhStep (Traced m d) = Traced m d' where d' = d >>= mhTrans' m -- | Full run of the Trace Metropolis-Hastings algorithm with a specified -- number of steps. mh :: MonadDistribution m => Int -> Traced m a -> m [a] mh n (Traced m d) = fmap (map output . NE.toList) (f n) where f k | k <= 0 = fmap (:| []) d | otherwise = do (x :| xs) <- f (k - 1) y <- mhTrans' m x return (y :| x : xs)