diff --git a/docs/guides/estimator-options.ipynb b/docs/guides/estimator-options.ipynb index 4f7755869e3..999f42c9dc7 100644 --- a/docs/guides/estimator-options.ipynb +++ b/docs/guides/estimator-options.ipynb @@ -250,6 +250,10 @@ "\n", "However, if `precision` is not specified by any PUB or in the run keyword argument (or if they are all `None`), then the precision value from the options is used, most notably `default_precision`.\n", "\n", + "\n", + "These precision parameters are only for specifying _target_ precision, and the results are not guaranteed to reach the specified precision.\n", + "\n", + "\n", "Note that Estimator options contain both `default_shots` and `default_precision`. However, because gate-twirling is enabled by default, the product of `num_randomizations` and `shots_per_randomization` takes precedence over those two options.\n", "\n", "Specifically, for any Estimator PUB:\n", @@ -263,6 +267,10 @@ "For example, if precision is specified in all four places, the one with highest precedence (precision specified in the PUB) is used.\n", "\n", "\n", + "Although precision specified in the PUB and in `run` have higher precedence, the job fails if `twirling` is enabled and the product of `num_randomizations` and `shots_per_randomization` is smaller than the shots needed to achieve the precision. In this scenario, `EstimatorV2` is unable to allocate the shots among the specified `num_randomizations`.\n", + "\n", + "\n", + "\n", "Precision scales inversely with usage. That is, the lower the precision, the more QPU time it takes to run.\n", "" ] diff --git a/docs/guides/sampler-options.ipynb b/docs/guides/sampler-options.ipynb index 754a1747b5a..d2e24d83589 100644 --- a/docs/guides/sampler-options.ipynb +++ b/docs/guides/sampler-options.ipynb @@ -144,6 +144,10 @@ "\n", "Thus, if shots are specified in all possible places, the one with highest precedence (shots specified in the PUB) is used.\n", "\n", + "\n", + "Although shots specified in the PUB and in `run` have higher precedence, the job fails if `twirling` is enabled and the product of `num_randomizations` and `shots_per_randomization` is smaller than the `shots` value. In this scenario, `SamplerV2` is unable to allocate the shots among the specified `num_randomizations`.\n", + "\n", + "\n", "Example:" ] },