FAQ
- How is ViTables licensed?
- Oops! I've got a problem. How can I get support?
- I've found a bug or I want to request a new feature. What should I do?
- How can I use the latest revision from the git repository?
- Are there graphical installers for Windows and Mac OS X platforms?
- But can I launch ViTables from my Desktop?
- Can I use ViTables with Anaconda3?
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
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
$ 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.
Are there graphical installers for Windows and Mac OS X platforms?
No, there aren't.
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. Basically two 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 and the Scripts
folder is in your PATH
).
You can install and run with
(Anaconda3) > vitables
If this fails, you can install ViTables from sources. Download and untar the tarball (or clone the GitHub
repo),
go to the root directory and proceed as you do in a typical installation from sources
(Anaconda3) > 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 fromAnaconda3\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 theinstall_requires
line in thesetup.py
file.