{-# LANGUAGE RankNTypes #-}

-- |
-- Module      :  Mcmc.Monitor.Parameter
-- Description :  Monitor parameters
-- Copyright   :  2021 Dominik Schrempf
-- License     :  GPL-3.0-or-later
--
-- Maintainer  :  dominik.schrempf@gmail.com
-- Stability   :  unstable
-- Portability :  portable
--
-- Creation date: Fri May 29 11:11:49 2020.
module Mcmc.Monitor.Parameter
  ( -- * Parameter monitors
    MonitorParameter (..),
    (>$<),
    monitorInt,
    monitorDouble,
    monitorDoubleF,
    monitorDoubleE,
  )
where

import qualified Data.ByteString.Builder as BB
import qualified Data.Double.Conversion.ByteString as BC
import Data.Functor.Contravariant

-- XXX: 'MonitorParameter' has a drawback. Extracting and monitoring multiple
-- parameters in one go is impossible.

-- | Instruction about a parameter to monitor.
--
-- Convert a parameter monitor from one data type to another with '(>$<)'.
--
-- For example, monitor a 'Double' value being the first entry of a tuple:
--
-- @
-- mon = fst >$< monitorDouble
-- @
data MonitorParameter a = MonitorParameter
  { -- | Name of parameter.
    MonitorParameter a -> String
mpName :: String,
    -- | Instruction about how to extract the parameter from the state.
    MonitorParameter a -> a -> Builder
mpFunc :: a -> BB.Builder
  }

instance Contravariant MonitorParameter where
  contramap :: (a -> b) -> MonitorParameter b -> MonitorParameter a
contramap a -> b
f (MonitorParameter String
n b -> Builder
m) = String -> (a -> Builder) -> MonitorParameter a
forall a. String -> (a -> Builder) -> MonitorParameter a
MonitorParameter String
n (b -> Builder
m (b -> Builder) -> (a -> b) -> a -> Builder
forall b c a. (b -> c) -> (a -> b) -> a -> c
. a -> b
f)

-- | Monitor 'Int'.
monitorInt ::
  -- | Name.
  String ->
  MonitorParameter Int
monitorInt :: String -> MonitorParameter Int
monitorInt String
n = String -> (Int -> Builder) -> MonitorParameter Int
forall a. String -> (a -> Builder) -> MonitorParameter a
MonitorParameter String
n Int -> Builder
BB.intDec

-- | Monitor 'Double' with eight decimal places (half precision).
monitorDouble ::
  -- | Name.
  String ->
  MonitorParameter Double
monitorDouble :: String -> MonitorParameter Double
monitorDouble String
n = String -> (Double -> Builder) -> MonitorParameter Double
forall a. String -> (a -> Builder) -> MonitorParameter a
MonitorParameter String
n (ByteString -> Builder
BB.byteString (ByteString -> Builder)
-> (Double -> ByteString) -> Double -> Builder
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Int -> Double -> ByteString
BC.toFixed Int
8)

-- | Monitor 'Double' with full precision computing the shortest string of
-- digits that correctly represent the number.
monitorDoubleF ::
  -- | Name.
  String ->
  MonitorParameter Double
monitorDoubleF :: String -> MonitorParameter Double
monitorDoubleF String
n = String -> (Double -> Builder) -> MonitorParameter Double
forall a. String -> (a -> Builder) -> MonitorParameter a
MonitorParameter String
n (ByteString -> Builder
BB.byteString (ByteString -> Builder)
-> (Double -> ByteString) -> Double -> Builder
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Double -> ByteString
BC.toShortest)

-- | Monitor 'Double' in exponential format and half precision.
monitorDoubleE ::
  -- | Name.
  String ->
  MonitorParameter Double
monitorDoubleE :: String -> MonitorParameter Double
monitorDoubleE String
n = String -> (Double -> Builder) -> MonitorParameter Double
forall a. String -> (a -> Builder) -> MonitorParameter a
MonitorParameter String
n (ByteString -> Builder
BB.byteString (ByteString -> Builder)
-> (Double -> ByteString) -> Double -> Builder
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Int -> Double -> ByteString
BC.toExponential Int
8)