source: git/kernel/GBEngine/kutil.h @ 7bb1ac

spielwiese
Last change on this file since 7bb1ac was 7bb1ac, checked in by Hans Schoenemann <hannes@…>, 8 years ago
chg: remove trailing spaces
  • Property mode set to 100644
File size: 31.7 KB
Line 
1#ifndef KUTIL_H
2#define KUTIL_H
3/****************************************
4*  Computer Algebra System SINGULAR     *
5****************************************/
6/*
7* ABSTRACT: kernel: utils for kStd
8*/
9
10
11#include <string.h>
12
13#include <omalloc/omalloc.h>
14#include <omalloc/omallocClass.h>
15#include <misc/mylimits.h>
16
17
18#include <kernel/polys.h>
19#include <polys/operations/pShallowCopyDelete.h>
20
21#include <kernel/structs.h>
22#include <kernel/GBEngine/kstd1.h>   /* for s_poly_proc_t */
23
24// define if tailrings should be used
25#define HAVE_TAIL_RING
26
27#if 1
28#define setmax 16
29#define setmaxL ((4096-12)/sizeof(LObject))
30#define setmaxLinc ((4096)/sizeof(LObject))
31
32#define setmaxT 64
33#define setmaxTinc 32
34#else
35#define setmax 16
36#define setmaxL 16
37#define setmaxLinc 16
38#define setmaxT 16
39#define setmaxTinc 16
40#endif
41
42// if you want std computations as in Singular version < 2:
43// This disables RedThrough, tailReductions against T (bba),
44// sets posInT = posInT15 (bba, strat->honey), and enables redFirst with LDeg
45// NOTE: can be achieved with option(oldStd)
46
47#undef NO_KINLINE
48#if !defined(KDEBUG) && !defined(NO_INLINE)
49#define KINLINE inline
50#else
51#define KINLINE
52#define NO_KINLINE 1
53#endif
54
55typedef int* intset;
56typedef int64  wlen_type;
57typedef wlen_type* wlen_set;
58
59typedef class sTObject TObject;
60typedef class sLObject LObject;
61typedef TObject * TSet;
62typedef LObject * LSet;
63
64typedef struct denominator_list_s denominator_list_s;
65typedef denominator_list_s *denominator_list;
66
67struct denominator_list_s{number n; denominator_list next;};
68extern denominator_list DENOMINATOR_LIST;
69
70class sTObject
71{
72public:
73  unsigned long sevSig;
74  poly sig;   // the signature of the element
75  poly p;       // Lm(p) \in currRing Tail(p) \in tailRing
76  poly t_p;     // t_p \in tailRing: as monomials Lm(t_p) == Lm(p)
77  poly max;     // p_GetMaxExpP(pNext(p))
78  ring tailRing;
79  long FDeg;    // pFDeg(p)
80  int ecart,
81    length,     // as of pLDeg
82    pLength,    // either == 0, or == pLength(p)
83    i_r;        // index of TObject in R set, or -1 if not in T
84  BOOLEAN is_normalized; // true, if pNorm was called on p, false otherwise
85  // used in incremental sba() with F5C:
86  // we know some of the redundant elements in
87  // strat->T beforehand, so we can just discard
88  // them and do not need to consider them in the
89  // interreduction process
90  BOOLEAN is_redundant;
91  // used in sba's sig-safe reduction:
92  // sometimes we already know that a reducer
93  // is sig-safe, so no need for a real
94  // sig-safeness check
95  BOOLEAN is_sigsafe;
96
97
98#ifdef HAVE_PLURAL
99  BOOLEAN is_special; // true, it is a new special S-poly (e.g. for SCA)
100#endif
101
102  // initialization
103  KINLINE void Init(ring r = currRing);
104  KINLINE sTObject(ring tailRing = currRing);
105  KINLINE sTObject(poly p, ring tailRing = currRing);
106  KINLINE sTObject(poly p, ring c_r, ring tailRing);
107  KINLINE sTObject(sTObject* T, int copy);
108
109  KINLINE void Set(ring r=currRing);
110  KINLINE void Set(poly p_in, ring r=currRing);
111  KINLINE void Set(poly p_in, ring c_r, ring t_r);
112
113  // Frees the polys of T
114  KINLINE void Delete();
115  // Sets polys to NULL
116  KINLINE void Clear();
117  // makes a copy of the poly of T
118  KINLINE void Copy();
119
120  // ring-dependent Lm access: these might result in allocation of monomials
121  KINLINE poly GetLmCurrRing();
122  KINLINE poly GetLmTailRing();
123  KINLINE poly GetLm(ring r);
124  // this returns Lm and ring r (preferably from tailRing), but does not
125  // allocate a new poly
126  KINLINE void GetLm(poly &p, ring &r) const;
127
128#ifdef OLIVER_PRIVAT_LT
129  // routines for calc. with rings
130  KINLINE poly GetLtCurrRing();
131  KINLINE poly GetLtTailRing();
132  KINLINE poly GetLt(ring r);
133  KINLINE void GetLt(poly &p, ring &r) const;
134#endif
135
136  KINLINE BOOLEAN IsNull() const;
137
138  KINLINE int GetpLength();
139
140  // makes sure that T.p exists
141  KINLINE void SetLmCurrRing();
142
143  // Iterations
144  // simply get the next monomial
145  KINLINE poly Next();
146  KINLINE void LmDeleteAndIter();
147
148  // deg stuff
149  // compute pTotalDegree
150  KINLINE long pTotalDeg() const;
151  // computes pFDeg
152  KINLINE long pFDeg() const;
153  // computes and sets FDeg
154  KINLINE long SetpFDeg();
155  // gets stored FDeg
156  KINLINE long GetpFDeg() const;
157
158  // computes pLDeg
159  KINLINE long pLDeg();
160  // sets length, FDeg, returns LDeg
161  KINLINE long SetDegStuffReturnLDeg();
162
163  // arithmetic
164  KINLINE void Mult_nn(number n);
165  KINLINE void ShallowCopyDelete(ring new_tailRing, omBin new_tailBin,
166                                 pShallowCopyDeleteProc p_shallow_copy_delete,
167                                 BOOLEAN set_max = TRUE);
168  // manipulations
169  KINLINE void pNorm();
170  KINLINE void pCleardenom();
171
172#ifdef KDEBUG
173  void wrp();
174#endif
175};
176
177extern int strat_nr;
178
179class sLObject : public sTObject
180{
181
182public:
183  unsigned long sev;
184  poly  p1,p2; /*- the pair p comes from,
185                 lm(pi) in currRing, tail(pi) in tailring -*/
186
187  poly  lcm;   /*- the lcm of p1,p2 -*/
188  kBucket_pt bucket;
189  int   i_r1, i_r2;
190  unsigned checked; // this is the index of S up to which
191                      // the corresponding LObject was already checked in
192                      // critical pair creation => when entering the
193                      // reduction process it is enough to start a second
194                      // rewritten criterion check from checked+1 onwards
195  BOOLEAN prod_crit;
196                      // NOTE: If prod_crit = TRUE then the corresponding pair is
197                      // detected by Buchberger's Product Criterion and can be
198                      // deleted
199
200  // initialization
201  KINLINE void Init(ring tailRing = currRing);
202  KINLINE sLObject(ring tailRing = currRing);
203  KINLINE sLObject(poly p, ring tailRing = currRing);
204  KINLINE sLObject(poly p, ring c_r, ring tailRing);
205
206  // Frees the polys of L
207  KINLINE void Delete();
208  KINLINE void Clear();
209
210  // Iterations
211  KINLINE void LmDeleteAndIter();
212  KINLINE poly LmExtractAndIter();
213
214  // spoly related things
215  // preparation for reduction if not spoly
216  KINLINE void PrepareRed(BOOLEAN use_bucket);
217  KINLINE void SetLmTail(poly lm, poly new_p, int length,
218                         int use_bucket, ring r);
219  KINLINE void Tail_Minus_mm_Mult_qq(poly m, poly qq, int lq, poly spNoether);
220  KINLINE void Tail_Mult_nn(number n);
221  // deletes bucket, makes sure that p and t_p exists
222  KINLINE poly GetP(omBin lmBin = NULL);
223  // similar, except that only t_p exists
224  KINLINE poly GetTP();
225
226  // does not delete bucket, just canonicalizes it
227  // returned poly is such that Lm(p) \in currRing, Tail(p) \in tailRing
228  KINLINE poly CanonicalizeP();
229
230  // makes a copy of the poly of L
231  KINLINE void Copy();
232
233  KINLINE int GetpLength();
234  KINLINE long pLDeg(BOOLEAN use_last);
235  KINLINE long pLDeg();
236  KINLINE int SetLength(BOOLEAN lengt_pLength = FALSE);
237  KINLINE long SetDegStuffReturnLDeg();
238  KINLINE long SetDegStuffReturnLDeg(BOOLEAN use_last);
239
240  // returns minimal component of p
241  KINLINE long MinComp();
242  // returns component of p
243  KINLINE long Comp();
244
245  KINLINE void ShallowCopyDelete(ring new_tailRing,
246                                 pShallowCopyDeleteProc p_shallow_copy_delete);
247
248  // sets sev
249  KINLINE void SetShortExpVector();
250
251  // enable assignment from TObject
252  KINLINE sLObject& operator=(const sTObject&);
253
254  // get T's corresponding to p1, p2: they might return NULL
255  KINLINE TObject* T_1(const skStrategy* strat);
256  KINLINE TObject* T_2(const skStrategy* strat);
257  KINLINE void     T_1_2(const skStrategy* strat,
258                         TObject* &T_1, TObject* &T_2);
259
260  // simplify coefficients
261  KINLINE void Normalize();
262  KINLINE void HeadNormalize();
263};
264
265
266extern int HCord;
267
268class skStrategy : public omallocClass
269{
270public:
271  kStrategy next;
272  int (*red)(LObject * L,kStrategy strat);
273  int (*red2)(LObject * L,kStrategy strat);
274  void (*initEcart)(TObject * L);
275  int (*posInT)(const TSet T,const int tl,LObject &h);
276  int (*posInLSba)(const LSet set, const int length,
277                LObject* L,const kStrategy strat);
278  int (*posInL)(const LSet set, const int length,
279                LObject* L,const kStrategy strat);
280  void (*enterS)(LObject &h, int pos,kStrategy strat, int atR/* =-1*/ );
281  void (*initEcartPair)(LObject * h, poly f, poly g, int ecartF, int ecartG);
282  int (*posInLOld)(const LSet Ls,const int Ll,
283                   LObject* Lo,const kStrategy strat);
284  void (*enterOnePair) (int i,poly p,int ecart, int isFromQ,kStrategy strat, int atR /*= -1*/);
285  void (*chainCrit) (poly p,int ecart,kStrategy strat);
286  BOOLEAN (*syzCrit) (poly sig, unsigned long not_sevSig, kStrategy strat);
287  BOOLEAN (*rewCrit1) (poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start /*= 0*/);
288  BOOLEAN (*rewCrit2) (poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start /*= 0*/);
289  BOOLEAN (*rewCrit3) (poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start /*= 0*/);
290  pFDegProc pOrigFDeg;
291  pLDegProc pOrigLDeg;
292  pFDegProc pOrigFDeg_TailRing;
293  pLDegProc pOrigLDeg_TailRing;
294  s_poly_proc_t s_poly;
295
296  LObject P;
297  ideal Shdl;
298  ideal D; /*V(S) is in D(D)*/
299  ideal M; /*set of minimal generators*/
300  polyset S;
301  polyset syz;
302  polyset sig;
303  intset ecartS;
304  intset fromS; // from which S[i] S[j] comes from
305                // this is important for signature-based
306                // algorithms
307  intset syzIdx;// index in the syz array at which the first
308                // syzygy of component i comes up
309                // important for signature-based algorithms
310  unsigned sbaOrder;
311  int currIdx;
312  int max_lower_index;
313  intset lenS;
314  wlen_set lenSw; /* for tgb.ccc */
315  intset fromQ;
316  unsigned long* sevS;
317  unsigned long* sevSyz;
318  unsigned long* sevSig;
319  unsigned long* sevT;
320  TSet T;
321  LSet L;
322  LSet    B;
323  poly    kHEdge;
324  poly    kNoether;
325  poly    t_kHEdge; // same polys in tailring
326  KINLINE poly    kNoetherTail();
327  poly    t_kNoether;
328  BOOLEAN * NotUsedAxis;
329  BOOLEAN * pairtest;/*used for enterOnePair*/
330  poly tail;
331  intvec * kModW;
332  intvec * kHomW;
333  // procedure for ShalloCopy from tailRing  to currRing
334  pShallowCopyDeleteProc p_shallow_copy_delete;
335  // pointers to Tobjects R[i] is ith Tobject which is generated
336  TObject**  R;
337  // S_2_R[i] yields Tobject which corresponds to S[i]
338  int*      S_2_R;
339  ring tailRing;
340  omBin lmBin;
341  omBin tailBin;
342  int nr;
343  int cp,c3;
344  int sl,mu;
345  int syzl,syzmax,syzidxmax;
346  int tl,tmax;
347  int Ll,Lmax;
348  int Bl,Bmax;
349  int ak,LazyDegree,LazyPass;
350  int syzComp;
351  int HCord;
352  int lastAxis;
353  int newIdeal;
354  int minim;
355  #ifdef HAVE_RINGS
356  bool sigdrop; //This is used to check sigdrop in sba over Z
357  int nrsyzcrit; // counts how many pairs are deleted by SyzCrit
358  int nrrewcrit; // counts how many pairs are deleted by FaugereRewCrit
359  int sbaEnterS; // sba over Z strategy: if sigdrop element has _*gen(sbaEnterS+1), then
360                 // add directly sbaEnterS elements into S
361  int blockred;  // counter for blocked reductions in redSig
362  int blockredmax;
363  #endif
364  #ifdef HAVE_SHIFTBBA
365  int lV;
366  int cv; // in shift bases: counting V criterion
367  #endif
368  BOOLEAN interpt;
369  BOOLEAN homog;
370#ifdef HAVE_PLURAL
371  BOOLEAN z2homog; // Z_2 - homogeneous input allows product criterion in commutative and SCA cases!
372#endif
373  BOOLEAN kHEdgeFound;
374  BOOLEAN honey,sugarCrit;
375  BOOLEAN Gebauer,noTailReduction;
376  BOOLEAN fromT;
377  BOOLEAN noetherSet;
378  BOOLEAN update;
379  BOOLEAN posInLOldFlag;
380  BOOLEAN use_buckets;
381  // if set, pLDeg(p, l) == (pFDeg(pLast(p), pLength)
382  BOOLEAN LDegLast;
383  // if set, then L.length == L.pLength
384  BOOLEAN length_pLength;
385  // if set, then posInL does not depend on L.length
386  BOOLEAN posInLDependsOnLength;
387  /*FALSE, if posInL == posInL10*/
388#ifdef HAVE_PLURAL
389  // set this flag to 1 to stop the product criteria
390  // use ALLOW_PROD_CRIT(strat) to test
391  BOOLEAN no_prod_crit;
392#define ALLOW_PROD_CRIT(A) (!(A)->no_prod_crit)
393#else
394#define ALLOW_PROD_CRIT(A) (1)
395#endif
396  char    redTailChange;
397  char    news;
398  char    newt;/*used for messageSets*/
399  char    noClearS;
400  char    completeReduce_retry;
401  char    overflow;
402
403  skStrategy();
404  ~skStrategy();
405
406  // return TObject corresponding to S[i]: assume that it exists
407  // i.e. no error checking is done
408  KINLINE TObject* S_2_T(int i);
409  // like S_2_T, except that NULL is returned if it can not be found
410  KINLINE TObject* s_2_t(int i);
411};
412
413void deleteHC(poly *p, int *e, int *l, kStrategy strat);
414void deleteHC(LObject* L, kStrategy strat, BOOLEAN fromNext = FALSE);
415void deleteInS (int i,kStrategy strat);
416void deleteInSSba (int i,kStrategy strat);
417void cleanT (kStrategy strat);
418static inline LSet initL (int nr=setmaxL)
419{ return (LSet)omAlloc(nr*sizeof(LObject)); }
420void deleteInL(LSet set, int *length, int j,kStrategy strat);
421void enterL (LSet *set,int *length, int *LSetmax, LObject p,int at);
422void enterSBba (LObject &p,int atS,kStrategy strat, int atR = -1);
423void enterSSba (LObject &p,int atS,kStrategy strat, int atR = -1);
424void initEcartPairBba (LObject* Lp,poly f,poly g,int ecartF,int ecartG);
425void initEcartPairMora (LObject* Lp,poly f,poly g,int ecartF,int ecartG);
426int posInS (const kStrategy strat, const int length, const poly p,
427            const int ecart_p);
428int posInSMonFirst (const kStrategy strat, const int length, const poly p,
429            const int ecart_p);
430int posInIdealMonFirst (const ideal F, const poly p,int start = 0,int end = -1);
431int posInT0 (const TSet set,const int length,LObject &p);
432int posInT1 (const TSet set,const int length,LObject &p);
433int posInT2 (const TSet set,const int length,LObject &p);
434int posInT11 (const TSet set,const int length,LObject &p);
435int posInTSig (const TSet set,const int length,LObject &p);
436int posInT110 (const TSet set,const int length,LObject &p);
437int posInT13 (const TSet set,const int length,LObject &p);
438int posInT15 (const TSet set,const int length,LObject &p);
439int posInT17 (const TSet set,const int length,LObject &p);
440int posInT17_c (const TSet set,const int length,LObject &p);
441int posInT19 (const TSet set,const int length,LObject &p);
442int posInT_EcartpLength(const TSet set,const int length,LObject &p);
443int posInT_EcartFDegpLength(const TSet set,const int length,LObject &p);
444int posInT_FDegpLength(const TSet set,const int length,LObject &p);
445int posInT_pLength(const TSet set,const int length,LObject &p);
446
447#ifdef HAVE_MORE_POS_IN_T
448int posInT_EcartFDegpLength(const TSet set,const int length,LObject &p);
449int posInT_FDegpLength(const TSet set,const int length,LObject &p);
450int posInT_pLength(const TSet set,const int length,LObject &p);
451#endif
452
453
454void reorderS (int* suc,kStrategy strat);
455int posInLF5C (const LSet set, const int length,
456               LObject* L,const kStrategy strat);
457int posInLSig (const LSet set, const int length,
458               LObject* L,const kStrategy strat);
459int posInLSigRing (const LSet set, const int length,
460               LObject* L,const kStrategy strat);
461int posInLRing (const LSet set, const int length,
462               LObject* L,const kStrategy strat);
463int posInSyz (const kStrategy strat, const poly sig);
464int posInL0 (const LSet set, const int length,
465             LObject* L,const kStrategy strat);
466int posInL11 (const LSet set, const int length,
467             LObject* L,const kStrategy strat);
468int posInL11Ring (const LSet set, const int length,
469             LObject* L,const kStrategy strat);
470int posInLF5CRing (const LSet set, int start , const int length,
471             LObject* L,const kStrategy strat);
472int posInL11Ringls (const LSet set, const int length,
473             LObject* L,const kStrategy strat);
474int posInL13 (const LSet set, const int length,
475             LObject* L,const kStrategy strat);
476int posInL15 (const LSet set, const int length,
477             LObject* L,const kStrategy strat);
478int posInL15Ring (const LSet set, const int length,
479             LObject* L,const kStrategy strat);
480int posInL17 (const LSet set, const int length,
481             LObject* L,const kStrategy strat);
482int posInL10 (const LSet set, const int length,
483             LObject* L,const kStrategy strat);
484int posInL10Ring (const LSet set, const int length,
485             LObject* L,const kStrategy strat);
486int posInL110 (const LSet set, const int length,
487             LObject* L,const kStrategy strat);
488KINLINE poly redtailBba (poly p,int pos,kStrategy strat,BOOLEAN normalize=FALSE);
489KINLINE poly redtailBbaBound (poly p,int pos,kStrategy strat,int bound,BOOLEAN normalize=FALSE);
490#ifdef HAVE_RINGS
491KINLINE poly redtailBba_Z (poly p,int pos,kStrategy strat);
492poly redtailBba_Z (LObject* L, int pos, kStrategy strat );
493#endif
494poly redtailBba (LObject *L, int pos,kStrategy strat,
495                 BOOLEAN withT = FALSE,BOOLEAN normalize=FALSE);
496poly redtailBbaBound (LObject *L, int pos,kStrategy strat,int bound,
497                 BOOLEAN withT = FALSE,BOOLEAN normalize=FALSE);
498poly redtailSba (LObject *L, int pos,kStrategy strat,
499                 BOOLEAN withT = FALSE,BOOLEAN normalize=FALSE);
500poly redtailBba (TObject *T, int pos,kStrategy strat);
501poly redtail (poly p,int pos,kStrategy strat);
502poly redtail (LObject *L,int pos,kStrategy strat);
503poly redNF (poly h,int & max_ind,int nonorm,kStrategy strat);
504int redNF0 (LObject *P,kStrategy strat);
505poly redNFTail (poly h,const int sl,kStrategy strat);
506int redHoney (LObject* h, kStrategy strat);
507#ifdef HAVE_RINGS
508int redRing (LObject* h,kStrategy strat);
509int redRiloc (LObject* h,kStrategy strat);
510void enterExtendedSpoly(poly h,kStrategy strat);
511void enterExtendedSpolySig(poly h,poly hSig,kStrategy strat);
512void superenterpairs (poly h,int k,int ecart,int pos,kStrategy strat, int atR = -1);
513void superenterpairsSig (poly h,poly hSig,int hFrom,int k,int ecart,int pos,kStrategy strat, int atR = -1);
514poly kCreateZeroPoly(long exp[], long cabsind, poly* t_p, ring leadRing, ring tailRing);
515long ind2(long arg);
516
517long ind_fact_2(long arg);
518long twoPow(long arg);
519ideal createG0();
520#endif
521int redLazy (LObject* h,kStrategy strat);
522int redHomog (LObject* h,kStrategy strat);
523int redSig (LObject* h,kStrategy strat);
524int redSigRing (LObject* h,kStrategy strat);
525//adds hSig to be able to check with F5's criteria when entering pairs!
526void enterpairsSig (poly h, poly hSig, int from, int k, int ec, int pos,kStrategy strat, int atR = -1);
527void enterpairs (poly h, int k, int ec, int pos,kStrategy strat, int atR = -1);
528void entersets (LObject h);
529void pairs ();
530BOOLEAN enterOneStrongPoly (int i,poly p,int /*ecart*/, int /*isFromQ*/,kStrategy strat, int atR = -1, bool enterTstrong = FALSE);
531BOOLEAN sbaCheckGcdPair (LObject* h,kStrategy strat);
532BOOLEAN enterOneStrongPolySig (int i,poly p,poly sig,int /*ecart*/, int /*isFromQ*/,kStrategy strat, int atR = -1);
533void message (int i,int* reduc,int* olddeg,kStrategy strat,int red_result);
534void messageStat (int hilbcount,kStrategy strat);
535void messageStatSBA (int hilbcount,kStrategy strat);
536#ifdef KDEBUG
537void messageSets (kStrategy strat);
538#else
539#define messageSets(s)  do {} while (0)
540#endif
541
542void initEcartNormal (TObject* h);
543void initEcartBBA (TObject* h);
544void initS (ideal F, ideal Q,kStrategy strat);
545void initSL (ideal F, ideal Q,kStrategy strat);
546void initSLSba (ideal F, ideal Q,kStrategy strat);
547/*************************************************
548 * when initializing a new bunch of principal
549 * syzygies at the beginning of a new iteration
550 * step in a signature-based algorithm we
551 * compute ONLY the leading elements of those
552 * syzygies, NOT the whole syzygy
553 * NOTE: this needs to be adjusted for a more
554 * general approach on signature-based algorithms
555 ***********************************************/
556void initSyzRules (kStrategy strat);
557void updateS(BOOLEAN toT,kStrategy strat);
558void enterSyz (LObject &p,kStrategy strat, int atT);
559void enterT (LObject &p,kStrategy strat, int atT = -1);
560#ifdef HAVE_RINGS
561void enterT_strong (LObject &p,kStrategy strat, int atT = -1);
562#endif
563void cancelunit (LObject* p,BOOLEAN inNF=FALSE);
564void HEckeTest (poly pp,kStrategy strat);
565void initBuchMoraCrit(kStrategy strat);
566void initSbaCrit(kStrategy strat);
567void initHilbCrit(ideal F, ideal Q, intvec **hilb,kStrategy strat);
568void initBuchMoraPos(kStrategy strat);
569void initBuchMoraPosRing(kStrategy strat);
570void initSbaPos(kStrategy strat);
571void initBuchMora (ideal F, ideal Q,kStrategy strat);
572void initSbaBuchMora (ideal F, ideal Q,kStrategy strat);
573void exitBuchMora (kStrategy strat);
574void exitSba (kStrategy strat);
575void updateResult(ideal r,ideal Q,kStrategy strat);
576void completeReduce (kStrategy strat, BOOLEAN withT=FALSE);
577void kFreeStrat(kStrategy strat);
578void enterOnePairNormal (int i,poly p,int ecart, int isFromQ,kStrategy strat, int atR);
579void enterOnePairLift (int i,poly p,int ecart, int isFromQ,kStrategy strat, int atR);
580void enterOnePairSig (int i,poly p,poly pSig,int ecart, int isFromQ,kStrategy strat, int atR);
581void enterOnePairSigRing (int i,poly p,poly pSig,int ecart, int isFromQ,kStrategy strat, int atR);
582void chainCritNormal (poly p,int ecart,kStrategy strat);
583void chainCritOpt_1 (poly,int,kStrategy strat);
584void chainCritSig (poly p,int ecart,kStrategy strat);
585BOOLEAN homogTest(polyset F, int Fmax);
586BOOLEAN newHEdge(kStrategy strat);
587BOOLEAN syzCriterion(poly sig, unsigned long not_sevSig, kStrategy strat);
588BOOLEAN syzCriterionInc(poly sig, unsigned long not_sevSig, kStrategy strat);
589KINLINE BOOLEAN arriRewDummy(poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start);
590BOOLEAN arriRewCriterion(poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start);
591BOOLEAN arriRewCriterionPre(poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start);
592BOOLEAN faugereRewCriterion(poly sig, unsigned long not_sevSig, poly lm, kStrategy strat, int start);
593BOOLEAN findMinLMPair(poly sig, unsigned long not_sevSig, kStrategy strat, int start);
594
595/// returns index of p in TSet, or -1 if not found
596int kFindInT(poly p, TSet T, int tlength);
597
598/// return -1 if no divisor is found
599///        number of first divisor in T, otherwise
600int kFindDivisibleByInT(const kStrategy strat, const LObject* L, const int start=0);
601
602/// return -1 if no divisor is found
603///        number of first divisor in S, otherwise
604int kFindDivisibleByInS(const kStrategy strat, int *max_ind, LObject* L);
605
606int kFindNextDivisibleByInS(const kStrategy strat, int start,int max_ind, LObject* L);
607TObject*
608kFindDivisibleByInS(kStrategy strat, int pos, LObject* L, TObject *T,
609                    long ecart = LONG_MAX);
610
611/***************************************************************
612 *
613 * stuff to be inlined
614 *
615 ***************************************************************/
616
617KINLINE TSet initT ();
618KINLINE TObject** initR();
619KINLINE unsigned long* initsevT();
620KINLINE poly k_LmInit_currRing_2_tailRing(poly p, ring tailRing, omBin bin);
621KINLINE poly k_LmInit_tailRing_2_currRing(poly p, ring tailRing, omBin bin);
622KINLINE poly k_LmShallowCopyDelete_currRing_2_tailRing(poly p, ring tailRing, omBin bin);
623KINLINE poly k_LmShallowCopyDelete_tailRing_2_currRing(poly p, ring tailRing,  omBin bin);
624
625KINLINE poly k_LmInit_currRing_2_tailRing(poly p, ring tailRing);
626KINLINE poly k_LmInit_tailRing_2_currRing(poly p, ring tailRing);
627KINLINE poly k_LmShallowCopyDelete_currRing_2_tailRing(poly p, ring tailRing);
628KINLINE poly k_LmShallowCopyDelete_tailRing_2_currRing(poly p, ring tailRing);
629
630// if exp bound is not violated, return TRUE and
631//                               get m1 = LCM(LM(p1), LM(p2))/LM(p1)
632//                                   m2 = LCM(LM(p1), LM(p2))/LM(p2)
633// return FALSE and m1 == NULL, m2 == NULL     , otherwise
634KINLINE BOOLEAN k_GetLeadTerms(const poly p1, const poly p2, const ring p_r,
635                               poly &m1, poly &m2, const ring m_r);
636#ifdef HAVE_RINGS
637KINLINE void k_GetStrongLeadTerms(const poly p1, const poly p2, const ring leadRing,
638                               poly &m1, poly &m2, poly &lcm, const ring taiRing);
639#endif
640#ifdef KDEBUG
641// test strat
642BOOLEAN kTest(kStrategy strat);
643// test strat, and test that S is contained in T
644BOOLEAN kTest_TS(kStrategy strat);
645// test LObject
646BOOLEAN kTest_L(LObject* L, ring tailRing = NULL,
647                 BOOLEAN testp = FALSE, int lpos = -1,
648                 TSet T = NULL, int tlength = -1);
649// test TObject
650BOOLEAN kTest_T(TObject* T, ring tailRing = NULL, int tpos = -1, char TN = '?');
651// test set strat->SevS
652BOOLEAN kTest_S(kStrategy strat);
653#else
654#define kTest(A)        (TRUE)
655#define kTest_TS(A)     (TRUE)
656#define kTest_T(T)      (TRUE)
657#define kTest_S(T)      (TRUE)
658#define kTest_L(T)      (TRUE)
659#endif
660
661
662/***************************************************************
663 *
664 * From kstd2.cc
665 *
666 ***************************************************************/
667poly kFindZeroPoly(poly input_p, ring leadRing, ring tailRing);
668ideal bba (ideal F, ideal Q,intvec *w,intvec *hilb,kStrategy strat);
669ideal sba (ideal F, ideal Q,intvec *w,intvec *hilb,kStrategy strat);
670poly kNF2 (ideal F, ideal Q, poly q, kStrategy strat, int lazyReduce);
671ideal kNF2 (ideal F,ideal Q,ideal q, kStrategy strat, int lazyReduce);
672poly kNF2Bound (ideal F, ideal Q, poly q,int bound, kStrategy strat, int lazyReduce);
673ideal kNF2Bound (ideal F,ideal Q,ideal q,int bound, kStrategy strat, int lazyReduce);
674void initBba(kStrategy strat);
675void initSba(ideal F,kStrategy strat);
676void f5c (kStrategy strat, int& olddeg, int& minimcnt, int& hilbeledeg,
677          int& hilbcount, int& srmax, int& lrmax, int& reduc, ideal Q,
678          intvec *w,intvec *hilb );
679
680/***************************************************************
681 *
682 * From kspoly.cc
683 *
684 ***************************************************************/
685// Reduces PR with PW
686// Assumes PR != NULL, PW != NULL, Lm(PW) divides Lm(PR)
687// Changes: PR
688// Const:   PW
689// If coef != NULL, then *coef is a/gcd(a,b), where a = LC(PR), b = LC(PW)
690// If strat != NULL, tailRing is changed if reduction would violate exp bound
691// of tailRing
692// Returns: 0 everything ok, no tailRing change
693//          1 tailRing has successfully changed (strat != NULL)
694//          2 no reduction performed, tailRing needs to be changed first
695//            (strat == NULL)
696//         -1 tailRing change could not be performed due to exceeding exp
697//            bound of currRing
698int ksReducePoly(LObject* PR,
699                 TObject* PW,
700                 poly spNoether = NULL,
701                 number *coef = NULL,
702                 kStrategy strat = NULL);
703
704int ksReducePolyBound(LObject* PR,
705                 TObject* PW,
706                 int bound,
707                 poly spNoether = NULL,
708                 number *coef = NULL,
709                 kStrategy strat = NULL);
710
711// Reduces PR with PW
712// Assumes PR != NULL, PW != NULL, Lm(PW) divides Lm(PR)
713// Changes: PR
714// Const:   PW
715// If coef != NULL, then *coef is a/gcd(a,b), where a = LC(PR), b = LC(PW)
716// If strat != NULL, tailRing is changed if reduction would violate exp bound
717// of tailRing
718// Returns: 0 everything ok, no tailRing change
719//          1 tailRing has successfully changed (strat != NULL)
720//          2 no reduction performed, tailRing needs to be changed first
721//            (strat == NULL)
722//          3 no reduction performed, not sig-safe!!!
723//         -1 tailRing change could not be performed due to exceeding exp
724//            bound of currRing
725int ksReducePolySig(LObject* PR,
726                 TObject* PW,
727                 long idx,
728                 poly spNoether = NULL,
729                 number *coef = NULL,
730                 kStrategy strat = NULL);
731
732int ksReducePolySigRing(LObject* PR,
733                 TObject* PW,
734                 long idx,
735                 poly spNoether = NULL,
736                 number *coef = NULL,
737                 kStrategy strat = NULL);
738
739// Reduces PR at Current->next with PW
740// Assumes PR != NULL, Current contained in PR
741//         Current->next != NULL, LM(PW) devides LM(Current->next)
742// Changes: PR
743// Const:   PW
744// Return: see ksReducePoly
745int ksReducePolyTail(LObject* PR,
746                     TObject* PW,
747                     poly Current,
748                     poly spNoether = NULL);
749
750KINLINE int ksReducePolyTail(LObject* PR, TObject* PW, LObject* Red);
751
752// Creates S-Poly of Pair
753// Const:   Pair->p1, Pair->p2
754// Changes: Pair->p == S-Poly of p1, p2
755// Assume:  Pair->p1 != NULL && Pair->p2
756void ksCreateSpoly(LObject* Pair, poly spNoether = NULL,
757                   int use_buckets=0, ring tailRing=currRing,
758                   poly m1 = NULL, poly m2 = NULL, TObject** R = NULL);
759
760/*2
761* creates the leading term of the S-polynomial of p1 and p2
762* do not destroy p1 and p2
763* remarks:
764*   1. the coefficient is 0 (nNew)
765*   2. pNext is undefined
766*/
767poly ksCreateShortSpoly(poly p1, poly p2, ring tailRing);
768
769
770// old stuff
771KINLINE poly ksOldSpolyRed(poly p1, poly p2, poly spNoether = NULL);
772KINLINE poly ksOldSpolyRedNew(poly p1, poly p2, poly spNoether = NULL);
773KINLINE poly ksOldCreateSpoly(poly p1, poly p2, poly spNoether = NULL, ring r = currRing);
774KINLINE void ksOldSpolyTail(poly p1, poly q, poly q2, poly spNoether, ring r = currRing);
775
776/***************************************************************
777 *
778 * Routines related for ring changes during std computations
779 *
780 ***************************************************************/
781// return TRUE and set m1, m2 to k_GetLcmTerms,
782//             if spoly creation of strat->P does not violate
783//             exponent bound of strat->tailRing
784//      FALSE, otherwise
785BOOLEAN kCheckSpolyCreation(LObject* L, kStrategy strat, poly &m1, poly &m2);
786#ifdef HAVE_RINGS
787// return TRUE if gcdpoly creation of R[atR] and S[atS] does not violate
788//             exponent bound of strat->tailRing
789//      FALSE, otherwise
790BOOLEAN kCheckStrongCreation(int atR, poly m1, int atS, poly m2, kStrategy strat);
791poly preIntegerCheck(ideal F, ideal Q);
792void postReduceByMon(LObject* h, kStrategy strat);
793void postReduceByMonSig(LObject* h, kStrategy strat);
794void finalReduceByMon(kStrategy strat);
795#endif
796// change strat->tailRing and adjust all data in strat, L, and T:
797// new tailRing has larger exponent bound
798// do nothing and return FALSE if exponent bound increase would result in
799// larger exponent bound that that of currRing
800BOOLEAN kStratChangeTailRing(kStrategy strat,
801                             LObject* L = NULL, TObject* T = NULL,
802                             // take this as new_expbound: if 0
803                             // new expbound is 2*expbound of tailRing
804                             unsigned long new_expbound = 0);
805// initiate a change of the tailRing of strat -- should be called
806// right before main loop in bba
807void kStratInitChangeTailRing(kStrategy strat);
808
809/// Output some debug info about a given strategy
810void kDebugPrint(kStrategy strat);
811
812// getting sb order for sba computations
813ring sbaRing(kStrategy strat, const ring r=currRing, BOOLEAN complete=TRUE, int sgn=1);
814
815KINLINE void clearS (poly p, unsigned long p_sev, int* at, int* k,
816  kStrategy strat);
817
818#include <kernel/GBEngine/kInline.h>
819
820/* shiftgb stuff */
821#include <kernel/GBEngine/shiftgb.h>
822
823poly pMove2CurrTail(poly p, kStrategy strat);
824
825poly pMoveCurrTail2poly(poly p, kStrategy strat);
826
827poly pCopyL2p(LObject h, kStrategy strat);
828
829void enterTShift(LObject p, kStrategy strat, int atT, int uptodeg, int lV);
830
831void initBuchMoraShift (ideal F,ideal Q,kStrategy strat);
832
833void enterOnePairManyShifts (int i, poly p, int ecart, int isFromQ, kStrategy strat, int atR, int uptodeg, int lV); // ok
834
835void enterOnePairSelfShifts (poly qq, poly p, int ecart, int isFromQ, kStrategy strat, int atR, int uptodeg, int lV);
836
837void enterOnePairShift (poly q, poly p, int ecart, int isFromQ, kStrategy strat, int atR, int ecartq, int qisFromQ, int shiftcount, int ifromS, int uptodeg, int lV); // ok
838
839void enterpairsShift (poly h,int k,int ecart,int pos,kStrategy strat, int atR,int uptodeg, int lV);
840
841void initenterpairsShift (poly h,int k,int ecart,int isFromQ,kStrategy strat, int atR,int uptodeg, int lV);
842
843void updateSShift(kStrategy strat,int uptodeg,int lV);
844
845void initBbaShift(kStrategy strat);
846
847poly redtailBbaShift (LObject* L, int pos, kStrategy strat, BOOLEAN withT, BOOLEAN normalize);
848
849int redFirstShift (LObject* h,kStrategy strat); // ok
850
851ideal freegb(ideal I, int uptodeg, int lVblock);
852
853ideal bbaShift(ideal F, ideal Q,intvec *w,intvec *hilb,kStrategy strat, int uptodeg, int lV);
854// test syz strategy: // will be removed soon
855extern  int (*test_PosInT)(const TSet T,const int tl,LObject &h);
856extern  int (*test_PosInL)(const LSet set, const int length,
857                LObject* L,const kStrategy strat);
858#endif
Note: See TracBrowser for help on using the repository browser.