In order to keep the filesizes small to avoid issue when analysis the smallData files, we try to extract the important information gleaned from areaDetectors at an event-by-event basis and only save these pieces of data.

Analysis functions

The following functions are readily available for use in smalldata_tools:

• ROI
• Azimuthal integration
• Droplet
• Projection
• Autocorrelation
• ROIFunc
• ...

The funtions definition can be found in <smalldata_tools>/smalldata_tools/ana_funcs, in case one want to take a close look at how the data are processed. These analysis functions are sub-classes of DetObjectFunc and the computation are done in the custom process method defined in each subclass.

...

The different common modes are described here

Interactive SmallDataAna session

For the use of the interactive features of SmallDataAna_psana, we recommend to start it in an ipython session as interactive grabbing of user input is currently not implemented via the notebook.

Creating an average image

In order to decide on the proper ROI, fit a team center or make a mask, the first step is always to create an image that you would like to use as base. This is achieved using the following function in the python terminal opened from:

/sdf/data/lcls/ds/<hutch>/<expname>/results/smalldata_tools via:

./producers/runSmallDataAna -r <#> [-e <expname>]

The following command will create an average image of 100 events of an area detector with a set of default parameters:

SDAna In: anaps.AvImage()

This will by default create an average image of 100 events of an area detector. The method will list and prompt for a detector name if more than one area detector is found in the dataset.

The full command with all its options can be looked via using the "?" feature of iPython:

SDAna In: anaps.AvImage?

If you would like to take a quick look at your average image before proceeding, call:

SDAna In: anaps.plotAvImage()

The SmallDataAna session can typically be used to help setting the parameters for the smalldata production.

-------------------------------------------------------------------------------------------------------------------------------------------------------------

Deprecated

Typical forms of userData

...