38
38
lazy_import ('sage.interfaces.magma' , 'magma' )
39
39
40
40
41
- def genera (sig_pair , determinant , max_scale = None , even = False ):
41
+ def genera (sig_pair , determinant , max_scale = None , even = False ) -> list :
42
42
r"""
43
43
Return a list of all global genera with the given conditions.
44
44
@@ -51,7 +51,7 @@ def genera(sig_pair, determinant, max_scale=None, even=False):
51
51
- ``determinant`` -- integer; the sign is ignored
52
52
53
53
- ``max_scale`` -- (default: ``None``) an integer; the maximum scale of a
54
- jordan block
54
+ Jordan block
55
55
56
56
- ``even`` -- boolean (default: ``False``)
57
57
@@ -139,7 +139,7 @@ def _local_genera(p, rank, det_val, max_scale, even):
139
139
140
140
- ``det_val`` -- valuation of the determinant at `p`
141
141
142
- - ``max_scale`` -- integer the maximal scale of a jordan block
142
+ - ``max_scale`` -- integer the maximal scale of a Jordan block
143
143
144
144
- ``even`` -- boolean; ignored if `p` is not `2`
145
145
@@ -225,7 +225,7 @@ def _local_genera(p, rank, det_val, max_scale, even):
225
225
226
226
def _blocks (b , even_only = False ):
227
227
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``.
229
229
230
230
This is a helper function for :meth:`_local_genera`.
231
231
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):
589
589
return compartments
590
590
591
591
592
- def canonical_2_adic_trains (genus_symbol_quintuple_list , compartments = None ) :
592
+ def canonical_2_adic_trains (genus_symbol_quintuple_list ) -> list :
593
593
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.
602
602
In particular, every Jordan component is part of a train.
603
603
604
604
INPUT:
605
605
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).
609
608
610
609
OUTPUT: list of lists of distinct integers
611
610
@@ -654,12 +653,8 @@ def canonical_2_adic_trains(genus_symbol_quintuple_list, compartments=None):
654
653
655
654
See [CS1999]_, pp. 381-382 for definitions and examples.
656
655
"""
657
- if compartments is not None :
658
- from sage .misc .superseded import deprecation
659
- deprecation (23955 , "the compartments keyword has been deprecated" )
660
-
661
656
# 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.
663
658
symbol = genus_symbol_quintuple_list
664
659
symbol .append ([symbol [- 1 ][0 ]+ 1 , 0 , 1 , 0 , 0 ]) # We have just modified the input globally!
665
660
# 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):
680
675
trains .append (new_train )
681
676
new_train = [i ]
682
677
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
684
679
# the train continues
685
680
new_train .append (i )
686
681
# the last train was never added.
@@ -3318,7 +3313,7 @@ def norm(self):
3318
3313
3319
3314
def _gram_from_jordan_block (p , block , discr_form = False ):
3320
3315
r"""
3321
- Return the Gram matrix of this jordan block.
3316
+ Return the Gram matrix of this Jordan block.
3322
3317
3323
3318
This is a helper for :meth:`discriminant_form` and :meth:`gram_matrix`.
3324
3319
No input checks.
0 commit comments