| Name | cigvis JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | CIGVis is a tool for geophysical data visualization |
| upload_time | 2024-11-30 10:10:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
visualization
geophysics
seismic
data
cigvis
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# CIGVis - a tool for visualizing multidimensional geophysical data
## Overview
**cigvis** is a tool for visualizing multidimensional geophysical data, developed by the [Computational Interpretation Group (CIG)](https://cig.ustc.edu.cn/main.htm). Users can quickly visualize data with just a few lines of code.
cigvis can be used for various geophysical data visualizations, including 3D seismic data, overlays of seismic data with other information like labels, faults, RGT, horizon surfaces, well log trajectories, and well log curves, 3D geological bodies, 2D data, and 1D data, among others. Its GitHub repository can be found at [github.com/JintaoLee-Roger/cigvis](https://github.com/JintaoLee-Roger/cigvis), and documentation is available at [https://cigvis.readthedocs.io/](https://cigvis.readthedocs.io/).
cigvis leverages the power of underlying libraries such as [vispy](https://github.com/vispy/vispy) for 3D visualization, [matplotlib](https://matplotlib.org/) for 2D and 1D visualization, [plotly](https://plotly.com/) for Jupyter environments (work in progress), and [viser](https://github.com/nerfstudio-project/viser) for web-based visualization (SSH-Friendly). The 3D visualization component is heavily based on the code from [yunzhishi/seismic-canvas](https://github.com/yunzhishi/seismic-canvas) and has been further developed upon this foundation.
## Installation
To install via PyPI, use:
```shell
# Minimal installation
pip install cigvis
# include plotly
pip install "cigvis[plotly]"
# include viser
pip install "cigvis[viser]"
# install all dependencies
pip install "cigvis[all]"
```
For local installation, clone the repository from GitHub and then install it using pip:
```shell
git clone https://github.com/JintaoLee-Roger/cigvis.git
# Minimal installation
pip install -e . --config-settings editable_mode=compat
# include plotly
pip install -e ".[plotly]" --config-settings editable_mode=compat
# include viser
pip install -e ".[viser]" --config-settings editable_mode=compat
# install all dependencies
pip install -e ".[all]" --config-settings editable_mode=compat
```
## Core Features
1. Convenient 3D geophysical data visualization.
2. Ongoing development of 2D and 1D data visualization.
3. Additional colormaps tailored for geophysical data.
4. Rapid display of large data in OpenVDS format.
## Usage
### Basic Structure
The fundamental structure of cigvis's visualization code consists of:
1. Data loading
2. Creating nodes
3. Passing nodes to the `plot3D` function
For example:
```python
import numpy as np
import cigvis
# Load data
d = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)
# Create nodes
nodes = cigvis.create_slices(d)
# Visualize in 3D
cigvis.plot3D(nodes)
```
This basic code structure allows you to quickly visualize your geophysical data using cigvis. Simply load your data, create nodes, and pass them to the `plot3D` function as demonstrated in the example above.
### Camera and Dragging
Left click and drag to rotate the camera angle; right click and drag, or scroll mouse wheel, to zoom in and out. Hold `<Shift>` key, left click and drag to pan move. Press `<Space>` key to return to the initial view. Press `<S>` key to save a screenshot PNG file at any time. Press `<Esc>` key to close the window.
Hold `<Ctrl>` key, the selectable visual nodes will be highlighted when your mouse hovers over them; left click and drag to move the highlighted visual node. The volume slices will update their contents in real-time during dragging. You can also press `<D>` key to toggle the dragging mode on/off.
Press `<z>` to zoom in z axis, press `<Z>` or `<Shift> + <z>` to zoom out z axis.
Press `<f>` to increase `fov` value, press `<F>` or `<Shift> + <f>` to decrease `fov` value.
Press `<s>` to save a screen shot.
Press `<a>` to print the camera's parameters in real-time; hold on
the `<alt>` (or `<option>` in macos) and left click the mouse to
show the coordinate of the click point in the 3D volume.
### Various Geophysical data
In cigvis, we represent various geophysical data as individual nodes, assemble these nodes into a list, and then pass this list to the `plot3D` function for visualization.
We visualize a three-dimensional data volume as multiple slices along the x, y, and z directions. Additionally, we can overlay other three-dimensional data slices on these slices, allowing users to interactively drag them along an axis using the mouse.
Horizon data can be represented as scatter points with a shape of (N, 3), or as z-values on a regular grid of size (n1, n2).
Well log trajectories are displayed as tubes, where the size of the first well log curve is represented by the color and radius at each position along the tube. Other well log curves are displayed as surfaces attached to the tube's edge. An example is shown below (code available at [cigvis/gallery/3Dvispy/09](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/09-slice_surf_body_logs.html#sphx-glr-gallery-3dvispy-09-slice-surf-body-logs-py)).
These capabilities within cigvis allow for versatile and interactive visualizations of a wide range of geophysical data types, enhancing the understanding and analysis of such data in geoscience applications.
### Multivolumes in One Canvas
You can pass multiple independent nodes combinations to the `plot3D` function while specifying a grid (e.g., `grid=(2,2)`). This allows you to divide the canvas into multiple independent sub-canvases, where each sub-canvas displays a separate 3D data set within the same canvas. The example code for this can be found in the documentation at [cigvis/gallery/3Dvispy/10](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/10-multi_canvas.html#sphx-glr-gallery-3dvispy-10-multi-canvas-py).
Furthermore, you can link the cameras of all sub-canvases together (just need pass `share=True` to `plot3D` function). This means that any rotation, scaling, or slicing performed in one sub-canvas will be mirrored in all other sub-canvases, ensuring that they all exhibit the same changes simultaneously. This feature is highly advantageous when comparing multiple sets of data, such as results from different experiments, results alongside labels, seismic data compared with attributes, and more.
You can find example code for this functionality in the documentation at [cigvis/gallery/3Dvispy/11](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/11-share_cameras.html#sphx-glr-gallery-3dvispy-11-share-cameras-py).
These capabilities provide a powerful way to visualize and compare multiple independent 3D data sets within a single canvas using cigvis.
## Web-based Visualization
Based on [viser](https://github.com/nerfstudio-project/viser), cigvis also supports visualization 3D data in web/browser environment with just a few lines changed. All you need to do is simply replace `cigvis` with `viserplot`, see follows:
``` diff
import numpy as np
import cigvis
+ from cigvis import viserplot
# Load data
d = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)
# Create nodes
- nodes = cigvis.create_slices(d)
+ nodes = viserplot.create_slices(d)
# Visualize in 3D
- cigvis.plot3D(nodes)
+ viserplot.plot3D(nodes)
```
When you are in `jupyter` environment, we recommand to maintain a unique server, otherwise the port will be changed.
``` diff
import numpy as np
import cigvis
+ from cigvis import viserplot
+ server = viserplot.create_server(8080)
# Load data
d = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)
# Create nodes
- nodes = cigvis.create_slices(d)
+ nodes = viserplot.create_slices(d)
# Visualize in 3D
- cigvis.plot3D(nodes)
+ viserplot.plot3D(nodes, server=server)
```
After calling `viserplot.plot3D`, it will generate some logs like:
```txt
╭─────────────── viser ───────────────╮
│ ╷ │
│ HTTP │ http://0.0.0.0:8080 │
│ Websocket │ ws://0.0.0.0:8080 │
│ ╵ │
╰─────────────────────────────────────╯
```
If you are running the code on your local machine, just open `0.0.0.0:8080` in your browser to see the image. If you are running the code on a remote server (yes, cigvis also works when connected remotely using ssh!), you can enter `{ip}:8080` in the browser to see the visualization (`ip` is the ip of remote server, e.g., `222.195.77.88:8080`).
There are sevreal examples in `examples/viser/` for reference.
## Example Data
All data used by examples in the [gallery](https://cigvis.readthedocs.io/gallery) can be download at [https://rec.ustc.edu.cn/share/19a16120-5c42-11ee-a0d4-4329aa6b754b](https://rec.ustc.edu.cn/share/19a16120-5c42-11ee-a0d4-4329aa6b754b), password: `1234`.
## Example Gallery
See: [cigvis/gallery](https://cigvis.readthedocs.io/en/latest/gallery/index.html)
## TODO
- [ ] move all functions for triangle mesh creation to `meshs/`
Raw data
{
"_id": null,
"home_page": null,
"name": "cigvis",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "visualization, geophysics, seismic, data, cigvis",
"author": null,
"author_email": "Jintao Li <lijintaobt@gmail.com>",
"download_url": null,
"platform": null,
"description": "\n\n# CIGVis - a tool for visualizing multidimensional geophysical data\n\n## Overview\n\n**cigvis** is a tool for visualizing multidimensional geophysical data, developed by the [Computational Interpretation Group (CIG)](https://cig.ustc.edu.cn/main.htm). Users can quickly visualize data with just a few lines of code.\n\ncigvis can be used for various geophysical data visualizations, including 3D seismic data, overlays of seismic data with other information like labels, faults, RGT, horizon surfaces, well log trajectories, and well log curves, 3D geological bodies, 2D data, and 1D data, among others. Its GitHub repository can be found at [github.com/JintaoLee-Roger/cigvis](https://github.com/JintaoLee-Roger/cigvis), and documentation is available at [https://cigvis.readthedocs.io/](https://cigvis.readthedocs.io/).\n\ncigvis leverages the power of underlying libraries such as [vispy](https://github.com/vispy/vispy) for 3D visualization, [matplotlib](https://matplotlib.org/) for 2D and 1D visualization, [plotly](https://plotly.com/) for Jupyter environments (work in progress), and [viser](https://github.com/nerfstudio-project/viser) for web-based visualization (SSH-Friendly). The 3D visualization component is heavily based on the code from [yunzhishi/seismic-canvas](https://github.com/yunzhishi/seismic-canvas) and has been further developed upon this foundation.\n\n## Installation\n\nTo install via PyPI, use:\n```shell\n# Minimal installation\npip install cigvis\n\n# include plotly \npip install \"cigvis[plotly]\"\n\n# include viser\npip install \"cigvis[viser]\"\n\n# install all dependencies\npip install \"cigvis[all]\"\n```\n\nFor local installation, clone the repository from GitHub and then install it using pip:\n```shell\ngit clone https://github.com/JintaoLee-Roger/cigvis.git\n# Minimal installation\npip install -e . --config-settings editable_mode=compat\n\n# include plotly \npip install -e \".[plotly]\" --config-settings editable_mode=compat\n\n# include viser\npip install -e \".[viser]\" --config-settings editable_mode=compat\n\n# install all dependencies\npip install -e \".[all]\" --config-settings editable_mode=compat\n```\n\n## Core Features\n\n1. Convenient 3D geophysical data visualization.\n2. Ongoing development of 2D and 1D data visualization.\n3. Additional colormaps tailored for geophysical data.\n4. Rapid display of large data in OpenVDS format.\n\n\n## Usage\n\n### Basic Structure\n\nThe fundamental structure of cigvis's visualization code consists of:\n1. Data loading\n2. Creating nodes\n3. Passing nodes to the `plot3D` function\n\nFor example:\n```python\nimport numpy as np\nimport cigvis\n\n# Load data\nd = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)\n\n# Create nodes\nnodes = cigvis.create_slices(d)\n\n# Visualize in 3D\ncigvis.plot3D(nodes)\n```\n\nThis basic code structure allows you to quickly visualize your geophysical data using cigvis. Simply load your data, create nodes, and pass them to the `plot3D` function as demonstrated in the example above.\n\n### Camera and Dragging\n\nLeft click and drag to rotate the camera angle; right click and drag, or scroll mouse wheel, to zoom in and out. Hold `<Shift>` key, left click and drag to pan move. Press `<Space>` key to return to the initial view. Press `<S>` key to save a screenshot PNG file at any time. Press `<Esc>` key to close the window.\n\nHold `<Ctrl>` key, the selectable visual nodes will be highlighted when your mouse hovers over them; left click and drag to move the highlighted visual node. The volume slices will update their contents in real-time during dragging. You can also press `<D>` key to toggle the dragging mode on/off.\n\nPress `<z>` to zoom in z axis, press `<Z>` or `<Shift> + <z>` to zoom out z axis. \nPress `<f>` to increase `fov` value, press `<F>` or `<Shift> + <f>` to decrease `fov` value.\n\n\n\nPress `<s>` to save a screen shot.\n\nPress `<a>` to print the camera's parameters in real-time; hold on \nthe `<alt>` (or `<option>` in macos) and left click the mouse to \nshow the coordinate of the click point in the 3D volume.\n\n\n\n\n### Various Geophysical data\n\nIn cigvis, we represent various geophysical data as individual nodes, assemble these nodes into a list, and then pass this list to the `plot3D` function for visualization.\n\nWe visualize a three-dimensional data volume as multiple slices along the x, y, and z directions. Additionally, we can overlay other three-dimensional data slices on these slices, allowing users to interactively drag them along an axis using the mouse.\n\nHorizon data can be represented as scatter points with a shape of (N, 3), or as z-values on a regular grid of size (n1, n2).\n\nWell log trajectories are displayed as tubes, where the size of the first well log curve is represented by the color and radius at each position along the tube. Other well log curves are displayed as surfaces attached to the tube's edge. An example is shown below (code available at [cigvis/gallery/3Dvispy/09](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/09-slice_surf_body_logs.html#sphx-glr-gallery-3dvispy-09-slice-surf-body-logs-py)).\n\n\n\nThese capabilities within cigvis allow for versatile and interactive visualizations of a wide range of geophysical data types, enhancing the understanding and analysis of such data in geoscience applications.\n\n\n### Multivolumes in One Canvas\n\nYou can pass multiple independent nodes combinations to the `plot3D` function while specifying a grid (e.g., `grid=(2,2)`). This allows you to divide the canvas into multiple independent sub-canvases, where each sub-canvas displays a separate 3D data set within the same canvas. The example code for this can be found in the documentation at [cigvis/gallery/3Dvispy/10](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/10-multi_canvas.html#sphx-glr-gallery-3dvispy-10-multi-canvas-py).\n\n\n\nFurthermore, you can link the cameras of all sub-canvases together (just need pass `share=True` to `plot3D` function). This means that any rotation, scaling, or slicing performed in one sub-canvas will be mirrored in all other sub-canvases, ensuring that they all exhibit the same changes simultaneously. This feature is highly advantageous when comparing multiple sets of data, such as results from different experiments, results alongside labels, seismic data compared with attributes, and more. \nYou can find example code for this functionality in the documentation at [cigvis/gallery/3Dvispy/11](https://cigvis.readthedocs.io/en/latest/gallery/3Dvispy/11-share_cameras.html#sphx-glr-gallery-3dvispy-11-share-cameras-py).\n\n\n\nThese capabilities provide a powerful way to visualize and compare multiple independent 3D data sets within a single canvas using cigvis.\n\n## Web-based Visualization\n\nBased on [viser](https://github.com/nerfstudio-project/viser), cigvis also supports visualization 3D data in web/browser environment with just a few lines changed. All you need to do is simply replace `cigvis` with `viserplot`, see follows:\n\n``` diff\n import numpy as np\n import cigvis\n+ from cigvis import viserplot\n\n # Load data\n d = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)\n\n # Create nodes\n- nodes = cigvis.create_slices(d)\n+ nodes = viserplot.create_slices(d)\n\n # Visualize in 3D\n- cigvis.plot3D(nodes)\n+ viserplot.plot3D(nodes)\n```\n\nWhen you are in `jupyter` environment, we recommand to maintain a unique server, otherwise the port will be changed.\n\n``` diff\n import numpy as np\n import cigvis\n+ from cigvis import viserplot\n+ server = viserplot.create_server(8080)\n\n # Load data\n d = np.fromfile('sx.dat', np.float32).reshape(ni, nt, nx)\n\n # Create nodes\n- nodes = cigvis.create_slices(d)\n+ nodes = viserplot.create_slices(d)\n\n # Visualize in 3D\n- cigvis.plot3D(nodes)\n+ viserplot.plot3D(nodes, server=server)\n```\n\nAfter calling `viserplot.plot3D`, it will generate some logs like:\n```txt\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 viser \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 \u2577 \u2502\n\u2502 HTTP \u2502 http://0.0.0.0:8080 \u2502\n\u2502 Websocket \u2502 ws://0.0.0.0:8080 \u2502\n\u2502 \u2575 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n```\n\nIf you are running the code on your local machine, just open `0.0.0.0:8080` in your browser to see the image. If you are running the code on a remote server (yes, cigvis also works when connected remotely using ssh!), you can enter `{ip}:8080` in the browser to see the visualization (`ip` is the ip of remote server, e.g., `222.195.77.88:8080`).\n\nThere are sevreal examples in `examples/viser/` for reference.\n\n\n## Example Data\n\nAll data used by examples in the [gallery](https://cigvis.readthedocs.io/gallery) can be download at [https://rec.ustc.edu.cn/share/19a16120-5c42-11ee-a0d4-4329aa6b754b](https://rec.ustc.edu.cn/share/19a16120-5c42-11ee-a0d4-4329aa6b754b), password: `1234`.\n\n\n## Example Gallery\n\nSee: [cigvis/gallery](https://cigvis.readthedocs.io/en/latest/gallery/index.html)\n\n## TODO\n\n- [ ] move all functions for triangle mesh creation to `meshs/`\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CIGVis is a tool for geophysical data visualization",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/JintaoLee-Roger/cigvis",
"documentation": "https://cigvis.readthedocs.io/en/latest/"
},
"split_keywords": [
"visualization",
" geophysics",
" seismic",
" data",
" cigvis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "edb49666fd2dfcb9fb107dd309261f83cba264bbdbcb6b3dd6ce4c9d2e94104f",
"md5": "c4149b9447968e97c6bf9bd122f97ca9",
"sha256": "46b54bc12d60fff4fc6ca44ff1772e55084dfdbfd332110b6f35fb600a485ef2"
},
"downloads": -1,
"filename": "cigvis-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4149b9447968e97c6bf9bd122f97ca9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 146865,
"upload_time": "2024-11-30T10:10:49",
"upload_time_iso_8601": "2024-11-30T10:10:49.014169Z",
"url": "https://files.pythonhosted.org/packages/ed/b4/9666fd2dfcb9fb107dd309261f83cba264bbdbcb6b3dd6ce4c9d2e94104f/cigvis-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-30 10:10:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JintaoLee-Roger",
"github_project": "cigvis",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "cigvis"
}
