FAQ

How is ViTables licensed?

It has a GPLv3 license.

Oops! I've got a problem. How can I get support?

It's always worth to check the messages posted to the ViTables users' group : searching the list is a great way to get your questions answered. You can search the list using its web interface or from the Gmane interface. If you don't find an answer to your question I strongly recommended you to subscribe to the users' group and ask for help there. Probably some subscriber (ViTables developer or user) will be able to help you.

I've found a bug or I want to request a new feature. What should I do?

You should report it, of course :-). Please, send your report with the bug tracker.

How can I use the latest revision from the git repository?

If you want to run the development version of ViTables, first of all you have to clone it from the git repository. For instance:

$ git clone http://github.com/uvemas/ViTables.git vitables_tip

will download the latest revision and put it in the vitables_tip directory. You can use it as is or you can build the ViTables package from sources and install it. Although packaging is not difficult it can be tricky because you may need to install the Sphinx documentation system. So packaging is not recommended. Instead, from the top level directory do the following:

$ cp scripts/start.py run_vitables.py
$ python run_vitables.py

and ViTables should start. Beware that the HTML User's Guide will not be available unless you build it before running ViTables.

But can I launch ViTables from my Desktop?

Of course, you can. After installation, just create a Desktop shortcut as you usually do on your platform. Make sure that it points to the vitables executable. The only tricky thing is to give a nice icon to the shortcut.

On Windows the icon file is icons\vitables.ico and can be located in the installation folder.

On Linux it is a bit more difficult because the icons are not included in the package (tarball or wheel). So you have to download them from the repository. In particular you need the unixapp folder. There you will find the required .desktop file and icons (.png files) of several sizes. With all that stuff just follow the standard way for creating Desktop shortcuts on Linux. That's all.

If you have problems with the shortcut creation there are lots of tutorials in the Internet, like this for Windows or this for Ubuntu Linux.

Can I use ViTables with Anaconda3?

Yes, you can. Three different installation ways are available. The most convenient is, of course, install the ViTables package from conda-channel (I assume you are on a Windows machine here):

(Anaconda3) > conda install -c conda-forge vitables=3.0.0

Afterwards a ViTables executable should exist in the Scripts directory and can be launched by issuing the command:

(Anaconda3) > some-path\Anaconda3\Scripts\vitables

If this fails, you can install ViTables from sources. Download and untar the tarball (or clone the GitHub repo) and go to the root directory. From there you can create an environment for ViTables with the environment.yml file:

(Anaconda3) > conda env create -n vitables -f environment.yml
(Anaconda3) > some-path\Anaconda3\Scripts\activate vitables
(vitables) >

After installation you can execute the program easily:

(vitables) > vitables

Finally you can do a typical installation from sources:

(Anaconda3) > python setup.py install
(Anaconda3) > some-path\Anaconda3\Scripts\vitables

Caveat emptor: as you know ViTables depends on PyQt5. Unfortunately the pip installed PyQt5 package and the analogous package provided by Anaconda3 are in conflict with each other (you can read more about this here). In order to avoid problems I recommend you to follow these advices:

  • if you have installed the package from the conda-forge channel, remove the PyQt5 dependency from Anaconda3\pkgs\vitables-3.0.0-0\Lib\site-packages\ViTables-3.0.0.egg-info\requires.txt
  • if you are going to install from sources, before you proceed, remove the PyQt5 dependency from the install_requires line in the setup.py file.