<div dir="ltr"><div class="gmail_quote"><div class="gmail_attr">Hi, I must thank y'all for the exceptionally fast responses (and apologize for my own tragically slow response!)</div><div dir="ltr" class="gmail_attr"><br></div><div dir="ltr" class="gmail_attr">On Sat, Mar 13, 2021 at 1:32 AM Eric Wieser <<a href="mailto:wieser.eric%2Bnumpy@gmail.com" target="_blank">wieser.eric+numpy@gmail.com</a>> wrote:<br>
> Einsum has a secret integer argument format that appears in the Examples section of the</div><div dir="ltr" class="gmail_attr">> `np.einsum` docs, but appears not to be mentioned at all in the parameter listing.</div><div dir="ltr" class="gmail_attr">  <br></div><div class="gmail_attr">Ah, yes, this is precisely the sort of API I was hoping for!  I found it pretty easy to use, but here's a snippet that solves my original problem for those wondering:</div><div class="gmail_attr"><br></div><div class="gmail_attr"><a href="https://github.com/exphp-share/gpaw-raman-script/blob/f98fe14cd6/script/symmetry.py#L442-L471">https://github.com/exphp-share/gpaw-raman-script/blob/f98fe14cd6/script/symmetry.py#L442-L471</a>  </div><div dir="ltr" class="gmail_attr"><br></div><div>On Fri, Mar 12, 2021 at 8:09 PM Andras Deak <<a href="mailto:deak.andris@gmail.com" target="_blank">deak.andris@gmail.com</a>> wrote:  <br></div><div>> But I'm not sure _where_ this could be highlighted among the</div><div>> parameters; after all this is all covered by the *operands parameter.</div><div><br></div><div><div>The parameter list is definitely one of the places I checked most closely, and having something there would have helped.  I'd say that, technically, this also overlaps with the subscripts argument, which now holds the first array, and I feel like that may be the best place to put something.  For instance, a short paragraph could be added to the end of 'subscripts':</div><div><br></div><div>"einsum also has an alternative interface that uses integer labels for axes, in which case the subscripts argument is not present.  This is documented below." (with a link)</div><div><br></div><div>(the idea I'm trying to capture here is to avoid creating any specific (or potentially wrong) picture of how the arguments look in the alternate signature, more or less forcing the reader to follow a link to where it is more easily described somewhere outside the constraints of parameter-based documentation)</div><div><br></div><div>---</div><div>Michael</div><div dir="ltr"><a href="https://github.com/exphp-share/gpaw-raman-script/blob/f98fe14cd60d78dbffd8f07f078696d3aa96ab07/script/symmetry.py#L442-L471" target="_blank"></a><br></div></div></div></div>