Metadata-Version: 2.1
Name: lightquakevisualizer
Version: 0.0.6
Summary: A collection of scripts to visualize SeisSol output using pyvista
Author: Thomas Ulrich
License: MIT
Project-URL: Repository, https://github.com/Thomas-Ulrich/light-quake-visualizer.git
Keywords: pyvista,SeisSol
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cmasher
Requires-Dist: cmcrameri
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pyvista
Requires-Dist: seissolxdmf >=0.1.3
Requires-Dist: vtk
Requires-Dist: Pillow

# Light Quake Visualizer

A collection of scripts to visualize SeisSol output using PyVista.

## Features

- Visualize SeisSol output files in XDMF and HDF-VTK formats
- Support for multiple datasets and variables
- Customizable color maps, color ranges, and scalar bar settings, lighting
- Slicing options
- And more...

For more information on available options and their descriptions, run:

```
light_quake_visualizer --help
```


## A simple example of use

Plot the volume output file at time 10s, variable u with a pvcc (saved from ParaView):

```
light_quake_visualizer output_tpv5_ref/tpv5_sym.xdmf --var u --time 10.0 --cmap broc --view output_tpv5_ref/tpv5.pvcc  --scalar_bar "0.9 0.1" --color_range "-0.5 0.5" --zoom 1.0 --lighting 0.6 0.4 0.6
```

## Plotting several datasets

Here sliced volume output (variable u), and (unsliced) fault output (variable ASl):

```
light_quake_visualizer  "output_tpv5_ref/tpv5_sym.xdmf;output_tpv5_ref/tpv5_sym-fault.xdmf" --var "u;ASl" --time 10.0 --cmap "broc;viridis" --view output_tpv5_ref/tpv5.pvcc  --scalar_bar "0.8 0.1" --color_range "-0.5 0.5;0 5" --zoom 1.0 --light 0.5 0.5 0.5 --slice "0 0 -2000 0 0 1" "1;0"
```

## Support for the new HDF-VTK

Example usage with the new HDF-VTK format:
```
light_quake_visualizer  output_tpv5_new_format/tpv5_sym-wavefield-2.hdf --var u --time "i0" --cmap broc --view output_tpv5_ref/tpv5.pvcc  --scalar_bar "0.9 0.1" --color_range "-0.5 0.5" --zoom 1.0 --lighting 0.6 0.4 0.6
```

## Generate vector graphic color bar image

Example usage:

```
generate_color_bar vik --crange -2 2 --labelfont 8 --height 1.2 3.6 --nticks 3
```

## Combining snapshots with possible overlap

Change the background to white, and combine several images with partial overlap:

```
image_combiner --i image1.png image2.png --o combined_image.png --col 2 --rel 0.5 1.0
```
