TreeScape is a Jupyter-based visualization tool for performance data, enabling users to programmatically render graphs. With TreeScape, you can load an ensemble of Caliper performance files and visualize the collective performance of an application across many runs. This could involve tracking performance changes over time, comparing the performance achieved by different users, running scaling studies across time, etc. TreeScape is the replacement for SPOT, which was web-based.
The notebook below provides some examples of how to interact with TreeScape:
regression_notebooks/NightlyTestDemo_local.ipynb.
TreeScape is an open-source project, and we welcome contributions from the community.
You can also start an issue for a [bug report or feature] request(https://github.com/LLNL/treescape/issues/new).
- Clone the repository:
git clone https://github.com/LLNL/treescape.git
- Create a virtual environment:
python3 -m venv venv
- Activate the virtual environment:
source venv/bin/activate
- Install the dependencies:
pip install -r requirements.txt
- Run the notebook: To make it easier to reach your notebooks, launch jupyter notebook from the directory where your notebooks are.
jupyter notebook
-
Open Notebook After jupyter notebook is running, open the notebook
regression_notebooks/NightlyTestDemo_local.ipynb. You will need to modify the paths to the caliper files to match your local environment. You will need to modify the following paths too: sys.path.append("/Users/aschwanden1/min-venv-local/lib/python3.9/site-packages") sys.path.append("/Users/aschwanden1/github/treescape") -
Run the cells in the notebook.
treescape - This is the main directory. It contains the python code for the project. scripts - This directory contains misc test scripts that are used to test exportSVG and other features. regression_scripts - This directory contains scripts that are used to run regression tests. You can save a baseline for a set of data, and then compare future data to that baseline. baseline_results - this directory contains the baseline results for the regression tests. sandbox - This directory contains notebooks that are used for development and testing. Contains throwaway code that may be useful for debugging. regression_notebooks - This directory contains notebooks that are used to run regression tests. licenses - This directory contains the licenses for the project. js - This directory contains the javascript code for the project.
We welcome all kinds of contributions: new features, bug fixes, documentation edits; it's all great!
To contribute, make a pull request,
with main as the destination branch.
TreeScape was created by Pascal Aschwandan and Matthew LeGendre.
TreeScape is released under an MIT license. For more details, please see the LICENSE, COPYRIGHT files.
LLNL-CODE-2010855