next up previous contents index
Next: The tbsetup Command Up: The WRspice User Interface Previous: Sparse Matrix Package   Contents   Index


Initialization Files

WRspice will attempt to source startup files used for initialization when the program is started. First, a file named ``wrspiceinit'' is searched for in the system startup directory, and if found is sourced into WRspice. The system startup directory has a default location built into the program
(/usr/local/xictools/wrspice/startup, or if XT_PREFIX is set in the environment, its value replaces ``/usr/local''), but this can be changed by setting the SPICE_LIB_DIR environment variable to another location.

license.host file
When using a license server on a remote machine, it is necessary to provide the name of this machine or WRspice can not run. One way to do this is to create a license.host file in the startup directory, e.g. /usr/local/xictools/wrspice/startup. The license.host file consists of a single line of text, giving the host name of the license server machine. The host name can optionally be suffixed with ``:port'', where port is the port number in use by the license server. This is required if for some reason the license server is not running on the default port.

.wrspiceinit file
Files named ``.wrspiceinit'' are searched for in the user's home directory, and the current directory, and are sourced, if found, in that order. If running on Microsoft Windows which does not support the notion of a home directory, WRspice will look in the environment for a variable named ``HOME'', and its value will be taken as the path to the "home directory". If not set, the search is skipped.

These files have identical format, and contain ordinary script commands, which can be used to set the default behavior of WRspice. The first line is ignored, but all remaining lines are taken as script commands. The special directive tbsetup, which can only appear in these files, provides the setup information for the graphical interface. Unlike ordinary input files, it is not necessary to enclose the commands in .control or .exec blocks in the startup files.

X Resources
When using the X-window system, the X resource-passing mechanism can be used to set the default colors used in plots. The resource mechanism is otherwise ignored in the current version of WRspice. The base names for the color resources are ``color0'' through ``color19'', with the corresponding class names capitalized. Thus, one way to define alternative plotting colors is to create a file named ``Wrspice'' in the user's home directory, which contains lines like
*color2: red
for each new color definition. The color name should be known to the X window system, i.e., be listed in the rgb.txt file in the X-windows system library.

The same definitions could be placed in a .wrspiceinit file with lines like ``set color2 = red''.

.wrpasswd file
On startup, WRspice will read the .wrpasswd file if found in the user's home directory. This file contains the encrypted password to the program distribution repository, and is created in WRspice with the passwd command. This file can also be generated from Xic. If present and the password is active, WRspice will check for the availability of updates on startup, and the wrupdate command will be enabled.



Subsections
next up previous contents index
Next: The tbsetup Command Up: The WRspice User Interface Previous: Sparse Matrix Package   Contents   Index
Stephen R. Whiteley 2017-02-22