#9439: hyperbolic geometry
------------------------------------------------------------------------------+
       Reporter:  vdelecroix                                                  | 
        Owner:  vdelecroix  
           Type:  enhancement                                                 | 
       Status:  new         
       Priority:  major                                                       | 
    Milestone:  sage-5.11   
      Component:  geometry                                                    | 
   Resolution:              
       Keywords:  hyperbolic geometry, Poincare disc, upper half plane, sd35  | 
  Work issues:              
Report Upstream:  N/A                                                         | 
    Reviewers:  Johan Bosman
        Authors:  Vincent Delecroix, Martin Raum                              | 
    Merged in:              
   Dependencies:                                                              | 
     Stopgaps:              
------------------------------------------------------------------------------+

Comment (by vdelecroix):

 Hi,

 Replying to [comment:26 glaun]:
 > I've addressed issues 1-4, and I was hoping you wouldn't mind giving me
 some guidance about how to handle the remaining issues.  Specifically, I
 have the following questions:
 >
 > 1) Should I post a patch for the fixes of 1-4?  Or should I wait until I
 fix the remaining issues?  More generally, should I err on the side of
 posting more patches (so more people can help) or posting only ones that
 seem more significant?

 Not necessarily. You can fold your two patches into one and post only the
 update version of your previous patch (to fold two patches `hg qfold`).

 > 2) I like the structure of your code, and I aim to emulate it.  Does it
 make sense for me to combine your class structure with the features in
 mine and post it in skeletal form before fixing all of the functions?  For
 example, I could post a class diagram, or just an outline of the modules
 with the guts removed. Or is this step likely to be more work with little
 payoff?  I would ideally like the structure to be as democratically
 decided as possible.

 Your code definitely contains much more material than mine. If you like
 better the structure I drafted you are free to reuse it. If you post
 anything on trac it is always better that it is working code.

 In my opinion, as you are currently working on that project, you may
 choose the datastructure you prefer and indicate '''clearly''' in the
 documentation the concept, why did you choose that design and why did you
 discard the other ones.

 > 3) I find your usage of HyperbolicPlane for the upper half plane to be
 confusing since the HyperbolicDisc is also topologically a plane.

 I agree. It was just because I always find HH and DD in textbooks and did
 not ask myself more questions.

 > I'm used to referring to both as the hyperbolic plane, and I typically
 differentiate them by specifying which model of the plane.  I have been
 using the abbreviations UHP, PD, KM, and HM which were just decided by
 fiat to be short and convenient.  Is there anything you dislike about this
 approach to naming?  I worry that HyperbolicUHP is too cryptic, but
 HyperbolicUpperHalfPlane is too long.

 I like better UHP, PD, KM and HM but I think they should not be imported
 in the standard namespace as such (because it is not clear how the user
 may find them). What about something like:
 {{{
 sage: hyperbolic_geometry.upper_half_plane()
 The upper half plane
 sage: hyperbolic_geometry.UHP
 The upper half plane
 etc
 }}}
 That way, we may use tab completion. But perhaps, "hyperbolic_geometry" is
 a bit too long. If somebody want it in the global namespace it is still
 possible to do
 {{{
 sage: from sage.XXX.hyperbolic_geometry import *
 sage: UHP
 The upper half plane
 }}}

 Vincent

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9439#comment:27>
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/groups/opt_out.


Reply via email to