Macaulay2 » Documentation
Packages » Normaliz :: readMultipleNmzData
next | previous | forward | backward | up | index | toc

# readMultipleNmzData -- reads an output file of Normaliz containing several matrices

- Usage:
    `readNmzData s`
- Inputs:
  - a string, the suffix of the file to be read
- Outputs:
  - a list, the content of the file

## Description

This function can read several matrices from a Normaliz output file. At the moment, the only output file that contains several matrices is the file with suffix cst. It contains the supporting hyperplanes, the defining equations and the congruences defining the (same) cone. It is possible that one of the matrices is a matrix with zero rows.

    i1 : nmzFilename="example" -- to keep the files

    o1 = example

    i2 : mat=matrix({{1,2,3},{4,5,6},{7,8,10}});

                  3       3
    o2 : Matrix ZZ  <-- ZZ

    i3 : normaliz(allComputations => true,mat,"integral_closure")

    o3 = RationalCone{"cgr" => | 0 |                                          }
                               | 4 |
                      "equ" => | 0 |
                               | 3 |
                      "gen" => | 1 2 3  |
                               | 2 3 4  |
                               | 3 4 5  |
                               | 4 5 6  |
                               | 7 8 10 |
                      "inv" => HashTable{"" => (1, 1, 1)                     }
                                         "class group" => (0, 3)
                                         "degree 1 elements" => 5
                                         "dim max subspace" => 0
                                         "embedding dim" => 3
                                         "external index" => 1
                                         "graded" => true
                                         "grading denom" => 1
                                         "grading" => (-1, 1, 0)
                                         "hilbert basis elements" => 5
                                         "hilbert quasipolynomial denom" => 2
                                         "hilbert series denom" => (1, 1, 1)
                                         "hilbert series num" => (1, 2)
                                         "inhomogeneous" => false
                                         "integrally closed" => false
                                         "internal index" => 3
                                         "multiplicity denom" => 1
                                         "multiplicity" => 3
                                         "number extreme rays" => 3
                                         "number support hyperplanes" => 3
                                         "rank" => 3
                                         "size triangulation" => 1
                                         "sum dets" => 3
                      "sup" => | -4 11 -6 |
                               | -2 -2 3  |
                               | 1  -2 1  |

    o3 : RationalCone

    i4 : readMultipleNmzData "cst"

    o4 = {| -4 11 -6 |, | 0 |, | 0 |, | -1 1 0 |}
          | -2 -2 3  |  | 3 |  | 4 |
          | 1  -2 1  |

    o4 : List

    i5 : rmNmzFiles();

## Ways to use readMultipleNmzData:

- `readMultipleNmzData(String)`

## For the programmer

The object readMultipleNmzData is a method function.

The source of this document is in /build/macaulay2-88fgJW/macaulay2-1.25.11+ds/M2/Macaulay2/packages/Normaliz.m2:1196:0.