Difference between revisions of "Known issues"

From VistrailsWiki
Jump to navigation Jump to search
(Added a table detailing the status of the command-line arguments.)
Line 1: Line 1:
Check this page for known issues with VisTrails Releases and how to work around them.
Check this page for known issues with VisTrails Releases and how to work around them.
==Command-Line Switches==
The VisTrails development team is refactoring the implementation of many of the command-line switches supported by VisTrails. Please refer to the table below for a summary of which switches work and which ones don't, and their status.
<table border=1>
<tr>
<th>Short form</th><th>Long form</th><th>Description</th>
</tr>
<tr>
<td>-h</td><td>--help</td><td>Print a help message and exit.</td>
</tr>
<tr>
<td>-S ''/path''</td><td>--startup=''/path''</td><td>Set user configuration directory (default is ~/.vistrails).<br><font color="RED">'''NOT WORKING'''. See ticket #213.</font></td>
</tr>
<tr>
<td>-?</td><td>&nbsp;</td><td>Print a help message and exit.</td>
</tr>
<tr>
<td>-v</td><td>--version</td><td>Print version information and exit.</td>
</tr>
<tr>
<td>-V ''num''</td><td>--verbose=''num''</td><td>Set verboseness level (0–2, default=0,
higher means more verbose).<br> <font color="RED">'''NOT WORKING.''' I cannot tell whether this option makes any difference.</font></td>
</tr>
<tr>
<td>-b</td><td>--noninteractive</td><td>Run in non-interactive (batch) mode.</td>
</tr>
<tr>
<td>-n</td><td>--nosplash</td><td>Do not display splash screen on startup. <br><font color="RED">'''NOT WORKING'''. It's a one-line code fix, but I'm waiting for my Qt license before I check it in.</font></td>
</tr>
<tr>
<td>-c ''num''</td><td>--cache=''num''</td><td>Enable/disable caching (0 to disable,
nonzero to enable. Default is enabled).<br><font color="RED">'''UNTESTED.''' Not sure how to verify this.</font></td>
</tr>
<tr>
<td>-m ''num''</td><td>--movies=''num''</td><td>Set automatic movie creation on spreadsheet
(0 or 1, default=1). Set this to zero to work around VTK bug with offscreen renderer and OpenGL texture3D mappers. <br><font color="RED">'''UNTESTED.''' Actually, I'm not completely sure what this is supposed to do.</font></td>
</tr>
<tr>
<td>-s</td><td>--multiheads</td><td>Display the Builder and Spreadsheet on
different screens (if available). <br><font color="RED">'''NOT WORKING.''' See Ticket #211.</font></td>
</tr>
<tr>
<td>-x</td><td>--maximized</td><td>Maximize Builder and Spreadsheet windows at startup. <br><font color="RED">'''NOT WORKING.''' See Ticket #211.</font></td>
</tr>
<tr>
<td>-l</td><td>--nologger</td><td>Disable logging. <br><font color="RED">'''NOT WORKING.''' This is a weird one. I've experimented a bit with the code, but cannot get the logging flag to behave predictably.</font></td>
</tr>
<tr>
<td>-d</td><td>--debugsignals</td><td>Debug Qt signals. <br><font color="RED">'''NOT WORKING.''' As far as I can tell, this option is never exercised in the code.</font></td>
</tr>
<tr>
<td>-a ''params''</td><td>--parameters=''params''</td><td>Set workflow parameters (non-interactive mode only). <br><font color="RED">'''WORKING, BUT''' this option depends on the ability to create parameter aliases, and I'm not sure whether aliases are a feature we want to support in the long term.</font></td>
</tr>
<tr>
<td>-t ''host''</td><td>--host=''host''</td><td>Set hostname or IP address of database
server.</td>
</tr>
<tr>
<td>-r ''port''</td><td>--port=''port''</td><td>Set database port.</td>
</tr>
<tr>
<td>-f ''dbName''</td><td>--db=''dbName''</td><td>Set database name.</td>
</tr>
<tr>
<td>-u ''userName''</td><td>--user=''userName''</td><td>Set database username. <br><font color="RED">'''NOT SURE''' if this works as advertised. Sometimes the username is not automatically populated in the Open Database Connection dialog, while the other fields are.</font></td>
</tr>
</table>
==Rev 674==
==Rev 674==
On Linux machines using PyQt4.2, there is a bug that causes vtk pipelines not to show on the spreadsheet.
On Linux machines using PyQt4.2, there is a bug that causes vtk pipelines not to show on the spreadsheet.

Revision as of 16:10, 27 June 2008

Check this page for known issues with VisTrails Releases and how to work around them.

Command-Line Switches

The VisTrails development team is refactoring the implementation of many of the command-line switches supported by VisTrails. Please refer to the table below for a summary of which switches work and which ones don't, and their status.

Short formLong formDescription
-h--helpPrint a help message and exit.
-S /path--startup=/pathSet user configuration directory (default is ~/.vistrails).
NOT WORKING. See ticket #213.
-? Print a help message and exit.
-v--versionPrint version information and exit.
-V num--verbose=numSet verboseness level (0–2, default=0, higher means more verbose).
NOT WORKING. I cannot tell whether this option makes any difference.
-b--noninteractiveRun in non-interactive (batch) mode.
-n--nosplashDo not display splash screen on startup.
NOT WORKING. It's a one-line code fix, but I'm waiting for my Qt license before I check it in.
-c num--cache=numEnable/disable caching (0 to disable, nonzero to enable. Default is enabled).
UNTESTED. Not sure how to verify this.
-m num--movies=numSet automatic movie creation on spreadsheet (0 or 1, default=1). Set this to zero to work around VTK bug with offscreen renderer and OpenGL texture3D mappers.
UNTESTED. Actually, I'm not completely sure what this is supposed to do.
-s--multiheadsDisplay the Builder and Spreadsheet on different screens (if available).
NOT WORKING. See Ticket #211.
-x--maximizedMaximize Builder and Spreadsheet windows at startup.
NOT WORKING. See Ticket #211.
-l--nologgerDisable logging.
NOT WORKING. This is a weird one. I've experimented a bit with the code, but cannot get the logging flag to behave predictably.
-d--debugsignalsDebug Qt signals.
NOT WORKING. As far as I can tell, this option is never exercised in the code.
-a params--parameters=paramsSet workflow parameters (non-interactive mode only).
WORKING, BUT this option depends on the ability to create parameter aliases, and I'm not sure whether aliases are a feature we want to support in the long term.
-t host--host=hostSet hostname or IP address of database server.
-r port--port=portSet database port.
-f dbName--db=dbNameSet database name.
-u userName--user=userNameSet database username.
NOT SURE if this works as advertised. Sometimes the username is not automatically populated in the Open Database Connection dialog, while the other fields are.


Rev 674

On Linux machines using PyQt4.2, there is a bug that causes vtk pipelines not to show on the spreadsheet. Solution: edit the file path_to_vistrails_src/vistrails/packages/vtk/vtkcell.py

in the import section (around line 27), add

 import sip

replace line 244:

 vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])

by

try:
    vp = '_%s_void_p' % (hex(int(QtGui.QX11Info.display()))[2:])
except TypeError:
    #This was changed for PyQT4.2
    if isinstance(QtGui.QX11Info.display(),QtGui.Display):
        display = sip.unwrapinstance(QtGui.QX11Info.display())
        vp = '_%s_void_p' % (hex(display)[2:])

Rev 559

There are two issues with the binary version of this release.

1. When the current directory is not on the PATH. This causes VisTrails to raise a Requirements not fulfilled exception.

Solution: Adding '.' or path_to_vistrails_install/vistrails to the PATH solves this problem.

2. When installing on a non-english system or on a custom directory, VisTrails won't start. This is due to absolute paths inside the bookmarks file.

Solution: Remove file bookmarks.xml inside ~/.vistrails folder. On Windows XP it's located on C:\Documents and Settings\your_username\.vistrails. On Windows Vista, it's located at C:\Users\your_username\.vistrails.