SharedMeatAxe  1.0
Using the MeatAxe Programs: General Remarks

Setting up the environment

It is recommended that you include the MeatAxe installation directory, where all the programs are installed, in your path. You may also define the following environment variables which are recognized by the MeatAxe programs:

MTXLIB
Name of the MeatAxe library directory, see The library directory. You need to define this variable only if you want to use a library directory different from the default library directory chosen at compile time. This can be overridden by the -L command line option.
MTXBIN
Name of the MeatAxe installation directory. This is necessary if the programs have been moved into another directory without recompiling and you want to use the automatic table file generation feature. The value of this variable can be overridden by the -B option.

Arithmetic Tables

All programs use lookup tables for row operations and finite field arithmetic. These tables are read from a file named pXXX.zzz. where XXX is the field order. For example, tables for GF(25) are read from the file p025.zzz. If the table file does not exist, it will be created automatically. Table files may also be placed in the library directory (see below) because the programs look there before they try to generate a new file.

File Types

All MeatAxe programs operate on files and do not require user interaction. There are two kinds of files:

  • Binary (internal format) data files. Programs usually read and write data in binary format.
  • Text files, used by some programs as zcv and zpr. The format of text files is described with the zcv program.

Typically, a program reads a number of input files and produces one or more output files. For example, the ZMU (multiply) program expects two input and one output file. Thus,

zmu mat1 mat2 result

reads matrices from "mat1" and "mat2", and writes the product to "result". To find out which files are used by a specific program, look up the program description in section Program Index. You can also run any MeatAxe program with the "--help" option to get an on-line help.

The library directory

When given a file name, all programs look for the file in the current directory first. If the file is not found there, they try to find it in the library directory, provided a library has been defined.

For MeatAxe applications, the location of the library directory must be provided at run-time by defining the environment variable MTXLIB. It must be a directory name including a trailing separator character (e.g., '/' for UNIX). For library functions, the library directory must be provided at run-time by defining the global C variable MtxLibDir.


SharedMeatAxe 1.0 documentation, generated on Sat Dec 30 2017 12:13:21