Box plot with custom quartiles being inconsistent with upperfence parameter

In the documentation: https://plotly.com/python/box-plots/#box-plot-with-precomputed-quartiles

There is a code sample with upperfence parameter set to [5,6,7] which doesn't really make sense because the q3 values are [7,8,9] and I think the upperfence of a box plot can't be lower than the q3 values. However, the provided example returns a boxplot with all upperfences set to 9, which is the maximum-minimum upperfence value possible for the provided boxplots. I think this behavior is not desirable because difficult to understand.

I think it would be better to raise an error. If you prefer not to raise an error, I guess a better option would be to set the upperfence to the minimum possible values in each boxplot.

Have a nice day.

Start with the linked documentation example, “Box plot with precomputed quartiles,” and trace how its q3 and upperfence values are handled. Compare the documented output with the requested behavior, then define and verify a consistent result for invalid upperfence values; the documentation example should no longer be confusing.