gmpl-tex 1.0.1b1

Convert GMPL (GNU MathProg) models into LaTeX.

gmpl-tex

Convert GMPL (GNU MathProg) optimization models into LaTeX, so the constraints, sets, parameters, variables and objectives you wrote for a solver can go straight into a paper with readable, renamed symbols.

The tool works in two phases so you stay in control of the notation:

1. Lookup-table generation - parse model.mod into a JSON table listing every set, parameter, variable, constraint and objective name. Each name maps to a label you can edit.
2. LaTeX generation - render the model to LaTeX, substituting your edited labels from the JSON table.

Requirements

• Python 3.10 or newer. Check what you have:
  • Windows: py --version
  • macOS / Linux: python3 --version
  • If it's missing, install from python.org. On Windows, tick "Add python.exe to PATH" in the installer.
• lark - installed automatically.

Install

pip install gmpl-tex

After installing, the command gmpl-tex works the same on every platform.

Windows users: use py -m pip install gmpl-tex if pip isn't on your PATH.

Usage

gmpl-tex model.mod [lookup.json] --json
gmpl-tex model.mod [lookup.json] [output.tex] --latex

A full run, start to finish:

# 1. Generate the editable lookup table (writes model.json)
gmpl-tex model.mod --json

# 2. Open model.json and edit the label on the right-hand side of each entry,
#    e.g. "finishTime": "fTime"

# 3. Render LaTeX using your edited labels (writes model.tex)
gmpl-tex model.mod model.json --latex

If you skip step 1 and run gmpl-tex model.mod --latex directly, a default table is created automatically (labels equal to the raw names) and used. If a model.json already exists next to the model, it is reused as-is and never overwritten.

An example model is included under examples/model.mod.

Troubleshooting

• Subscripted label values warning: LaTeX doesn't like multiple '_' in names. While the converter has no problem generating code with multiple name subscripts, LaTeX will eventually throw a Double subscript error on compilation. To generate valid LaTeX code, remove the '_' in any label values inside the json table. Then re-run the converter with --latex.

• A symbol shows up in red in the output: That symbol is missing from your model.json lookup table.

License

MIT - see LICENSE.