|
|
| 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
| |
| ** SplitViewportHorizontal <font color="green">* since 3.98</font>
| |
| * --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.
| |
