Skip to content

fix usage of samples vs. draws #823

Description

@bob-carpenter

Summary:

We should be using "sample" to mean a multi-set of draws and "draw" to indicate a single draw from a sampler. We should not be saying "take N samples" but rather "take N draws" or "sample of size N".

cf. @avehtari's comment here:

I (and Andrew) don't like num_samples. It should be either num_draws, num_total_draws, or sample_size.

Description:

I think we can use this Google search to find all potentially problematic cases:

"samples" site:mc-stan.org/docs

Warning: there are quite a few.

Current Version:

v2.18.0 [this boilerplate needs to be updated regularly---it's really 2.35]

Activity

  1. WardBrian commented on Oct 18, 2024

    @WardBrian
    Member

    this boilerplate needs to be updated regularly---it's really 2.35

    Slightly off topic, but I would be in favor of removing this entirely from the docs repo. I think it’s pretty clear that issues here mean “against the currently live site”

  2. jgabry commented on Oct 18, 2024

    @jgabry
    Member

    this boilerplate needs to be updated regularly---it's really 2.35

    Slightly off topic, but I would be in favor of removing this entirely from the docs repo. I think it’s pretty clear that issues here mean “against the currently live site”

    Agree!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions