{"id":20917529,"url":"https://github.com/nimble-dev/comparemcmcs","last_synced_at":"2025-05-13T12:30:43.665Z","repository":{"id":45042169,"uuid":"192420567","full_name":"nimble-dev/compareMCMCs","owner":"nimble-dev","description":"Tools for comparing MCMC efficiency from nimble and/or other engines","archived":false,"fork":false,"pushed_at":"2024-10-02T15:38:27.000Z","size":9121,"stargazers_count":1,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-03T06:02:11.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nimble-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-06-17T21:21:45.000Z","updated_at":"2024-10-02T15:38:32.000Z","dependencies_parsed_at":"2024-11-18T16:51:32.564Z","dependency_job_id":"d0024f97-dd1e-497c-992c-84b733f3eaf8","html_url":"https://github.com/nimble-dev/compareMCMCs","commit_stats":{"total_commits":39,"total_committers":5,"mean_commits":7.8,"dds":0.4358974358974359,"last_synced_commit":"c4eaefdff622233581ae5fb13addb64c22145105"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimble-dev%2FcompareMCMCs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimble-dev%2FcompareMCMCs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimble-dev%2FcompareMCMCs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nimble-dev%2FcompareMCMCs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nimble-dev","download_url":"https://codeload.github.com/nimble-dev/compareMCMCs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253942143,"owners_count":21987992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T16:33:57.954Z","updated_at":"2025-05-13T12:30:43.261Z","avatar_url":"https://github.com/nimble-dev.png","language":"R","readme":"# compareMCMCs\n[![CRAN](https://www.r-pkg.org/badges/version/compareMCMCs)](https://cran.r-project.org/package=compareMCMCs)\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.03844/status.svg)](https://doi.org/10.21105/joss.03844)\n\ncompareMCMCs is a package for running, managing, and comparing results from different MCMC packages.  It was refactored from the nimble package as part of the release of nimble version 0.8.0.\n\nThe User Manual (aka package vignette) giving an overview of compareMCMCs can be viewed [here](https://cran.r-project.org/web/packages/compareMCMCs/vignettes/compareMCMCs.html).\n\nRight now, compareMCMCs works with NIMBLE, JAGS and Stan.  It has a plug-in system to make it easy to include other MCMC engines in comparisons.\n\ncompareMCMCs allows you to configure a set of MCMCs to run and then automatically time them and process their results to generate html output with comparisons of efficiency and posterior distributions. This system started life as part of the `nimble` package.  It can make use of nimble's MCMC configuration system, or it can be used independently of nimble.\n\nUse of other MCMCs is supported by a plugin system.  Plugins are provided for JAGS and Stan.  Since nimble and JAGS (as well as WinBUGS and OpenBUGS) use different dialects of the same model language, it is sometimes possible to compare them using the same model code.\n\nIt is also possible to provide new comparison metrics and/or new figure components for html comparison pages.\n\nIn summary, compareMCMCs provides:\n\n- the `compareMCMCs` function to run one or more MCMCs and manage the results;\n- the `MCMCresult` class to manage results by storing samples, timing information, metrics or summaries of performance, and other details;\n- a plugin systems to include new MCMC engines;\n- a plugin system for new metrics for comparison among MCMCs;\n- a system for generating html pages with figures from comparison metrics, including a plugin system to provide new page components;\n- partial backward compatibility to nimble's original `MCMCsuite` and `compareMCMCs` functions.\n\n## Installation\n\n`compareMCMCs` is on CRAN and can be installed from R via\n\n```r\ninstall.packages(\"compareMCMCs\")\n```\n\nTo install compareMCMCs from Github \n\n```r\nlibrary(devtools)\ninstall_github(\"nimble-dev/compareMCMCs\", subdir = \"compareMCMCs\")\n```\nOr, of course, you can download and build the package, which is in the directory `compareMCMCs`.\n\n### Dependencies to run MCMC plug-ins \n\nTo use the `compareMCMCs` plugin for JAGS you first need to install JAGS. See [JAGS [homepage](http://mcmc-jags.sourceforge.net/) for platform-based instructions. You will also need the `rjags` package:\n\n```r\ninstall.packages(\"rjags\")\n```\n\nTo use the `compareMCMCs` plugin for stan, you first need to install the `rstan` package:\n\n```r\ninstall.packages(\"rstan\")\n```\n\n## Contributing and requesting support\n\nWe welcome contributions to `compareMCMCs`.   Of particular interest are contributions for the various plug-in features, including:\n\n- plug-ins for different MCMC engines,\n- plug-ins for different comparison metrics, and\n- plug-ins for different comparison page components.\n\nWe also welcome support requests, bug fixes and documentation suggestions.\n\nTo request support or report a bug, please be signed in to a GitHub account and submit an issue [here](https://github.com/nimble-dev/compareMCMCs/issues).\n\nTo contribute code, please make a GitHub pull request.  If it is very short or you want to start discussion about the idea before implementing it, you can do so by submitting an issue.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnimble-dev%2Fcomparemcmcs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnimble-dev%2Fcomparemcmcs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnimble-dev%2Fcomparemcmcs/lists"}