OpenViSUS Visualization project
The mission of ViSUS.org is to provide support for the scientific community with Big Data, management, analysis and visualization tools.
In this website we provide access to open source software tools and libraries such as the ViSUS framework and the PIDX library. These softwares are distributed under the permissive BSD license (see LICENSE file).
conda see docs/conda_installation.md.
pip is installed, updated and in PATH. The installation is tested on python3.7, so it is recommended.
pip install --upgrade OpenVisus # configure OpenVisus (one time) python -m OpenVisus configure # test installation python -c "from OpenVisus import *"
- if you get permission denied error, use
pip install --user.
- if you need a minimal installation without the GUI replace
- If you want to create an isolated virtual environment with
# make sure venv is latest pip install --upgrade virtualenv # create a virtual environment in current directory venv ./ovenv # activate the virtual environment source ./ovenv/bin/activate
Run the OpenVisus viewer:
python -m OpenVisus viewer
Sometimes, PyQt (or other packages like
pyqt5-sip) is already installed in system and OpenVisus viewer gets confused which package to use. To solve that issue, follow these steps before main installation:
- If on linux, make sure PyQt5 or any of it's related packages are not installed system-wide.
- For Ubuntu use
sudo apt remove python3-pyqt5to remove pyqt5 and all other related packages listed here.
- For any Arch based distro, use
sudo pacman -Rs python-pyqt5. Same for all other packages like
- For Ubuntu use
- Remove all pyqt5 packages with pip:
pip uninstall pyqt5 PyQt5-sip
You can find OpenViSUS documentation regarding the install, configuration, viewer, and Python package here.
Quick Tour and Tutorials
Start with quick_tour.ipynb Jupyter Notebook.
See Samples/jupyter directory.
To run the tutorials on the cloud click this binder link.
Run OpenVisus server
Docker OpenVisus server:
Kubernetes OpenVisus servers:
Docker Swarm OpenVisus servers:
Convert (and similar)
Connecting to OpenViSUS Server Using a Proxy
In your visus.config, you can specify a proxy scheme, ip, and port for the client (either the viewer or the python package) to use when connecting to an OpenViSUS server. This can be useful in accessing a server that is hosted on an internal network which is only accessible through SSH, for example.
An example visus.config file containing proxy information would look like this:
<visus> <Configuration> <NetService proxy="socks5://localhost" proxyport="55051"/> </Configuration> ... (The rest of the config follows) </visus>
The "proxy" variable above contains both the scheme (SOCKS5) and ip (localhost).
A user would need to start the SOCKS5 proxy connection using a client. This can be done using ssh on Linux/MacOS with the following command:
ssh -D 55051 user@server
On Windows, you can enable a SOCKS5 proxy by using PuTTY. More information on that can be found here.
Keep in mind that the port you open the connection with must match the one specified in the visus.config file.