#18997: Unitary and symplectic (dual) polar graphs
-------------------------+-------------------------------------------------
       Reporter:         |        Owner:
  dimpase                |       Status:  needs_work
           Type:         |    Milestone:  sage-6.9
  enhancement            |   Resolution:
       Priority:  major  |    Merged in:
      Component:  graph  |    Reviewers:  Nathann Cohen
  theory                 |  Work issues:
       Keywords:         |       Commit:
        Authors:  Dima   |  acc985a045f02a1c796accd9a029ae809a0a92fd
  Pasechnik              |     Stopgaps:
Report Upstream:  N/A    |
         Branch:         |
  u/dimpase/unitary      |
   Dependencies:         |
  #18972                 |
-------------------------+-------------------------------------------------

Comment (by dimpase):

 Replying to [comment:24 ncohen]:
 > Helloooooooo Dima,
 >
 > - About the methods with a "algorithm" keyword: some of them do not have
 an
 >   `INPUT` block where the parameter is described. Also, it would be
 better if
 >   instead of checking `!= 'gap'` you tested `algorithm =='Gap'` then
 `algorithm
 >   is None` and finally raised an exception if the argument does not
 beelong to
 >   the allowed list. This being said, I would have nothing against it if
 you
 >   chose to remove the pure Sage code. It's up to you.
 it's always better to have 2 implementations... I'll rearrange as you ask.
 >
 > - Backticks are missing around `Sp(x,y)` and others.
 >
 > - We have `SimplecticGraph` and `SimplecticDualPolarGraph` -- should we
 >   uniformize the `Polar` somehow?
 yep, how about renaming `SimplecticGraph` to `SimplecticPolarGraph` and
 make `SimplecticGraph` a deprecated alias to `SimplecticPolarGraph`?


 > - Can you please remove/change all tests that take more than 2 seconds?
 How about I'll move them into examples and mark them # not tested (long
 time)?
 They test "generic" situations, whereas all the small examples there are
 kinds of corner cases.


 > - Some graphs are not defined on a html page, and for those you link
 toward
 >   "Distance-regular graphs". As this is much harder to find than a web
 page,
 >   could you provide some quick definition of the class, just to give the
 user
 >   "an idea"?

 all these `SymplecticPolar`, `OrthogonalPolar`, etc are very similar, as
 well as all `SymplecticDualPolar` etc.
 There is a freely available preprint that describes them in detail:
 https://repository.cwi.nl/noauth/search/fullrecord.php?publnr=6775

 I'd rather include this as a reference.

 Perhaps it's more meaningful to create a separate module, say
 polar_families.py,
 where we move all them, as well as `AffinePolar` guys. Then a doc can be
 written
 in the top of this new module.

 We could also extend the wikipedia page https://en.wikipedia.org/wiki
 /Distance-regular_graph and have docs there...

 >
 > - You may want (it's up to you) to add "SEEALSO" blocks between your
 methods.
 >
 > - As we now have many of these polar graphs, you may want (it's up to
 you) to
 >   split them from the "Graph families" block of the index
 >
 
(http://doc.sagemath.org/html/en/reference/graphs/sage/graphs/graph_generators.html)
 >   and give them a block of their own.

 this would be even more meaningful with a new module.

--
Ticket URL: <http://trac.sagemath.org/ticket/18997#comment:25>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to