docs icon indicating copy to clipboard operation
docs copied to clipboard

`num_chains` documentation implies filenames are different in sequential and parallel cases

Open WardBrian opened this issue 3 years ago • 1 comments

Summary:

The Multi Chain Sampling section includes the following sentence

If the model was not compiled with STAN_THREADS=true, the above command will run 4 chains sequentially and will produce the sample in output_1.csv, output_2.csv, output_3.csv, output_4.csv.

This sentence is confusing because the output file names are the same in the sequential and parallel case, but as written it implies that the output filenames are also part of the conditional statement being made.

This prompted this forum question

WardBrian avatar Jan 30 '23 21:01 WardBrian

I don't think this actually implies they are different, but I can see how someone will be confused.

All I would do to clarify is add a parenthetical, "(the same files as when run in parallel)".

The content should be the same either way, too, because the seeds are distinct and the same in the parallel and sequential case.

bob-carpenter avatar Jan 30 '23 22:01 bob-carpenter