System Command-Line Options

The following are options that can be specified when starting Chimera from the system command line.

--bgopacity
Make the background transparent and allow its opacity to be adjusted (opacity = 1 - transparency). Not all systems have the hardware required to support this option. PNG and TIFF images saved from the session will include opacity information, making them easier to composite with different backgrounds in image-editing applications. (Note: TIFF images with background transparency may not be interpreted correctly by Adobe Photoshop®.) With this option, the opacity is initially set to zero; if the background color is subsequently changed, however, the background will no longer be transparent unless the color definition includes transparency. Background transparency can also be enabled in the Effects tool.
--debug
(1) Put the current directory at the front of the Python module search path instead of at the end, and (2) turn off redirection of standard error to the Reply Log. On UNIX, the standard error will go to a terminal window. On Windows, the standard error will go to a separate chimera debug console window, which opens automatically when --debug is used. The --pypath option can be used to add directories to front of the Python module search path.
--fullscreen
Start in fullscreen mode (Windows only).
--geometry wxh+x+y
Set the size and location of the Chimera window. The variables w and h are the width and height of the window in pixels, and x and y are the X and Y offsets of the top left corner of the window from the top left corner of the screen. The wxh part of the argument can be omitted if size control is not important. The +x+y part of the argument can be omitted if controlled placement is not important. Depending on the system, various borders and menubars may or may not be included, so some experimentation may be required to size and place the window exactly as desired.
--listfiletypes
List the file types that can be read by Chimera and the corresponding filename prefixes and suffixes (no startup).
--nogui
Run Chimera without a graphical user interface. This is useful in combination with Python input that generates output such as text files that need not be viewed with the Chimera graphics window. The --nostatus option can be used to suppress status messages when --nogui is used.
--nomultisample
Do not attempt to use graphics multisampling. With most modern graphics cards, it is possible to use multiple samples per pixel so that edges are antialiased. It may be necessary, however, to turn off multisampling in the presence of certain graphics driver bugs.
--nostatus
Suppress status messages if --nogui is also being used.
--preferences pref_file
Use pref_file (specified with a relative or absolute pathname) as the preferences file for the Chimera session.
--pypath directory
Add directory to the front of the Python module search path.
--root
Report the Chimera root directory (no startup).
--screen screen_number
Use a particular monitor for display (useful when multiple monitors are hooked up to the computer). The default is 0, usually the only monitor attached.
--script script.py
Put all unprocessed arguments into sys.argv for the script to handle. The end of arguments for Chimera can be indicated with --. For example,
chimera --nogui --nostatus --script myscript.py -- -p 1jhg -r 1.8
would pass the arguments -p 1jhg -r 1.8 to the script. See the Programmer's FAQ for more details.
--send input
If there is a running instance of Chimera that is set to accept web data, use it to open the file input; otherwise, start a new instance of Chimera to open the file. If there are multiple running instances of Chimera set to accept web data, the file will be sent to the instance that most recently had focus (was most recently clicked into).
--start Tool_name
Launch the tool named Tool_name. This option can be used more than once in the same startup command. Individual tools are documented in the Tools section of the Chimera User's Guide and listed in the Chimera Tools menu. If Tool_name contains any spaces, it must be enclosed in double quotes, for example: "Volume Viewer". This is just one of several ways to start a tool.
--stereo
Start Chimera in sequential stereo mode. Sequential stereo is a rapid flickering between left-eye and right-eye views; special synchronized glasses are needed to obtain the three-dimensional effect. This mode is not always available.
--title title
Change the title of the Chimera window (shown on the top bar) from the default of Chimera to the string title. If title contains any spaces, it must be enclosed in double quotes.
--version
Report the version of Chimera (no startup).
--visual visual_id
Use a different visual setting than that determined automatically by Chimera (does not apply to Windows; on other systems, visual ID numbers and properties can generally be listed by commands such as glxinfo, xglinfo, or xdpyinfo). This option is mainly for debugging rather than general usage.

UCSF Computer Graphics Laboratory / October 2007