a note in the docstring saying what `ws_z` and `ws_n` are would be useful...