# Pan3D
<img style="display: inline-block;" src="https://media.githubusercontent.com/media/Kitware/pan3d/main/docs/images/kitware.svg" alt="Kitware Logo" href="https://kitware.com" width="100">
[![Documentation Status][docs-image]][docs-link]
[![Binder][binder-image]][binder-link]
[![Build Status][GHAction-image]][GHAction-link]
[![PyPI Version][pypi-v-image]][pypi-v-link]
[![License][apache-license-image]][license-link]
Pan3D aims to be an utility package for viewing and processing a wide variety of multidimensional datasets. Any dataset that can be interpreted with [xarray][xarray-link] can be explored and rendered with Pan3D. [Read The Doc][docs-link] is available for additional information.
XArray Viewer is a Pan3D application focused on geospatial rendering use cases. This is a graphical user interface leveraging the Pan3D infrastructure to help geospatial scientists explore data.
For an introduction to this project, check out our [blog post][blog-post-link].
## Installation
To install requirements for the Pan3D VTK mesh builder class only:
pip install pan3d
To install requirements for the graphical user interface (viewers + explorers):
pip install "pan3d[viewer]"
**Optional**: to install requirements for Pangeo and ESGF catalogs, respectively:
pip install "pan3d[pangeo]"
pip install "pan3d[esgf]"
**Recommended**: To install all requirements, including optional packages:
pip install "pan3d[all]"
## Quick Start
`xr-viewer` is the main entrypoint for launching XArray Viewer locally. Below are some example usages.
To launch XArray Viewer without a target dataset to browse XArray examples:
xr-viewer
To launch XArray Viewer with a local path to a target dataset:
xr-viewer --xarray-file ./examples/example_dataset.nc
To launch XArray Viewer with a remote URL to a target dataset:
xr-viewer --xarray-url https://host.org/link/to/dataset.zarr
To launch XArray Viewer with a compatible configuration file (see [examples][examples-link]):
xr-viewer --import-state ./examples/example_config_xarray.json
To launch the Catalog browser will allow you to query the Pangeo and ESGF Dataset Catalogs (see [Catalogs Tutorial](tutorials/catalogs.md)) depending on the available dependencies:
xr-catalog
You may have to install the required dependencies:
pip install "pan3d[pangeo]"
pip install "pan3d[esgf]"
> The `xr-viewer` entrypoint will automatically launch your default browser to open `localhost:8080`.
>
> To launch without opening your browser, add the `--server` argument to your command.
## Tutorials
- [How to use XArray Viewer](tutorials/dataset_viewer.md)
- [XArray Viewer command line](tutorials/command_line.md)
- [Catalogs Tutorial](tutorials/catalogs.md)
- [How to use Pan3D in a Jupyter notebook](tutorials/jupyter_notebook.md)
## Examples
Pan3D comes with a set of example configuration files and example Jupyter notebooks in the [examples][examples-link] folder. You can checkout the repository to run these locally, or you can use the [Pan3D Binder instance][binder-link] to run these examples.
<!-- Links -->
[docs-image]: https://readthedocs.org/projects/pan3d/badge/?version=latest
[docs-link]: https://pan3d.readthedocs.io/en/latest
[binder-image]: https://mybinder.org/badge_logo.svg
[binder-link]: https://mybinder.org/v2/gh/Kitware/pan3d/main?labpath=examples%2Fjupyter
[GHAction-image]: https://github.com/Kitware/pan3d/workflows/Test/badge.svg
[GHAction-link]: https://github.com/Kitware/pan3d/actions?query=event%3Apush+branch%3Amain
[pypi-v-image]: https://img.shields.io/pypi/v/pan3d.svg
[pypi-v-link]: https://pypi.org/project/pan3d/
[apache-license-image]: https://img.shields.io/badge/license-Apache%202-blue.svg
[license-link]: https://raw.githubusercontent.com/Kitware/pan3d/main/LICENSE
[xarray-link]: https://docs.xarray.dev/en/stable/user-guide/io.html
[blog-post-link]: https://www.kitware.com/kitware-introduces-pan3d-a-collaborative-interoperable-visualization-tool/
[examples-link]: https://github.com/Kitware/pan3d/tree/main/examples
Raw data
{
"_id": null,
"home_page": null,
"name": "pan3d",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "Python, Interactive, Web, Application, Framework",
"author": "Kitware Inc.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9a/48/0171e4aff95bb0433a99e9a7808aaee643c759b9b0d87401a27d1fbd49d7/pan3d-0.12.0.tar.gz",
"platform": null,
"description": "# Pan3D\n\n<img style=\"display: inline-block;\" src=\"https://media.githubusercontent.com/media/Kitware/pan3d/main/docs/images/kitware.svg\" alt=\"Kitware Logo\" href=\"https://kitware.com\" width=\"100\">\n\n[![Documentation Status][docs-image]][docs-link]\n[![Binder][binder-image]][binder-link]\n[![Build Status][GHAction-image]][GHAction-link]\n[![PyPI Version][pypi-v-image]][pypi-v-link]\n[![License][apache-license-image]][license-link]\n\nPan3D aims to be an utility package for viewing and processing a wide variety of multidimensional datasets. Any dataset that can be interpreted with [xarray][xarray-link] can be explored and rendered with Pan3D. [Read The Doc][docs-link] is available for additional information.\n\nXArray Viewer is a Pan3D application focused on geospatial rendering use cases. This is a graphical user interface leveraging the Pan3D infrastructure to help geospatial scientists explore data.\n\n\n\nFor an introduction to this project, check out our [blog post][blog-post-link].\n\n\n## Installation\n\nTo install requirements for the Pan3D VTK mesh builder class only:\n\n pip install pan3d\n\nTo install requirements for the graphical user interface (viewers + explorers):\n\n pip install \"pan3d[viewer]\"\n\n**Optional**: to install requirements for Pangeo and ESGF catalogs, respectively:\n\n pip install \"pan3d[pangeo]\"\n\n pip install \"pan3d[esgf]\"\n\n**Recommended**: To install all requirements, including optional packages:\n\n pip install \"pan3d[all]\"\n\n## Quick Start\n\n`xr-viewer` is the main entrypoint for launching XArray Viewer locally. Below are some example usages.\n\nTo launch XArray Viewer without a target dataset to browse XArray examples:\n\n xr-viewer\n\nTo launch XArray Viewer with a local path to a target dataset:\n\n xr-viewer --xarray-file ./examples/example_dataset.nc\n\nTo launch XArray Viewer with a remote URL to a target dataset:\n\n xr-viewer --xarray-url https://host.org/link/to/dataset.zarr\n\nTo launch XArray Viewer with a compatible configuration file (see [examples][examples-link]):\n\n xr-viewer --import-state ./examples/example_config_xarray.json\n\nTo launch the Catalog browser will allow you to query the Pangeo and ESGF Dataset Catalogs (see [Catalogs Tutorial](tutorials/catalogs.md)) depending on the available dependencies:\n\n xr-catalog\n\nYou may have to install the required dependencies:\n\n pip install \"pan3d[pangeo]\"\n pip install \"pan3d[esgf]\"\n\n\n> The `xr-viewer` entrypoint will automatically launch your default browser to open `localhost:8080`.\n>\n> To launch without opening your browser, add the `--server` argument to your command.\n\n\n## Tutorials\n\n- [How to use XArray Viewer](tutorials/dataset_viewer.md)\n- [XArray Viewer command line](tutorials/command_line.md)\n- [Catalogs Tutorial](tutorials/catalogs.md)\n- [How to use Pan3D in a Jupyter notebook](tutorials/jupyter_notebook.md)\n\n## Examples\n\nPan3D comes with a set of example configuration files and example Jupyter notebooks in the [examples][examples-link] folder. You can checkout the repository to run these locally, or you can use the [Pan3D Binder instance][binder-link] to run these examples.\n\n\n<!-- Links -->\n[docs-image]: https://readthedocs.org/projects/pan3d/badge/?version=latest\n[docs-link]: https://pan3d.readthedocs.io/en/latest\n[binder-image]: https://mybinder.org/badge_logo.svg\n[binder-link]: https://mybinder.org/v2/gh/Kitware/pan3d/main?labpath=examples%2Fjupyter\n[GHAction-image]: https://github.com/Kitware/pan3d/workflows/Test/badge.svg\n[GHAction-link]: https://github.com/Kitware/pan3d/actions?query=event%3Apush+branch%3Amain\n[pypi-v-image]: https://img.shields.io/pypi/v/pan3d.svg\n[pypi-v-link]: https://pypi.org/project/pan3d/\n[apache-license-image]: https://img.shields.io/badge/license-Apache%202-blue.svg\n[license-link]: https://raw.githubusercontent.com/Kitware/pan3d/main/LICENSE\n[xarray-link]: https://docs.xarray.dev/en/stable/user-guide/io.html\n[blog-post-link]: https://www.kitware.com/kitware-introduces-pan3d-a-collaborative-interoperable-visualization-tool/\n[examples-link]: https://github.com/Kitware/pan3d/tree/main/examples\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Utility package for processing and visualizing 3D datasets",
"version": "0.12.0",
"project_urls": null,
"split_keywords": [
"python",
" interactive",
" web",
" application",
" framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b8e3afa3f70b0ccbde1ab0921b4337111e212ecc85f6237a5e2fde3ec09310b2",
"md5": "56fbb6f8d49b7512d7d1f10cf1c617cb",
"sha256": "a95b24602fec51b1ef1c89cbc2ccca7430a54688f144022fbbd8213c2b2215c5"
},
"downloads": -1,
"filename": "pan3d-0.12.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "56fbb6f8d49b7512d7d1f10cf1c617cb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 87001,
"upload_time": "2024-12-09T21:37:56",
"upload_time_iso_8601": "2024-12-09T21:37:56.059078Z",
"url": "https://files.pythonhosted.org/packages/b8/e3/afa3f70b0ccbde1ab0921b4337111e212ecc85f6237a5e2fde3ec09310b2/pan3d-0.12.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9a480171e4aff95bb0433a99e9a7808aaee643c759b9b0d87401a27d1fbd49d7",
"md5": "ab968fab963e0617d596ef03607b9784",
"sha256": "fb1bd8e1f24669981c0f4647a28cfc9c2579c81add017a14ae51218dc8d28e0f"
},
"downloads": -1,
"filename": "pan3d-0.12.0.tar.gz",
"has_sig": false,
"md5_digest": "ab968fab963e0617d596ef03607b9784",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 74603,
"upload_time": "2024-12-09T21:37:57",
"upload_time_iso_8601": "2024-12-09T21:37:57.949491Z",
"url": "https://files.pythonhosted.org/packages/9a/48/0171e4aff95bb0433a99e9a7808aaee643c759b9b0d87401a27d1fbd49d7/pan3d-0.12.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 21:37:57",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pan3d"
}
JSON