{"id":24241743,"url":"https://github.com/joergbuchwald/vtuinterface","last_synced_at":"2025-10-26T14:43:57.882Z","repository":{"id":39493159,"uuid":"282728412","full_name":"joergbuchwald/VTUinterface","owner":"joergbuchwald","description":"Python-Interface for reading and writing VTU files and exactracting time series data from PVD/VTU files","archived":false,"fork":false,"pushed_at":"2024-11-13T12:31:03.000Z","size":13251,"stargazers_count":16,"open_issues_count":3,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-14T02:48:23.350Z","etag":null,"topics":["julia","pvd","pvd-files","python","series-data","timesteps","vtk","vtu","vtu-files"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joergbuchwald.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-26T20:32:02.000Z","updated_at":"2024-11-13T12:31:06.000Z","dependencies_parsed_at":"2024-02-29T17:52:53.348Z","dependency_job_id":"f17c44e5-09b7-4b73-8ccf-1828e0e4e928","html_url":"https://github.com/joergbuchwald/VTUinterface","commit_stats":{"total_commits":188,"total_committers":7,"mean_commits":"26.857142857142858","dds":"0.22340425531914898","last_synced_commit":"a100860c634691d7c120dabd9b0dce4dc6deb10e"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joergbuchwald%2FVTUinterface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joergbuchwald%2FVTUinterface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joergbuchwald%2FVTUinterface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joergbuchwald%2FVTUinterface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joergbuchwald","download_url":"https://codeload.github.com/joergbuchwald/VTUinterface/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233963945,"owners_count":18758122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["julia","pvd","pvd-files","python","series-data","timesteps","vtk","vtu","vtu-files"],"created_at":"2025-01-14T21:40:23.105Z","updated_at":"2025-09-23T09:31:57.900Z","avatar_url":"https://github.com/joergbuchwald.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![DOI](https://zenodo.org/badge/282728412.svg)](https://zenodo.org/badge/latestdoi/282728412) [![VTUinterface](https://github.com/joergbuchwald/VTUinterface/actions/workflows/python-package.yml/badge.svg)](https://github.com/joergbuchwald/VTUinterface/actions/workflows/python-package.yml) [![codecov](https://codecov.io/gh/joergbuchwald/VTUinterface/branch/master/graph/badge.svg?token=9E1OJIJI8Z)](https://codecov.io/gh/joergbuchwald/VTUinterface) [![DOI](https://joss.theoj.org/papers/10.21105/joss.03673/status.svg)](https://doi.org/10.21105/joss.03673)\n\n\n# VTUinterface\n\nVTUinterface is a python package for easy accessing VTU/PVD files as outputed by Finite Element software like OpenGeoSys. It uses the VTK python wrapper and linear interpolation between time steps and grid points to access any points in space and time within the simulation domain.\n\n\nVTUinterface together with ogs6py can be viewed in action here:\n\n[![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/eihNKjK-I-s/0.jpg)](https://www.youtube.com/watch?v=eihNKjK-I-s)\n\n## 0. Installation\n\nNote: VTUinterface requires the vtk wrapper for python. Alternatively, [a version](https://github.com/joergbuchwald/VTUinterface/tree/meshio) based on [MESHIO](https://github.com/nschloe/meshio) is also under development.\nclone the repository and use pip to install the package\n\n```shell\n# pip install [--user] https://github.com/joergbuchwald/VTUinterface/archive/refs/heads/master.zip\n```\n\n## 1. Documentation for VTUinterface\n\nYou can find the documentation under [https://joergbuchwald.github.io/VTUinterface-doc/](https://joergbuchwald.github.io/VTUinterface-doc/)\n\n\n\n## 2. Quick start\n\n## CAUTION: naming style of methods has changed (2021-05-20)\n\n[Basic Usage (python)](https://github.com/joergbuchwald/VTUinterface/blob/master/README_python.md)\n\nAlthough, a python package, VTUinterface is tested to work through PyCall under julia as well:\n\n[Basic Usage (julia)](https://github.com/joergbuchwald/VTUinterface/blob/master/README_julia.md)\n\n\nUnittests can be run via\n\n```shell\n# python tests/test_vtuinterface.py\n```\nfrom the project root directory.\n\n## 3. FAQ/Troubleshooting\n\nInstallation:\n- If the vtk whell can't be found on PyPI you can checkout https://github.com/pyvista/pyvista/discussions/2064 for unofficial wheels.\n\nAs the input data is triangulated with QHull for the linear interpolation it might fail at boundaries or if a wrong input dimension is given.\nPossible solutions:\n\n- In order for interpolation to work correctly providing the correct dimension (set via `dim` keyword) of the problem is crucial.\n- As the `dim` keyword specifies also the coordinates to use, VTUinterface assumes that `dim=1` refers to the x coordinate and `dim=2` implies that the problem lies in the xy-plane by default. This can be changed by specifying `one_d_axis` for one dimension or `two_d_planenormal` for two dimensions.\n- For some meshes it might help to adjust the number of points taken into account by the triangulation, which can be done using the `nneighbors` keyword. Default value is 20.\n- Especially along boundaries, linear interpolation with the QHULL method often fails, this can be resolved by using nearest neighbor interpolation.\n- Alternatively, you can change now the `interpolation_backend` from scipy to vtk and try out different interpolation kernels.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoergbuchwald%2Fvtuinterface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoergbuchwald%2Fvtuinterface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoergbuchwald%2Fvtuinterface/lists"}