I'm late to the party here, but I find the docstring quite confusing with respect to the coordinates and what output I might expect. Would it be possible to include a short but verbose example in the docstring?