ParaView/Users Guide/Command line arguments: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
(Replaced content with "{{ParaView/Template/DeprecatedUsersGuide}}")
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
= Command-Line Arguments and Environment Variables =
{{ParaView/Template/DeprecatedUsersGuide}}
 
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
* --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.

Latest revision as of 21:31, 14 January 2015

PAGE DELETED
The Users Guide has been moved from the Wiki to The ParaView Guide. Please use the history if you want to access the old version of this document.