FACET Developers Guide - this document is under construction!

I. Overview

The FACET facility is controlled by the VMS-based SCP control system, and EPICS controls for some systems.  This is a basic FACET control system physics development guide.

confluence test area:

test2

II. Logging into the FACET control system network

The FACET EPICS control system resides on its own MCC-based private network, parallel to and separate from the LCLS network.  The FACET servers that will be used for matlab work are:

• facet-srv01

The FACET and LCLS directory structures have a parallel naming convention:

• LCLS top-level directory: /usr/local/lcls
• FACET top-level directory: /usr/local/facet

To log into the FACET network from a linux terminal session:

• Account setup:
  • Your afs unix account must be added to the facet group.  Contact Ken Brobeck (x2558).
  • You will be logging into the facet network as the shared fphysics account. For personal matlab settings, Mike Zelazny (x3673) will set you up with an (optional) user-specific directory and environment (ENVS script file) under fphysics.
• Log into the mcclogin machine with your afs account:
  ssh mcclogin

• login
  • From mcclogin, log into facet-srv01 as the fphysics account
    ssh fphysics@facet-srv01
  • When prompted, enter your user number assigned by Mike (or 0 if you don't have one.)
  • With Mike's setup, you are now in /home/fphysics/userid (e.g. /home/fphysics/fred)

To log into the FACET network from an OPI in MCC:

• Click the ..... icon on the desktop.

III. FACET edm displays: facethome

facethome is the toplevel display for the FACET accelerator. It is similar to lclshome, a grid showing all areas and subsystems, with clickability into the various displays.

To run facethome from a terminal session on the facet network (see above) enter:

• enter
  facethome
  at the command prompt

To run facethome from a an MCC opi:

• click the ... icon on the screen

IV. SCP

To run a SCP from a terminal session window:

• you will need a VMS account on MCC. To get one, please contact Ken Brobeck (x2558)
• from your afs account on mcclogin, log into mcc and run the scp:
  ssh mcc
  scp xt userid (e.g. scp xt fred)

To run a SCP from facethome:

• click the "SCP..." button

V. Matlab

For a complete overview and detailed instructions please refer to the "MATLAB Programmer's Guide for FACET physicists", which can be found here: /usr/local/facet/tools/matlab/programming_guide_matlab.doc and .pdf

Environment setup
After you log onto a Linux machine using the fphysics account, you'll need to customize the environment for matlab. Once Mike Z. has set up your user directory under fphysics as described in II. above, add these commands to your /home/fphysics/userid/ENVS file, and they will be automatically invoked every time you log in. Note: All strings are case-sensitive.

• source /usr/local/facet/tools/script/ENVS_facet.bash
• export EPICS_CA_MAX_ARRAY_BYTES=40000000 (if you'll be using OTR image data)
• export DISPLAY=your_IP_address:0 (if you're logging in from Windows)

Note: your_IP_address can be found after running ipconfig on Windows.

*Starting matlab

• If you want the full GUI development environment, type
  matlab
• If you want to run applications only and/or do some basic scripting (recommended), type
  matlab -nodesktop -nosplash
  This starts the fully working command-line version that requires much less resources.

Directories
tested matlab scripts that are shared can be found here:
/usr/local/facet/tools/matlab/toolbox

matlab scripts developed by the FACET software engineering group are here:
/usr/local/facet/tools/matlab/src

CVS
All shared matlab scripts are stored in the version control system, CVS. LCLS and FACET matlab scripts share their CVS repository, so there are many LCLS-specific scripts to be found in the toolbox and src directories, alongside the FACET and so-called "accelerator-agnostic" versions.

Please refer to the Programmer's Guide for more info.

BSA: beam synchronous data

VI. AIDA

http://www.slac.stanford.edu/grp/cd/soft/aida/

VII. Useful links