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 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505
|
{\subsection{gfan\_bases}\label{applist:_bases}
This is a program for computing all reduced Gr\"obner bases of a polynomial ideal. It takes the ring and a generating set for the ideal as input. By default the enumeration is done by an almost memoryless reverse search. If the ideal is symmetric the symmetry option is useful and enumeration will be done up to symmetry using a breadth first search. The program needs a starting Gr\"obner basis to do its computations. If the -g option is not specified it will compute one using Buchberger's algorithm.
\newline
{\bf Options:}
\begin{description}
\item[-g]Tells the program that the input is already a Gr\"obner basis (with the initial term of each polynomial being the first ones listed). Use this option if it takes too much time to compute the starting (standard degree lexicographic) Gr\"obner basis and the input is already a Gr\"obner basis.
\item[-\hspace{0.013cm}-symmetry]Tells the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the ideal. The program checks that the ideal stays fixed when permuting the variables with respect to elements in the group. The program uses breadth first search to compute the set of reduced Gr\"obner bases up to symmetry with respect to the specified subgroup.
\item[-e]Echo. Output the generators for the symmetry group.
\item[-\hspace{0.013cm}-disableSymmetryTest]When using -\hspace{0.013cm}-symmetry this option will disable the check that the group read off from the input actually is a symmetry group with respect to the input ideal.
\item[-\hspace{0.013cm}-parameters value]With this option you can specify how many variables to treat as parameters instead of variables. This makes it possible to do computations where the coefficient field is the field of rational functions in the parameters.\item[-\hspace{0.013cm}-interrupt value]Interrupt the enumeration after a specified number of facets have been computed (works for usual symmetric traversals, but may not work in general for non-symmetric traversals or for traversals restricted to fans).\end{description}
{\subsection{gfan\_buchberger}\label{applist:_buchberger}
This program computes a reduced lexicographic Gr\"obner basis of the polynomial ideal given as input. The default behavior is to use Buchberger's algorithm. The ordering of the variables is $a>b>c...$ (assuming that the ring is Q[a,b,c,...]).
\newline
{\bf Options:}
\begin{description}
\item[-w]Compute a Gr\"obner basis with respect to a degree lexicographic order with $a>b>c...$ instead. The degrees are given by a weight vector which is read from the input after the generating set has been read.
\item[-r]Use the reverse lexicographic order (or the reverse lexicographic order as a tie breaker if -w is used). The input must be homogeneous if the pure reverse lexicographic order is chosen. Ignored if -W is used.
\item[-W]Do a Gr\"obner walk. The input must be a minimal Gr\"obner basis. If -W is used -w is ignored.
\item[-g]Do a generic Gr\"obner walk. The input must be homogeneous and must be a minimal Gr\"obner basis with respect to the reverse lexicographic term order. The target term order is always lexicographic. The -W option must be used.
\item[-\hspace{0.013cm}-parameters value]With this option you can specify how many variables to treat as parameters instead of variables. This makes it possible to do computations where the coefficient field is the field of rational functions in the parameters.\end{description}
{\subsection{gfan\_combinerays}\label{applist:_combinerays}
This program combines rays from the specified polymake file by adding according to a list of vectors of indices given on the standard input.
\newline
{\bf Options:}
\begin{description}
\item[-i value]Specify the name of the input file.\item[-\hspace{0.013cm}-section value]Specify a section of the polymake file to use as input, rather than standard input.\end{description}
{\subsection{gfan\_doesidealcontain}\label{applist:_doesidealcontain}
This program takes a marked Gr\"obner basis of an ideal I and a set of polynomials on its input and tests if the polynomial set is contained in I by applying the division algorithm for each element. The output is 1 for true and 0 for false.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-remainder]Tell the program to output the remainders of the divisions rather than outputting 0 or 1.\item[-\hspace{0.013cm}-multiplier]Reads in a polynomial that will be multiplied to the polynomial to be divided before doing the division.\end{description}
{\subsection{gfan\_fancommonrefinement}\label{applist:_fancommonrefinement}
This program takes two polyhedral fans and computes their common refinement.
\newline
{\bf Options:}
\begin{description}
\item[-i1 value]Specify the name of the first input file.\item[-i2 value]Specify the name of the second input file.\item[-\hspace{0.013cm}-stable]Compute the stable intersection.\end{description}
{\subsection{gfan\_fanhomology}\label{applist:_fanhomology}
This program takes a polyhedral fan and computes its reduced homology groups. Of course the support of a fan is contractible, so what is really computed is the reduced homology groups of the support of the fan after quotienting out with the lineality space and intersecting with a sphere. Notice that taking the quotient with the lineality space results in an inverted suspension which just results in a shift of the reduced homology groups.
\newline
{\bf Options:}
\begin{description}
\item[-i value]Specify the name of the input file.\item[-\hspace{0.013cm}-no-optimize]Disable preprocessing of boundary maps before doing lattice computations.\end{description}
{\subsection{gfan\_fanisbalanced}\label{applist:_fanisbalanced}
This program checks if a fan is balanced
\newline
{\bf Options:}
\begin{description}
\item[-i value]Specify the name of the input file.\item[-\hspace{0.013cm}-makeBalanced]Assign positive multiplicities to cones to make the fan balanced instead. Fan is assumed to be pure.\item[-\hspace{0.013cm}-facetComplex]When making the fan balanced, first take facet complex\item[-\hspace{0.013cm}-cone]Output cone of all balanced weight functions.\end{description}
{\subsection{gfan\_fanlink}\label{applist:_fanlink}
This program takes a polyhedral fan and a vector and computes the link of the polyhedral fan around that vertex. The link will have lineality space dimension equal to the dimension of the relative open polyhedral cone of the original fan containing the vector.
\newline
{\bf Options:}
\begin{description}
\item[-i value]Specify the name of the input file.\item[-\hspace{0.013cm}-symmetry]Reads in a fan stored with symmetry. The generators of the symmetry group must be given on the standard input.
\item[-\hspace{0.013cm}-star]Computes the star instead. The star is defined as the smallest polyhedral fan containing all cones of the original fan containing the vector.\end{description}
{\subsection{gfan\_fanproduct}\label{applist:_fanproduct}
This program takes two polyhedral fans and computes their product.
\newline
{\bf Options:}
\begin{description}
\item[-i1 value]Specify the name of the first input file.\item[-i2 value]Specify the name of the second input file.\end{description}
{\subsection{gfan\_fansubfan}\label{applist:_fansubfan}
This program takes a polyhedral fan and a list of vectors and computes the smallest subfan of the fan having the list of vectors in its support.
\newline
{\bf Options:}
\begin{description}
\item[-i value]Specify the name of the input file.\item[-\hspace{0.013cm}-symmetry]Reads in the cone stored with symmetry. The generators of the symmetry group must be given on the standard input.
\end{description}
{\subsection{gfan\_genericlinearchange}\label{applist:_genericlinearchange}
This program takes a list of polynomials and performs a generic linear change of coordinates by introducing nxn new variables.
{\subsection{gfan\_groebnercone}\label{applist:_groebnercone}
This program computes a Gr\"obner cone. Three different cases are handled. The input may be a marked reduced Gr\"obner basis in which case its Gr\"obner cone is computed. The input may be just a marked minimal basis in which case the cone computed is not a Gr\"obner cone in the usual sense but smaller. (These cones are described in [Fukuda, Jensen, Lauritzen, Thomas]). The third possible case is that the Gr\"obner cone is possibly lower dimensional and given by a pair of Gr\"obner bases as it is useful to do for tropical varieties, see option -\hspace{0.013cm}-pair. The facets of the cone can be read off in section FACETS and the equations in section IMPLIED\_EQUATIONS.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-restrict]Add an inequality for each coordinate, so that the the cone is restricted to the non-negative orthant.\item[-\hspace{0.013cm}-pair]The Gr\"obner cone is given by a pair of compatible Gr\"obner bases. The first basis is for the initial ideal and the second for the ideal itself. See the tropical section of the manual.\item[-\hspace{0.013cm}-asfan]Writes the cone as a polyhedral fan with all its faces instead. In this way the extreme rays of the cone are also computed.\item[-\hspace{0.013cm}-vectorinput]Compute a cone given list of inequalities rather than a Gr\"obner cone. The input is an integer which specifies the dimension of the ambient space, a list of inequalities given as vectors and a list of equations.\end{description}
{\subsection{gfan\_groebnerfan}\label{applist:_groebnerfan}
This is a program for computing the Gr\"obner fan of a polynomial ideal as a polyhedral complex. It takes a generating set for the ideal as input. If the ideal is symmetric the symmetry option is useful and enumeration will be done up to symmetry. The program needs a starting Gr\"obner basis to do its computations. If the -g option is not specified it will compute one using Buchberger's algorithm.
\newline
{\bf Options:}
\begin{description}
\item[-g]Tells the program that the input is already a Gr\"obner basis (with the initial term of each polynomial being the first ones listed). Use this option if it takes too much time to compute the starting (standard degree lexicographic) Gr\"obner basis and the input is already a Gr\"obner basis.
\item[-\hspace{0.013cm}-symmetry]Tells the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the ideal. The program checks that the ideal stays fixed when permuting the variables with respect to elements in the group. The program uses breadth first search to compute the set of reduced Gr\"obner bases up to symmetry with respect to the specified subgroup.
\item[-\hspace{0.013cm}-disableSymmetryTest]When using -\hspace{0.013cm}-symmetry this option will disable the check that the group read off from the input actually is a symmetry group with respect to the input ideal.
\item[-\hspace{0.013cm}-restrictingfan value]Specify the name of a file containing a polyhedral fan in Polymake format. The computation of the Gr\"obner fan will be restricted to this fan. If the -\hspace{0.013cm}-symmetry option is used then this restricting fan must be invariant under the symmetry and the orbits in the file must be with respect to the specified group of symmetries. The orbits of maximal cones of the file are then read in rather than the maximal cones.
\item[-\hspace{0.013cm}-parameters value]With this option you can specify how many variables to treat as parameters instead of variables. This makes it possible to do computations where the coefficient field is the field of rational functions in the parameters.\item[-\hspace{0.013cm}-nocones]Tells the program not to output the CONES and MAXIMAL\_CONES sections, but still output CONES\_COMPRESSED and MAXIMAL\_CONES\_COMPRESSED if -\hspace{0.013cm}-symmetry is used.\item[-\hspace{0.013cm}-interrupt value]Interrupt the enumeration after a specified number of facets have been computed (works for usual symmetric traversals, but may not work in general for non-symmetric traversals or for traversals restricted to fans).\end{description}
{\subsection{gfan\_homogeneityspace}\label{applist:_homogeneityspace}
This program computes the homogeneity space of a list of polynomials - as a cone. Thus generators for the homogeneity space are found in the section LINEALITY\_SPACE. If you wish the homogeneity space of an ideal you should first compute a set of homogeneous generators and call the program on these. A reduced Gr\"obner basis will always suffice for this purpose.
{\subsection{gfan\_homogenize}\label{applist:_homogenize}
This program homogenises a list of polynomials by introducing an extra variable. The name of the variable to be introduced is read from the input after the list of polynomials. Without the -w option the homogenisation is done with respect to total degree.
Example:
Input:
Q[x,y]\{y-1\}
z
Output:
Q[x,y,z]\{y-z\}
\newline
{\bf Options:}
\begin{description}
\item[-i]Treat input as an ideal. This will make the program compute the homogenisation of the input ideal. This is done by computing a degree Gr\"obner basis and homogenising it.\item[-w]Specify a homogenisation vector. The length of the vector must be the same as the number of variables in the ring. The vector is read from the input after the list of polynomials.
\item[-H]Let the name of the new variable be H rather than reading in a name from the input.\end{description}
{\subsection{gfan\_initialforms}\label{applist:_initialforms}
This program converts a list of polynomials to a list of their initial forms with respect to the vector given after the list.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-ideal]Treat input as an ideal. This will make the program compute the initial ideal of the ideal generated by the input polynomials. The computation is done by computing a Gr\"obner basis with respect to the given vector. The vector must be positive or the input polynomials must be homogeneous in a positive grading. None of these conditions are checked by the program.
\item[-\hspace{0.013cm}-pair]Produce a pair of polynomial lists. Used together with -\hspace{0.013cm}-ideal this option will also write a compatible reduced Gr\"obner basis for the input ideal to the output. This is useful for finding the Gr\"obner cone of a non-monomial initial ideal.
\item[-\hspace{0.013cm}-mark]If the -\hspace{0.013cm}-pair option is and the -\hspace{0.013cm}-ideal option is not used this option will still make sure that the second output basis is marked consistently with the vector.\item[-\hspace{0.013cm}-list]Read in a list of vectors instead of a single vector and produce a list of polynomial sets as output.\end{description}
{\subsection{gfan\_interactive}\label{applist:_interactive}
This is a program for doing interactive walks in the Gr\"obner fan of an ideal. The input is a Gr\"obner basis defining the starting Gr\"obner cone of the walk. The program will list all flippable facets of the Gr\"obner cone and ask the user to choose one. The user types in the index (number) of the facet in the list. The program will walk through the selected facet and display the new Gr\"obner basis and a list of new facet normals for the user to choose from. Since the program reads the user's choices through the the standard input it is recommended not to redirect the standard input for this program.
\newline
{\bf Options:}
\begin{description}
\item[-L]Latex mode. The program will try to show the current Gr\"obner basis in a readable form by invoking LaTeX and xdvi.
\item[-x]Exit immediately.
\item[-f]Tell the program to list the flipped reduced Gr\"obner basis of the initial ideal for each flippable wall in the current Gr\"obner cone.
\item[-w]Tell the program to list (a Gr\"obner basis with respect to the current term order for) the initial ideal for each flippable wall in the current Gr\"obner cone.
\item[-i]Tell the program to list the defining set of inequalities of the non-restricted Gr\"obner cone as a set of vectors after having listed the current Gr\"obner basis.
\item[-W]Print weight vector. This will make the program print an interior vector of the current Gr\"obner cone and a relative interior point for each flippable facet of the current Gr\"obner cone.
\item[-\hspace{0.013cm}-tropical]Traverse a tropical variety interactively.\end{description}
{\subsection{gfan\_ismarkedgroebnerbasis}\label{applist:_ismarkedgroebnerbasis}
This program checks if a set of marked polynomials is a Gr\"obner basis with respect to its marking. First it is checked if the markings are consistent with respect to a positive vector. Then Buchberger's S-criterion is checked. The output is boolean value.
{\subsection{gfan\_krulldimension}\label{applist:_krulldimension}
Takes an ideal $I$ and computes the Krull dimension of R/I where R is the polynomial ring. This is done by first computing a Gr\"obner basis.
\newline
{\bf Options:}
\begin{description}
\item[-g]Tell the program that the input is already a reduced Gr\"obner basis.\end{description}
{\subsection{gfan\_latticeideal}\label{applist:_latticeideal}
This program computes the lattice ideal of a lattice. The input is a list of generators for the lattice.
\newline
{\bf Options:}
\begin{description}
\item[-t]Compute the toric ideal of the matrix whose rows are given on the input instead.\item[-\hspace{0.013cm}-convert]Does not do any computation, but just converts the vectors to binomials.\end{description}
{\subsection{gfan\_leadingterms}\label{applist:_leadingterms}
This program converts a list of polynomials to a list of their leading terms.
\newline
{\bf Options:}
\begin{description}
\item[-m]Do the same thing for a list of polynomial sets. That is, output the set of sets of leading terms.
\end{description}
{\subsection{gfan\_list}\label{applist:_list}
This program lists all subcommands of the Gfan installation.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-hidden]Show hidden commands which are not officially supported.\end{description}
{\subsection{gfan\_markpolynomialset}\label{applist:_markpolynomialset}
This program marks a set of polynomials with respect to the vector given at the end of the input, meaning that the largest terms are moved to the front. In case of a tie the lexicographic term order with $a>b>c...$ is used to break it.
{\subsection{gfan\_minkowskisum}\label{applist:_minkowskisum}
This is a program for computing the normal fan of the Minkowski sum of the Newton polytopes of a list of polynomials.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-symmetry]Tells the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the ideal. The program checks that the ideal stays fixed when permuting the variables with respect to elements in the group. The program uses breadth first search to compute the set of reduced Gr\"obner bases up to symmetry with respect to the specified subgroup.
\item[-\hspace{0.013cm}-disableSymmetryTest]When using -\hspace{0.013cm}-symmetry this option will disable the check that the group read off from the input actually is a symmetry group with respect to the input ideal.
\item[-\hspace{0.013cm}-nocones]Tell the program to not list cones in the output.\end{description}
{\subsection{gfan\_minors}\label{applist:_minors}
This program will generate the r*r minors of a d*n matrix of indeterminates.
\newline
{\bf Options:}
\begin{description}
\item[-r value]Specify r.\item[-d value]Specify d.\item[-n value]Specify n.\item[-M2]Use Macaulay2 conventions for order of variables.\item[-\hspace{0.013cm}-names]Assign names to the minors.\item[-\hspace{0.013cm}-dressian]Produce tropical defining the Dressian(3,n) instead. (The signs may not be correct, that is the equations may not be Pluecker relations.)\item[-\hspace{0.013cm}-pluckersymmetries]Do nothing but produce symmetry generators for the Pluecker ideal.\item[-\hspace{0.013cm}-symmetry]Produces a list of generators for the group of symmetries keeping the set of minors fixed. (Only without -\hspace{0.013cm}-names).\item[-\hspace{0.013cm}-parametrize]Parametrize the set of d times n matrices of Barvinok rank less than or equal to r-1 by a list of tropical polynomials.\item[-\hspace{0.013cm}-ultrametric]Produce tropical equations cutting out the ultrametrics.\end{description}
{\subsection{gfan\_mixedvolume}\label{applist:_mixedvolume}
This program computes the mixed volume of the Newton polytopes of a list of polynomials. The ring is specified on the input. After this follows the list of polynomials.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-vectorinput]Read in a list of point configurations instead of a polynomial ring and a list of polynomials.\item[-\hspace{0.013cm}-cyclic value]Use cyclic-n example instead of reading input.\item[-\hspace{0.013cm}-noon value]Use Noonburg-n example instead of reading input.\item[-\hspace{0.013cm}-chandra value]Use Chandrasekhar-n example instead of reading input.\item[-\hspace{0.013cm}-katsura value]Use Katsura-n example instead of reading input.\item[-\hspace{0.013cm}-gaukwa value]Use Gaukwa-n example instead of reading input.\item[-\hspace{0.013cm}-eco value]Use Eco-n example instead of reading input.\item[-j value]Number of threads\end{description}
{\subsection{gfan\_overintegers}\label{applist:_overintegers}
This program is an experimental implementation of Gr\"obner bases for ideals in Z[x\_1,...,x\_n].
Several operations are supported by specifying the appropriate option:
(1) computation of the reduced Gr\"obner basis with respect to a given vector (tiebroken lexicographically),
(2) computation of an initial ideal,
(3) computation of the Gr\"obner fan,
(4) computation of a single Gr\"obner cone.
Since Gfan only knows polynomial rings with coefficients being elements of a field, the ideal is specified by giving a set of polynomials in the polynomial ring Q[x\_1,...,x\_n]. That is, by using Q instead of Z when specifying the ring. The ideal MUST BE HOMOGENEOUS (in a positive grading) for computation of the Gr\"obner fan. Non-homogeneous ideals are allowed for the other computations if the specified weight vectors are positive.
NOTE: This program is experimental and expected to change behaviour in future releases, so don't write your SAGE and M2 interfaces just yet.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-groebnerBasis]Asks the program to compute a marked Gr\"obner basis with respect to a weight vector tie-broken lexicographically.
The input order is: Ring ideal vector.
\item[-\hspace{0.013cm}-initialIdeal]Asks the program to compute an initial ideal with respect to a vector. The input order is: Ring ideal vector.
\item[-\hspace{0.013cm}-groebnerFan]Asks the program to compute the Gr\"obner fan.
The input order is: Ring ideal.
\item[-\hspace{0.013cm}-groebnerCone]Asks the program to compute a single Gr\"obner cone containing the specified vector in its relative interior. The output is stored as a fan. The input order is: Ring ideal vector.\item[-m]For the operations taking a vector as input, read in a list of vectors instead, and perform the operation for each vector in the list.\item[-g]Tells the program that the input is already a Gr\"obner basis (with the initial term of each polynomial being the first ones listed). Use this option if the usual -\hspace{0.013cm}-groebnerFan is too slow.
\end{description}
{\subsection{gfan\_padic}\label{applist:_padic}
This program is an experimental implementation of p-adic Gr\"obner bases as proposed by Diane Maclagan.
Several operations are supported by specifying the appropriate option:
(1) computation of Gr\"obner basis with respect to a given vector (tiebroken lexicographically),
(2) computation of the p-adic initial ideal,
(3) computation of the p-adic Gr\"obner complex as defined by Maclagan and Sturmfels,
(4) computation of a single polyhedron of the p-adic Gr\"obner complex.
The input ideal should be an ideal of the polynomial ring with coefficient field Q. The valuation is specified with the option -p. The ideal MUST BE HOMOGENEOUS (in a positive grading).
Since gfan can only handle fans and not polyhedral complexes in general, what is computed as the Gr\"obner complex is actually the "fan over" the complex - in other words, the first coordinate is supposed to be 1 in the output fan.
Similarly, the weight vectors must be specified in an homogeneous way, for example by adding an additional 1 entry as first coordinate. (If fractions are needed, use the entry as a common denominator.) NOTE: This program is experimental and expected to change behaviour in future releases, so don't write your SAGE and M2 interfaces just yet. In particular this program uses the tropical minimum-convention!!
\newline
{\bf Options:}
\begin{description}
\item[-p value]Defines the prime used for the valuation.\item[-\hspace{0.013cm}-groebnerBasis]Asks the program to compute a marked Gr\"obner basis with respect to a weight vector (tie-broken lexicographically).
The input order is: Ring ideal vector.
\item[-\hspace{0.013cm}-initialIdeal]Asks the program to compute an initial ideal with respect to a vector. The input order is: Ring ideal vector.
\item[-\hspace{0.013cm}-groebnerComplex]Asks the program to compute the p-adic Gr\"obner complex.
The input order is: Ring ideal.
\item[-\hspace{0.013cm}-groebnerPolyhedron]Asks the program to compute a single polyhedron of the Gr\"obner complex containing the specified vector in its relative interior. The output is stored as a fan. The input order is: Ring ideal vector.\item[-m]For the operations taking a vector as input, read in a list of vectors instead, and perform the operation for each vector in the list.\end{description}
{\subsection{gfan\_polynomialsetunion}\label{applist:_polynomialsetunion}
This program computes the union of a list of polynomial sets given as input. The polynomials must all belong to the same ring. The ring is specified on the input. After this follows the list of polynomial sets.
\newline
{\bf Options:}
\begin{description}
\item[-s]Sort output by degree.
\end{description}
{\subsection{gfan\_render}\label{applist:_render}
This program renders a Gr\"obner fan as an xfig file. To be more precise, the input is the list of all reduced Gr\"obner bases of an ideal. The output is a drawing of the Gr\"obner fan intersected with a triangle. The corners of the triangle are (1,0,0) to the right, (0,1,0) to the left and (0,0,1) at the top. If there are more than three variables in the ring these coordinates are extended with zeros. It is possible to shift the 1 entry cyclic with the option -\hspace{0.013cm}-shiftVariables.
\newline
{\bf Options:}
\begin{description}
\item[-L]Make the triangle larger so that the shape of the Gr\"obner region appears.\item[-\hspace{0.013cm}-shiftVariables value]Shift the positions of the variables in the drawing. For example with the value equal to 1 the corners will be right: (0,1,0,0,...), left: (0,0,1,0,...) and top: (0,0,0,1,...). The shifting is done modulo the number of variables in the polynomial ring. The default value is 0.\end{description}
{\subsection{gfan\_renderstaircase}\label{applist:_renderstaircase}
This program renders a staircase diagram of a monomial initial ideal to an xfig file. The input is a Gr\"obner basis of a (not necessarily monomial) polynomial ideal. The initial ideal is given by the leading terms in the Gr\"obner basis. Using the -m option it is possible to render more than one staircase diagram. The program only works for ideals in a polynomial ring with three variables.
\newline
{\bf Options:}
\begin{description}
\item[-m]Read multiple ideals from the input. The ideals are given as a list of lists of polynomials. For each polynomial list in the list a staircase diagram is drawn.
\item[-d value]Specifies the number of boxes being shown along each axis. Be sure that this number is large enough to give a correct picture of the standard monomials. The default value is 8.
\item[-w value]Width. Specifies the number of staircase diagrams per row in the xfig file. The default value is 5.
\end{description}
{\subsection{gfan\_resultantfan}\label{applist:_resultantfan}
This program computes the resultant fan as defined in "Computing Tropical Resultants" by Jensen and Yu. The input is a polynomial ring followed by polynomials, whose coefficients are ignored. The output is the fan of coefficients such that the input system has a tropical solution.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-codimension]Compute only the codimension of the resultant fan and return.
\item[-\hspace{0.013cm}-symmetry]Tells the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the vector configuration. The program DOES NOT checks that the configuration stays fixed when permuting the variables with respect to elements in the group. The output is grouped according to the symmetry.
\item[-\hspace{0.013cm}-nocones]Tells the program not to output the CONES and MAXIMAL\_CONES sections, but still output CONES\_COMPRESSED and MAXIMAL\_CONES\_COMPRESSED if -\hspace{0.013cm}-symmetry is used.
\item[-\hspace{0.013cm}-special]Read in a zero-one vector from the standard input and specialize all variables with a one. That is, compute the stable intersection of the resultant fan with the subspace where the variables with a one in the vector are forced to zero. AT THE MOMENT ALSO A RELATIVE INTERIOR POINT OF A STARTING CONE IS READ.
\item[-\hspace{0.013cm}-vectorinput]Read in a list of point configurations instead of a polynomial ring and a list of polynomials.
\item[-\hspace{0.013cm}-projection]Use the projection method to compute the resultant fan. This works only if the resultant fan is a hypersurface. If this option is combined with -\hspace{0.013cm}-special, then the output fan lives in the subspace of the non-specialized coordinates.
\end{description}
{\subsection{gfan\_saturation}\label{applist:_saturation}
This program computes the saturation of the input ideal with the product of the variables x\_1,...,x\_n. The ideal does not have to be homogeneous.
\newline
{\bf Options:}
\begin{description}
\item[-h]Tell the program that the input is a homogeneous ideal (with homogeneous generators).
\item[-\hspace{0.013cm}-noideal]Do not treat input as an ideal but just factor out common monomial factors of the input polynomials.\end{description}
{\subsection{gfan\_secondaryfan}\label{applist:_secondaryfan}
This program computes the secondary fan of a vector configuration. The configuration is given as an ordered list of vectors. In order to compute the secondary fan of a point configuration an additional coordinate of ones must be added. For example \{(1,0),(1,1),(1,2),(1,3)\}.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-unimodular]Use heuristics to search for unimodular triangulation rather than computing the complete secondary fan\item[-\hspace{0.013cm}-scale value]Assuming that the first coordinate of each vector is 1, this option will take the polytope in the 1 plane and scale it. The point configuration will be all lattice points in that scaled polytope. The polytope must have maximal dimension. When this option is used the vector configuration must have full rank. This option may be removed in the future.\item[-\hspace{0.013cm}-restrictingfan value]Specify the name of a file containing a polyhedral fan in Polymake format. The computation of the Secondary fan will be restricted to this fan. If the -\hspace{0.013cm}-symmetry option is used then this restricting fan must be invariant under the symmetry and the orbits in the file must be with respect to the specified group of symmetries. The orbits of maximal cones of the file are then read in rather than the maximal cones.
\item[-\hspace{0.013cm}-symmetry]Tells the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the vector configuration. The program checks that the configuration stays fixed when permuting the variables with respect to elements in the group. The output is grouped according to the symmetry.
\item[-\hspace{0.013cm}-nocones]Tells the program not to output the CONES and MAXIMAL\_CONES sections, but still output CONES\_COMPRESSED and MAXIMAL\_CONES\_COMPRESSED if -\hspace{0.013cm}-symmetry is used.\item[-\hspace{0.013cm}-interrupt value]Interrupt the enumeration after a specified number of facets have been computed (works for usual symmetric traversals, but may not work in general for non-symmetric traversals or for traversals restricted to fans).\end{description}
{\subsection{gfan\_stats}\label{applist:_stats}
This program takes a list of reduced Gr\"obner bases for the same ideal and computes various statistics. The following information is listed: the number of bases in the input, the number of variables, the dimension of the homogeneity space, the maximal total degree of any polynomial in the input and the minimal total degree of any basis in the input, the maximal number of polynomials and terms in a basis in the input.
{\subsection{gfan\_substitute}\label{applist:_substitute}
This program changes the variable names of a polynomial ring. The input is a polynomial ring, a polynomial set in the ring and a new polynomial ring with the same coefficient field but different variable names. The output is the polynomial set written with the variable names of the second polynomial ring.
Example:
Input:
Q[a,b,c,d]\{2a-3b,c+d\}Q[b,a,c,x]
Output:
Q[b,a,c,x]\{2*b-3*a,c+x\}
{\subsection{gfan\_symmetries}\label{applist:_symmetries}
This program computes the symmetries of a polynomial ideal. The program is slow, so think before using it. Use -\hspace{0.013cm}-symmetry to give hints about which subgroup of the symmetry group could be useful. The program checks each element of the specified subgroup to see if it preserves the ideal.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-symmetry]Specify subgroup to be searched for permutations keeping the ideal fixed.\item[-\hspace{0.013cm}-symsigns]Specify for each generator of the group specified wiht -\hspace{0.013cm}-symmetry an element of $\{-1,+1\}^n$ which by its multiplication on the variables together with the permutation is expected to keep the ideal fixed.\end{description}
{\subsection{gfan\_tolatex}\label{applist:_tolatex}
This program converts ASCII math to TeX math. The data-type is specified by the options.
\newline
{\bf Options:}
\begin{description}
\item[-h]Add a header to the output. Using this option the output will be LaTeXable right away.\item[-\hspace{0.013cm}-polynomialset\_]The data to be converted is a list of polynomials.\item[-\hspace{0.013cm}-polynomialsetlist\_]The data to be converted is a list of lists of polynomials.\end{description}
{\subsection{gfan\_topolyhedralfan}\label{applist:_topolyhedralfan}
This program takes a list of reduced Gr\"obner bases and produces the fan of all faces of these. In this way by giving the complete list of reduced Gr\"obner bases, the Gr\"obner fan can be computed as a polyhedral complex. The option -\hspace{0.013cm}-restrict lets the user choose between computing the Gr\"obner fan or the restricted Gr\"obner fan.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-restrict]Add an inequality for each coordinate, so that the the cones are restricted to the non-negative orthant.\item[-\hspace{0.013cm}-symmetry]Tell the program to read in generators for a group of symmetries (subgroup of $S\_n$) after having read in the ring. The output is grouped according to these symmetries. Only one representative for each orbit is needed on the input.
\end{description}
{\subsection{gfan\_tropicalbasis}\label{applist:_tropicalbasis}
This program computes a tropical basis for an ideal defining a tropical curve. Defining a tropical curve means that the Krull dimension of R/I is at most 1 + the dimension of the homogeneity space of I where R is the polynomial ring. The input is a generating set for the ideal. If the input is not homogeneous option -h must be used.
\newline
{\bf Options:}
\begin{description}
\item[-h]Homogenise the input before computing a tropical basis and dehomogenise the output. This is needed if the input generators are not already homogeneous.\end{description}
{\subsection{gfan\_tropicalbruteforce}\label{applist:_tropicalbruteforce}
This program takes a marked reduced Gr\"obner basis for a homogeneous ideal and computes the tropical variety of the ideal as a subfan of the Gr\"obner fan. The program is slow but works for any homogeneous ideal. If you know that your ideal is prime over the complex numbers or you simply know that its tropical variety is pure and connected in codimension one then use gfan\_tropicalstartingcone and gfan\_tropicaltraverse instead.
{\subsection{gfan\_tropicalcurve}\label{applist:_tropicalcurve}
This program computes a tropical basis for an ideal defining a tropical curve. Defining a tropical curve means that the Krull dimension of R/I is at most 1 + the dimension of the homogeneity space of I where R is the polynomial ring. The input is a generating set for the ideal. If the input is not homogeneous option -h must be used.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-singleray]Only compute a single ray of the curve.\item[-\hspace{0.013cm}-parameters value]With this option you can specify how many variables to treat as parameters instead of variables. This makes it possible to do computations where the coefficient field is the field of rational functions in the parameters.\end{description}
{\subsection{gfan\_tropicalevaluation}\label{applist:_tropicalevaluation}
This program evaluates a tropical polynomial function in a given set of points.
{\subsection{gfan\_tropicalfunction}\label{applist:_tropicalfunction}
This program takes a polynomial and tropicalizes it. The output is piecewise linear function represented by a fan whose cones are the linear regions. Each ray of the fan gets the value of the tropical function assigned to it. In other words this program computes the normal fan of the Newton polytope of the input polynomial with additional information.\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-exponents]Tell program to read a list of exponent vectors instead.\end{description}
{\subsection{gfan\_tropicalhypersurface}\label{applist:_tropicalhypersurface}
This program computes the tropical hypersurface defined by a principal ideal. The input is the polynomial ring followed by a set containing just a generator of the ideal.
{\subsection{gfan\_tropicalintersection}\label{applist:_tropicalintersection}
This program computes the set theoretical intersection of a set of tropical hypersurfaces (or to be precise, their common refinement as a fan). The input is a list of polynomials with each polynomial defining a hypersurface. Considering tropical hypersurfaces as fans, the intersection can be computed as the common refinement of these. Thus the output is a fan whose support is the intersection of the tropical hypersurfaces.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-tropicalbasistest]This option will test that the input polynomials for a tropical basis of the ideal they generate by computing the tropical prevariety of the input polynomials and then refine each cone with the Gr\"obner fan and testing whether each cone in the refinement has an associated monomial free initial ideal. If so, then we have a tropical basis and 1 is written as output. If not, then a zero is written to the output together with a vector in the tropical prevariety but not in the variety. The actual check is done on a homogenization of the input ideal, but this does not affect the result. (This option replaces the -t option from earlier gfan versions.)
\item[-\hspace{0.013cm}-tplane]This option intersects the resulting fan with the plane x\_0=-1, where x\_0 is the first variable. To simplify the implementation the output is actually the common refinement with the non-negative half space. This means that "stuff at infinity" (where x\_0=0) is not removed.\item[-\hspace{0.013cm}-symmetryPrinting]Parse a group of symmetries after the input has been read. Used when printing with -\hspace{0.013cm}-incidence.\item[-\hspace{0.013cm}-symmetryExploit]Restrict computation to the closed lexicographic fundamental domain of the specified symmetry group. This overwrites -\hspace{0.013cm}-restrict.\item[-\hspace{0.013cm}-nocones]Tells the program not to output the CONES and MAXIMAL\_CONES sections, but still output CONES\_COMPRESSED and MAXIMAL\_CONES\_COMPRESSED if -\hspace{0.013cm}-symmetry is used.\item[-\hspace{0.013cm}-restrict]Restrict the computation to a full-dimensional cone given by a list of marked polynomials. The cone is the closure of all weight vectors choosing these marked terms.\item[-\hspace{0.013cm}-stable]Find the stable intersection of the input polynomials using tropical intersection theory. This can be slow. Most other options are ignored.\item[-\hspace{0.013cm}-parameters value]With this option you can specify how many variables to treat as parameters instead of variables. This makes it possible to do computations where the coefficient field is the field of rational functions in the parameters.\end{description}
{\subsection{gfan\_tropicallifting}\label{applist:_tropicallifting}
This program is part of the Puiseux lifting algorithm implemented in Gfan and Singular. The Singular part of the implementation can be found in:
Anders Nedergaard Jensen, Hannah Markwig, Thomas Markwig:
tropical.lib. A SINGULAR 3.0 library for computations in tropical geometry, 2007
See also
http://www.mathematik.uni-kl.de/\~{}keilen/de/tropical.html
and the paper
Jensen, Markwig, Markwig: "An algorithm for lifting points in a tropical variety".
Example:
Run Singular from the directory where tropical.lib is located.
Give the following sequence of commands to Singular:
LIB "tropical.lib";
ring R=0,(t,x,y,z),dp;
ideal i=-y2t4+x2,yt3+xz+y;
intvec w=1,-2,0,2;
list L=tropicallifting(i,w,3);
displaytropicallifting(L,"subst");
This produces a Puiseux series solution to i with valuation (2,0,-2)
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-noMult]Disable the multiplicity computation.\item[-n value]Number of variables that should have negative weight.\item[-c]Only output a list of vectors being the possible choices.\end{description}
{\subsection{gfan\_tropicallinearspace}\label{applist:_tropicallinearspace}
This program generates tropical equations for a tropical linear space in the Speyer sense given the tropical Pluecker coordinates as input.
\newline
{\bf Options:}
\begin{description}
\item[-d value]Specify d.\item[-n value]Specify n.\item[-\hspace{0.013cm}-trees]list the boundary trees (assumes d=3)\end{description}
{\subsection{gfan\_tropicalmultiplicity}\label{applist:_tropicalmultiplicity}
This program computes the multiplicity of a tropical cone given a marked reduced Gr\"obner basis for its initial ideal.
{\subsection{gfan\_tropicalprevariety}\label{applist:_tropicalprevariety}
This program computes the tropical prevariety of a set of polynomials. The program works in two different modes. By default the coefficient field is regarded as having trivial valuation and the output is a polyhedral fan. With the option -\hspace{0.013cm}-usevaluation the program uses the valuation of the given coefficient field when defining the tropical prevariety. As a consequence the output in this case is a polyhedral complex represented by the half-open polyhedral fan over it.
It is often useful to use the field Q(t). However, because of the limitations of the current parser, the way to specify elements of for example Q(t)[x1,x2] is to write them as polynomials in Q[t,x1,x2].
When -\hspace{0.013cm}-usevaluation is used the options -\hspace{0.013cm}-mint and -\hspace{0.013cm}-minx can switch the program from max to min convention.
In particular, using both -\hspace{0.013cm}-mint and -\hspace{0.013cm}-minx switches conventions to the [Speyer,Sturmfels]/[Maclagan,Sturmfels] convention.
Example:
./gfan \_tropicalprevariety -j32 -\hspace{0.013cm}-usevaluation -\hspace{0.013cm}-bits64
with input:
Q(t)[x,y]\{1+t*x+x+y\}
produces a polyhedral complex.\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-saveas value]Specify filename for saving intermediate result.\item[-\hspace{0.013cm}-loadfrom value]Specify filename for loading intermediate result.\item[-j value]Number of threads\item[-\hspace{0.013cm}-bits value]Number of bits used in intermediate integer type. Allowed values are 64, 32 and 0 for arbitrary precision. In the postprocessing step the computed prevariety is converted in arbitrary precission.\item[-\hspace{0.013cm}-usevaluation]Use valuations in the defintion of the tropical hypersurfaces. The used valuation comes from the ring specified. For example Q(t) will come with its usual valuation. In order to represent the output an additional 0th coordinate is introduced.\item[-\hspace{0.013cm}-mint]In a field with parameter t this option decides if maximal or minimal degrees of t determine the valuation.\item[-\hspace{0.013cm}-minx]Switch the programme to min convention for the variables.\end{description}
{\subsection{gfan\_tropicalrank}\label{applist:_tropicalrank}
This program will compute the tropical rank of matrix given as input. Tropical addition is MAXIMUM.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-kapranov]Compute Kapranov rank instead of tropical rank.\item[-\hspace{0.013cm}-determinant]Compute the tropical determinant instead.\end{description}
{\subsection{gfan\_tropicalstartingcone}\label{applist:_tropicalstartingcone}
This program computes a starting pair of marked reduced Gr\"obner bases to be used as input for gfan\_tropicaltraverse. The input is a homogeneous ideal whose tropical variety is a pure d-dimensional polyhedral complex.
\newline
{\bf Options:}
\begin{description}
\item[-g]Tell the program that the input is already a reduced Gr\"obner basis.\item[-d]Output dimension information to standard error.\item[-\hspace{0.013cm}-stable]Find starting cone in the stable intersection or, equivalently, pretend that the coefficients are genereric.\end{description}
{\subsection{gfan\_tropicaltraverse}\label{applist:_tropicaltraverse}
This program computes a polyhedral fan representation of the tropical variety of a homogeneous prime ideal $I$. Let $d$ be the Krull dimension of $I$ and let $\omega$ be a relative interior point of $d$-dimensional Gr\"obner cone contained in the tropical variety. The input for this program is a pair of marked reduced Gr\"obner bases with respect to the term order represented by $\omega$, tie-broken in some way. The first one is for the initial ideal $in\_\omega(I)$ the second one for $I$ itself. The pair is the starting point for a traversal of the $d$-dimensional Gr\"obner cones contained in the tropical variety. If the ideal is not prime but with the tropical variety still being pure $d$-dimensional the program will only compute a codimension $1$ connected component of the tropical variety.
\newline
{\bf Options:}
\begin{description}
\item[-\hspace{0.013cm}-symmetry]Do computations up to symmetry and group the output accordingly. If this option is used the program will read in a list of generators for a symmetry group after the pair of Gr\"obner bases have been read. Two advantages of using this option is that the output is nicely grouped and that the computation can be done faster.\item[-\hspace{0.013cm}-symsigns]Specify for each generator of the symmetry group an element of $\{-1,+1\}^n$ which by its multiplication on the variables together with the permutation will keep the ideal fixed. The vectors are given as the rows of a matrix.\item[-\hspace{0.013cm}-nocones]Tells the program not to output the CONES and MAXIMAL\_CONES sections, but still output CONES\_ORBITS and MAXIMAL\_CONES\_ORBITS if -\hspace{0.013cm}-symmetry is used.\item[-\hspace{0.013cm}-disableSymmetryTest]When using -\hspace{0.013cm}-symmetry this option will disable the check that the group read off from the input actually is a symmetry group with respect to the input ideal.
\item[-\hspace{0.013cm}-stable]Traverse the stable intersection or, equivalently, pretend that the coefficients are genereric.\item[-\hspace{0.013cm}-interrupt value]Interrupt the enumeration after a specified number of facets have been computed (works for usual symmetric traversals, but may not work in general for non-symmetric traversals or for traversals restricted to fans).\end{description}
{\subsection{gfan\_tropicalweildivisor}\label{applist:_tropicalweildivisor}
This program computes the tropical Weil divisor of piecewise linear (or tropical rational) function on a tropical k-cycle. See the Gfan manual for more information.
\newline
{\bf Options:}
\begin{description}
\item[-i1 value]Specify the name of the Polymake input file containing the k-cycle.\item[-i2 value]Specify the name of the Polymake input file containing the piecewise linear function.\end{description}
{\subsection{gfan\_version}\label{applist:_version}
This program writes out version information of the Gfan installation.
|