# ModVis
[](https://pypi.python.org/pypi/modvis)
[](https://anaconda.org/conda-forge/modvis)
**A python package for model visualization.**
- Free software: MIT license
- Documentation: https://pinshuai.github.io/modvis
## Features
- Visualize model outputs from hydrologic models including ATS, PFLOTRAN, and etc.
- Plot unstructured meshes with variables such as groundwater table, saturation, and evapotranspiration.
- Evaluate model performance using different metrics.
## Installation
`ModVis` is available on PyPI. To install, run the following command:
```
pip install modvis
```
If you want to run the latest version of the code, you can install from git:
```
pip install -U git+https://github.com/pinshuai/modvis.git
```
Alternatively, if you want to debug and test the code, you can clone the repository and install from source:
```
git clone https://github.com/pinshuai/modvis.git
cd modvis
pip install -e .
```
## Quick start
To plot variables on the surface mesh:
```python
import modvis.ats_xdmf as xdmf
import modvis.plot_vis_file as pv
# import visdump file
visfile = xdmf.VisFile(model_dir='.', domain='surface', load_mesh=True)
# plot surface ponded depth
pv.plot_surface_data(visfile, var_name="surface-ponded_depth", log=True,
time_slice="2019-05-01", vmin=0.01, vmax=4)
```
## Examples
Jupyter notebook examples can be found under [examples/notebooks](./examples/notebooks)
## Credits
This work is supported by LDRD funding from PNNL.
This package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [giswqs/pypackage](https://github.com/giswqs/pypackage) project template.
Raw data
{
"_id": null,
"home_page": "https://github.com/pinshuai/modvis",
"name": "modvis",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "modvis",
"author": "Pin Shuai",
"author_email": "pin.shuai@usu.edu",
"download_url": "https://files.pythonhosted.org/packages/99/6b/5c6b938f13fb59801f0991a65e66a8867eea77b59612d5ed1796a3412a51/modvis-0.0.8.tar.gz",
"platform": null,
"description": "# ModVis\n\n\n[](https://pypi.python.org/pypi/modvis)\n\n[](https://anaconda.org/conda-forge/modvis)\n\n\n**A python package for model visualization.**\n\n\n- Free software: MIT license\n- Documentation: https://pinshuai.github.io/modvis\n \n\n## Features\n\n- Visualize model outputs from hydrologic models including ATS, PFLOTRAN, and etc.\n- Plot unstructured meshes with variables such as groundwater table, saturation, and evapotranspiration.\n- Evaluate model performance using different metrics.\n\n## Installation\n\n`ModVis` is available on PyPI. To install, run the following command:\n\n```\npip install modvis\n```\n\nIf you want to run the latest version of the code, you can install from git:\n\n```\npip install -U git+https://github.com/pinshuai/modvis.git\n```\n\nAlternatively, if you want to debug and test the code, you can clone the repository and install from source:\n\n```\ngit clone https://github.com/pinshuai/modvis.git\ncd modvis\npip install -e .\n```\n\n## Quick start\n\nTo plot variables on the surface mesh:\n\n```python\nimport modvis.ats_xdmf as xdmf\nimport modvis.plot_vis_file as pv\n\n# import visdump file\nvisfile = xdmf.VisFile(model_dir='.', domain='surface', load_mesh=True)\n\n# plot surface ponded depth\npv.plot_surface_data(visfile, var_name=\"surface-ponded_depth\", log=True,\n time_slice=\"2019-05-01\", vmin=0.01, vmax=4)\n```\n\n## Examples\n\nJupyter notebook examples can be found under [examples/notebooks](./examples/notebooks)\n\n\n## Credits\n\nThis work is supported by LDRD funding from PNNL.\n\nThis package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [giswqs/pypackage](https://github.com/giswqs/pypackage) project template.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "A python package for model visualization.",
"version": "0.0.8",
"project_urls": {
"Homepage": "https://github.com/pinshuai/modvis"
},
"split_keywords": [
"modvis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "996b5c6b938f13fb59801f0991a65e66a8867eea77b59612d5ed1796a3412a51",
"md5": "511267e41bf7bb38a2eb3781b214476c",
"sha256": "bc1b5fb5ffb340f94653ed6e13dbce263c26f98078b5379849a16a5e3ef268e4"
},
"downloads": -1,
"filename": "modvis-0.0.8.tar.gz",
"has_sig": false,
"md5_digest": "511267e41bf7bb38a2eb3781b214476c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 51630,
"upload_time": "2024-07-09T23:01:55",
"upload_time_iso_8601": "2024-07-09T23:01:55.288837Z",
"url": "https://files.pythonhosted.org/packages/99/6b/5c6b938f13fb59801f0991a65e66a8867eea77b59612d5ed1796a3412a51/modvis-0.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-09 23:01:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pinshuai",
"github_project": "modvis",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "modvis"
}
JSON
