docs: add CmdStanPy getting-started example

docs/source/conf.py

@@ -1,3 +1,4 @@
+
 # pylint: disable=redefined-builtin,invalid-name
 """Sphinx configuration file."""
 

docs/source/how_to/ConversionGuideCmdStanPy.md

@@ -0,0 +1,14 @@
+# CmdStanPy Conversion Guide
+
+ArviZ can convert CmdStanPy sampling results into the ArviZ data structure using `from_cmdstanpy`.
+
+```python
+import arviz_base as az
+from cmdstanpy import CmdStanModel
+
+model = CmdStanModel(stan_file="bernoulli.stan")
+fit = model.sample({"N": 10, "y": [0, 1, 0, 0, 0, 0, 0, 0, 0, 1]})
+
+idata = az.from_cmdstanpy(posterior=fit)
+az.plot_trace_dist(idata)
+

docs/source/how_to/ConversionGuideCmdStanPy.mdy

@@ -0,0 +1,13 @@
+# CmdStanPy Conversion Guide
+
+ArviZ can convert CmdStanPy sampling results into the ArviZ data structure using `from_cmdstanpy`.
+
+```python
+import arviz_base as az
+from cmdstanpy import CmdStanModel
+
+model = CmdStanModel(stan_file="bernoulli.stan")
+fit = model.sample({"N": 10, "y": [0, 1, 0, 0, 0, 0, 0, 0, 0, 1]})
+
+idata = az.from_cmdstanpy(posterior=fit)
+az.plot_trace_dist(idata)

docs/source/index.md

@@ -56,16 +56,15 @@ where `<option>` can be one of:
 * `test` (for developers)
 * `doc` (for developers)
 
-
 You can install multiple bundles of optional dependencies separating them with commas.
 Thus, to install all user facing optional dependencies you should use `arviz-base[netcdf,zarr]`
 
 :::{toctree}
 :caption: Tutorials
 :hidden:
 
-tutorial/WorkingWithDataTree
 tutorial/label_guide
+how_to/ConversionGuideCmdStanPy
 how_to/ConversionGuideEmcee
 how_to/ConversionGuideNumPyro
 ArviZ in Context <https://arviz-devs.github.io/EABM/>
@@ -85,4 +84,4 @@ api/index
 BlueSky <https://bsky.app/profile/arviz.bsky.social>
 Mastodon <https://bayes.club/@ArviZ>
 GitHub repository <https://github.com/arviz-devs/arviz-base>
-:::
+:::

docs/source/tutorial/WorkingWithDataTree.ipynb

@@ -14,7 +14,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -23,7 +23,9 @@
     "import numpy as np\n",
     "import xarray as xr\n",
     "\n",
-    "xr.set_options(display_expand_data=False, display_expand_attrs=False);"
+    "xr.set_options(display_expand_data=False, display_expand_attrs=False)\n",
+    "\n",
+    "xr.set_options(display_expand_data=False, display_expand_attrs=False)"
    ]
   },
   {
@@ -19388,9 +19390,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:base] *",
    "language": "python",
-   "name": "python3"
+   "name": "conda-base-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -19402,7 +19404,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.11"
+   "version": "3.13.9"
   },
   "varInspector": {
    "cols": {