Skip to content

Commit 8ad505a

Browse files
committed
2 parents fabc409 + 9090f87 commit 8ad505a

File tree

10 files changed

+7193
-58
lines changed

10 files changed

+7193
-58
lines changed

_quarto.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ website:
2222
page-navigation: true
2323
back-to-top-navigation: true
2424
open-graph: true
25-
25+
2626
navbar:
2727
logo: "img/logo_tm.png"
2828
logo-alt: "Stan logo"
@@ -31,7 +31,7 @@ website:
3131
- text: "Stan"
3232
href: index.qmd
3333
- text: "Getting Started"
34-
href: install/
34+
href: install/index.qmd
3535
- text: "Documentation"
3636
href: "https://mc-stan.org/docs"
3737
- text: "Learning Resources"
@@ -49,9 +49,9 @@ website:
4949
- text: "Diagnostics and Warnings"
5050
href: learn-stan/diagnostics-warnings.qmd
5151
- text: "Tools"
52-
href: tools/
52+
href: tools/index.qmd
5353
- text: "About"
54-
href: about/
54+
href: about/index.qmd
5555
tools:
5656
- icon: github
5757
url: https://github.com/stan-dev

about/index.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Stan is freedom-respecting, open-source software <span
1313
class="note">(new BSD core, some interfaces GPLv3)</span>.&nbsp; Stan
1414
is associated with NumFOCUS, a 501(c)(3) nonprofit supporting open code
1515
and reproducible science, through which you can [help support
16-
Stan](#support-stan).
16+
Stan](#help-fund-stan).
1717

1818
## Licensing
1919

index.css

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
/* custom CSS only for the home page */
2+
/* all other CSS is shared with docs and in the quarto-config submodule */
3+
4+
5+
6+
.content-block {
7+
padding-top: 20px;
8+
padding-bottom: 10px;
9+
margin-left: 30px;
10+
margin-right: 30px;
11+
}
12+
13+
@media (min-width: 900px) {
14+
.content-block {
15+
margin-left: 50px;
16+
margin-right: 50px;
17+
}
18+
}
19+
20+
@media (min-width: 1200px) {
21+
.content-block {
22+
max-width: 1100px;
23+
margin-left: auto;
24+
margin-right: auto;
25+
}
26+
}
27+
28+
.hero-banner {
29+
position: relative;
30+
display: flex;
31+
justify-content: center;
32+
color: var(--stan-hero);
33+
background-color: var(--stan-hero-bg);
34+
border: 10px solid var(--stan-secondary);
35+
}
36+
37+
.hero-banner h1 {
38+
font-size: 2.5rem;
39+
margin-top: 1rem;
40+
text-align: center;
41+
}
42+
43+
.hero-banner .content-block {
44+
padding-top: 0;
45+
}
46+
47+
.hero-code {
48+
display: flex;
49+
justify-content: center;
50+
align-items: center;
51+
padding-bottom: 1rem;
52+
padding-top: 1rem;
53+
}
54+
55+
.hero-code .sourceCode {
56+
border-bottom-left-radius: 5px;
57+
border-bottom-right-radius: 5px;
58+
}
59+
60+
.hero-code pre,
61+
.hero-code code {
62+
color: var(--bs-body-color);
63+
padding: 0.25em;
64+
}
65+
66+
.hero-code .code-with-filename-file {
67+
border: 1px solid rgba(233, 236, 239, 0.2);
68+
border-top-left-radius: 5px;
69+
border-top-right-radius: 5px;
70+
background-color: var(--stan-secondary);
71+
}
72+
.hero-code .code-with-filename-file pre {
73+
background-color: inherit;
74+
color: var(--stan-hero);
75+
}

index.qmd

Lines changed: 36 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -11,26 +11,19 @@ aliases:
1111
- events/index.html
1212
- users/index.html
1313

14-
14+
css: index.css
15+
code-copy: false
1516
---
1617

1718

1819
::: {.hero-banner}
19-
::: {.grid}
20-
::: {.g-col-1}
21-
:::
22-
::: {.g-col-8 }
20+
:::: {.content-block}
21+
2322
# Stan: Software for Bayesian Data&nbsp;Analysis
24-
:::
25-
:::
26-
:::
2723

24+
::::: {.hero-text .grid}
25+
:::::: {.g-col-12 .g-col-md-8}
2826

29-
::: {.second-banner}
30-
::: {.grid}
31-
::: {.g-col-1}
32-
:::
33-
::: {.g-col-8}
3427
### Bayesian Modeling
3528

3629
Stan enables sophisticated statistical modeling using Bayesian inference, allowing for more accurate and interpretable results in complex data scenarios.
@@ -44,45 +37,52 @@ Stan's probabilistic programming language is suitable for a wide range of applic
4437
Interfaces for Python, Julia, R, and the Unix shell make it easy to use Stan in any programming environment,
4538
on laptops, clusters, or in the cloud. A rich ecosystem of tools for validation and visualization support
4639
decision-making and communication.
47-
48-
::: {.hero-buttons style="position: relative; display: flex; justify-content: center;"}
40+
::::::
41+
42+
:::::: {.g-col-12 .g-col-md-4 .hero-code}
43+
44+
```{.stan filename="bernoulli.stan"}
45+
data {
46+
int<lower=0> N;
47+
array[N] int<lower=0, upper=1> y;
48+
}
49+
parameters {
50+
real<lower=0, upper=1> theta;
51+
}
52+
model {
53+
// uniform prior on interval 0,1
54+
theta ~ beta(1, 1);
55+
y ~ bernoulli(theta);
56+
}
57+
```
58+
59+
::::::
60+
61+
:::::
62+
::::: {.hero-buttons style="position: relative; display: flex; justify-content: center;"}
4963
[Get Started](install/){.btn-action-primary .btn-action .btn .btn-success .btn-lg role="button"}
64+
:::::
65+
::::
5066
:::
5167

52-
:::
53-
:::
54-
:::
5568

5669

70+
::: {.content-block}
5771

58-
::: {.second-banner}
59-
::: {.grid}
60-
::: {.g-col-1}
61-
:::
62-
::: {.g-col-8}
63-
## Community Resources
72+
### Community Resources
6473
* The Stan [forums](https://discourse.mc-stan.org) provide support for all user levels and topics, from installing software, to writing Stan programs, to advanced Bayesian modeling techniques and methodology.
6574

6675
* Stan's [documentation](https://mc-stan.org/docs), [tutorials](learn-stan/tutorials.qmd), and [case studies](learn-stan/case-studies.qmd) help users learn and use Stan effectively in their own projects.
6776
The [Prior Choice Recommendations](https://github.com/stan-dev/stan/wiki/Prior-Choice-Recommendations) wiki page provides guidance on appropriate priors for use with Stan.
68-
:::
69-
:::
70-
:::
7177

72-
::: {.second-banner}
73-
::: {.grid}
74-
::: {.g-col-1}
75-
:::
78+
---
7679

77-
::: {.g-col-8}
78-
## Developer Resources
80+
### Developer Resources
7981
* The [Stan Developer Wiki](https://github.com/stan-dev/stan/wiki)
8082

8183
* The [Stan Forums Developers category](https://discourse.mc-stan.org/c/stan-dev/10)
8284

8385
* The Stan slack channel [mc-stan.slack.com](https://join.slack.com/t/mc-stan/shared_invite/zt-1le4ebi4m-UMtiOkJb4gcS16qz2wIYCw)
8486
is for informal developer discussions.
85-
:::
86-
:::
87-
:::
8887

88+
:::

learn-stan/case-studies.qmd

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,35 @@ aliases:
88

99
The case studies on this page are intended to reflect best practices in Bayesian methodology and Stan programming. We aim to keep them current with the latest version of the Stan language, but there may be times when case studies need updating to reflect the latest Stan features and syntax.
1010

11+
12+
## Volume 11 (2025)
13+
14+
### The Sum-to-Zero Constraint in Stan
15+
16+
The [`sum_to_zero_vector`](https://mc-stan.org/docs/reference-manual/transforms.html#zero-sum-vector)
17+
constrained parameter type was introduced in the [Stan 2.36 release](https://github.com/stan-dev/cmdstan/releases/tag/v2.36.0).
18+
This case study demonstrates the efficiency and robustness of this constrained type; how to adjust the marginal variances for a normal prior, and how to implement the sum-to-zero constraining transform as a Stan function, to extend its use beyond a simple vector.
19+
20+
<a href="case-studies/sum_to_zero_vector.html" target="_blank" rel="noopener noreferrer">View HTML</a>
21+
*(link opens in new tab)*
22+
23+
Author
24+
: Mitzi Morris
25+
26+
Keywords
27+
: sum-to-zero, group-level categorical predictors, spatial models
28+
29+
Source Repository
30+
: [example-models/jupyter/sum-to-zero](https://github.com/stan-dev/example-models/tree/master/jupyter/sum-to-zero){target="_blank"}
31+
(GitHub)
32+
33+
Dependencies
34+
: `cmdstanpy`, `numpy`, `pandas`, `geopandas`, `libpysal`, `plotnine`
35+
36+
License
37+
: BSD (3 clause), CC-BY
38+
39+
1140
## Volume 10 (2023)
1241

1342
### Instrumental Variables Analysis of Randomized Experiments with One-Sided Noncompliance
@@ -466,7 +495,7 @@ Keywords
466495
equations, posterior predictive checks
467496

468497
Source Repository
469-
: [stan-dev/example-models/knitr/lotka-volterra](){target="_blank"}
498+
: [stan-dev/example-models/knitr/lotka-volterra](https://github.com/stan-dev/example-models/tree/master/knitr/lotka-volterra){target="_blank"}
470499
(GitHub)
471500

472501
R Package Dependencies

learn-stan/case-studies/sum_to_zero_vector.html

Lines changed: 7016 additions & 0 deletions
Large diffs are not rendered by default.

learn-stan/stancon-talks.qmd

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: StanCon Talks
2+
title: StanCon
33
page-layout: full
44
toc-location: right
55

@@ -15,30 +15,43 @@ aliases:
1515
* Location & Date: Oxford University, England -- September 9-13, 2024
1616
* [Program](stancon/StanCon2024-program.pdf){target="_blank"}
1717
* Recorded Talks: [YouTube playlist](https://www.youtube.com/playlist?list=PLCrWEzJgSUqzNzh6mjWsWUu-lSK59VXP6)
18+
* Keynotes:
19+
+ The Pragmatic Probabilistic Programmer -- Mitzi Morris
20+
+ Applied modeling for drug development -- Sebastian Weber
21+
+ From the Depths to the Stars: How Modeling Shark Movements Illuminates Star Behavior -- Vianey Leos Barajas
22+
+ Bayesian multilevel causal modelling of the frequency and implications of having two HIV infections -- Chris Wymant
1823
* Tutorials (not recorded)
1924
+ Introduction to Stan -- Richard McElreath
2025
+ Model selection -- Aki Vehtari, Noa Kallioinen, and Teemu Säilynoja
2126
+ Bayesian hierarchical models in Stan -- Sean Pinkney
2227
+ Bayesian optmization with Stan -- Anna Riha and Elizaveta Semenova
2328
+ Biodiversity modeling and forecasting -- Will Pearse
2429
+ Infectious disease modeling in Stan -- Juliette Unwin
25-
* Organizers: Charles Margossian, Will Pearse,
30+
* Organizers: Michael Collyer, Ellen Mobbs, Joss Wright, Richard McElreath, Elizaveta Semenova, Ben Lambert, Seth Flaxman, Charles Margossian, Juliette Unwin, Will Pearse, Makkunda Sharma
31+
* Sponsors: Daiichi-Sankyo, Metrum Research Group, Generable, Jumping Rivers, Taylor and Francis, NumFocus, the Oxford Internet Institute, and the Max Planck Institute for Evolutionary Anthropology
32+
* [Archived event page](https://github.com/stan-dev/stan-dev.github.io/blob/df6b188d6e1057863dddf110c109c1b8bc51b36e/events/stancon2024/index.md)
2633

2734

2835
## StanCon 2023 St. Louis
2936

3037
* Location & Date: Washington University, USA -- June 20-23, 2023
3138
* [Program](stancon/StanCon2023-program.pdf){target="_blank"}
3239
* GitHub repository of slides and course materials from StanCon 2023: [https://github.com/stan-dev/stancon2023](https://github.com/stan-dev/stancon2023){target="_blank"}
40+
* Keynotes
41+
+ The efficient frontier: Bayes, neural nets, and the future of Stan -- Bob Carpenter
42+
+ We all can benefit from Bayesian analysis reporting guidelines if we use them -- John Kruschke
43+
+ Statistical Significance Makes our Mission: Impossible -- Mariel Finucane
44+
+ Regression Under Endogeneity: Bernstein-von Mises Theory and Bayes Factors Testing -- Siddhartha Chib
3345
* Tutorials
3446
+ Fundamentals of Stan -- Charles Margossian
3547
+ Bayesian workflow illustrated using BRMS -- Mitzi Morris
3648
+ Hierarchical models in Stan: varieties, optimizations & nuances -- Mike Lawrence
3749
+ Building a GPT in Stan -- Daniel Lee
3850
+ Cognitive diagnostic models in R and Stan -- Jake Thompson
3951
+ Advances of model assessment, selection, and inference after model selection -- Andrew Johnson
40-
* Organizers: Charles Margossian, Debashis Mondal, Yi Zhang, Eric Ward
41-
52+
* Organizers: Charles Margossian, Debashis Mondal, Eric Ward, Vianey Leos Barajas, Yi Zhang
53+
* Sponsors: Washington University in St Louis, Metrum Research Group, NumFocus, Sage Therapeutics, Jumping Rivers
54+
* [Archived event page](https://github.com/stan-dev/stan-dev.github.io/blob/df6b188d6e1057863dddf110c109c1b8bc51b36e/events/stancon2023/index.md)
4255

4356
## StanCon 2020 Global
4457

redirects.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
https://mc-stan.org/shop/index.html https://mc-stan.org/about/#shop-for-stan-swag
33
https://mc-stan.org/about/team/index.html https://mc-stan.org/about/#stan-development-team
44
https://mc-stan.org/about/developers/index.html https://mc-stan.org/about/#stan-development-team
5-
https://mc-stan.org/support/index.html https://mc-stan.org/about/#support-stan
5+
https://mc-stan.org/support/index.html https://mc-stan.org/about/#help-fund-stan
66
https://mc-stan.org/events/stanconnect_Ecology1/index.html https://mc-stan.org/learn-stan/field-guides.html#stanconnect-sessions
77
https://mc-stan.org/events/stanconnect_CogNeuro/index.html https://mc-stan.org/learn-stan/field-guides.html#stanconnect-sessions
88
https://mc-stan.org/events/stanconnect_Biomedical/index.html https://mc-stan.org/learn-stan/field-guides.html#stanconnect-sessions

tools/index.qmd

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -110,16 +110,18 @@ For detailed installation instructions see [Getting Started](../install/).
110110

111111
| **Editor/IDE** | **Tool** | **Description** |
112112
|------------------------|----------|-----------------|
113-
| **RStudio** | **Built-in Support** | RStudio 1.2+ includes Stan syntax highlighting and code snippets. [(Source code)](https://github.com/rstudio/rstudio/blob/main/src/gwt/acesupport/acemode/stan_highlight_rules.js){target="_blank"} |
114-
| **Visual Studio Code** | [**Stan VSCode Extension**](https://marketplace.visualstudio.com/items?itemName=ivan-bocharov.stan-vscode){target="_blank"} | Stan language support with syntax highlighting, autocompletion, and snippets. |
115-
| **Emacs** | [**stan-mode**](https://github.com/stan-dev/stan-mode){target="_blank"} | Major mode for Stan with syntax highlighting and indentation. |
116-
| **Vim** | [**stan-vim**](https://github.com/eigenfoo/stan-vim){target="_blank"} | Syntax highlighting, indentation, and code folding for Stan in Vim. |
117-
| **Atom** | [**language-stan**](https://github.com/stan-dev/atom-language-stan){target="_blank"} | Stan language support in Atom editor. |
118-
| **Sublime Text** | [**SublimeStan**](https://github.com/djsutherland/sublime-stan){target="_blank"} | Syntax highlighting for Stan in Sublime Text. |
119-
| **JupyterLab** | [**jupyterlab-stan-highlight**](https://www.npmjs.com/package/jupyterlab-stan-highlight){target="_blank"} | Syntax highlighting for Stan code blocks in JupyterLab. |
120-
| **Javascript** | [**Prism**](https://prismjs.com/){target="_blank"} </br> [**Highlight.js**](https://github.com/highlightjs/highlight.js){target="_blank"} | Lightweight syntax highlighting library - [(Source code)](https://github.com/PrismJS/prism/blob/master/components/prism-stan.js){target="_blank"}. </br> Syntax highlighter written in javascript - [(Source code)](https://github.com/highlightjs/highlight.js/blob/main/src/languages/stan.js){target="_blank"} |
121-
**Markdown Editors** | [**Pandoc**](https://pandoc.org/){target="_blank"} </br> [**Pygments**](https://pygments.org/){target="_blank"} | Stan syntax highlighting for document formats. [(Source code)](https://invent.kde.org/frameworks/syntax-highlighting/-/blob/master/data/syntax/stan.xml)</br>Python highlighter for Stan code blocks [(Source code)](https://github.com/pygments/pygments/blob/master/pygments/lexers/modeling.py){target="_blank"} |
122-
| **LaTeX** | [**lstbayes**](https://github.com/jrnold/lstbayes){target="_blank"} | LaTeX listings for Stan syntax highlighting. |
113+
| **RStudio** | **Built-in Support** | RStudio 1.2+ includes Stan syntax highlighting and code snippets [(Source code)](https://github.com/rstudio/rstudio/blob/main/src/gwt/acesupport/acemode/stan_highlight_rules.js){target="_blank"} |
114+
| **Visual Studio Code** | [**VSCode Stan Extension**](https://marketplace.visualstudio.com/items?itemName=wardbrian.vscode-stan-extension){target="_blank"} | Stan language support with syntax highlighting, linting, autocompletion, and snippets |
115+
| **Emacs** | [**stan-mode**](https://github.com/stan-dev/stan-mode){target="_blank"} <br/> [**stan-ts-mode**](https://github.com/WardBrian/stan-ts-mode){target="_blank"} | Major mode for Stan with syntax highlighting and indentation <br /> Tree-sitter based (Emacs 29+) major mode for Stan. Fewer features than stan-mode, but generally more up to date syntax highlighting. |
116+
| **Vim** | [**stan-vim**](https://github.com/eigenfoo/stan-vim){target="_blank"} | Syntax highlighting, indentation, and code folding for Stan in Vim |
117+
| **JupyterLab** | [**jupyterlab-stan-highlight**](https://www.npmjs.com/package/jupyterlab-stan-highlight){target="_blank"} | Syntax highlighting for Stan code blocks in JupyterLab |
118+
| **Javascript** | [**Prism**](https://prismjs.com/){target="_blank"} </br> [**Highlight.js**](https://github.com/highlightjs/highlight.js){target="_blank"} | Lightweight syntax highlighting library [(Source code)](https://github.com/PrismJS/prism/blob/master/components/prism-stan.js){target="_blank"} </br> Syntax highlighter written in javascript [(Source code)](https://github.com/highlightjs/highlight.js/blob/main/src/languages/stan.js){target="_blank"} |
119+
**Markdown** | [**Pandoc**](https://pandoc.org/){target="_blank"} </br> [**Pygments**](https://pygments.org/){target="_blank"} | Stan syntax highlighting for document formats [(Source code)](https://invent.kde.org/frameworks/syntax-highlighting/-/blob/master/data/syntax/stan.xml)</br>Python highlighter for Stan code blocks [(Source code)](https://github.com/pygments/pygments/blob/master/pygments/lexers/modeling.py){target="_blank"} |
120+
| **Zed** | [**zed-stan-extension**](https://github.com/wardbrian/zed-stan-extension){target="_blank"} | Syntax highlighting for Stan in the Zed editor |
121+
| **LaTeX** | [**lstbayes**](https://github.com/jrnold/lstbayes){target="_blank"} | LaTeX listings for Stan syntax highlighting |
122+
| **Sublime Text** | [**SublimeStan**](https://github.com/djsutherland/sublime-stan){target="_blank"} | Syntax highlighting for Stan in Sublime Text |
123+
| **Atom** | [**atom-language-stan**](https://github.com/stan-dev/atom-language-stan){target="_blank"} | Stan language support in Atom editor and GitHub.com |
124+
123125
: {tbl-colwidths="[15, 25, 60]"}
124126

125127
---

0 commit comments

Comments
 (0)