lightquakevisualizer


Namelightquakevisualizer JSON
Version 0.3.6 PyPI version JSON
download
home_pageNone
SummaryA collection of scripts to visualize SeisSol output using pyvista
upload_time2025-08-01 21:34:35
maintainerNone
docs_urlNone
authorThomas Ulrich
requires_python>=3.10
licenseNone
keywords pyvista seissol
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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  --annotate_text "black 0.1 0.9 {time:.1f}"
```

## 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"
```

## Plotting rupture time contour lines 

Here is an example of plotting fault slip (ASl) with rupture time (RT) contour lines
```
light_quake_visualizer --variable ASl --cmap davos_r0 --color_range "0 3.0" --contour "file_index=0 var=RT contour=grey,2,0,max,1 contour=black,4,0,max,5" --zoom 2.0 --window 1200 600 --output ASl --time "i-1" --view normal output_tpv5_ref/tpv5_sym.xdmf
```

## 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
```

## Support for tandem fault output

```
light_quake_visualizer --time "i::5" --var slip-rate --cmap turbo output/fault.pvd --view xz --log_scale 0 --scalar_bar "0.1 0.3" --annotate_text "black 0.1 0.9 {long_time}" --zoom 1.5 --color_range "1e-7 1e0"
```

## 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
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "lightquakevisualizer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "pyvista, SeisSol",
    "author": "Thomas Ulrich",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/d2/b4/2f0ac25805a6557ef51c9a0800e40892cdcc048fbb04fa7b7a7c1443a564/lightquakevisualizer-0.3.6.tar.gz",
    "platform": null,
    "description": "# Light Quake Visualizer\n\nA collection of scripts to visualize SeisSol output using PyVista.\n\n## Features\n\n- Visualize SeisSol output files in XDMF and HDF-VTK formats\n- Support for multiple datasets and variables\n- Customizable color maps, color ranges, and scalar bar settings, lighting\n- Slicing options\n- And more...\n\nFor more information on available options and their descriptions, run:\n\n```\nlight_quake_visualizer --help\n```\n\n## A simple example of use\n\nPlot the volume output file at time 10s, variable u with a pvcc (saved from ParaView):\n\n```\nlight_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  --annotate_text \"black 0.1 0.9 {time:.1f}\"\n```\n\n## Plotting several datasets\n\nHere sliced volume output (variable u), and (unsliced) fault output (variable ASl):\n\n```\nlight_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\"\n```\n\n## Plotting rupture time contour lines \n\nHere is an example of plotting fault slip (ASl) with rupture time (RT) contour lines\n```\nlight_quake_visualizer --variable ASl --cmap davos_r0 --color_range \"0 3.0\" --contour \"file_index=0 var=RT contour=grey,2,0,max,1 contour=black,4,0,max,5\" --zoom 2.0 --window 1200 600 --output ASl --time \"i-1\" --view normal output_tpv5_ref/tpv5_sym.xdmf\n```\n\n## Support for the new HDF-VTK\n\nExample usage with the new HDF-VTK format:\n```\nlight_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\n```\n\n## Support for tandem fault output\n\n```\nlight_quake_visualizer --time \"i::5\" --var slip-rate --cmap turbo output/fault.pvd --view xz --log_scale 0 --scalar_bar \"0.1 0.3\" --annotate_text \"black 0.1 0.9 {long_time}\" --zoom 1.5 --color_range \"1e-7 1e0\"\n```\n\n## Generate vector graphic color bar image\n\nExample usage:\n\n```\ngenerate_color_bar vik --crange -2 2 --labelfont 8 --height 1.2 3.6 --nticks 3\n```\n\n## Combining snapshots with possible overlap\n\nChange the background to white, and combine several images with partial overlap:\n\n```\nimage_combiner --i image1.png image2.png --o combined_image.png --col 2 --rel 0.5 1.0\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A collection of scripts to visualize SeisSol output using pyvista",
    "version": "0.3.6",
    "project_urls": {
        "Repository": "https://github.com/Thomas-Ulrich/light-quake-visualizer.git"
    },
    "split_keywords": [
        "pyvista",
        " seissol"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "818d23029b6747c692ac29794b4dbc88def7bdf6245bc5cb4208e5c9ded92530",
                "md5": "8cf3553003839ef3608b4a032d2165db",
                "sha256": "1f9cf7f707071056ff76bdea1fd289391547ad92e192d501d15ea602120f1db1"
            },
            "downloads": -1,
            "filename": "lightquakevisualizer-0.3.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8cf3553003839ef3608b4a032d2165db",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 18570,
            "upload_time": "2025-08-01T21:34:33",
            "upload_time_iso_8601": "2025-08-01T21:34:33.970321Z",
            "url": "https://files.pythonhosted.org/packages/81/8d/23029b6747c692ac29794b4dbc88def7bdf6245bc5cb4208e5c9ded92530/lightquakevisualizer-0.3.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d2b42f0ac25805a6557ef51c9a0800e40892cdcc048fbb04fa7b7a7c1443a564",
                "md5": "9d4e6600528be7e90072db8e79d1f8f8",
                "sha256": "4bac76582a26fcfffe5a83f03b3b5a7ddaa3f3a752339f9a50e43cac38372403"
            },
            "downloads": -1,
            "filename": "lightquakevisualizer-0.3.6.tar.gz",
            "has_sig": false,
            "md5_digest": "9d4e6600528be7e90072db8e79d1f8f8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 18324,
            "upload_time": "2025-08-01T21:34:35",
            "upload_time_iso_8601": "2025-08-01T21:34:35.657122Z",
            "url": "https://files.pythonhosted.org/packages/d2/b4/2f0ac25805a6557ef51c9a0800e40892cdcc048fbb04fa7b7a7c1443a564/lightquakevisualizer-0.3.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-01 21:34:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Thomas-Ulrich",
    "github_project": "light-quake-visualizer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "lightquakevisualizer"
}
        
Elapsed time: 1.30589s