CmdStan.jl

CmdStan.jl v6 provides an alternative, older Julia wrapper to Stan's `cmdstan` executable. CmdStan will be deprecated in 2022.
Author StanJulia
Popularity
30 Stars
Updated Last
6 Months Ago
Started In
May 2018

CmdStan

Project Status Documentation Build Status

Purpose

A package to run Stan's cmdstan executable from Julia.

Status

CmdStan.jl will be deprecated in 2022. Please switch to StanSample.jl. Time permitting, Pull Requests will be merged if all tests pass and new fuctionality is tested.

Prerequisites

For more info on Stan, please go to http://mc-stan.org.

The Julia package CmdStan.jl is based on Stan's command line interface, 'cmdstan'.

The 'cmdstan' interface needs to be installed separatedly. Please see cmdstan installation for further details.

The location of the cmdstan executable and related programs is now obtained from the environment variable JULIA_CMDSTAN_HOME. This used to be CMDSTAN_HOME.

Right now versioninfo() will show its setting (if defined).

Versions

Release 6.2.0 - Thanks to @Byrth.

Switch from using

cd(dir) do  
  # stuff
  run(cmd)
end

to

stuff

run(setenv(cmd, ENV; dir=dir))

in main functions.

Release 6.0.9

  1. Switch to GitHub actions.

Release 6.0.8

  1. Thanks to @yiyuezhuo, a function extract has been added to simplify grouping variables into a NamedTuple.
  2. Stanmodel's output_format argument has been extended with an option to request conversion to a NamedTuple.
  3. Updated CSV.read to specify Dataframe argument

Release 6.0.7

  1. Compatibility updates
  2. Cmdstan version updates.

Release 6.0.2-6

  1. Fixed an issue related to naming of created files. Thanks to mkshirazi.
  2. Several bumps to deal with package versions.
  3. Re-enabling Coverage.

Release 6.0.2

  1. Init files were not properly included in cmd. Thanks to ueliwechsler and andrstef.

Release 6.0.1

  1. Removed dependency on Documenter.

Release 6.0.0 contains:

  1. Revert back to output an array by default.
  2. Switch to Requires.jl to delay/prevent loading of MCMCChains if not needed (thanks to suggestions by @Byrth and Stijn de Waele).
  3. Updates to documentation.

Release 6.0.0 is a breaking release.

To revert back to v5.x behavior a script needs to include using MCMCChains (which thus must be installed) and specify output_format=:mcmcchains in the call to stanmodel(). This option is not tested on Travis. A sub-directory examples_mcmcchains has been added which demonstrate this usage pattern.

CmdStan.jl tested on cmdstan v2.21.0.

Documentation

  • STABLEdocumentation of the most recently tagged version.
  • DEVELdocumentation of the in-development version.

Questions and issues

Question and contributions are very welcome, as are feature requests and suggestions. Please open an issue if you encounter any problems or have a question.

References

There is no shortage of good books on Bayesian statistics. A few of my favorites are:

  1. Bolstad: Introduction to Bayesian statistics

  2. Bolstad: Understanding Computational Bayesian Statistics

  3. Gelman, Hill: Data Analysis using regression and multileve,/hierachical models

  4. McElreath: Statistical Rethinking

  5. Gelman, Carlin, and others: Bayesian Data Analysis

  6. Lee, Wagenmakers: Bayesian Cognitive Modeling

  7. Kruschke:Doing Bayesian Data Analysis

  8. Betancourt: A Conceptual Introduction to Hamiltonian Monte Carlo

Used By Packages