# MultivariateView
A multivariate/multimodal volume visualizer!
This [RadVolViz](https://doi.org/10.1109/TVCG.2023.3263856)-inspired prototype utilizes [trame](https://kitware.github.io/trame/) and [VTK](https://vtk.org/) to render multi-channel volumetric datasets.
# Install and Run
To install, first ensure you are in an environment using Python3.10 or newer, and then run the following command:
```bash
pip install multivariate-view
```
Next, run `multivariate-view`, or `mv-view`, to start the application. If no `--data` path is provided, it will
automatically download and load the example dataset pictured above.
# Example Data
The example dataset pictured above is from the reconstruction of an X-ray fluorescence tomography of a mixed ionic-electronic conductor (MIEC) from the following article:
*Ge, M., Huang, X., Yan, H. et al. Three-dimensional imaging of grain boundaries via quantitative fluorescence X-ray tomography analysis. Commun Mater 3, 37 (2022). https://doi.org/10.1038/s43246-022-00259-x*
This example dataset is downloaded automatically and loaded if the application is started without providing a `--data` path. Utilizing the lens in MultivariateView produces visualizations of the following phases:
## CGO Phase (ionic conductor)
## CFO Phase (electronic conductor)
## EP2 Phase (emergent phase)
*Note: the EP1 phase from the paper is comprised of fewer voxels and is more difficult to visualize without data filters*
# Data Loading
Two of the easiest formats to use are HDF5 and NPZ. For both of these file types, each channel of the volume should have its own dataset at the top level, and each dataset must be identical in shape and datatype. There should be no other datasets present.
If the application is started with `multivariate-view --data /path/to/data.h5`, then all root level datasets will be loaded automatically and visualized.
Raw data
{
"_id": null,
"home_page": null,
"name": "multivariate-view",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Patrick Avery <patrick.avery@kitware.com>, Sankhesh Jhaveri <sankhesh.jhaveri@kitware.com>, Sebastien Jourdain <sebastien.jourdain@kitware.com>",
"keywords": "web, trame, vtk, radvolviz, multivariate, volume",
"author": null,
"author_email": "Patrick Avery <patrick.avery@kitware.com>, Sankhesh Jhaveri <sankhesh.jhaveri@kitware.com>, Sebastien Jourdain <sebastien.jourdain@kitware.com>",
"download_url": "https://files.pythonhosted.org/packages/b8/f6/b3e0f42f27a139296476e957fc67f74f7c53f6a1f4bf70bdea4967651cb8/multivariate_view-0.1.1.tar.gz",
"platform": null,
"description": "# MultivariateView\n\n\n\nA multivariate/multimodal volume visualizer!\n\nThis [RadVolViz](https://doi.org/10.1109/TVCG.2023.3263856)-inspired prototype utilizes [trame](https://kitware.github.io/trame/) and [VTK](https://vtk.org/) to render multi-channel volumetric datasets.\n\n# Install and Run\n\nTo install, first ensure you are in an environment using Python3.10 or newer, and then run the following command:\n\n```bash\npip install multivariate-view\n```\n\nNext, run `multivariate-view`, or `mv-view`, to start the application. If no `--data` path is provided, it will\nautomatically download and load the example dataset pictured above.\n\n# Example Data\nThe example dataset pictured above is from the reconstruction of an X-ray fluorescence tomography of a mixed ionic-electronic conductor (MIEC) from the following article:\n\n*Ge, M., Huang, X., Yan, H. et al. Three-dimensional imaging of grain boundaries via quantitative fluorescence X-ray tomography analysis. Commun Mater 3, 37 (2022). https://doi.org/10.1038/s43246-022-00259-x*\n\nThis example dataset is downloaded automatically and loaded if the application is started without providing a `--data` path. Utilizing the lens in MultivariateView produces visualizations of the following phases:\n\n## CGO Phase (ionic conductor)\n\n\n## CFO Phase (electronic conductor)\n\n\n## EP2 Phase (emergent phase)\n\n\n*Note: the EP1 phase from the paper is comprised of fewer voxels and is more difficult to visualize without data filters*\n\n# Data Loading\n\nTwo of the easiest formats to use are HDF5 and NPZ. For both of these file types, each channel of the volume should have its own dataset at the top level, and each dataset must be identical in shape and datatype. There should be no other datasets present.\n\nIf the application is started with `multivariate-view --data /path/to/data.h5`, then all root level datasets will be loaded automatically and visualized.\n",
"bugtrack_url": null,
"license": "Copyright 2024 Kitware Inc. Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ",
"summary": "RadVolViz-inspired multivariate volume visualizer using VTK",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"web",
" trame",
" vtk",
" radvolviz",
" multivariate",
" volume"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0fbf6d528a7bd6466e6ab4709bcde7a98c6aac6e4443f02d1ebde0ba5716c061",
"md5": "411cc065550e78bd92ddfec51f534143",
"sha256": "7699c44ebefbf56423e1072f897ca8b24ec6bb7ee9ccfe4233d6374b6fe4f927"
},
"downloads": -1,
"filename": "multivariate_view-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "411cc065550e78bd92ddfec51f534143",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 1844457,
"upload_time": "2024-06-09T03:11:19",
"upload_time_iso_8601": "2024-06-09T03:11:19.114757Z",
"url": "https://files.pythonhosted.org/packages/0f/bf/6d528a7bd6466e6ab4709bcde7a98c6aac6e4443f02d1ebde0ba5716c061/multivariate_view-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b8f6b3e0f42f27a139296476e957fc67f74f7c53f6a1f4bf70bdea4967651cb8",
"md5": "bb508fdaabb1e624ef83affe5a162fe3",
"sha256": "337b35484a51a1de30b59a56957b6b61e2e604e99a6f5da53e2c80cd3609bf7c"
},
"downloads": -1,
"filename": "multivariate_view-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "bb508fdaabb1e624ef83affe5a162fe3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1781647,
"upload_time": "2024-06-09T03:11:23",
"upload_time_iso_8601": "2024-06-09T03:11:23.349594Z",
"url": "https://files.pythonhosted.org/packages/b8/f6/b3e0f42f27a139296476e957fc67f74f7c53f6a1f4bf70bdea4967651cb8/multivariate_view-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-09 03:11:23",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "multivariate-view"
}
JSON