For newer versions of xcrysden, the installation of compiled
package is fairly simple:
- unpack the
package file as:
gunzip -c xc-version
tar xvf -
cd into the so-created directory (i.e.,
- and try:
If this works then add the root directory of just installed
xcrysden package (i.e.,
xcrysden-version) to your
The use of
XCRYSDEN_TOPDIR environmental variable
is optional for newer versions. Optionally also the
XCRYSDEN_SCRATCH environmental variable can be
defined. It is the place where XCrySDen writes scratch (temporary)
files. If this variable is not defined then either the value of
TMP) environmental variable
(if defined) or the
/tmp will be used as the
BEWARE: If an older XCrySDen version is already installed
then you need to manually unset (or update) the
XCRYSDEN_TOPDIR variable definition in your profile
- Unpack the *.tar.gz archive-file.
- Define the XCRYSDEN_TOPDIR and
XCRYSDEN_SCRATCH environmental variables
(XCRYSDEN_TOPDIR should point to XCrySDen root directory).
- Create the XCRYSDEN_SCRATCH directory (if it does not
- Run the program as xcrysden.
- From time to time clean the $XCRYSDEN_SCRATCH
directory. For example, use the xc_cleanscratch
it is recomemded to run the "./xcConfigure"
script instead !!! [READ BELOW]
After unpacking the *.tar.gz
archive-file, each user
should define two environmental variables: XCRYSDEN_TOPDIR
. This can be facilitated by the
script which in addition asks some questions
and configures the package accoring to user's wishes. From
script modifies your profile
depending on the shell). It defines the two environmental variables
modifies the PATH
variable by including the
to the path. Then you should source the
corresponding profile in order to load the newly-added definitions.
If you are using the csh- or tcsh-shell then execute:
For for sh-shell execute:
For bash-shell execute:
Then you can lanuch the program as:
From time to time clean the scratch directory
). This can be done by
BEWARE: If an older XCrySDen version is already
installed, then you should manually update the
XCRYSDEN_TOPDIR variable definition in your profile to
point to the new place !!!
It creates the $HOME/.xcrysden
directory and add the
The former file is used for setting some definitions, like the
image conversion program (for example the "convert" program of
ImageMagick), which is used for conversion between different
graphics formats while printing to a file (this enables to print to
various formats like JPG/PNG/GIF/TIFF). In the second file the
X-resources for XCrySDen
are specified, like fonts and colors. (read
The compilation of XCrySDen
requires the following
software: Tcl/Tk >= 8.3, and OpelGL (or Mesa). The compilation
requires not just the Tcl/Tk + OpenGL library-files, but also their
header files !!!
- The Tcl/Tk can be downloaded from here.
- The Mesa can be downloaded from here.
To compile the source package the file Make.sys
present in the package root directory. Templates can be find in
subdirectory. Copy an appropriate template file:
- cp ./system/Make.MY-SISTEM Make.sys
Now edit the file Make.sys to suit your needs. Then if you are
impatient simply try:
See also How to install the compiled
section for the description of xcConfigure
script. The xcConfigure
will modify your profile
depending on the shell). Then you should source the corresponding
profile in order to load the newly-added definitions.
If the installation has failed for some reason, then read a few
hints that are described below.
First, please read careful the instructions inside
Make.sys and edit the file according to your needs.
Basically you have two possibilities in
- To use the included sources of external libraries, i.e.,
tcl8.3, tk8.3, Mesa-4.0 (for
package only). In this case the flag
must be set to
yes, which will enable the compilation
of the libraries, and the corresponding section of
Make.sys should be uncommented (it is already
uncommented by default).
- To use your own libraries. In this case the flag
COMPILE_LIBRARIES must be set to
COMPILE_LIBRARIES = yes section should be commented,
COMPILE_LIBRARIES = no section uncommented.
If you are using the
which contains also the required external libraries (Tcl, Tk,
Mesa), then check if the error occurred during the compilation of
external libraries. If this is the case, try to compile the library
manually, i.e., do
, where LIB is
the corresponding library directory, and read the installation
If you are using the
package this means that the error occurred during the XCrySDen compilation. Possibly you
can correct the error by editing the