next up previous contents
Visit our: CCMS Home Page
Send us your comments on this user guide: CCMS Comment Form
Next: Chapter 3 Using XtalView Up: Table of Contents Previous: Chapter 1 Introduction


Chapter 2

Getting Started


Before you can run XtalView, you must set up your environment as described below. For help with installing XtalView, see the README file in the top directory of the XtalView distribution. For help with setting up your environment, read the following section.

Once you have installed XtalView and set up your environment, start XtalView by typing xtalmgr &. This executes the XtalView Manager program. From this program you can start all of the other XtalView programs.


Setting Up Your Environment


Before using XtalView, you must set several environment variables to tell the programs where key information is stored. Perform the following steps:

  1. Copy the XtalView.env file to your home directory. This file is located in the top directory of the XtalView distribution. Contact you system administrator if you don't know where XtalView is installed.

  2. Edit the XtalView.env file. You must edit three lines:

    Set the XTALVIEWHOME environment variable to the location of the XtalView distribution. Make sure you use the full path name to the directory.

    Set the CRYSTALDATA environment variable to the directory where your crystal data is (or will be) located. Again, make sure you use the full path name. If this directory does not already exist, you must create it before you can use XtalView.

    Set the CRYSTAL environment variable to the name of your default crystal.

  3. The commands in the XtalView.env file must be executed before you can use XtalView. To do this, put the line

    source ~/XtalView.env

    in your .cshrc file.

  4. XtalView requires fonts that may not be installed on non-Sun machines. These fonts are included in the XtalView distribution (in the directory $XTALVIEWHOME/fonts), but the procedure to make use of them depends on how you will be running XtalView.

    • If you are running XtalView locally (i.e., NOT over a network), execute the command $XTALVIEWHOME/bin/share/fonts. You only need to do this once each time you log in to your workstation. Note: The XtalView.env file must have been sourced before this will work.

    • If you are running XtalView remotely, and the machine-independent part of the XtalView distribution is available on your local workstation: Before you log on to the remote machine, execute the command $XTALVIEWHOME/bin/share/fonts. You only need to do this once each time you log in to the local workstation.

      Note: The XtalView.env file must have been sourced before this will work.

    • If you are running XtalView remotely, the machine-independent part of the XtalView distribution is not available on your local workstation, and your local machine is a UNIX workstation:

      Copy the $XTALVIEWHOME/fonts directory and the script $XTALVIEWHOME/bin/share/fonts to the local machine. Set the XBIN and XTAL-VIEWFONTSDIR variables in the fonts script to the directories that hold the standard X binaries (e.g., /usr/bin/X11) and the XtalView fonts, respectively. Then execute the fonts script. You only need to execute the edited script once each time you log in to the local workstation.

    • If you are running XtalView remotely, the machine-independent part of the XtalView distribution is not available on your local workstation, and your local machine is not a UNIX workstation (e.g., it's an X-terminal):

      Consult your system's documentation for information on setting up the font path. Besides adding the $XTALVIEWHOME/fonts directories to the font path, you must also move any 100-dpi directories to the end of the font path.

The XtalView package is now ready for use. You can access the XtalView programs through the xtalmgr program, or you can run them individually.

Note for Silicon Graphics users:

Read the file $XTALVIEWHOME/make_sgi4dIRIX4/README for additional instructions.



next up previous contents
Visit our: CCMS Home Page
Send us your comments on this user guide: CCMS Comment Form
Next: Chapter 3 Using XtalView Up: Table of Contents Previous: Chapter 1 Introduction

XtalView User Guide