arviz-devs/arviz

Write conversion guides

Open

#1,489 建立於 2021年1月8日

在 GitHub 查看
 (2 留言) (0 反應) (0 負責人)TeX (1,818 star) (495 fork)batch import
DiscussionHelp WantedUser Documentation

描述

Tell us about it

Convert the cookbook into a collection of notebooks (one per PPL) with extended documentation on the respective converter function from_xyz. PPL tracker:

  • PyMC3 (if the examples below are good enough it's only a matter of putting the notebook together)
  • PyStan
  • CmdStanPy
  • Pyro
  • NumPyro
  • emcee (there are extensive examples in the from_emcee api docs that can help write this)
  • TensorFlow Probability

Thoughts on implementation

I think it would be great to define a set of tasks of increasing difficulty and then (if possible) show how to tackle them in each of the PPLs and how to convert the data to InferenceData. The current example in the cookbook is a possible starting point. The examples (click on the QR codes) for my ProbProg poster are a more complete example of InferenceData creation. And my pymc3-arviz blogpost could be used as intermediate examples.

Note: the cookbook would not be deleted, it would keep the numpy array, dict, dataframe... conversions

貢獻者指南

技術棧
python
領域
documentation
議題類型
documentation
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
over 1 week
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
stale
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
PythonProbabilistic programming conceptsArviZ basics
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
45
研究方向
Create Jupyter notebooks for each PPL (PyMC3, PyStan, CmdStanPy, Pyro, NumPyro, TensorFlow Probability) demonstrating conversion to InferenceData using the respective arviz.from xyz function. Use the existing cookbook and example notebooks as templates. Each notebook should include a complete example with code, explanations, and references to the API documentation.