inv_chi_square.hpp

Go to the documentation of this file.

#ifndef __STAN__PROB__DIST__UNI__CONTINUOUS__INV_CHI_SQUARE_HPP__
#define __STAN__PROB__DIST__UNI__CONTINUOUS__INV_CHI_SQUARE_HPP__

#include <stan/agrad.hpp>
#include <stan/math/error_handling.hpp>
#include <stan/math/special_functions.hpp>
#include <stan/meta/traits.hpp>
#include <stan/prob/constants.hpp>
#include <stan/prob/traits.hpp>
#include <stan/prob/internal_math.hpp>

namespace stan {

  namespace prob {

    template <bool propto,
              typename T_y, typename T_dof, 
              class Policy>
    typename return_type<T_y,T_dof>::type
    inv_chi_square_log(const T_y& y, const T_dof& nu, 
                       const Policy&) {
      static const char* function = "stan::prob::inv_chi_square_log(%1%)";

      // check if any vectors are zero length
      if (!(stan::length(y) 
            && stan::length(nu)))
        return 0.0;

      using stan::math::check_finite;      
      using stan::math::check_positive;
      using stan::math::check_not_nan;
      using stan::math::value_of;
      using stan::math::check_consistent_sizes;

      typename return_type<T_y,T_dof>::type logp(0.0);
      if (!check_finite(function, nu, "Degrees of freedom parameter", &logp, Policy()))
        return logp;
      if (!check_positive(function, nu, "Degrees of freedom parameter", &logp, Policy()))
        return logp;
      if (!check_not_nan(function, y, "Random variable", &logp, Policy()))
        return logp;

      if (!(check_consistent_sizes(function,
                                   y,nu,
                                   "Random variable","Degrees of freedom parameter",
                                   &logp, Policy())))
        return logp;

       
      // set up template expressions wrapping scalars into vector views
      VectorView<const T_y> y_vec(y);
      VectorView<const T_dof> nu_vec(nu);
      size_t N = max_size(y, nu);
      
      for (size_t n = 0; n < length(y); n++) 
        if (value_of(y_vec[n]) <= 0)
          return LOG_ZERO;

      using boost::math::lgamma;
      using stan::math::multiply_log;
      for (size_t n = 0; n < N; n++) {
        if (include_summand<propto,T_dof>::value)
          logp += nu_vec[n] * NEG_LOG_TWO_OVER_TWO - lgamma(0.5 * nu_vec[n]);
        if (include_summand<propto,T_y,T_dof>::value)
          logp -= multiply_log(0.5*nu_vec[n]+1.0, y_vec[n]);
        if (include_summand<propto,T_y>::value)
          logp -= 0.5 / y_vec[n];
      }
      return logp;
    }

    template <bool propto,
              typename T_y, typename T_dof>
    inline
    typename return_type<T_y,T_dof>::type
    inv_chi_square_log(const T_y& y, const T_dof& nu) {
      return inv_chi_square_log<propto>(y,nu,stan::math::default_policy());
    }

    template <typename T_y, typename T_dof, 
              class Policy>
    inline
    typename return_type<T_y,T_dof>::type
    inv_chi_square_log(const T_y& y, const T_dof& nu, 
                       const Policy&) {
      return inv_chi_square_log<false>(y,nu,Policy());
    }
      

    template <typename T_y, typename T_dof>
    inline
    typename return_type<T_y,T_dof>::type
    inv_chi_square_log(const T_y& y, const T_dof& nu) {
      return inv_chi_square_log<false>(y,nu,stan::math::default_policy());
    }
      
    template <typename T_y, typename T_dof, class Policy>
    typename return_type<T_y,T_dof>::type
    inv_chi_square_cdf(const T_y& y, const T_dof& nu, const Policy&) {
          
      // Size checks
      if ( !( stan::length(y) && stan::length(nu) ) ) return 0.0;
          
      // Error checks
      static const char* function = "stan::prob::inv_chi_square_cdf(%1%)";
          
      using stan::math::check_finite;      
      using stan::math::check_positive;
      using stan::math::check_not_nan;
      using stan::math::check_consistent_sizes;
          
      using boost::math::tools::promote_args;
          
      double P(1.0);
          
      if (!check_finite(function, nu, "Degrees of freedom parameter", &P, Policy()))
        return P;
          
      if (!check_positive(function, nu, "Degrees of freedom parameter", &P, Policy()))
        return P;
          
      if (!check_not_nan(function, y, "Random variable", &P, Policy()))
        return P;
          
      if (!check_positive(function, y, "Random variable", &P, Policy()))
        return P;
          
      if (!(check_consistent_sizes(function, y, nu,
                                   "Random variable", "Degrees of freedom parameter",
                                   &P, Policy())))
        return P;
          
      // Wrap arguments in vectors
      VectorView<const T_y> y_vec(y);
      VectorView<const T_dof> nu_vec(nu);
      size_t N = max_size(y, nu);
          
      agrad::OperandsAndPartials<T_y, T_dof> operands_and_partials(y, nu);
          
      std::fill(operands_and_partials.all_partials,
                operands_and_partials.all_partials + operands_and_partials.nvaris, 0.0);
          
      // Compute CDF and its gradients
      using stan::math::value_of;
      using boost::math::gamma_p_derivative;
      using boost::math::gamma_q;
      using boost::math::tgamma;
      using boost::math::digamma;
          
      // Cache a few expensive function calls if nu is a parameter
      DoubleVectorView<!is_constant_struct<T_dof>::value, is_vector<T_dof>::value> gamma_vec(stan::length(nu));
      DoubleVectorView<!is_constant_struct<T_dof>::value, is_vector<T_dof>::value> digamma_vec(stan::length(nu));
          
      if (!is_constant_struct<T_dof>::value)  {
              
        for (size_t i = 0; i < stan::length(nu); i++) {
          const double nu_dbl = value_of(nu_vec[i]);
          gamma_vec[i] = tgamma(nu_dbl);
          digamma_vec[i] = digamma(nu_dbl);
        }
              
      }
          
      // Compute vectorized CDF and gradient
      for (size_t n = 0; n < N; n++) {
              
        // Pull out values
        const double y_dbl = value_of(y_vec[n]);
        const double y_inv_dbl = 1.0 / y_dbl;
        const double nu_dbl = value_of(nu_vec[n]);
              
        // Compute
        const double Pn = gamma_q(0.5 * nu_dbl, 0.5 * y_inv_dbl);
              
        P *= Pn;
              
        if (!is_constant_struct<T_y>::value)
          operands_and_partials.d_x1[n] 
            += 0.5 * y_inv_dbl * y_inv_dbl * gamma_p_derivative(0.5 * nu_dbl, 0.5 * y_inv_dbl) / Pn;
              
        if (!is_constant_struct<T_dof>::value)
          operands_and_partials.d_x2[n] 
            += 0.5 * stan::math::gradRegIncGamma(0.5 * nu_dbl, 0.5 * y_inv_dbl, gamma_vec[n], digamma_vec[n]) / Pn;
              
      }
          
      for (size_t n = 0; n < N; n++) {
              
        if (!is_constant_struct<T_y>::value)
          operands_and_partials.d_x1[n] *= P;
              
        if (!is_constant_struct<T_dof>::value)
          operands_and_partials.d_x2[n] *= P;
              
      }
          
      return operands_and_partials.to_var(P);
          
    }
      
    template <typename T_y, typename T_dof>
    inline typename return_type<T_y,T_dof>::type
    inv_chi_square_cdf(const T_y& y, const T_dof& nu) {
      return inv_chi_square_cdf(y, nu, stan::math::default_policy());
    }
    
  }
}

#endif