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. What should I do?

You should report it, of course :-). Send your report to the ViTables users' group or use 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 (specially on Windows platforms because you may need to install some additional software like the Sphinx documentation system, the NSIS installer, or the MSVC++ 2008 Express Edition). So packaging is not recommended. Instead, from the top level directory do the following:

$ cp scripts/vitables 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. The Sphinx documentation system is required in order to build the documentation.

Are the PyQt4 libraries shipped with the Windows installer?

Currently they are not. The installer contains the ViTables sources, examples and documentation (in both HTML and PDF formats). That's all.

ViTables is built on top of a big pyramid of software. Including all the required software in the installer would make its size really huge. IMHO this is unnecessary, the vast majority of people willing to install ViTables are PyTables users, so they have most of software prerequisites already installed. And not including the PyQt4 libraries doesn't penalise users with lots of extra work as there is a nice Windows installer for them.

I've issues installing ViTables on Mac OS X. What have I to do?

Warning

The answer to this question is out of date. Please, if you have more updated information post it to the ViTables users' group

Unfortunately I cannot provide much assistance on this subject because I've not Mac OS X platforms available. A step by step guide for installing ViTables (and its prerequisites) on Mac OS X follows (the original source is here)

In theory, you can install ViTables as a native application by running

$ ./macosxapp/make.sh

but I cannot grant it works.

If the above doesn't help your best bet is to ask for help to the ViTables users' group