Gurobi log file tools for parsing and exploring data
Project description
GRBlogtools
Extract information from Gurobi log files and generate pandas DataFrames or Excel worksheets for further processing. Also includes a wrapper for out-of-the-box interactive visualizations using the plotting library Plotly.
Installation
python -m pip install grblogtools
It is recommended to prepend the pip install
command with python -m
to ensure that the package is installed using the correct Python version currently active in your environment.
See CHANGELOG for added, removed or fixed functionality.
Usage
First, you need a set of Gurobi log files to compare, e.g.,
- results from several model instances
- comparisons of different parameter settings
- performance variability experiments involving multiple random seed runs
- ...
You may also use the provided grblogtools.ipynb notebook with the example data set to get started. Additionally, there is a Gurobi TechTalk demonstrating how to use grblogtools (YouTube):
Pandas/Plotly
-
parse log files:
import grblogtools as glt results = glt.parse(["run1/*.log", "run2/*.log"]) summary = results.summary() nodelog_progress = results.progress("nodelog")
Depending on your requirements, you may need to filter or modify the resulting DataFrames.
-
draw interactive charts, preferably in a Jupyter Notebook:
- final results from the individual runs:
glt.plot(summary, type="box")
- progress charts for the individual runs:
glt.plot(nodelog_progress, y="Gap", color="Log", type="line")
- progress of the norel heuristic (note, the time recorded here is since the start of norel, and does not include presolve + read time):
glt.plot(result.progress("norel"), x="Time", y="Incumbent", color="Log", type="line")
These are just examples using the Plotly Python library - of course, any other plotting library of your choice can be used to work with these DataFrames.
Excel
Convert your log files to Excel worksheets right on the command-line:
python -m grblogtools myrun.xlsx data/*.log
List all available options and how to use the command-line tool:
python -m grblogtools --help
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for grblogtools-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ccfe51b7cb911bfac6393326df9866eee1cd1396cd2e74658f4403634819be78 |
|
MD5 | f91b3b3b9cfeac42cb3fe8cacbcee7ed |
|
BLAKE2b-256 | 627754f8d5a9409d09f5104924edddaae9be7511b141e8cbab65648999bbdba1 |