ParaView/Users Guide/Command line arguments

From KitwarePublic
< ParaView
Revision as of 09:12, 24 July 2013 by Jzarl (talk | contribs) (→‎Rendering Options: add side-by-side stereo)
Jump to navigationJump to search

Command-Line Arguments and Environment Variables

The following is a list of options available when running ParaView from the command line. When two options are listed, separated by a comma, either of them can be used to achieve the specified result. Unless otherwise specified, all command-line options are used on the client program. Following the list of command-line options is a set of environment variables ParaView recognizes.

General Options

  • --data : Load the specified data file into ParaView (--data=data_file).
  • --disable-registry, -dr : Launch ParaView in its default state; do not load any preferences saved in ParaView’s registry file.
  • --help, /? : Display a list of the command-line arguments and their descriptions.
  • --version, -V : Display ParaView’s version number, and then exit.

Client-Server Options

  • --server, -s : Tell the client process where to connect to the server. The default is ‑‑server =localhost. This command-line option is used on the client.
  • --client-host, -ch : Tell the server process(es) where to connect to the client. The default is ‑‑client-host=localhost. This command-line option is used on the server(s).
  • --server-port, -sp : Specify the port to use in establishing a connection between the client and the server. The default is --server-port=11111. If used, this argument must be specified on both the client and the server command lines, and the port numbers must match.
  • --data-server-port, -dsp : Specify the port to use in establishing a connection between the client and the data server. The default is --data-server-port=11111. If used, this argument must be specified on both the client and the data server command lines, and the port numbers must match.
  • --render-server-port, -rsp : Specify the port to use in establishing a connection between the client and the render server. The default is --render-server-port=22221. If used, this argument must be specified on both the client and the render server command lines, and the port numbers must match.
  • --reverse-connection, -rc : Cause the data and render servers to connect to the client. When using this option, the client, data server, and render server (if used) must be started with this command-line argument, and you should start the client before starting either server.
  • --connect-id : Using a connect ID is a security feature in client-server mode. To use this feature, pass this command-line argument with the same ID number to the client and server(s). If you do not pass the same ID number, the server(s) will be shut down.
  • --machines, -m : Use this command-line argument to pass in the network configuration file for the render server. See section Error: Reference source not found for a description of this file.

Rendering Options

  • --stereo : Enable stereo rendering in ParaView.
  • --stereo-type: Set the stereo rendering type. Options are:
    • Crystal Eyes
    • Red-Blue
    • Interlaced ( Default )
    • Dresden
    • Anaglyph
    • Checkerboard
    • SplitViewportHorizontal * since 3.98
  • --tile-dimensions-x, -tdx : Specify the number of tiles in the horizontal direction of the tiled display (‑‑tile‑dimensions-x=number_of_tiles). This value defaults to 0. To use this option, you must be running in client/server or client/data server/render server mode, and this option must be specified on the client command line. Setting this option to a value greater than 0 will enable the tiled display. If this argument is set to a value greater than 0 and -tdy (see below) is not set, then -tdy will default to 1.
  • --tile-dimensions-y, -tdy : Specify the number of tiles in the vertical direction of the tiled display (‑‑tile‑dimensions-y=number_of_tiles). This value defaults to 0. To use this option, you must be running in client/server or client/data server/render server mode, and this option must be specified on the client command line. Setting this option to a value greater than 0 will enable the tiled display. If this argument is set to a value greater than 0 and -tdx (see above) is not set, then -tdx will default to 1.
  • --tile-mullion-x, -tmx : Specify the spacing (in pixels) between columns in tiled display images.
  • --tile-mullion-y, -tmy : Specify the spacing (in pixels) between rows in tiled display images.
  • --use-offscreen-rendering : Use offscreen rendering on the satellite processes. On unix platforms, software rendering or mangled Mesa must be used with this option.
  • --disable-composite, -dc : Use this command-line option if the data server does not have rendering resources and you are not using a render server. All the rendering will then be done on the client.

Executable help

paraview --help

 --connect-id=opt      Set the ID of the server and client to make sure they match.
 
 --cslog=opt           ClientServerStream log file.
 
 --data=opt            Load the specified data. To specify file series replace the numeral with a '.' eg. my0.vtk, my1.vtk...myN.vtk becomes my..vtk
 
 --data-directory=opt  Set the data directory where test-case data are.
 
 --disable-light-kit   When present, disables light kit by default. Useful for dashboard tests.
 
 --disable-registry    
 -dr                   Do not use registry when running ParaView (for testing).
 
 --exit                Exit application when testing is done. Use for testing.
 
 --help                
 /?                    Displays available command line arguments.
 
 --machines=opt        
 -m=opt                Specify the network configurations file for the render server.
 
 --multi-servers       Allow client to connect to several pvserver
 
 --script=opt          Set a python script to be evaluated on startup.
 
 --server=opt          
 -s=opt                Set the name of the server resource to connect with when the client starts.
 
 --server-url=opt      
 -url=opt              Set the server-url to connect with when the client starts. --server (-s) option supersedes this option, hence one should only use one of the two options.
 
 --state=opt           Load the specified statefile (.pvsm).
 
 --stereo              Tell the application to enable stereo rendering
 
 --stereo-type=opt     Specify the stereo type. This valid only when --stereo is specified. Possible values are "Crystal Eyes", "Red-Blue", "Interlaced", "Dresden", "Anaglyph", "Checkerboard"
 
 --test-baseline=opt   Add test baseline. Can be used multiple times to specify multiple baselines for multiple tests, in order.
 
 --test-directory=opt  Set the temporary directory where test-case output will be stored.
 
 --test-master         (For testing) When present, tests master configuration.
 
 --test-script=opt     Add test script. Can be used multiple times to specify multiple tests.
 
 --test-slave          (For testing) When present, tests slave configuration.
 
 --test-threshold=opt  Add test image threshold. Can be used multiple times to specify multiple image thresholds for multiple tests in order.
 
 --version             
 -V                    Give the version number and exit.

pvbatch --help

 --cslog=opt                ClientServerStream log file.
 
 --help                     
 /?                         Displays available command line arguments.
 
 --machines=opt             
 -m=opt                     Specify the network configurations file for the render server.
 
 --symmetric                
 -sym                       When specified, the python script is processed symmetrically on all processes.
 
 --use-offscreen-rendering  Render offscreen on the satellite processes. This option only works with software rendering or mangled mesa on Unix.
 
 --version                  
 -V                         Give the version number and exit.

pvpython --help

 --connect-id=opt   Set the ID of the server and client to make sure they match.
 
 --cslog=opt        ClientServerStream log file.
 
 --data=opt         Load the specified data. To specify file series replace the numeral with a '.' eg. my0.vtk, my1.vtk...myN.vtk becomes my..vtk
 
 --help             
 /?                 Displays available command line arguments.
 
 --machines=opt     
 -m=opt             Specify the network configurations file for the render server.
 
 --multi-servers    Allow client to connect to several pvserver
 
 --state=opt        Load the specified statefile (.pvsm).
 
 --stereo           Tell the application to enable stereo rendering
 
 --stereo-type=opt  Specify the stereo type. This valid only when --stereo is specified. Possible values are "Crystal Eyes", "Red-Blue", "Interlaced", "Dresden", "Anaglyph", "Checkerboard"
 
 --version          
 -V                 Give the version number and exit.

pvserver --help

 --client-host=opt          
 -ch=opt                    Tell the data|render server the host name of the client, use with -rc.
 
 --connect-id=opt           Set the ID of the server and client to make sure they match.
 
 --cslog=opt                ClientServerStream log file.
 
 --disable-composite        
 -dc                        Use this option when rendering resources are not available on the server.
 
 --help                     
 /?                         Displays available command line arguments.
 
 --machines=opt             
 -m=opt                     Specify the network configurations file for the render server.
 
 --multi-clients            Allow server to keep listening for serveral client toconnect to it and share the same visualization session.
 
 --reverse-connection       
 -rc                        Have the server connect to the client.
 
 --server-port=opt          
 -sp=opt                    What port should the combined server use to connect to the client. (default 11111).
 
 --tile-dimensions-x=opt    
 -tdx=opt                   Size of tile display in the number of displays in each row of the display.
 
 --tile-dimensions-y=opt    
 -tdy=opt                   Size of tile display in the number of displays in each column of the display.
 
 --tile-mullion-x=opt       
 -tmx=opt                   Size of the gap between columns in the tile display, in Pixels.
 
 --tile-mullion-y=opt       
 -tmy=opt                   Size of the gap between rows in the tile display, in Pixels.
 
 --timeout=opt              Time (in minutes) since connecting with a client after which the server may timeout. The client typically shows warning messages before the server times out.
 
 --use-offscreen-rendering  Render offscreen on the satellite processes. This option only works with software rendering or mangled mesa on Unix.
 
 --version                  
 -V                         Give the version number and exit.

pvdataserver --help

 --client-host=opt       
 -ch=opt                 Tell the data|render server the host name of the client, use with -rc.
 
 --connect-id=opt        Set the ID of the server and client to make sure they match.
 
 --cslog=opt             ClientServerStream log file.
 
 --data-server-port=opt  
 -dsp=opt                What port data server use to connect to the client. (default 11111).
 
 --help                  
 /?                      Displays available command line arguments.
 
 --machines=opt          
 -m=opt                  Specify the network configurations file for the render server.
 
 --multi-clients         Allow server to keep listening for serveral client toconnect to it and share the same visualization session.
 
 --reverse-connection    
 -rc                     Have the server connect to the client.
 
 --timeout=opt           Time (in minutes) since connecting with a client after which the server may timeout. The client typically shows warning messages before the server times out.
 
 --version               
 -V                      Give the version number and exit.

pvrenderserver --help

 --client-host=opt          
 -ch=opt                    Tell the data|render server the host name of the client, use with -rc.
 
 --connect-id=opt           Set the ID of the server and client to make sure they match.
 
 --cslog=opt                ClientServerStream log file.
 
 --help                     
 /?                         Displays available command line arguments.
 
 --machines=opt             
 -m=opt                     Specify the network configurations file for the render server.
 
 --render-server-port=opt   
 -rsp=opt                   What port should the render server use to connect to the client. (default 22221).
 
 --reverse-connection       
 -rc                        Have the server connect to the client.
 
 --tile-dimensions-x=opt    
 -tdx=opt                   Size of tile display in the number of displays in each row of the display.
 
 --tile-dimensions-y=opt    
 -tdy=opt                   Size of tile display in the number of displays in each column of the display.
 
 --tile-mullion-x=opt       
 -tmx=opt                   Size of the gap between columns in the tile display, in Pixels.
 
 --tile-mullion-y=opt       
 -tmy=opt                   Size of the gap between rows in the tile display, in Pixels.
 
 --use-offscreen-rendering  Render offscreen on the satellite processes. This option only works with software rendering or mangled mesa on Unix.
 
 --version                  
 -V                         Give the version number and exit.

Environment Variables

In addition to the command-line options previously listed, ParaView also recognizes the following environment variables.

  • PV_DISABLE_COMPOSITE_INTERRUPTS If this variable is set to 1, it is not possible to interrupt the compositing of images in parallel rendering. Otherwise it is interruptible through mouse interaction.
  • PV_ICET_WINDOW_BORDERS Setting this variable to 1 when running ParaView in tiled display mode using IceT causes the render window for each tile to be the same size as the display area in ParaView’s main application window. (Normally each render window fills the whole screen when tiled display mode is used.) This feature is sometimes useful when debugging ParaView.
  • PV_PLUGIN_PATH If you have shared libraries containing plugins you wish to load in ParaView at startup, set this environment variable to the path for these libraries.
  • PV_SOFTWARE_RENDERING This environment variable has the same effect as setting both the ‑‑use‑software‑rendering and --use-satellite-software environment variables.
  • VTK_CLIENT_SERVER_LOG If set to 1, a log file will be created for the ParaView client, server, and render server. The log files will contain any client-server streams sent to the corresponding client, server, or render server.
  • PV_DEBUG_PANELS If set to 1 a debug message will be printed with an explaination as to why each property widget in the properties panel was created.