Set up PSDM software

From cctbx_xfel
Revision as of 12:26, 5 February 2014 by Hattne (Talk)

Jump to: navigation, search

Prerequisites

The PSDM software distribution must be installed. PSDM provides installation and maintenance instructions at PSDM software distribution. The distribution can be installed anywhere on the filesystem; it is generally possible to install the PSDM software distribution without superuser privileges.

The installation root directory affects the absolute paths used in these instructions and differs from site to site. Some common installation root directories are listed below.

Site Installation root directory Notes
BNL /usr/local/crys/psdm
CCI, LBNL /net/viper/raid1/psdm Only available on viper.lbl.gov
SLAC /reg/g/psdm

Create a test release and analysis package

In what follows it is assumed that the PSDM software distribution is installed at /reg/g/psdm. Substitute /reg/g/psdm with the appropriate path in the instructions below.

A test release, which refers to a particular release of the LCLS packages, is represented by a directory in the file system, often called analysis-rel or myrelease. An analysis package within the test release in turn refers to the files implementing the analysis modules of the package. Details about installing of a test release and analysis packages are covered in Analysis Workbook. Quick Tour. The PSDM environment is prepared in a bash(1) shell using

$ . /reg/g/psdm/etc/ana_env.sh

or

% source /reg/g/psdm/etc/ana_env.csh

for a csh(1). Sourcing ana_env.sh or ana_env.csh modifies the environment of the current shell, and would have to be repeated every time a new shell is started. To make the changes persistent, add

test -r /reg/g/psdm/etc/ana_env.sh && . /reg/g/psdm/etc/ana_env.sh

to ~/.bashrc, or

test -r /reg/g/psdm/etc/ana_env.csh && source /reg/g/psdm/etc/ana_env.csh

to ~/.cshrc as appropriate. A test released based on the most current LCLS software is then set up in the current working directory using

$ newrel ana-current myrelease
$ cd myrelease
$ sit_setup
$ newpkg my_ana_pkg

Note that the names for the test release and the analysis package, myrelease and my_ana_pkg, are common, but nevertheless arbitrary, choices.


Keeping up to date with PSDM releases

Since the cctbx.xfel modules do not critically depend on any particular version of the PSDM software, it is generally possible to closely track the latest version of the PSDM distribution. To upgrade to the current PSDM release, do

$ cd myrelease
$ relupgrade ana-current

If relinfo does not output ana-current after that, one can edit ~/myrelease/.sit_release manually to that effect. Then rebuild

$ scons -c
$ scons


External links