Metadata-Version: 2.1
Name: talp-pages
Version: 3.5.2a2
Summary: Command line tools to generate performance reports using the TALP module of DLB
Home-page: https://pm.bsc.es/gitlab/dlb/dlb/
License: GPL-3.0-only
Keywords: HPC,Performance Analysis,Profiling,Continuous Performance Analysis
Author: Valentin Seitz
Author-email: valentin.seitz@bsc.es
Maintainer: Valentin Seitz
Maintainer-email: valentin.seitz@bsc.es
Requires-Python: >=3.9,<4.0
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: System :: Distributed Computing
Requires-Dist: jinja2 (>=3.1.4,<4.0.0)
Requires-Dist: kaleido (==0.2.1)
Requires-Dist: pandas (>=2.2.2,<3.0.0)
Requires-Dist: plotly
Requires-Dist: python-gitlab (>=4.4.0,<5.0.0)
Requires-Dist: tqdm
Project-URL: Repository, https://pm.bsc.es/gitlab/dlb/dlb/
Description-Content-Type: text/markdown

# TALP-Pages

As of version 3.5.0 of [DLB](https://dlb-docs.readthedocs.io/en/latest/) TALP-Pages is an experimental feature released together with DLB.
As TALP-Pages is Python-package, we prefer the distribution via pypi.org over the classic distribution channels.

Please note that: **this an experimental release**


## What is TALP-Pages?

TALP-Pages is a postprocessing tool for invesigating the parallel performance of HPC applications. 
We rely on [TALP](https://dlb-docs.readthedocs.io/en/latest/) to provide jsons for different runs in e.g. a weak-scaling or strong-scaling experiment. 
The users organizes the JSONS obtained by TALP and TALP-Pages produces a nice HTML report for the user to invesigate the performance. 

You can either do this stand-alone or integrated in a CI/CD setting.

If all of this sound a bit high level, make sure to have a look at [our documentation!](https://dlb-docs.readthedocs.io/en/latest/). We provide examples there :)

## I want to use TALP-Pages

Perfect: Check out [our documentation!](https://dlb-docs.readthedocs.io/en/latest/) We provide you with examples and How-Tos to integrate TALP-Pages into your workflow.


## Version compatibility

We follow a semantic-version like versioning system. 
Experimental features might change across minor releases. As both TALP-Pages and TALP are still considered experimental, the currently provided APIs might change slightly in the future.

We guarantee that TALP-Pages version `X.Y.Z` can postprocess all DLB emmited JSONS from versions `X.Y.*`
Note that, we will follow a different release cylce for the two different projects. TALP-Pages is expected to increase the Patch release more often than DLB. 


## Installation

TALP Pages is written in Python (3.9+). We rely on [poetry](https://python-poetry.org/) for packaging.
To use, simply install via:

```
pip install talp-pages
```


## License

TALP Pages is available under the General Public License v3.0.

