3838lazy_import ('sage.interfaces.magma' , 'magma' )
3939
4040
41- def genera (sig_pair , determinant , max_scale = None , even = False ):
41+ def genera (sig_pair , determinant , max_scale = None , even = False ) -> list :
4242 r"""
4343 Return a list of all global genera with the given conditions.
4444
@@ -51,7 +51,7 @@ def genera(sig_pair, determinant, max_scale=None, even=False):
5151 - ``determinant`` -- integer; the sign is ignored
5252
5353 - ``max_scale`` -- (default: ``None``) an integer; the maximum scale of a
54- jordan block
54+ Jordan block
5555
5656 - ``even`` -- boolean (default: ``False``)
5757
@@ -139,7 +139,7 @@ def _local_genera(p, rank, det_val, max_scale, even):
139139
140140 - ``det_val`` -- valuation of the determinant at `p`
141141
142- - ``max_scale`` -- integer the maximal scale of a jordan block
142+ - ``max_scale`` -- integer the maximal scale of a Jordan block
143143
144144 - ``even`` -- boolean; ignored if `p` is not `2`
145145
@@ -225,7 +225,7 @@ def _local_genera(p, rank, det_val, max_scale, even):
225225
226226def _blocks (b , even_only = False ):
227227 r"""
228- Return all viable `2`-adic jordan blocks with rank and scale given by ``b``.
228+ Return all viable `2`-adic Jordan blocks with rank and scale given by ``b``.
229229
230230 This is a helper function for :meth:`_local_genera`.
231231 It is based on the existence conditions for a modular `2`-adic genus symbol.
@@ -589,23 +589,22 @@ def canonical_2_adic_compartments(genus_symbol_quintuple_list):
589589 return compartments
590590
591591
592- def canonical_2_adic_trains (genus_symbol_quintuple_list , compartments = None ) :
592+ def canonical_2_adic_trains (genus_symbol_quintuple_list ) -> list :
593593 r"""
594- Given a `2`-adic local symbol (as the underlying list of quintuples)
595- this returns a list of lists of indices of the
596- ``genus_symbol_quintuple_list`` which are in the same train. A train
597- is defined to be a maximal interval of Jordan components so that
598- at least one of each adjacent pair (allowing zero-dimensional
599- Jordan components) is (scaled) of type I (i.e. odd).
600- Note that an interval of length one respects this condition as
601- there is no pair in this interval.
594+ Given a `2`-adic local symbol, return a list of lists of indices
595+ of the ``genus_symbol_quintuple_list`` which are in the same train.
596+
597+ A train is defined to be a maximal interval of Jordan components
598+ so that at least one of each adjacent pair (allowing
599+ zero-dimensional Jordan components) is (scaled) of type I
600+ (i.e. odd). Note that an interval of length one respects this
601+ condition as there is no pair in this interval.
602602 In particular, every Jordan component is part of a train.
603603
604604 INPUT:
605605
606- - ``genus_symbol_quintuple_list`` -- a quintuple of integers (with certain
607- restrictions).
608- - ``compartments`` -- this argument is deprecated
606+ - ``genus_symbol_quintuple_list`` -- a `2`-adic local symbol as a list of
607+ quintuples of integers (with certain restrictions).
609608
610609 OUTPUT: list of lists of distinct integers
611610
@@ -654,12 +653,8 @@ def canonical_2_adic_trains(genus_symbol_quintuple_list, compartments=None):
654653
655654 See [CS1999]_, pp. 381-382 for definitions and examples.
656655 """
657- if compartments is not None :
658- from sage .misc .superseded import deprecation
659- deprecation (23955 , "the compartments keyword has been deprecated" )
660-
661656 # avoid a special case for the end of symbol
662- # if a jordan component has rank zero it is considered even.
657+ # if a Jordan component has rank zero it is considered even.
663658 symbol = genus_symbol_quintuple_list
664659 symbol .append ([symbol [- 1 ][0 ]+ 1 , 0 , 1 , 0 , 0 ]) # We have just modified the input globally!
665660 # Hence, we have to remove the last entry of symbol at the end.
@@ -680,7 +675,7 @@ def canonical_2_adic_trains(genus_symbol_quintuple_list, compartments=None):
680675 trains .append (new_train )
681676 new_train = [i ]
682677 else :
683- # there is an odd jordan block adjacent to this jordan block
678+ # there is an odd Jordan block adjacent to this Jordan block
684679 # the train continues
685680 new_train .append (i )
686681 # the last train was never added.
@@ -3318,7 +3313,7 @@ def norm(self):
33183313
33193314def _gram_from_jordan_block (p , block , discr_form = False ):
33203315 r"""
3321- Return the Gram matrix of this jordan block.
3316+ Return the Gram matrix of this Jordan block.
33223317
33233318 This is a helper for :meth:`discriminant_form` and :meth:`gram_matrix`.
33243319 No input checks.
0 commit comments