You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

For the impatient users and quick reference here is the typical sequence of the steps through which the typical analysis should proceed. Some of these steps should be done only once, some on every login, and others more frequently. Every step is marked with the frequency at which it should be executed.

1. Setup an account (Freq: once)

This step is described in details in Account Setup section of the workbook. You need to be able to login to analysis host and source the environment setup script at logon time.

2. Environment setup (Freq: every logon)

Either source the the environment setup script on every logon: . /reg/g/psdm/etc/ana_env.sh or add this command to the shell login script as explained in Account Setup section.

3. Create a test release (Freq: once)

Releases are explained in Packages and Releases section. Create new test release with the command like this:

newrel ana-current analisys-rel

This will create a new directory named analisys-rel and populate it with few files and directories:

         ./analisys-rel/
                        arch/
                        build/
                        data/
                        include/
                        SConstruct

Does user need in all these files and directories (question)

Below we refer to this directory as a "test release". Usually separate analyses use separate test releases, and each test release should bear unique name if they are located in the same directory.

4. Change to the test release (Freq: every logon or whenever needed)

cd analisys-rel
sit_setup

The last sit_setup command is every important and must be executed from the release directory every time you change the directory.

5. Create new analysis package (Freq: once)

Choose sufficiently unique name for your analysis package and create the package.

It's better to choose name which contains letters, digits, and underscores only because the package name will be used for Python package names.

newpkg my_ana_pkg

This will create directory my_ana_pkg and populate it with few files and sub-directories:

       .../analisys-rel/
                      ./my_ana_pkg/
                                   SConscript
                                   doc/
                                       README
                                       ChangeLog

Does user need in all these files and directories (question)

6. Add analysis module (Freq: once)

This step depends on which specific analysis framework is used, currently we only support Python-based analysis and for this framework you need to execute following commands:

mkdir my_ana_pkg/src   # only if src directory does not exist yet
codegen -l pyana-module -o my_ana_pkg/src my_ana_pkg my_ana_mod

This will create file my_ana_pkg/src/my_ana_mod.py which contains boilerplate code for analysis module. In this command the "-l pyana-module" stands for module language, the "-o my_ana_pkg/src" indicates the output directory, and the package name my_ana_pkg is usualy used for comments in the created module(s). The codegen command can also be used to geneate other template modules, as explained here.

Like with the package name it's better to use names containing letters, digits, and underscores only.

7. Modify analysis code (Freq: as much as you need)

Use your favorite editor to add or modify code the analysis module.

8. Build (Freq: after every edit)

Run the command which builds all necessary software in your test release:

scons

9. Create configuration file (Freq: once)

In addition to analysis module the job usually needs a separate configuration file. The name and location of the file could be arbitrary. By default Python-based analysis uses file named pyana.cfg in current directory so the simplest would be to create it inside the release directory:

vi pyana.cfg

The file will contain both the names of the modules you want to load and parameters you want to pass to those modules, exact content of the configuration file is explained in Pyana User Manual.

10. Run the analysis (Freq: as much as you need)

Chose the data you want to process and start analysis job. For Pyana it would be something like (assuming properly prepared pyana.cfg in current directory):

pyana /reg/d/psdm/AMO/amo14410/xtc/e23-r0406-*.xtc
  • No labels