# gurobi-logtools
[](https://pypi.python.org/pypi/gurobi-logtools)
[](https://github.com/Gurobi/gurobi-logtools/blob/master/LICENSE)
[](https://github.com/Gurobi/gurobi-logtools/actions/workflows/python-tox.yml)
Extract information from Gurobi log files and generate [pandas DataFrames](https://pandas.pydata.org/) or Excel worksheets for further processing. Also includes a wrapper for out-of-the-box interactive visualizations using the plotting library [Plotly](https://plotly.com/python/).
> [!NOTE]
> We have renamed the project to `gurobi-logtools`, so please also adapt the import statement accordingly:
>
> `import gurobi_logtools as glt`

# Installation
```
python -m pip install gurobi-logtools
```
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](https://github.com/Gurobi/gurobi-logtools/blob/master/CHANGELOG.md) 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 [gurobi-logtools.ipynb notebook](https://github.com/Gurobi/gurobi-logtools/blob/master/gurobi-logtools.ipynb) with the [example data set](https://github.com/Gurobi/gurobi-logtools/tree/master/data) to get started.
Additionally, there is a [Gurobi TechTalk demonstrating how to use it (YouTube)](https://youtu.be/wbg4Zr_A1s8):
[](https://youtu.be/wbg4Zr_A1s8)
## Pandas/Plotly
1. parse log files:
```Python
import gurobi_logtools 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.
2. draw interactive charts, preferably in a [Jupyter Notebook](https://jupyter.org/):
- final results from the individual runs:
```Python
glt.plot(summary, type="box")
```
- progress charts for the individual runs:
```Python
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):
```Python
glt.plot(results.progress("norel"), x="Time", y="Incumbent", color="Log", type="line")
```
These are just examples using the [Plotly Python library](https://plotly.com/python/) - 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 gurobi_logtools myrun.xlsx data/*.log
```
List all available options and how to use the command-line tool:
```
python -m gurobi_logtools --help
```
## Rename log files
The command line tool can also rename log files according to the parameters set and model solved in a given run. This is useful if your log files do not have a consistent naming scheme, or if multiple runs are logged per file and you want to extract the individual runs.
For example:
```
python -m gurobi_logtools --write-to-dir nicenames summary.xlsx tests/assets/combined/*.log
```
separates logs for individual runs in the input files and writes copies to the 'nicenames' folder with a consistent naming scheme:
```
> ls nicenames
912-MIPFocus1-Presolve1-TimeLimit600-glass4-0.log
912-MIPFocus1-Presolve1-TimeLimit600-glass4-1.log
912-MIPFocus1-Presolve1-TimeLimit600-glass4-2.log
912-MIPFocus2-Presolve1-TimeLimit600-glass4-0.log
912-MIPFocus2-Presolve1-TimeLimit600-glass4-1.log
912-MIPFocus2-Presolve1-TimeLimit600-glass4-2.log
912-Presolve1-TimeLimit600-glass4-0.log
912-Presolve1-TimeLimit600-glass4-1.log
912-Presolve1-TimeLimit600-glass4-2.log
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Gurobi/gurobi-logtools",
"name": "gurobi-logtools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Gurobi Optimization, LLC",
"author_email": "support@gurobi.com",
"download_url": "https://files.pythonhosted.org/packages/bd/77/875d15a530a5eb49561ff81391ba423ed0b9f2a0ea00e5cd537757d14c23/gurobi_logtools-3.2.0.tar.gz",
"platform": "any",
"description": "# gurobi-logtools\n\n[](https://pypi.python.org/pypi/gurobi-logtools)\n[](https://github.com/Gurobi/gurobi-logtools/blob/master/LICENSE)\n[](https://github.com/Gurobi/gurobi-logtools/actions/workflows/python-tox.yml)\n\nExtract information from Gurobi log files and generate [pandas DataFrames](https://pandas.pydata.org/) or Excel worksheets for further processing. Also includes a wrapper for out-of-the-box interactive visualizations using the plotting library [Plotly](https://plotly.com/python/).\n\n> [!NOTE]\n> We have renamed the project to `gurobi-logtools`, so please also adapt the import statement accordingly:\n>\n> `import gurobi_logtools as glt`\n\n\n\n# Installation\n\n```\npython -m pip install gurobi-logtools\n```\n\nIt 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.\n\nSee [CHANGELOG](https://github.com/Gurobi/gurobi-logtools/blob/master/CHANGELOG.md) for added, removed or fixed functionality.\n\n# Usage\n\nFirst, you need a set of Gurobi log files to compare, e.g.,\n - results from several model instances\n - comparisons of different parameter settings\n - performance variability experiments involving multiple random seed runs\n - ...\n\nYou may also use the provided [gurobi-logtools.ipynb notebook](https://github.com/Gurobi/gurobi-logtools/blob/master/gurobi-logtools.ipynb) with the [example data set](https://github.com/Gurobi/gurobi-logtools/tree/master/data) to get started.\nAdditionally, there is a [Gurobi TechTalk demonstrating how to use it (YouTube)](https://youtu.be/wbg4Zr_A1s8):\n\n[](https://youtu.be/wbg4Zr_A1s8)\n\n## Pandas/Plotly\n1. parse log files:\n ```Python\n import gurobi_logtools as glt\n\n results = glt.parse([\"run1/*.log\", \"run2/*.log\"])\n summary = results.summary()\n nodelog_progress = results.progress(\"nodelog\")\n ```\n Depending on your requirements, you may need to filter or modify the resulting DataFrames.\n\n2. draw interactive charts, preferably in a [Jupyter Notebook](https://jupyter.org/):\n\n - final results from the individual runs:\n ```Python\n glt.plot(summary, type=\"box\")\n ```\n\n - progress charts for the individual runs:\n ```Python\n glt.plot(nodelog_progress, y=\"Gap\", color=\"Log\", type=\"line\")\n ```\n\n - progress of the norel heuristic (note, the time recorded here is since the start of norel, and does not include presolve + read time):\n ```Python\n glt.plot(results.progress(\"norel\"), x=\"Time\", y=\"Incumbent\", color=\"Log\", type=\"line\")\n ```\n\n These are just examples using the [Plotly Python library](https://plotly.com/python/) - of course, any other plotting library of your choice can be used to work with these DataFrames.\n\n## Excel\nConvert your log files to Excel worksheets right on the command-line:\n\n```\npython -m gurobi_logtools myrun.xlsx data/*.log\n```\n\nList all available options and how to use the command-line tool:\n\n```\npython -m gurobi_logtools --help\n```\n\n## Rename log files\nThe command line tool can also rename log files according to the parameters set and model solved in a given run. This is useful if your log files do not have a consistent naming scheme, or if multiple runs are logged per file and you want to extract the individual runs.\n\nFor example:\n\n```\npython -m gurobi_logtools --write-to-dir nicenames summary.xlsx tests/assets/combined/*.log\n```\n\nseparates logs for individual runs in the input files and writes copies to the 'nicenames' folder with a consistent naming scheme:\n\n```\n> ls nicenames\n912-MIPFocus1-Presolve1-TimeLimit600-glass4-0.log\n912-MIPFocus1-Presolve1-TimeLimit600-glass4-1.log\n912-MIPFocus1-Presolve1-TimeLimit600-glass4-2.log\n912-MIPFocus2-Presolve1-TimeLimit600-glass4-0.log\n912-MIPFocus2-Presolve1-TimeLimit600-glass4-1.log\n912-MIPFocus2-Presolve1-TimeLimit600-glass4-2.log\n912-Presolve1-TimeLimit600-glass4-0.log\n912-Presolve1-TimeLimit600-glass4-1.log\n912-Presolve1-TimeLimit600-glass4-2.log\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Gurobi log file tools for parsing and exploring data",
"version": "3.2.0",
"project_urls": {
"Homepage": "https://github.com/Gurobi/gurobi-logtools"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fc2cfc6eac833ead9ca0c485aefd91c55936624fd2e1d7dd650259d2b522cbc6",
"md5": "1ec83c612ee7b53abe4026bb249475ce",
"sha256": "54eb975fa37ee33b316c30c4695969271072f3a3c629b1a7b0b3dd273dfff6c2"
},
"downloads": -1,
"filename": "gurobi_logtools-3.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1ec83c612ee7b53abe4026bb249475ce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 54916,
"upload_time": "2024-12-19T09:43:38",
"upload_time_iso_8601": "2024-12-19T09:43:38.162095Z",
"url": "https://files.pythonhosted.org/packages/fc/2c/fc6eac833ead9ca0c485aefd91c55936624fd2e1d7dd650259d2b522cbc6/gurobi_logtools-3.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bd77875d15a530a5eb49561ff81391ba423ed0b9f2a0ea00e5cd537757d14c23",
"md5": "3ff2897237d0f8d8999ed0023bb6d4c1",
"sha256": "2ba0ac6d25b3056d9961f3436f3a919a7ea183292445a4956b52a74b2f82132f"
},
"downloads": -1,
"filename": "gurobi_logtools-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "3ff2897237d0f8d8999ed0023bb6d4c1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 28153,
"upload_time": "2024-12-19T09:43:39",
"upload_time_iso_8601": "2024-12-19T09:43:39.246408Z",
"url": "https://files.pythonhosted.org/packages/bd/77/875d15a530a5eb49561ff81391ba423ed0b9f2a0ea00e5cd537757d14c23/gurobi_logtools-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-19 09:43:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Gurobi",
"github_project": "gurobi-logtools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "gurobi-logtools"
}