[DOCS] .reset() doesn't clear growing axis

[andrzejnovak]

Unsure if intended behaviour

[henryiii]

.reset() empties all the bins. It doesn't remove items from a growing axis (guessing that's what you mean?). Rather wishing we called it .clear() now. :)

[andrzejnovak]

I see, so it is intended. I was trying to make a copy of a histogram (while trying to make a sum on categorical axes) to assign new bins.

I suppose it's unusual and if some groupby gets implemented unnecessary, but I'm not sure, if it's a completely illegitimate use

[henryiii]

This is clearly documented as "set counters to 0", so I think it's safe to close?

[henryiii]

(The name comes from Boost.Histogram, otherwise I'd suggest renaming it to .clear())

[andrzejnovak]

Sorry, could you point to where it's documented? I couldn't find it with a cursory search.

[henryiii]

https://github.com/scikit-hep/boost-histogram#cheatsheet and https://boost-histogram.readthedocs.io/en/latest/usage/histogram.html#operations

[henryiii]

Can this be closed or is there an action that should still be taken?

[HDembinski]

I don't think that .clear would be any more obvious than .reset. Important is the documentation, not the name.