Code coverage tests

This page documents the degree to which the PARI/GP source code is tested by our public test suite, distributed with the source distribution in directory src/test/. This is measured by the gcov utility; we then process gcov output using the lcov frond-end.

We test a few variants depending on Configure flags on the pari.math.u-bordeaux.fr machine (x86_64 architecture), and agregate them in the final report:

The target is to exceed 90% coverage for all mathematical modules (given that branches depending on DEBUGLEVEL or DEBUGMEM are not covered). This script is run to produce the results below.

LCOV - code coverage report
Current view: top level - basemath - Flv.c (source / functions) Hit Total Coverage
Test: PARI/GP v2.18.0 lcov report (development 29580-d8b649a849) Lines: 737 758 97.2 %
Date: 2024-10-04 09:07:15 Functions: 58 62 93.5 %
Legend: Lines: hit not hit

          Line data    Source code
       1             : /* Copyright (C) 2000-2019  The PARI group.
       2             : 
       3             : This file is part of the PARI/GP package.
       4             : 
       5             : PARI/GP is free software; you can redistribute it and/or modify it under the
       6             : terms of the GNU General Public License as published by the Free Software
       7             : Foundation; either version 2 of the License, or (at your option) any later
       8             : version. It is distributed in the hope that it will be useful, but WITHOUT
       9             : ANY WARRANTY WHATSOEVER.
      10             : 
      11             : Check the License for details. You should have received a copy of it, along
      12             : with the package; see the file 'COPYING'. If not, write to the Free Software
      13             : Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */
      14             : 
      15             : #include "pari.h"
      16             : #include "paripriv.h"
      17             : 
      18             : GEN
      19      388512 : Flv_to_ZV(GEN x)
      20     4096926 : { pari_APPLY_type(t_VEC, utoi(x[i])) }
      21             : 
      22             : GEN
      23    26718993 : Flc_to_ZC(GEN x)
      24   181436034 : { pari_APPLY_type(t_COL, utoi(x[i])) }
      25             : 
      26             : GEN
      27    11198390 : Flm_to_ZM(GEN x)
      28    36975875 : { pari_APPLY_type(t_MAT, Flc_to_ZC(gel(x,i))) }
      29             : 
      30             : GEN
      31          14 : Flc_to_ZC_inplace(GEN z)
      32             : {
      33          14 :   long i, l = lg(z);
      34         252 :   for (i=1; i<l; i++) gel(z,i) = utoi(z[i]);
      35          14 :   settyp(z, t_COL);
      36          14 :   return z;
      37             : }
      38             : 
      39             : GEN
      40           0 : Flm_to_ZM_inplace(GEN z)
      41             : {
      42           0 :   long i, l = lg(z);
      43           0 :   for (i=1; i<l; i++) Flc_to_ZC_inplace(gel(z, i));
      44           0 :   return z;
      45             : }
      46             : 
      47             : static GEN
      48     1748344 : Flm_solve_upper_1(GEN U, GEN B, ulong p, ulong pi)
      49     1748344 : { return Flm_Fl_mul_pre(B, Fl_inv(ucoeff(U, 1, 1), p), p, pi); }
      50             : 
      51             : static GEN
      52     2742762 : Flm_rsolve_upper_2(GEN U, GEN B, ulong p, ulong pi)
      53             : {
      54     2742762 :   ulong a = ucoeff(U, 1, 1), b = ucoeff(U, 1, 2), d = ucoeff(U, 2, 2);
      55     2742762 :   ulong D = Fl_mul_pre(a, d, p, pi), Dinv = Fl_inv(D, p);
      56     2742967 :   ulong ainv = Fl_mul_pre(d, Dinv, p, pi);
      57     2742949 :   ulong dinv = Fl_mul_pre(a, Dinv, p, pi);
      58     2742945 :   GEN B1 = rowslice(B, 1, 1);
      59     2742712 :   GEN B2 = rowslice(B, 2, 2);
      60     2742712 :   GEN X2 = Flm_Fl_mul_pre(B2, dinv, p, pi);
      61     2742883 :   GEN X1 = Flm_Fl_mul_pre(Flm_sub(B1, Flm_Fl_mul_pre(X2, b, p, pi), p),
      62             :                       ainv, p, pi);
      63     2742902 :   return vconcat(X1, X2);
      64             : }
      65             : 
      66             : /* solve U*X = B,  U upper triangular and invertible */
      67             : static GEN
      68     6567607 : Flm_rsolve_upper_pre(GEN U, GEN B, ulong p, ulong pi)
      69             : {
      70     6567607 :   long n = lg(U) - 1, n1;
      71             :   GEN U2, U11, U12, U22, B1, B2, X1, X2, X;
      72     6567607 :   pari_sp av = avma;
      73             : 
      74     6567607 :   if (n == 0) return B;
      75     6567600 :   if (n == 1) return Flm_solve_upper_1(U, B, p, pi);
      76     5489151 :   if (n == 2) return Flm_rsolve_upper_2(U, B, p, pi);
      77     2746395 :   n1 = (n + 1)/2;
      78     2746395 :   U2 = vecslice(U, n1 + 1, n);
      79     2747291 :   U22 = rowslice(U2, n1 + 1, n);
      80     2747148 :   B2 = rowslice(B, n1 + 1, n);
      81     2747121 :   X2 = Flm_rsolve_upper_pre(U22, B2, p, pi);
      82     2747427 :   U12 = rowslice(U2, 1, n1);
      83     2747201 :   B1 = rowslice(B, 1, n1);
      84     2747159 :   B1 = Flm_sub(B1, Flm_mul_pre(U12, X2, p, pi), p);
      85     2747086 :   if (gc_needed(av, 1)) gerepileall(av, 2, &B1, &X2);
      86     2747086 :   U11 = matslice(U, 1,n1, 1,n1);
      87     2747113 :   X1 = Flm_rsolve_upper_pre(U11, B1, p, pi);
      88     2747485 :   X = vconcat(X1, X2);
      89     2747506 :   if (gc_needed(av, 1)) X = gerepilecopy(av, X);
      90     2747505 :   return X;
      91             : }
      92             : 
      93             : static GEN
      94     2467243 : Flm_lsolve_upper_2(GEN U, GEN B, ulong p, ulong pi)
      95             : {
      96     2467243 :   ulong a = ucoeff(U, 1, 1), b = ucoeff(U, 1, 2), d = ucoeff(U, 2, 2);
      97     2467243 :   ulong D = Fl_mul_pre(a, d, p, pi), Dinv = Fl_inv(D, p);
      98     2467276 :   ulong ainv = Fl_mul_pre(d, Dinv, p, pi);
      99     2467279 :   ulong dinv = Fl_mul_pre(a, Dinv, p, pi);
     100     2467272 :   GEN B1 = vecslice(B, 1, 1);
     101     2467256 :   GEN B2 = vecslice(B, 2, 2);
     102     2467214 :   GEN X1 = Flm_Fl_mul_pre(B1, ainv, p, pi);
     103     2467275 :   GEN X2 = Flm_Fl_mul_pre(Flm_sub(B2, Flm_Fl_mul_pre(X1, b, p, pi), p),
     104             :                       dinv, p, pi);
     105     2467252 :   return shallowconcat(X1, X2);
     106             : }
     107             : 
     108             : /* solve X*U = B,  U upper triangular and invertible */
     109             : static GEN
     110     5288561 : Flm_lsolve_upper_pre(GEN U, GEN B, ulong p, ulong pi)
     111             : {
     112     5288561 :   long n = lg(U) - 1, n1;
     113             :   GEN U2, U11, U12, U22, B1, B2, X1, X2, X;
     114     5288561 :   pari_sp av = avma;
     115             : 
     116     5288561 :   if (n == 0) return B;
     117     5288561 :   if (n == 1) return Flm_solve_upper_1(U, B, p, pi);
     118     4618627 :   if (n == 2) return Flm_lsolve_upper_2(U, B, p, pi);
     119     2151383 :   n1 = (n + 1)/2;
     120     2151383 :   U2 = vecslice(U, n1 + 1, n);
     121     2151680 :   U11 = matslice(U, 1,n1, 1,n1);
     122     2151651 :   U12 = rowslice(U2, 1, n1);
     123     2151640 :   U22 = rowslice(U2, n1 + 1, n);
     124     2151646 :   B1 = vecslice(B, 1, n1);
     125     2151625 :   B2 = vecslice(B, n1 + 1, n);
     126     2151614 :   X1 = Flm_lsolve_upper_pre(U11, B1, p, pi);
     127     2151689 :   B2 = Flm_sub(B2, Flm_mul_pre(X1, U12, p, pi), p);
     128     2151651 :   if (gc_needed(av, 1)) gerepileall(av, 3, &B2, &U22, &X1);
     129     2151651 :   X2 = Flm_lsolve_upper_pre(U22, B2, p, pi);
     130     2151712 :   X = shallowconcat(X1, X2);
     131     2151711 :   if (gc_needed(av, 1)) X = gerepilecopy(av, X);
     132     2151711 :   return X;
     133             : }
     134             : 
     135             : static GEN
     136     4699845 : Flm_rsolve_lower_unit_2(GEN L, GEN A, ulong p, ulong pi)
     137             : {
     138     4699845 :   GEN X1 = rowslice(A, 1, 1);
     139     4699965 :   GEN X2 = Flm_sub(rowslice(A, 2, 2),
     140     4699808 :                    Flm_Fl_mul_pre(X1, ucoeff(L, 2, 1), p, pi), p);
     141     4699668 :   return vconcat(X1, X2);
     142             : }
     143             : 
     144             : /* solve L*X = A,  L lower triangular with ones on the diagonal
     145             : * (at least as many rows as columns) */
     146             : static GEN
     147    10733766 : Flm_rsolve_lower_unit_pre(GEN L, GEN A, ulong p, ulong pi)
     148             : {
     149    10733766 :   long m = lg(L) - 1, m1, n;
     150             :   GEN L1, L11, L21, L22, A1, A2, X1, X2, X;
     151    10733766 :   pari_sp av = avma;
     152             : 
     153    10733766 :   if (m == 0) return zero_Flm(0, lg(A) - 1);
     154    10733766 :   if (m == 1) return rowslice(A, 1, 1);
     155     9179383 :   if (m == 2) return Flm_rsolve_lower_unit_2(L, A, p, pi);
     156     4479542 :   m1 = (m + 1)/2;
     157     4479542 :   n = nbrows(L);
     158     4480352 :   L1 = vecslice(L, 1, m1);
     159     4480401 :   L11 = rowslice(L1, 1, m1);
     160     4480261 :   L21 = rowslice(L1, m1 + 1, n);
     161     4480256 :   A1 = rowslice(A, 1, m1);
     162     4480277 :   X1 = Flm_rsolve_lower_unit_pre(L11, A1, p, pi);
     163     4480532 :   A2 = rowslice(A, m1 + 1, n);
     164     4480156 :   A2 = Flm_sub(A2, Flm_mul_pre(L21, X1, p, pi), p);
     165     4480113 :   if (gc_needed(av, 1)) gerepileall(av, 2, &A2, &X1);
     166     4480113 :   L22 = matslice(L, m1+1,n, m1+1,m);
     167     4480208 :   X2 = Flm_rsolve_lower_unit_pre(L22, A2, p, pi);
     168     4480367 :   X = vconcat(X1, X2);
     169     4480572 :   if (gc_needed(av, 1)) X = gerepilecopy(av, X);
     170     4480572 :   return X;
     171             : }
     172             : 
     173             : static GEN
     174     1915942 : Flm_lsolve_lower_unit_2(GEN L, GEN A, ulong p, ulong pi)
     175             : {
     176     1915942 :   GEN X2 = vecslice(A, 2, 2);
     177     1915943 :   GEN X1 = Flm_sub(vecslice(A, 1, 1),
     178     1915941 :                    Flm_Fl_mul_pre(X2, ucoeff(L, 2, 1), p, pi), p);
     179     1915945 :   return shallowconcat(X1, X2);
     180             : }
     181             : 
     182             : /* solve L*X = A,  L square lower triangular with ones on the diagonal */
     183             : static GEN
     184     4444726 : Flm_lsolve_lower_unit_pre(GEN L, GEN A, ulong p, ulong pi)
     185             : {
     186     4444726 :   long m = lg(L) - 1, m1;
     187             :   GEN L1, L2, L11, L21, L22, A1, A2, X1, X2, X;
     188     4444726 :   pari_sp av = avma;
     189             : 
     190     4444726 :   if (m <= 1) return A;
     191     3965258 :   if (m == 2) return Flm_lsolve_lower_unit_2(L, A, p, pi);
     192     2049316 :   m1 = (m + 1)/2;
     193     2049316 :   L2 = vecslice(L, m1 + 1, m);
     194     2049321 :   L22 = rowslice(L2, m1 + 1, m);
     195     2049321 :   A2 = vecslice(A, m1 + 1, m);
     196     2049320 :   X2 = Flm_lsolve_lower_unit_pre(L22, A2, p, pi);
     197     2049322 :   if (gc_needed(av, 1)) X2 = gerepilecopy(av, X2);
     198     2049322 :   L1 = vecslice(L, 1, m1);
     199     2049322 :   L21 = rowslice(L1, m1 + 1, m);
     200     2049319 :   A1 = vecslice(A, 1, m1);
     201     2049322 :   A1 = Flm_sub(A1, Flm_mul_pre(X2, L21, p, pi), p);
     202     2049318 :   L11 = rowslice(L1, 1, m1);
     203     2049321 :   if (gc_needed(av, 1)) gerepileall(av, 3, &A1, &L11, &X2);
     204     2049321 :   X1 = Flm_lsolve_lower_unit_pre(L11, A1, p, pi);
     205     2049321 :   X = shallowconcat(X1, X2);
     206     2049321 :   if (gc_needed(av, 1)) X = gerepilecopy(av, X);
     207     2049321 :   return X;
     208             : }
     209             : 
     210             : /* destroy A */
     211             : static long
     212     3501608 : Flm_CUP_basecase(GEN A, GEN *R, GEN *C, GEN *U, GEN *P, ulong p, ulong pi)
     213             : {
     214     3501608 :   long i, j, k, m = nbrows(A), n = lg(A) - 1, pr, pc;
     215             :   ulong u, v;
     216             : 
     217     3501612 :   if (P) *P = identity_perm(n);
     218     3501585 :   *R = cgetg(m + 1, t_VECSMALL);
     219    17563566 :   for (j = 1, pr = 0; j <= n; j++)
     220             :   {
     221    19771682 :     for (pr++, pc = 0; pr <= m; pr++)
     222             :     {
     223   131970669 :       for (k = j; k <= n; k++) { v = ucoeff(A, pr, k); if (!pc && v) pc = k; }
     224    18441738 :       if (pc) break;
     225             :     }
     226    15391942 :     if (!pc) break;
     227    14061957 :     (*R)[j] = pr;
     228    14061957 :     if (pc != j)
     229             :     {
     230     2236470 :       swap(gel(A, j), gel(A, pc));
     231     2236470 :       if (P) lswap((*P)[j], (*P)[pc]);
     232             :     }
     233    14061957 :     u = Fl_inv(ucoeff(A, pr, j), p);
     234    95405626 :     for (i = pr + 1; i <= m; i++)
     235             :     {
     236    81343642 :       v = Fl_mul_pre(ucoeff(A, i, j), u, p, pi);
     237    81343154 :       ucoeff(A, i, j) = v;
     238    81343154 :       v = Fl_neg(v, p);
     239   372446960 :       for (k = j + 1; k <= n; k++)
     240   291106328 :         ucoeff(A, i, k) = Fl_addmul_pre(ucoeff(A, i, k),
     241   291103286 :                                         ucoeff(A, pr, k), v, p, pi);
     242             :     }
     243             :   }
     244     3501609 :   setlg(*R, j);
     245     3501623 :   *C = vecslice(A, 1, j - 1);
     246     3501605 :   if (U) *U = rowpermute(A, *R);
     247     3501604 :   return j - 1;
     248             : }
     249             : 
     250             : static const long Flm_CUP_LIMIT = 8;
     251             : 
     252             : static long
     253     3400034 : Flm_CUP_pre(GEN A, GEN *R, GEN *C, GEN *U, GEN *P, ulong p, ulong pi)
     254             : {
     255     3400034 :   long m = nbrows(A), m1, n = lg(A) - 1, i, r1, r2, r;
     256             :   GEN R1, C1, U1, P1, R2, C2, U2, P2;
     257             :   GEN A1, A2, B2, C21, U11, U12, T21, T22;
     258     3400031 :   pari_sp av = avma;
     259             : 
     260     3400031 :   if (m < Flm_CUP_LIMIT || n < Flm_CUP_LIMIT)
     261             :     /* destroy A; not called at the outermost recursion level */
     262     2389577 :     return Flm_CUP_basecase(A, R, C, U, P, p, pi);
     263     1010454 :   m1 = (minss(m, n) + 1)/2;
     264     1010452 :   A1 = rowslice(A, 1, m1);
     265     1010439 :   A2 = rowslice(A, m1 + 1, m);
     266     1010444 :   r1 = Flm_CUP_pre(A1, &R1, &C1, &U1, &P1, p, pi);
     267     1010449 :   if (r1 == 0)
     268             :   {
     269       24946 :     r2 = Flm_CUP_pre(A2, &R2, &C2, &U2, &P2, p, pi);
     270       24946 :     *R = cgetg(r2 + 1, t_VECSMALL);
     271       32683 :     for (i = 1; i <= r2; i++) (*R)[i] = R2[i] + m1;
     272       24946 :     *C = vconcat(zero_Flm(m1, r2), C2);
     273       24946 :     *U = U2;
     274       24946 :     *P = P2;
     275       24946 :     r = r2;
     276             :   }
     277             :   else
     278             :   {
     279      985503 :     U11 = vecslice(U1, 1, r1);
     280      985502 :     U12 = vecslice(U1, r1 + 1, n);
     281      985501 :     T21 = vecslicepermute(A2, P1, 1, r1);
     282      985496 :     T22 = vecslicepermute(A2, P1, r1 + 1, n);
     283      985496 :     C21 = Flm_lsolve_upper_pre(U11, T21, p, pi);
     284      985505 :     if (gc_needed(av, 1))
     285           0 :       gerepileall(av, 7, &R1, &C1, &P1, &U11, &U12, &T22, &C21);
     286      985505 :     B2 = Flm_sub(T22, Flm_mul_pre(C21, U12, p, pi), p);
     287      985503 :     r2 = Flm_CUP_pre(B2, &R2, &C2, &U2, &P2, p, pi);
     288      985501 :     r = r1 + r2;
     289      985501 :     *R = cgetg(r + 1, t_VECSMALL);
     290     6590002 :     for (i = 1; i <= r1; i++) (*R)[i] = R1[i];
     291     6138559 :     for (;      i <= r; i++)  (*R)[i] = R2[i - r1] + m1;
     292      985498 :     *C = shallowconcat(vconcat(C1, C21),
     293             :                        vconcat(zero_Flm(m1, r2), C2));
     294      985509 :     *U = shallowconcat(vconcat(U11, zero_Flm(r2, r1)),
     295             :                        vconcat(vecpermute(U12, P2), U2));
     296      985510 :     *P = cgetg(n + 1, t_VECSMALL);
     297     6590090 :     for (i = 1; i <= r1; i++) (*P)[i] = P1[i];
     298    12241293 :     for (; i <= n; i++)       (*P)[i] = P1[P2[i - r1] + r1];
     299             :   }
     300     1010454 :   if (gc_needed(av, 1)) gerepileall(av, 4, R, C, U, P);
     301     1010455 :   return r;
     302             : }
     303             : 
     304             : static long
     305     1112007 : Flm_echelon_gauss(GEN A, GEN *R, GEN *C, ulong p, ulong pi)
     306     1112007 : { return Flm_CUP_basecase(A, R, C, NULL, NULL, p, pi); }
     307             : 
     308             : /* complement of a strictly increasing subsequence of (1, 2, ..., n) */
     309             : static GEN
     310     1046278 : indexcompl(GEN v, long n)
     311             : {
     312     1046278 :   long i, j, k, m = lg(v) - 1;
     313     1046278 :   GEN w = cgetg(n - m + 1, t_VECSMALL);
     314    22635810 :   for (i = j = k = 1; i <= n; i++)
     315    21589532 :     if (j <= m && v[j] == i) j++; else w[k++] = i;
     316     1046278 :   return w;
     317             : }
     318             : 
     319             : /* column echelon form */
     320             : static long
     321     1871921 : Flm_echelon_pre(GEN A, GEN *R, GEN *C, ulong p, ulong pi)
     322             : {
     323     1871921 :   long j, j1, j2, m = nbrows(A), n = lg(A) - 1, n1, r, r1, r2;
     324             :   GEN A1, A2, R1, R1c, C1, R2, C2;
     325             :   GEN A12, A22, B2, C11, C21, M12;
     326     1871921 :   pari_sp av = avma;
     327             : 
     328     1871921 :   if (m < Flm_CUP_LIMIT || n < Flm_CUP_LIMIT)
     329     1112007 :     return Flm_echelon_gauss(Flm_copy(A), R, C, p, pi);
     330             : 
     331      759914 :   n1 = (n + 1)/2;
     332      759914 :   A1 = vecslice(A, 1, n1);
     333      759914 :   A2 = vecslice(A, n1 + 1, n);
     334      759914 :   r1 = Flm_echelon_pre(A1, &R1, &C1, p, pi);
     335      759914 :   if (!r1) return Flm_echelon_pre(A2, R, C, p, pi);
     336      703592 :   if (r1 == m) { *R = R1; *C = C1; return r1; }
     337             : 
     338      699914 :   R1c = indexcompl(R1, m);
     339      699914 :   C11 = rowpermute(C1, R1);
     340      699914 :   C21 = rowpermute(C1, R1c);
     341      699914 :   A12 = rowpermute(A2, R1);
     342      699914 :   A22 = rowpermute(A2, R1c);
     343      699914 :   M12 = Flm_rsolve_lower_unit_pre(C11, A12, p, pi);
     344      699914 :   B2 = Flm_sub(A22, Flm_mul_pre(C21, M12, p, pi), p);
     345      699913 :   r2 = Flm_echelon_pre(B2, &R2, &C2, p, pi);
     346      699914 :   if (!r2) { *R = R1; *C = C1; r = r1; }
     347             :   else
     348             :   {
     349      659479 :     R2 = perm_mul(R1c, R2);
     350      659479 :     C2 = rowpermute(vconcat(zero_Flm(r1, r2), C2),
     351             :                     perm_inv(vecsmall_concat(R1, R1c)));
     352      659479 :     r = r1 + r2;
     353      659479 :     *R = cgetg(r + 1, t_VECSMALL);
     354      659479 :     *C = cgetg(r + 1, t_MAT);
     355     8256509 :     for (j = j1 = j2 = 1; j <= r; j++)
     356     7597030 :       if (j2 > r2 || (j1 <= r1 && R1[j1] < R2[j2]))
     357             :       {
     358     4016379 :         gel(*C, j) = gel(C1, j1);
     359     4016379 :         (*R)[j] = R1[j1++];
     360             :       }
     361             :       else
     362             :       {
     363     3580651 :         gel(*C, j) = gel(C2, j2);
     364     3580651 :         (*R)[j] = R2[j2++];
     365             :       }
     366             :   }
     367      699914 :   if (gc_needed(av, 1)) gerepileall(av, 2, R, C);
     368      699914 :   return r;
     369             : }
     370             : 
     371             : static void /* assume m < p */
     372    11840730 : _Fl_addmul(GEN b, long k, long i, ulong m, ulong p, ulong pi)
     373             : {
     374    11840730 :   uel(b,k) = Fl_addmul_pre(uel(b, k), m, uel(b, i), p, pi);
     375    11840766 : }
     376             : static void /* same m = 1 */
     377      666807 : _Fl_add(GEN b, long k, long i, ulong p)
     378             : {
     379      666807 :   uel(b,k) = Fl_add(uel(b,k), uel(b,i), p);
     380      666807 : }
     381             : static void /* assume m < p && SMALL_ULONG(p) && (! (b[i] & b[k] & HIGHMASK)) */
     382     4153372 : _Fl_addmul_OK(GEN b, long k, long i, ulong m, ulong p)
     383             : {
     384     4153372 :   uel(b,k) += m * uel(b,i);
     385     4153372 :   if (uel(b,k) & HIGHMASK) uel(b,k) %= p;
     386     4153372 : }
     387             : static void /* assume SMALL_ULONG(p) && (! (b[i] & b[k] & HIGHMASK)) */
     388     2125002 : _Fl_add_OK(GEN b, long k, long i, ulong p)
     389             : {
     390     2125002 :   uel(b,k) += uel(b,i);
     391     2125002 :   if (uel(b,k) & HIGHMASK) uel(b,k) %= p;
     392     2125002 : }
     393             : 
     394             : /* assume 0 <= a[i,j] < p */
     395             : static GEN
     396      375968 : Fl_get_col_OK(GEN a, GEN b, long li, ulong p)
     397             : {
     398      375968 :   GEN u = cgetg(li+1,t_VECSMALL);
     399      375968 :   ulong m = uel(b,li) % p;
     400             :   long i,j;
     401             : 
     402      375968 :   uel(u,li) = (m * ucoeff(a,li,li)) % p;
     403     1458938 :   for (i = li-1; i > 0; i--)
     404             :   {
     405     1082970 :     m = p - uel(b,i)%p;
     406     3425127 :     for (j = i+1; j <= li; j++) {
     407     2342157 :       if (m & HIGHBIT) m %= p;
     408     2342157 :       m += ucoeff(a,i,j) * uel(u,j); /* 0 <= u[j] < p */
     409             :     }
     410     1082970 :     m %= p;
     411     1082970 :     if (m) m = ((p-m) * ucoeff(a,i,i)) % p;
     412     1082970 :     uel(u,i) = m;
     413             :   }
     414      375968 :   return u;
     415             : }
     416             : static GEN
     417     2162104 : Fl_get_col(GEN a, GEN b, long li, ulong p)
     418             : {
     419     2162104 :   GEN u = cgetg(li+1,t_VECSMALL);
     420     2162102 :   ulong m = uel(b,li) % p;
     421             :   long i,j;
     422             : 
     423     2162102 :   uel(u,li) = Fl_mul(m, ucoeff(a,li,li), p);
     424     5722083 :   for (i=li-1; i>0; i--)
     425             :   {
     426     3559979 :     m = b[i]%p;
     427     9112233 :     for (j = i+1; j <= li; j++)
     428     5552256 :       m = Fl_sub(m, Fl_mul(ucoeff(a,i,j), uel(u,j), p), p);
     429     3559977 :     if (m) m = Fl_mul(m, ucoeff(a,i,i), p);
     430     3559976 :     uel(u,i) = m;
     431             :   }
     432     2162104 :   return u;
     433             : }
     434             : 
     435             : static GEN
     436      646621 : Flm_ker_gauss_OK(GEN x, ulong p, long deplin)
     437             : {
     438             :   GEN y, c, d;
     439             :   long i, j, k, r, t, m, n;
     440             :   ulong a;
     441             : 
     442      646621 :   n = lg(x)-1;
     443      646621 :   m=nbrows(x); r=0;
     444             : 
     445      646622 :   c = zero_zv(m);
     446      646622 :   d = cgetg(n+1, t_VECSMALL);
     447      646618 :   a = 0; /* for gcc -Wall */
     448     3186340 :   for (k=1; k<=n; k++)
     449             :   {
     450     9142422 :     for (j=1; j<=m; j++)
     451     7998683 :       if (!c[j])
     452             :       {
     453     4245773 :         a = ucoeff(x,j,k) % p;
     454     4245773 :         if (a) break;
     455             :       }
     456     2592697 :     if (j > m)
     457             :     {
     458     1143741 :       if (deplin==1) {
     459       52978 :         c = cgetg(n+1, t_VECSMALL);
     460      173955 :         for (i=1; i<k; i++) c[i] = ucoeff(x,d[i],k) % p;
     461      103948 :         c[k] = 1; for (i=k+1; i<=n; i++) c[i] = 0;
     462       52978 :         return c;
     463             :       }
     464     1090763 :       r++; d[k] = 0;
     465             :     }
     466             :     else
     467             :     {
     468     1448956 :       ulong piv = p - Fl_inv(a, p); /* -1/a */
     469     1448957 :       c[j] = k; d[k] = j;
     470     1448957 :       ucoeff(x,j,k) = p-1;
     471     1448957 :       if (piv != 1)
     472     3125301 :         for (i=k+1; i<=n; i++) ucoeff(x,j,i) = (piv * ucoeff(x,j,i)) % p;
     473     7397483 :       for (t=1; t<=m; t++)
     474             :       {
     475     5948524 :         if (t == j) continue;
     476             : 
     477     4499566 :         piv = ( ucoeff(x,t,k) %= p );
     478     4499566 :         if (!piv) continue;
     479     2092108 :         if (piv == 1)
     480     2504228 :           for (i=k+1; i<=n; i++) _Fl_add_OK(gel(x,i),t,j, p);
     481             :         else
     482     4718509 :           for (i=k+1; i<=n; i++) _Fl_addmul_OK(gel(x,i),t,j,piv, p);
     483             :       }
     484             :     }
     485             :   }
     486      593643 :   if (deplin==1) return NULL;
     487             : 
     488      593636 :   y = cgetg(r+1, t_MAT);
     489     1684399 :   for (j=k=1; j<=r; j++,k++)
     490             :   {
     491     1090763 :     GEN C = cgetg(n+1, t_VECSMALL);
     492             : 
     493     2146815 :     gel(y,j) = C; while (d[k]) k++;
     494     8854437 :     for (i=1; i<k; i++)
     495     7763675 :       if (d[i])
     496     2280019 :         uel(C,i) = ucoeff(x,d[i],k) % p;
     497             :       else
     498     5483656 :         uel(C,i) = 0UL;
     499     7256853 :     uel(C,k) = 1UL; for (i=k+1; i<=n; i++) uel(C,i) = 0UL;
     500             :   }
     501      593636 :   if (deplin == 2) {
     502           0 :     GEN pc = cgetg(n - r + 1, t_VECSMALL);  /* indices of pivot columns */
     503           0 :     for (i = j = 1; j <= n; j++)
     504           0 :       if (d[j]) pc[i++] = j;
     505           0 :     return mkvec2(y, pc);
     506             :   }
     507      593636 :   return y;
     508             : }
     509             : 
     510             : /* in place, destroy x */
     511             : static GEN
     512      793913 : Flm_ker_gauss(GEN x, ulong p, long deplin)
     513             : {
     514             :   GEN y, c, d;
     515             :   long i, j, k, r, t, m, n;
     516             :   ulong a, pi;
     517      793913 :   n = lg(x)-1;
     518      793913 :   if (!n) return cgetg(1,t_MAT);
     519      793906 :   if (SMALL_ULONG(p)) return Flm_ker_gauss_OK(x, p, deplin);
     520      147285 :   pi = get_Fl_red(p);
     521             : 
     522      147286 :   m=nbrows(x); r=0;
     523             : 
     524      147288 :   c = zero_zv(m);
     525      147285 :   d = cgetg(n+1, t_VECSMALL);
     526      147284 :   a = 0; /* for gcc -Wall */
     527      474460 :   for (k=1; k<=n; k++)
     528             :   {
     529      854228 :     for (j=1; j<=m; j++)
     530      750895 :       if (!c[j])
     531             :       {
     532      567026 :         a = ucoeff(x,j,k);
     533      567026 :         if (a) break;
     534             :       }
     535      327177 :     if (j > m)
     536             :     {
     537      103334 :       if (deplin==1) {
     538           7 :         c = cgetg(n+1, t_VECSMALL);
     539          21 :         for (i=1; i<k; i++) c[i] = ucoeff(x,d[i],k);
     540           7 :         c[k] = 1; for (i=k+1; i<=n; i++) c[i] = 0;
     541           7 :         return c;
     542             :       }
     543      103327 :       r++; d[k] = 0;
     544             :     }
     545             :     else
     546             :     {
     547      223843 :       ulong piv = p - Fl_inv(a, p); /* -1/a */
     548      223845 :       c[j] = k; d[k] = j;
     549      223845 :       ucoeff(x,j,k) = p-1;
     550      223845 :       if (piv != 1)
     551      405102 :         for (i=k+1; i<=n; i++)
     552      187169 :           ucoeff(x,j,i) = Fl_mul_pre(piv, ucoeff(x,j,i), p, pi);
     553      971492 :       for (t=1; t<=m; t++)
     554             :       {
     555      747643 :         if (t == j) continue;
     556             : 
     557      523794 :         piv = ucoeff(x,t,k);
     558      523794 :         if (!piv) continue;
     559      308531 :         if (piv == 1)
     560       46075 :           for (i=k+1; i<=n; i++) _Fl_add(gel(x,i),t,j,p);
     561             :         else
     562      710212 :           for (i=k+1; i<=n; i++) _Fl_addmul(gel(x,i),t,j,piv,p, pi);
     563             :       }
     564             :     }
     565             :   }
     566      147283 :   if (deplin==1) return NULL;
     567             : 
     568      147276 :   y = cgetg(r+1, t_MAT);
     569      250600 :   for (j=k=1; j<=r; j++,k++)
     570             :   {
     571      103325 :     GEN C = cgetg(n+1, t_VECSMALL);
     572             : 
     573      166166 :     gel(y,j) = C; while (d[k]) k++;
     574      218060 :     for (i=1; i<k; i++)
     575      114735 :       if (d[i])
     576       79009 :         uel(C,i) = ucoeff(x,d[i],k);
     577             :       else
     578       35726 :         uel(C,i) = 0UL;
     579      166939 :     uel(C,k) = 1UL; for (i=k+1; i<=n; i++) uel(C,i) = 0UL;
     580             :   }
     581      147275 :   if (deplin == 2) {
     582      142420 :     GEN pc = cgetg(n - r + 1, t_VECSMALL);  /* indices of pivot columns */
     583      442394 :     for (i = j = 1; j <= n; j++)
     584      299976 :       if (d[j]) pc[i++] = j;
     585      142418 :     return mkvec2(y, pc);
     586             :   }
     587        4855 :   return y;
     588             : }
     589             : 
     590             : GEN
     591      271410 : Flm_intersect_i(GEN x, GEN y, ulong p)
     592             : {
     593      271410 :   long j, lx = lg(x);
     594             :   GEN z;
     595             : 
     596      271410 :   if (lx==1 || lg(y)==1) return cgetg(1,t_MAT);
     597      271396 :   z = Flm_ker(shallowconcat(x,y), p);
     598     1459357 :   for (j=lg(z)-1; j; j--) setlg(gel(z,j),lx);
     599      271396 :   return Flm_mul(x,z,p);
     600             : }
     601             : GEN
     602           0 : Flm_intersect(GEN x, GEN y, ulong p)
     603             : {
     604           0 :   pari_sp av = avma;
     605           0 :   return gerepileupto(av, Flm_image(Flm_intersect_i(x, y, p), p));
     606             : }
     607             : 
     608             : static GEN
     609      315292 : Flm_ker_echelon(GEN x, ulong p, long pivots) {
     610      315292 :   pari_sp av = avma;
     611             :   GEN R, Rc, C, C1, C2, S, K;
     612      315292 :   long n = lg(x) - 1, r;
     613      315292 :   ulong pi = get_Fl_red(p);
     614      315292 :   r = Flm_echelon_pre(Flm_transpose(x), &R, &C, p, pi);
     615      315292 :   Rc = indexcompl(R, n);
     616      315292 :   C1 = rowpermute(C, R);
     617      315292 :   C2 = rowpermute(C, Rc);
     618      315292 :   S = Flm_lsolve_lower_unit_pre(C1, C2, p, pi);
     619      315292 :   K = vecpermute(shallowconcat(Flm_neg(S, p), matid_Flm(n - r)),
     620             :                  perm_inv(vecsmall_concat(R, Rc)));
     621      315292 :   K = Flm_transpose(K);
     622      315292 :   if (pivots)
     623       32177 :     return gerepilecopy(av, mkvec2(K, R));
     624      283115 :   return gerepileupto(av, K);
     625             : }
     626             : 
     627             : static GEN
     628       30792 : Flm_deplin_echelon(GEN x, ulong p) {
     629       30792 :   pari_sp av = avma;
     630             :   GEN R, Rc, C, C1, C2, s, v;
     631       30792 :   long i, n = lg(x) - 1, r;
     632       30792 :   ulong pi = get_Fl_red(p);
     633       30792 :   r = Flm_echelon_pre(Flm_transpose(x), &R, &C, p, pi);
     634       30792 :   if (r == n) return gc_NULL(av);
     635       30785 :   Rc = indexcompl(R, n);
     636       30785 :   i = Rc[1];
     637       30785 :   C1 = rowpermute(C, R);
     638       30785 :   C2 = rowslice(C, i, i);
     639       30785 :   s = Flm_row(Flm_lsolve_lower_unit_pre(C1, C2, p, pi), 1);
     640       30785 :   v = vecsmallpermute(vecsmall_concat(Flv_neg(s, p), vecsmall_ei(n - r, 1)),
     641             :                  perm_inv(vecsmall_concat(R, Rc)));
     642       30785 :   return gerepileuptoleaf(av, v);
     643             : }
     644             : 
     645             : static GEN
     646     1140000 : Flm_ker_i(GEN x, ulong p, long deplin, long inplace) {
     647     1140000 :   if (lg(x) - 1 >= Flm_CUP_LIMIT && nbrows(x) >= Flm_CUP_LIMIT)
     648      346084 :     switch(deplin) {
     649      283115 :     case 0: return Flm_ker_echelon(x, p, 0);
     650       30792 :     case 1: return Flm_deplin_echelon(x, p);
     651       32177 :     case 2: return Flm_ker_echelon(x, p, 1);
     652             :     }
     653      793916 :   return Flm_ker_gauss(inplace? x: Flm_copy(x), p, deplin);
     654             : }
     655             : 
     656             : GEN
     657      595223 : Flm_ker_sp(GEN x, ulong p, long deplin) { return Flm_ker_i(x, p, deplin, 1); }
     658             : GEN
     659      544777 : Flm_ker(GEN x, ulong p) { return Flm_ker_i(x, p, 0, 0); }
     660             : GEN
     661           0 : Flm_deplin(GEN x, ulong p) { return Flm_ker_i(x, p, 1, 0); }
     662             : 
     663             : /* in place, destroy a, SMALL_ULONG(p) is TRUE */
     664             : static ulong
     665        1743 : Flm_det_gauss_OK(GEN a, long nbco, ulong p)
     666             : {
     667        1743 :   long i,j,k, s = 1;
     668        1743 :   ulong q, x = 1;
     669             : 
     670        7266 :   for (i=1; i<nbco; i++)
     671             :   {
     672        7140 :     for(k=i; k<=nbco; k++)
     673             :     {
     674        6958 :       ulong c = ucoeff(a,k,i) % p;
     675        6958 :       ucoeff(a,k,i) = c;
     676        6958 :       if (c) break;
     677             :     }
     678       17528 :     for(j=k+1; j<=nbco; j++) ucoeff(a,j,i) %= p;
     679        5705 :     if (k > nbco) return ucoeff(a,i,i);
     680        5523 :     if (k != i)
     681             :     { /* exchange the lines s.t. k = i */
     682        3122 :       for (j=i; j<=nbco; j++) lswap(ucoeff(a,i,j), ucoeff(a,k,j));
     683         784 :       s = -s;
     684             :     }
     685        5523 :     q = ucoeff(a,i,i);
     686             : 
     687        5523 :     if (x & HIGHMASK) x %= p;
     688        5523 :     x *= q;
     689        5523 :     q = Fl_inv(q,p);
     690       18417 :     for (k=i+1; k<=nbco; k++)
     691             :     {
     692       12894 :       ulong m = ucoeff(a,i,k) % p;
     693       12894 :       if (!m) continue;
     694             : 
     695        8687 :       m = p - ((m*q)%p);
     696       34419 :       for (j=i+1; j<=nbco; j++)
     697             :       {
     698       25732 :         ulong c = ucoeff(a,j,k);
     699       25732 :         if (c & HIGHMASK) c %= p;
     700       25732 :         ucoeff(a,j,k) = c  + m*ucoeff(a,j,i);
     701             :       }
     702             :     }
     703             :   }
     704        1561 :   if (x & HIGHMASK) x %= p;
     705        1561 :   q = ucoeff(a,nbco,nbco);
     706        1561 :   if (q & HIGHMASK) q %= p;
     707        1561 :   x = (x*q) % p;
     708        1561 :   if (s < 0 && x) x = p - x;
     709        1561 :   return x;
     710             : }
     711             : 
     712             : /* in place, destroy a */
     713             : static ulong
     714       52508 : Flm_det_gauss(GEN a, ulong p)
     715             : {
     716       52508 :   long i,j,k, s = 1, nbco = lg(a)-1;
     717       52508 :   ulong pi, q, x = 1;
     718             : 
     719       52508 :   if (SMALL_ULONG(p)) return Flm_det_gauss_OK(a, nbco, p);
     720       50765 :   pi = get_Fl_red(p);
     721      324462 :   for (i=1; i<nbco; i++)
     722             :   {
     723      274099 :     for(k=i; k<=nbco; k++)
     724      274099 :       if (ucoeff(a,k,i)) break;
     725      273696 :     if (k > nbco) return ucoeff(a,i,i);
     726      273696 :     if (k != i)
     727             :     { /* exchange the lines s.t. k = i */
     728        1090 :       for (j=i; j<=nbco; j++) lswap(ucoeff(a,i,j), ucoeff(a,k,j));
     729         212 :       s = -s;
     730             :     }
     731      273696 :     q = ucoeff(a,i,i);
     732             : 
     733      273696 :     x = Fl_mul_pre(x, q, p, pi);
     734      273697 :     q = Fl_inv(q,p);
     735     1173795 :     for (k=i+1; k<=nbco; k++)
     736             :     {
     737      900098 :       ulong m = ucoeff(a,i,k);
     738      900098 :       if (!m) continue;
     739             : 
     740      841673 :       m = Fl_mul_pre(m, q, p, pi);
     741     4327248 :       for (j=i+1; j<=nbco; j++)
     742     3485576 :         ucoeff(a,j,k) = Fl_sub(ucoeff(a,j,k), Fl_mul_pre(m,ucoeff(a,j,i), p, pi), p);
     743             :     }
     744             :   }
     745       50766 :   if (s < 0) x = Fl_neg(x, p);
     746       50766 :   return Fl_mul(x, ucoeff(a,nbco,nbco), p);
     747             : }
     748             : 
     749             : static ulong
     750       36414 : Flm_det_CUP(GEN a, ulong p) {
     751             :   GEN R, C, U, P;
     752       36414 :   long i, n = lg(a) - 1, r;
     753             :   ulong d;
     754       36414 :   ulong pi = get_Fl_red(p);
     755       36414 :   r = Flm_CUP_pre(a, &R, &C, &U, &P, p, pi);
     756       36414 :   if (r < n)
     757          42 :     d = 0;
     758             :   else {
     759       36372 :     d = perm_sign(P) == 1? 1: p-1;
     760      403575 :     for (i = 1; i <= n; i++)
     761      367203 :       d = Fl_mul_pre(d, ucoeff(U, i, i), p, pi);
     762             :   }
     763       36414 :   return d;
     764             : }
     765             : 
     766             : static ulong
     767       88922 : Flm_det_i(GEN x, ulong p, long inplace) {
     768       88922 :   pari_sp av = avma;
     769             :   ulong d;
     770       88922 :   if (lg(x) - 1 >= Flm_CUP_LIMIT)
     771       36414 :     d = Flm_det_CUP(x, p);
     772             :   else
     773       52508 :     d = Flm_det_gauss(inplace? x: Flm_copy(x), p);
     774       88922 :   return gc_ulong(av, d);
     775             : }
     776             : 
     777             : ulong
     778       88922 : Flm_det_sp(GEN x, ulong p) { return Flm_det_i(x, p, 1); }
     779             : ulong
     780           0 : Flm_det(GEN x, ulong p) { return Flm_det_i(x, p, 0); }
     781             : 
     782             : /* Destroy x */
     783             : static GEN
     784     4366859 : Flm_gauss_pivot(GEN x, ulong p, long *rr)
     785             : {
     786             :   GEN c,d;
     787             :   long i,j,k,r,t,n,m;
     788             : 
     789     4366859 :   n=lg(x)-1; if (!n) { *rr=0; return NULL; }
     790             : 
     791     4365550 :   m=nbrows(x); r=0;
     792     4365549 :   d=cgetg(n+1,t_VECSMALL);
     793     4365538 :   c = zero_zv(m);
     794    18796716 :   for (k=1; k<=n; k++)
     795             :   {
     796    35874121 :     for (j=1; j<=m; j++)
     797    34093017 :       if (!c[j])
     798             :       {
     799    18274218 :         ucoeff(x,j,k) %= p;
     800    18274218 :         if (ucoeff(x,j,k)) break;
     801             :       }
     802    14431149 :     if (j>m) { r++; d[k]=0; }
     803             :     else
     804             :     {
     805    12650014 :       ulong piv = p - Fl_inv(ucoeff(x,j,k), p);
     806    12650038 :       c[j]=k; d[k]=j;
     807    29074231 :       for (i=k+1; i<=n; i++)
     808    16424197 :         ucoeff(x,j,i) = Fl_mul(piv, ucoeff(x,j,i), p);
     809    60033677 :       for (t=1; t<=m; t++)
     810    47383760 :         if (!c[t]) /* no pivot on that line yet */
     811             :         {
     812    20212775 :           piv = ucoeff(x,t,k);
     813    20212775 :           if (piv)
     814             :           {
     815    11937514 :             ucoeff(x,t,k) = 0;
     816    36986491 :             for (i=k+1; i<=n; i++)
     817    25049076 :               ucoeff(x,t,i) = Fl_add(ucoeff(x,t,i),
     818    25049094 :                                      Fl_mul(piv,ucoeff(x,j,i),p),p);
     819             :           }
     820             :         }
     821    41724094 :       for (i=k; i<=n; i++) ucoeff(x,j,i) = 0; /* dummy */
     822             :     }
     823             :   }
     824     4365567 :   *rr = r; return gc_const((pari_sp)d, d);
     825             : }
     826             : 
     827             : static GEN
     828      268707 : Flm_pivots_CUP(GEN x, ulong p, long *rr)
     829             : {
     830      268707 :   long i, n = lg(x) - 1, r;
     831      268707 :   GEN R, C, U, P, d = zero_zv(n);
     832      268707 :   ulong pi = get_Fl_red(p);
     833      268707 :   r = Flm_CUP_pre(x, &R, &C, &U, &P, p, pi);
     834     2967798 :   for(i = 1; i <= r; i++)
     835     2699091 :     d[P[i]] = R[i];
     836      268707 :   *rr = n - r; return gc_const((pari_sp)d, d);
     837             : }
     838             : 
     839             : GEN
     840     4635564 : Flm_pivots(GEN x, ulong p, long *rr, long inplace)
     841             : {
     842     4635564 :   if (lg(x) - 1 >= Flm_CUP_LIMIT && nbrows(x) >= Flm_CUP_LIMIT)
     843      268706 :     return Flm_pivots_CUP(x, p, rr);
     844     4366858 :   return Flm_gauss_pivot(inplace? x: Flm_copy(x), p, rr);
     845             : }
     846             : 
     847             : long
     848       39620 : Flm_rank(GEN x, ulong p)
     849             : {
     850       39620 :   pari_sp av = avma;
     851             :   long r;
     852       39620 :   if (lg(x) - 1 >= Flm_CUP_LIMIT && nbrows(x) >= Flm_CUP_LIMIT) {
     853             :     GEN R, C;
     854        9688 :     ulong pi = get_Fl_red(p);
     855        9688 :     return gc_long(av, Flm_echelon_pre(x, &R, &C, p, pi));
     856             :   }
     857       29932 :   (void) Flm_pivots(x, p, &r, 0);
     858       29932 :   return gc_long(av, lg(x)-1 - r);
     859             : }
     860             : 
     861             : /* assume dim A >= 1, A invertible + upper triangular, 1s on diagonal,
     862             :  * reduced mod p */
     863             : static GEN
     864        1260 : Flm_inv_upper_1_ind(GEN A, long index, ulong p)
     865             : {
     866        1260 :   long n = lg(A)-1, i = index, j;
     867        1260 :   GEN u = const_vecsmall(n, 0);
     868        1260 :   u[i] = 1;
     869        1260 :   if (SMALL_ULONG(p))
     870        3255 :     for (i--; i>0; i--)
     871             :     {
     872        2009 :       ulong m = ucoeff(A,i,i+1) * uel(u,i+1); /* j = i+1 */
     873        7035 :       for (j=i+2; j<=n; j++)
     874             :       {
     875        5026 :         if (m & HIGHMASK) m %= p;
     876        5026 :         m += ucoeff(A,i,j) * uel(u,j);
     877             :       }
     878        2009 :       u[i] = Fl_neg(m % p, p);
     879             :     }
     880             :   else
     881          21 :     for (i--; i>0; i--)
     882             :     {
     883           7 :       ulong m = Fl_mul(ucoeff(A,i,i+1),uel(u,i+1), p); /* j = i+1 */
     884           7 :       for (j=i+2; j<=n; j++) m = Fl_add(m, Fl_mul(ucoeff(A,i,j),uel(u,j),p), p);
     885           7 :       u[i] = Fl_neg(m, p);
     886             :     }
     887        1260 :   return u;
     888             : }
     889             : static GEN
     890         476 : Flm_inv_upper_1(GEN A, ulong p)
     891             : {
     892             :   long i, l;
     893         476 :   GEN B = cgetg_copy(A, &l);
     894        1736 :   for (i = 1; i < l; i++) gel(B,i) = Flm_inv_upper_1_ind(A, i, p);
     895         476 :   return B;
     896             : }
     897             : /* destroy a, b */
     898             : static GEN
     899      100970 : Flm_gauss_sp_OK(GEN a, GEN b, ulong *detp, ulong p)
     900             : {
     901      100970 :   long i, j, k, li, bco, aco = lg(a)-1, s = 1;
     902      100970 :   ulong det = 1;
     903             :   GEN u;
     904             : 
     905      100970 :   li = nbrows(a);
     906      100970 :   bco = lg(b)-1;
     907      362515 :   for (i=1; i<=aco; i++)
     908             :   {
     909             :     ulong invpiv;
     910             :     /* Fl_get_col wants 0 <= a[i,j] < p for all i,j */
     911      893075 :     for (k = 1; k < i; k++) ucoeff(a,k,i) %= p;
     912      414073 :     for (k = i; k <= li; k++)
     913             :     {
     914      414066 :       ulong piv = ( ucoeff(a,k,i) %= p );
     915      414066 :       if (piv)
     916             :       {
     917      362508 :         ucoeff(a,k,i) = Fl_inv(piv, p);
     918      362508 :         if (detp)
     919             :         {
     920           0 :           if (det & HIGHMASK) det %= p;
     921           0 :           det *= piv;
     922             :         }
     923      362508 :         break;
     924             :       }
     925             :     }
     926             :     /* found a pivot on line k */
     927      362515 :     if (k > li) return NULL;
     928      362508 :     if (k != i)
     929             :     { /* swap lines so that k = i */
     930       34110 :       s = -s;
     931      140749 :       for (j=i; j<=aco; j++) swap(gcoeff(a,i,j), gcoeff(a,k,j));
     932      179090 :       for (j=1; j<=bco; j++) swap(gcoeff(b,i,j), gcoeff(b,k,j));
     933             :     }
     934      362508 :     if (i == aco) break;
     935             : 
     936      261545 :     invpiv = p - ucoeff(a,i,i); /* -1/piv mod p */
     937      814011 :     for (k=i+1; k<=li; k++)
     938             :     {
     939      552466 :       ulong m = ( ucoeff(a,k,i) %= p );
     940      552466 :       if (!m) continue;
     941             : 
     942      157579 :       m = Fl_mul(m, invpiv, p);
     943      157579 :       if (m == 1) {
     944      124293 :         for (j=i+1; j<=aco; j++) _Fl_add_OK(gel(a,j),k,i, p);
     945      194782 :         for (j=1;   j<=bco; j++) _Fl_add_OK(gel(b,j),k,i, p);
     946             :       } else {
     947      428214 :         for (j=i+1; j<=aco; j++) _Fl_addmul_OK(gel(a,j),k,i,m, p);
     948      715615 :         for (j=1;   j<=bco; j++) _Fl_addmul_OK(gel(b,j),k,i,m, p);
     949             :       }
     950             :     }
     951             :   }
     952      100963 :   if (detp)
     953             :   {
     954           0 :     det %=  p;
     955           0 :     if (s < 0 && det) det = p - det;
     956           0 :     *detp = det;
     957             :   }
     958      100963 :   u = cgetg(bco+1,t_MAT);
     959      476931 :   for (j=1; j<=bco; j++) gel(u,j) = Fl_get_col_OK(a,gel(b,j), aco,p);
     960      100963 :   return u;
     961             : }
     962             : 
     963             : /* destroy a, b */
     964             : static GEN
     965     2138560 : Flm_gauss_sp_i(GEN a, GEN b, ulong *detp, ulong p)
     966             : {
     967     2138560 :   long i, j, k, li, bco, aco = lg(a)-1, s = 1;
     968     2138560 :   ulong det = 1;
     969             :   GEN u;
     970             :   ulong pi;
     971     2138560 :   if (!aco) { if (detp) *detp = 1; return cgetg(1,t_MAT); }
     972     2138560 :   if (SMALL_ULONG(p)) return Flm_gauss_sp_OK(a, b, detp, p);
     973     2037590 :   pi = get_Fl_red(p);
     974     2037590 :   li = nbrows(a);
     975     2037590 :   bco = lg(b)-1;
     976     5303949 :   for (i=1; i<=aco; i++)
     977             :   {
     978             :     ulong invpiv;
     979             :     /* Fl_get_col wants 0 <= a[i,j] < p for all i,j */
     980     5542808 :     for (k = i; k <= li; k++)
     981             :     {
     982     5542809 :       ulong piv = ucoeff(a,k,i);
     983     5542809 :       if (piv)
     984             :       {
     985     5303967 :         ucoeff(a,k,i) = Fl_inv(piv, p);
     986     5303959 :         if (detp) det = Fl_mul_pre(det, piv, p, pi);
     987     5303959 :         break;
     988             :       }
     989             :     }
     990             :     /* found a pivot on line k */
     991     5303958 :     if (k > li) return NULL;
     992     5303958 :     if (k != i)
     993             :     { /* swap lines so that k = i */
     994      181789 :       s = -s;
     995      676971 :       for (j=i; j<=aco; j++) swap(gcoeff(a,i,j), gcoeff(a,k,j));
     996      369313 :       for (j=1; j<=bco; j++) swap(gcoeff(b,i,j), gcoeff(b,k,j));
     997             :     }
     998     5303958 :     if (i == aco) break;
     999             : 
    1000     3266370 :     invpiv = p - ucoeff(a,i,i); /* -1/piv mod p */
    1001     8242420 :     for (k=i+1; k<=li; k++)
    1002             :     {
    1003     4976061 :       ulong m = ucoeff(a,k,i);
    1004     4976061 :       if (!m) continue;
    1005             : 
    1006     4139208 :       m = Fl_mul_pre(m, invpiv, p, pi);
    1007     4139204 :       if (m == 1) {
    1008      637584 :         for (j=i+1; j<=aco; j++) _Fl_add(gel(a,j),k,i, p);
    1009      443291 :         for (j=1;   j<=bco; j++) _Fl_add(gel(b,j),k,i, p);
    1010             :       } else {
    1011    11365287 :         for (j=i+1; j<=aco; j++) _Fl_addmul(gel(a,j),k,i,m, p, pi);
    1012     7892086 :         for (j=1;   j<=bco; j++) _Fl_addmul(gel(b,j),k,i,m, p, pi);
    1013             :       }
    1014             :     }
    1015             :   }
    1016     2037571 :   if (detp)
    1017             :   {
    1018           0 :     if (s < 0 && det) det = p - det;
    1019           0 :     *detp = det;
    1020             :   }
    1021     2037571 :   u = cgetg(bco+1,t_MAT);
    1022     4199692 :   for (j=1; j<=bco; j++) gel(u,j) = Fl_get_col(a,gel(b,j), aco,p);
    1023     2037588 :   return u;
    1024             : }
    1025             : 
    1026             : static GEN
    1027     1073716 : Flm_gauss_from_CUP(GEN b, GEN R, GEN C, GEN U, GEN P, ulong p, ulong pi, ulong *detp)
    1028             : {
    1029     1073716 :   GEN Y = Flm_rsolve_lower_unit_pre(rowpermute(C, R), rowpermute(b, R), p, pi);
    1030     1073732 :   GEN X = rowpermute(Flm_rsolve_upper_pre(U, Y, p, pi), perm_inv(P));
    1031     1073733 :   if (detp)
    1032             :   {
    1033      910979 :     ulong d = perm_sign(P) == 1? 1: p-1;
    1034      910992 :     long i, r = lg(R);
    1035     5611929 :     for (i = 1; i < r; i++)
    1036     4700950 :       d = Fl_mul_pre(d, ucoeff(U, i, i), p, pi);
    1037      910979 :     *detp = d;
    1038             :   }
    1039     1073733 :   return X;
    1040             : }
    1041             : 
    1042             : static GEN
    1043      162754 : Flm_gauss_CUP(GEN a, GEN b, ulong *detp, ulong p) {
    1044             :   GEN R, C, U, P;
    1045      162754 :   long n = lg(a) - 1, r;
    1046      162754 :   ulong pi = get_Fl_red(p);
    1047      162754 :   if (nbrows(a) < n || (r = Flm_CUP_pre(a, &R, &C, &U, &P, p, pi)) < n)
    1048          14 :     return NULL;
    1049      162740 :   return Flm_gauss_from_CUP(b, R, C, U, P, p, pi, detp);
    1050             : }
    1051             : 
    1052             : GEN
    1053     2182204 : Flm_gauss_sp(GEN a, GEN b, ulong *detp, ulong p) {
    1054     2182204 :   pari_sp av = avma;
    1055             :   GEN x;
    1056     2182204 :   if (lg(a) - 1 >= Flm_CUP_LIMIT)
    1057       43644 :     x = Flm_gauss_CUP(a, b, detp, p);
    1058             :   else
    1059     2138560 :     x = Flm_gauss_sp_i(a, b, detp, p);
    1060     2182201 :   if (!x) return gc_NULL(av);
    1061     2182194 :   return gerepileupto(av, x);
    1062             : }
    1063             : 
    1064             : GEN
    1065     2141828 : Flm_gauss(GEN a, GEN b, ulong p) {
    1066     2141828 :   pari_sp av = avma;
    1067             :   GEN x;
    1068     2141828 :   if (lg(a) - 1 >= Flm_CUP_LIMIT)
    1069      104246 :     x = Flm_gauss_CUP(a, b, NULL, p);
    1070             :   else {
    1071     2037582 :     a = RgM_shallowcopy(a);
    1072     2037581 :     b = RgM_shallowcopy(b);
    1073     2037581 :     x = Flm_gauss_sp(a, b, NULL, p);
    1074             :   }
    1075     2141822 :   if (!x) return gc_NULL(av);
    1076     2141808 :   return gerepileupto(av, x);
    1077             : }
    1078             : 
    1079             : static GEN
    1080       58511 : Flm_inv_i(GEN a, ulong *detp, ulong p, long inplace) {
    1081       58511 :   pari_sp av = avma;
    1082       58511 :   long n = lg(a) - 1;
    1083             :   GEN b, x;
    1084       58511 :   if (n == 0) return cgetg(1, t_MAT);
    1085       58511 :   b = matid_Flm(nbrows(a));
    1086       58511 :   if (n >= Flm_CUP_LIMIT)
    1087       14864 :     x = Flm_gauss_CUP(a, b, detp, p);
    1088             :   else {
    1089       43647 :     if (!inplace)
    1090       43626 :       a = RgM_shallowcopy(a);
    1091       43647 :     x = Flm_gauss_sp(a, b, detp, p);
    1092             :   }
    1093       58511 :   if (!x) return gc_NULL(av);
    1094       58504 :   return gerepileupto(av, x);
    1095             : }
    1096             : 
    1097             : GEN
    1098          42 : Flm_inv_sp(GEN a, ulong *detp, ulong p) {
    1099          42 :   return Flm_inv_i(a, detp, p, 1);
    1100             : }
    1101             : 
    1102             : GEN
    1103       58469 : Flm_inv(GEN a, ulong p) {
    1104       58469 :   return Flm_inv_i(a, NULL, p, 0);
    1105             : }
    1106             : 
    1107             : GEN
    1108          21 : Flm_Flc_gauss(GEN a, GEN b, ulong p) {
    1109          21 :   pari_sp av = avma;
    1110          21 :   GEN z = Flm_gauss(a, mkmat(b), p);
    1111          21 :   if (!z) return gc_NULL(av);
    1112          14 :   if (lg(z) == 1) { set_avma(av); return cgetg(1,t_VECSMALL); }
    1113          14 :   return gerepileuptoleaf(av, gel(z,1));
    1114             : }
    1115             : 
    1116             : GEN
    1117      911005 : Flm_adjoint(GEN A, ulong p)
    1118             : {
    1119      911005 :   pari_sp av = avma;
    1120             :   GEN R, C, U, P, C1, U1, v, c, d;
    1121      911005 :   long r, i, q, n = lg(A)-1, m;
    1122             :   ulong D;
    1123      911005 :   ulong pi = get_Fl_red(p);
    1124      911004 :   if (n == 0) return cgetg(1, t_MAT);
    1125      911004 :   r = Flm_CUP_pre(A, &R, &C, &U, &P, p, pi);
    1126      910997 :   m = nbrows(A);
    1127      910996 :   if (r == n)
    1128             :   {
    1129      910982 :     GEN X = Flm_gauss_from_CUP(matid_Flm(m), R, C, U, P, p, pi, &D);
    1130      910995 :     return gerepileupto(av, Flm_Fl_mul_pre(X, D, p, pi));
    1131             :   }
    1132          14 :   if (r < n-1) return zero_Flm(n, m);
    1133          28 :   for (q = n, i = 1; i < n; i++)
    1134          14 :     if (R[i] != i) { q = i; break; }
    1135          14 :   C1 = matslice(C, 1, q-1, 1, q-1);
    1136          14 :   c = vecslice(Flm_row(C, q), 1, q-1);
    1137          14 :   c = Flm_lsolve_lower_unit_pre(C1, Flm_transpose(mkmat(c)), p, pi);
    1138          14 :   d = cgetg(m+1, t_VECSMALL);
    1139          28 :   for (i=1; i<q; i++)    uel(d,i) = ucoeff(c,1,i);
    1140          14 :   uel(d,q) = p-1;
    1141          21 :   for (i=q+1; i<=m; i++) uel(d,i) = 0;
    1142          14 :   U1 = vecslice(U, 1, n-1);
    1143          14 :   v = gel(Flm_rsolve_upper_pre(U1, mkmat(gel(U,n)), p, pi),1);
    1144          14 :   v = vecsmall_append(v, p-1);
    1145          14 :   D = perm_sign(P) != (odd(q+n)?-1:1) ? p-1 : 1;
    1146          28 :   for (i = 1; i <= n-1; i++)
    1147          14 :     D = Fl_mul_pre(D, ucoeff(U1, i, i), p, pi);
    1148          14 :   d = Flv_Fl_mul(d, D, p);
    1149          14 :   return rowpermute(Flc_Flv_mul(v, d, p),perm_inv(P));
    1150             : }
    1151             : 
    1152             : static GEN
    1153         287 : Flm_invimage_CUP(GEN A, GEN B, ulong p) {
    1154         287 :   pari_sp av = avma;
    1155             :   GEN R, Rc, C, U, P, B1, B2, C1, C2, X, Y, Z;
    1156             :   long r;
    1157         287 :   ulong pi = get_Fl_red(p);
    1158         287 :   r = Flm_CUP_pre(A, &R, &C, &U, &P, p, pi);
    1159         287 :   Rc = indexcompl(R, nbrows(B));
    1160         287 :   C1 = rowpermute(C, R);
    1161         287 :   C2 = rowpermute(C, Rc);
    1162         287 :   B1 = rowpermute(B, R);
    1163         287 :   B2 = rowpermute(B, Rc);
    1164         287 :   Z = Flm_rsolve_lower_unit_pre(C1, B1, p, pi);
    1165         287 :   if (!gequal(Flm_mul_pre(C2, Z, p, pi), B2))
    1166          14 :     return NULL;
    1167         273 :   Y = vconcat(Flm_rsolve_upper_pre(vecslice(U, 1, r), Z, p, pi),
    1168         273 :               zero_Flm(lg(A) - 1 - r, lg(B) - 1));
    1169         273 :   X = rowpermute(Y, perm_inv(P));
    1170         273 :   return gerepileupto(av, X);
    1171             : }
    1172             : 
    1173             : GEN
    1174         917 : Flm_invimage_i(GEN A, GEN B, ulong p)
    1175             : {
    1176             :   GEN d, x, X, Y;
    1177         917 :   long i, j, nY, nA = lg(A)-1, nB = lg(B)-1;
    1178             : 
    1179         917 :   if (!nB) return cgetg(1, t_MAT);
    1180         770 :   if (maxss(nA, nB) >= Flm_CUP_LIMIT && nbrows(B) >= Flm_CUP_LIMIT)
    1181         287 :     return Flm_invimage_CUP(A, B, p);
    1182             : 
    1183         483 :   x = Flm_ker(shallowconcat(Flm_neg(A,p), B), p);
    1184             :   /* AX = BY, Y in strict upper echelon form with pivots = 1.
    1185             :    * We must find T such that Y T = Id_nB then X T = Z. This exists iff
    1186             :    * Y has at least nB columns and full rank */
    1187         483 :   nY = lg(x)-1;
    1188         483 :   if (nY < nB) return NULL;
    1189         483 :   Y = rowslice(x, nA+1, nA+nB); /* nB rows */
    1190         483 :   d = cgetg(nB+1, t_VECSMALL);
    1191        1750 :   for (i = nB, j = nY; i >= 1; i--, j--)
    1192             :   {
    1193        1281 :     for (; j>=1; j--)
    1194        1274 :       if (coeff(Y,i,j)) { d[i] = j; break; }
    1195        1274 :     if (!j) return NULL;
    1196             :   }
    1197             :   /* reduce to the case Y square, upper triangular with 1s on diagonal */
    1198         476 :   Y = vecpermute(Y, d);
    1199         476 :   x = vecpermute(x, d);
    1200         476 :   X = rowslice(x, 1, nA);
    1201         476 :   return Flm_mul(X, Flm_inv_upper_1(Y,p), p);
    1202             : }
    1203             : GEN
    1204         875 : Flm_invimage(GEN A, GEN B, ulong p)
    1205             : {
    1206         875 :   pari_sp av = avma;
    1207         875 :   GEN X = Flm_invimage_i(A,B,p);
    1208         875 :   if (!X) return gc_NULL(av);
    1209         875 :   return gerepileupto(av, X);
    1210             : }
    1211             : 
    1212             : GEN
    1213      130710 : Flm_Flc_invimage(GEN A, GEN y, ulong p)
    1214             : {
    1215      130710 :   pari_sp av = avma;
    1216      130710 :   long i, l = lg(A);
    1217             :   GEN M, x;
    1218             :   ulong t;
    1219             : 
    1220      130710 :   if (l==1) return NULL;
    1221      130570 :   if (lg(y) != lgcols(A)) pari_err_DIM("Flm_Flc_invimage");
    1222      130570 :   M = cgetg(l+1,t_MAT);
    1223     1077496 :   for (i=1; i<l; i++) gel(M,i) = gel(A,i);
    1224      130570 :   gel(M,l) = y; M = Flm_ker(M,p);
    1225      130570 :   i = lg(M)-1; if (!i) return gc_NULL(av);
    1226             : 
    1227      127372 :   x = gel(M,i); t = x[l];
    1228      127372 :   if (!t) return gc_NULL(av);
    1229             : 
    1230      127365 :   setlg(x,l); t = Fl_inv(Fl_neg(t,p),p);
    1231      127365 :   if (t!=1) x = Flv_Fl_mul(x, t, p);
    1232      127365 :   return gerepileuptoleaf(av, x);
    1233             : }

Generated by: LCOV version 1.16