# $Id: README 577 2006-10-11 16:51:51Z indraneel $

Please read the README at the top level of the distribution.

PALSSE runs can be controlled via a configuration file. The
configuration file allows one to specify:

input, output and debug directories
debug level
characters of PDB input file to check for and omit when scanning a directory
filenames to use from a listfile
directory containing listfile
whether postscript plots of sheets are required
whether pymol log files are required
whether insight log files are required
whether to overwrite previous output files
extension for output files
output directories and relative directories for pymol and insight scripts
comparison file input directories for DSSP, stride, sstruc, molauto,
  pross (may be broken)
how many processes to fork (for openmosix cluster or smp machine)
whether to use pvm (for pvm enabled cluster, pypvm required, may be broken)

The configuration file can be specified using the environment variable
PALSSECONF. If PALSSECONF is not set a ~/.palsse.conf file is
required. The provided ../etc/palsse.conf file is only suitable for
testing. Please change the parameters when you use the program.

Configuration options for palsse.conf are explained in the
../etc/palsse.conf example file.

Input files may be compressed (.Z), gzipped (.gz) or bzipped (.bz2).

Installation instructions are provided in the INSTALL file. PALSSE can
currently only be run from the ../src/ directory. A system wide
installation method is not currently available.

To run PALSSE from the ../src/ directory:
cd ../src/
python PALSSE <arguments>

Program can have 0 to 2 arguments:
  No arguments: Multiple file mode, input paths and filenames from
configuration file.
  With arguments: Single file mode. First argument is input filename
with full path. Second argument (optional) is ID to use for output
filenames. First 4 characters of input filename (or complete filename
if filename < 5 charaters) is used as ID if second argument is
missing.
