--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, and MATLAB
* dependencies: => #12569
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:1>
* reviewer: => Florent Hivert
Comment:
Hi Samuele,
Good to have you onboard !
- First of all, if you want a review you should check the {{{needs-
review}}} button below.
- when you put some example under the title {{{EXAMPLES::}}}
there is no need to but them in {{{TESTS::}}}. Both are tested alike.
- You should add a rubric {{{INPUT::}}} explaining what {{{other}}} can
be. Here I think it could be a {{{Permutations}}}, a {{{list}}}, a
{{{tuple}}}
or any {{{iterable}}}. A few examples demonstrating this should also be
added
(see
[http://www.sagemath.org/doc/developer/conventions.html#documentation-
strings documentation strings] for the precise syntax).
- Are you sure that you didn't mixed up the convention for over/under ? To
break the ambiguity, I'd rather call them {{{shifted_concatenation}}} and
{{{shifted_anti_concatenation}}}. Or maybe only one function
{{{shifted_concatenation}}}, with an optional parameter {{{shift}}} which
can
be either {{{"left"}}} or {{{"right"}}}. Or even
{{{shift_right (True by default)}}}...
What do you think ? Maybe it is worth asking for a vote on
{{{Sage-combinat-devel}}}.
- You should add a ".. SEEALSO::" rubric linking the three functions one
to
the other (see also #12078 ;-)
- Finally, You could add some consistency tests checking that for some
relatively large permutations, the cardinality of the interval in the
correct
binomial coefficient.
Sorry for this long list of requests, once you gets used to Sage, you'll
do all
of this without thinking of it.
And many thanks for taking care of this.
Florent
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:2>
Comment(by nthiery):
Replying to [comment:2 hivert]:
> - Are you sure that you didn't mixed up the convention for over/under ?
To
> break the ambiguity, I'd rather call them {{{shifted_concatenation}}}
and
> {{{shifted_anti_concatenation}}}. Or maybe only one function
> {{{shifted_concatenation}}}, with an optional parameter {{{shift}}}
which can
> be either {{{"left"}}} or {{{"right"}}}. Or even
> {{{shift_right (True by default)}}}...
Quite a few functions take an argument side="left"/"right", more often
than not the default being "right". If
{{{
x.shifted_concatenation(y, side="right")
}}}
sounds unambiguous enough about the shift being on y (and not the
concatenation being on the right), I vote for this. Otherwise
shift="left"/"right"
Cheers,
Nicolas
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:3>
* status: new => needs_review
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:4>
Comment(by giraudo):
Hi Florent, hi Nicolas,
thanks a lot for the suggestions of improvement. I just have updated the
patch.
Samuele
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:5>
Comment (by elixyre):
This patch is disappeared? I think the shuffle on words is now efficient.
This post could be closed?
Jean-Baptiste
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:6>
Comment (by knsam):
Replying to [comment:6 elixyre]:
> This patch is disappeared? I think the shuffle on words is now
efficient.
Not quite. Sage 5.6 takes 21.93 seconds.
>
> This post could be closed?
So, no I'd think.
>
> Jean-Baptiste
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:7>
* cc: knsam (added)
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:8>
* status: needs_review => needs_work
Comment:
Helloooooooooooooooooo !!!
This patch looks ood to go, but it would be nice to add your two new
methods to the (new) index of methods at the top of permutation.py `:-)`
Nathann
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:9>
* status: needs_work => positive_review
* reviewer: Florent Hivert => Florent Hivert, Darij Grinberg
* dependencies: #12569 => #12569, #14772
Comment:
Methods added to the index. Patch reviewed and rebased upon #14772.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:10>
* cc: tscrim, sage-combinat (added)
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:11>