flint-sys 0.9.0

Bindings to the FLINT C library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

/*
    Copyright (C) 2006, 2007, 2008, 2009, 2010, 2016 William Hart
    Copyright (C) 2009, 2011 Andy Novocin
    Copyright (C) 2010 Sebastian Pancratz

    This file is part of FLINT.

    FLINT is free software: you can redistribute it and/or modify it under
    the terms of the GNU Lesser General Public License (LGPL) as published
    by the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.  See <https://www.gnu.org/licenses/>.
*/

#ifndef FMPZ_POLY_FACTOR_H
#define FMPZ_POLY_FACTOR_H

#ifdef FMPZ_POLY_FACTOR_INLINES_C
#define FMPZ_POLY_FACTOR_INLINE
#else
#define FMPZ_POLY_FACTOR_INLINE static inline
#endif

#include "nmod_types.h"
#include "fmpz_types.h"

#ifdef __cplusplus
extern "C" {
#endif

void fmpz_poly_factor_init(fmpz_poly_factor_t fac);

void fmpz_poly_factor_init2(fmpz_poly_factor_t fac, slong alloc);

void fmpz_poly_factor_realloc(fmpz_poly_factor_t fac, slong alloc);

void fmpz_poly_factor_fit_length(fmpz_poly_factor_t fac, slong len);

void fmpz_poly_factor_clear(fmpz_poly_factor_t fac);

void fmpz_poly_factor_set(fmpz_poly_factor_t res,
                                                 const fmpz_poly_factor_t fac);

void fmpz_poly_factor_insert(fmpz_poly_factor_t fac,
                             const fmpz_poly_t p, slong exp);

void fmpz_poly_factor_concat(fmpz_poly_factor_t res,
                             const fmpz_poly_factor_t fac);

void fmpz_poly_factor_print(const fmpz_poly_factor_t fac);

void fmpz_poly_factor_zassenhaus_recombination(
            fmpz_poly_factor_t final_fac, const fmpz_poly_factor_t lifted_fac,
                               const fmpz_poly_t F, const fmpz_t P, slong exp);

void fmpz_poly_factor_squarefree(fmpz_poly_factor_t fac,
                                                          const fmpz_poly_t F);

void fmpz_poly_factor_mignotte(fmpz_t B, const fmpz_poly_t f);

void _fmpz_poly_factor_zassenhaus(fmpz_poly_factor_t final_fac,
              slong exp, const fmpz_poly_t f, slong cutoff, int use_van_hoeij);

void fmpz_poly_factor_zassenhaus(fmpz_poly_factor_t fac,
                                                          const fmpz_poly_t G);

void _fmpz_poly_factor_quadratic(fmpz_poly_factor_t fac,
                                               const fmpz_poly_t f, slong exp);

void _fmpz_poly_factor_cubic(fmpz_poly_factor_t fac,
                                               const fmpz_poly_t f, slong exp);

slong _fmpz_poly_factor_CLD_mat(fmpz_mat_t res, const fmpz_poly_t f,
                             fmpz_poly_factor_t lifted_fac, fmpz_t P, ulong k);

int fmpz_poly_factor_van_hoeij_check_if_solved(fmpz_mat_t M,
          fmpz_poly_factor_t final_fac, fmpz_poly_factor_t lifted_fac,
                          const fmpz_poly_t f, fmpz_t P, slong exp, fmpz_t lc);

void fmpz_poly_factor_van_hoeij(fmpz_poly_factor_t final_fac,
        const nmod_poly_factor_t fac, const fmpz_poly_t f, slong exp, ulong p);

void fmpz_poly_factor(fmpz_poly_factor_t fac, const fmpz_poly_t G);

/* Inlines *******************************************************************/

void fmpz_poly_factor_get_fmpz_poly(fmpz_poly_t z, const fmpz_poly_factor_t F, slong i);
void fmpz_poly_factor_get_fmpz(fmpz_t z, const fmpz_poly_factor_t F);

/* zassenhaus ****************************************************************/

void zassenhaus_subset_first(slong * s, slong r, slong m);

int zassenhaus_subset_next(slong * s, slong r);

slong zassenhaus_subset_next_disjoint(slong * s, slong r);

typedef struct {
    slong deg;
    unsigned char * pos_degs;   /* possible degrees: entries are 0 or 1*/
    slong new_length;
    slong new_total;
    slong * new_degs;
    slong alloc;
} zassenhaus_prune_struct;

typedef zassenhaus_prune_struct zassenhaus_prune_t[1];

FMPZ_POLY_FACTOR_INLINE
void zassenhaus_prune_init(zassenhaus_prune_t Z)
{
    Z->deg = 0;
    Z->pos_degs = NULL;
    Z->new_length = 0;
    Z->new_total = 0;
    Z->new_degs = NULL;
    Z->alloc = 0;
}

void zassenhaus_prune_clear(zassenhaus_prune_t Z);

void zassenhaus_prune_set_degree(zassenhaus_prune_t Z, slong d);

FMPZ_POLY_FACTOR_INLINE
void zassenhaus_prune_start_add_factors(zassenhaus_prune_t Z)
{
    Z->new_length = 0;
    Z->new_total = 0;
}

void zassenhaus_prune_add_factor(zassenhaus_prune_t Z,
                                                         slong deg, slong exp);

void zassenhaus_prune_end_add_factors(zassenhaus_prune_t Z);

int zassenhaus_prune_must_be_irreducible(const zassenhaus_prune_t Z);

FMPZ_POLY_FACTOR_INLINE
int zassenhaus_prune_degree_is_possible(const zassenhaus_prune_t Z, slong d)
{
    if (d <= 0)
        return d == 0;

    if (d >= Z->deg)
        return d == Z->deg;

    return Z->pos_degs[d];
}

void fmpz_poly_factor_zassenhaus_recombination_with_prune(
            fmpz_poly_factor_t final_fac, const fmpz_poly_factor_t lifted_fac,
                                const fmpz_poly_t F, const fmpz_t P, slong exp,
                                                   const zassenhaus_prune_t Z);

#ifdef __cplusplus
}
#endif

#endif