mirror of
https://github.com/slsdetectorgroup/slsDetectorPackage.git
synced 2025-04-25 07:40:03 +02:00
ed84d21da0
git-svn-id: file:///afs/psi.ch/project/sls_det_software/svn/slsDetectorSoftware@186 951219d9-93cf-4727-9268-0efd64621fa3
464 lines
13 KiB
C++
464 lines
13 KiB
C++
|
|
#ifndef ANGULARCONVERSION_H
|
|
#define ANGULARCONVERSION_H
|
|
|
|
|
|
#include "slsDetectorBase.h"
|
|
#include <string>
|
|
#include <fstream>
|
|
|
|
|
|
|
|
//float angle(int ichan, float encoder, float totalOffset, float conv_r, float center, float offset, float tilt, int direction)
|
|
|
|
|
|
using namespace std;
|
|
|
|
/**
|
|
@short Angular conversion constants needed for a detector module
|
|
*/
|
|
typedef struct {
|
|
float center; /**< center of the module (channel at which the radius is perpendicular to the module surface) */
|
|
float ecenter; /**< error in the center determination */
|
|
float r_conversion; /**< detector pixel size (or strip pitch) divided by the diffractometer radius */
|
|
float er_conversion; /**< error in the r_conversion determination */
|
|
float offset; /**< the module offset i.e. the position of channel 0 with respect to the diffractometer 0 */
|
|
float eoffset; /**< error in the offset determination */
|
|
float tilt; /**< ossible tilt in the orthogonal direction (unused)*/
|
|
float etilt; /**< error in the tilt determination */
|
|
} angleConversionConstant;
|
|
|
|
|
|
/**
|
|
|
|
@short methods to set/unset the angular conversion and merge the data
|
|
class containing the methods to set/unset the angular conversion and merge the data
|
|
|
|
|
|
The angular conversion itself is defined by the angle() function defined in usersFunctions.cpp
|
|
|
|
*/
|
|
class angularConversion : public virtual slsDetectorBase {
|
|
|
|
public:
|
|
/** default constructor */
|
|
angularConversion();
|
|
/** virtual destructor */
|
|
virtual ~angularConversion();
|
|
|
|
|
|
|
|
//virtual int readAngularConversion(string fname)=0;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
reads an angular conversion file
|
|
\param fname file to be read
|
|
\param nmod number of modules (maximum) to be read
|
|
\param angOff pointer to array of angleConversionConstants
|
|
\returns OK or FAIL
|
|
*/
|
|
static int readAngularConversion(string fname, int nmod, angleConversionConstant *angOff);
|
|
|
|
/**
|
|
reads an angular conversion file
|
|
\param ifstream input file stream to be read
|
|
\param nmod number of modules (maximum) to be read
|
|
\param angOff pointer to array of angleConversionConstants
|
|
\returns OK or FAIL
|
|
|
|
*/
|
|
static int readAngularConversion(ifstream& ifs, int nmod, angleConversionConstant *angOff);
|
|
/**
|
|
writes an angular conversion file
|
|
\param fname file to be written
|
|
\param nmod number of modules to be written
|
|
\param angOff pointer to array of angleConversionConstants
|
|
\returns OK or FAIL
|
|
*/
|
|
static int writeAngularConversion(string fname, int nmod, angleConversionConstant *angOff);
|
|
|
|
/**
|
|
writes an angular conversion file
|
|
\param ofstream output file stream
|
|
\param nmod number of modules to be written
|
|
\param angOff pointer to array of angleConversionConstants
|
|
\returns OK or FAIL
|
|
*/
|
|
static int writeAngularConversion(ofstream& ofs, int nmod, angleConversionConstant *angOff);
|
|
|
|
/**
|
|
pure virtual function
|
|
\param file name to be written (nmod and array of angular conversion constants default to the ones ot the slsDetector
|
|
*/
|
|
virtual int writeAngularConversion(string fname)=0;
|
|
|
|
/**
|
|
sets the arrays of the merged data to 0. NB The array should be created with size nbins >= 360./getBinSize();
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\param nbins number of bins
|
|
\returns OK or FAIL
|
|
*/
|
|
static int resetMerging(float *mp, float *mv,float *me, int *mm, int nbins);
|
|
/**
|
|
sets the arrays of the merged data to 0. NB The array should be created with size >= 360./getBinSize();
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\returns OK or FAIL
|
|
*/
|
|
int resetMerging(float *mp, float *mv,float *me, int *mm);
|
|
|
|
/**
|
|
creates the arrays for merging the data and sets them to 0.
|
|
*/
|
|
int resetMerging();
|
|
|
|
/**
|
|
merge dataset
|
|
\param p1 angular positions of dataset
|
|
\param v1 data
|
|
\param e1 errors
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\param nchans number of channels
|
|
\param binsize size of angular bin
|
|
\param nb number of angular bins
|
|
\param badChanMask badchannelmask (if NULL does not correct for bad channels)
|
|
\returns OK or FAIL
|
|
*/
|
|
|
|
static int addToMerging(float *p1, float *v1, float *e1, float *mp, float *mv,float *me, int *mm, int nchans, float binsize,int nb, int *badChanMask );
|
|
|
|
/**
|
|
merge dataset
|
|
\param p1 angular positions of dataset
|
|
\param v1 data
|
|
\param e1 errors
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\param badChanMask badchannelmask (if NULL does not correct for bad channels)
|
|
\returns OK or FAIL
|
|
*/
|
|
|
|
int addToMerging(float *p1, float *v1, float *e1, float *mp, float *mv,float *me, int *mm, int *badChanMask);
|
|
/**
|
|
merge dataset
|
|
\param p1 angular positions of dataset
|
|
\param v1 data
|
|
\param e1 errors
|
|
\param badChanMask badchannelmask (if NULL does not correct for bad channels)
|
|
\returns OK or FAIL
|
|
*/
|
|
|
|
int addToMerging(float *p1, float *v1, float *e1,int *badChanMask);
|
|
|
|
/**
|
|
calculates the "final" positions, data value and errors for the merged data
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\param nb number of bins
|
|
\returns FAIL or the number of non empty bins (i.e. points belonging to the pattern)
|
|
*/
|
|
|
|
static int finalizeMerging(float *mp, float *mv,float *me, int *mm, int nb);
|
|
/**
|
|
calculates the "final" positions, data value and errors for the merged data
|
|
\param mp already merged postions
|
|
\param mv already merged data
|
|
\param me already merged errors (squared sum)
|
|
\param mm multiplicity of merged arrays
|
|
\returns FAIL or the number of non empty bins (i.e. points belonging to the pattern)
|
|
*/
|
|
|
|
int finalizeMerging(float *mp, float *mv,float *me, int *mm);
|
|
|
|
/**
|
|
calculates the "final" positions, data value and errors for the merged data
|
|
\returns FAIL or the number of non empty bins (i.e. points belonging to the pattern)
|
|
*/
|
|
|
|
int finalizeMerging();
|
|
|
|
|
|
/**
|
|
set detector global offset
|
|
\param f global offset to be set
|
|
\returns actual global offset
|
|
*/
|
|
float setGlobalOffset(float f){return setAngularConversionParameter(GLOBAL_OFFSET,f);};
|
|
|
|
|
|
/**
|
|
set detector fine offset
|
|
\param f global fine to be set
|
|
\returns actual fine offset
|
|
*/
|
|
float setFineOffset(float f){return setAngularConversionParameter(FINE_OFFSET,f);};
|
|
|
|
/**
|
|
get detector fine offset
|
|
\returns actual fine offset
|
|
*/
|
|
float getFineOffset(){return getAngularConversionParameter(FINE_OFFSET);};
|
|
|
|
/**
|
|
get detector global offset
|
|
\returns actual global offset
|
|
*/
|
|
float getGlobalOffset(){return getAngularConversionParameter(GLOBAL_OFFSET);};
|
|
|
|
/**
|
|
|
|
set detector bin size
|
|
\param bs bin size to be set
|
|
\returns actual bin size
|
|
*/
|
|
float setBinSize(float bs){if (bs>0) nBins=360/bs; return setAngularConversionParameter(BIN_SIZE,bs);};
|
|
|
|
/**
|
|
get detector bin size
|
|
\returns detector bin size used for merging (approx angular resolution)
|
|
*/
|
|
float getBinSize() {return getAngularConversionParameter(BIN_SIZE);};
|
|
|
|
|
|
|
|
/**
|
|
|
|
get angular direction
|
|
\returns actual angular direction (1 is channel number increasing with angle, -1 decreasing)
|
|
*/
|
|
int getAngularDirection(){return (int)getAngularConversionParameter(ANGULAR_DIRECTION);};
|
|
|
|
|
|
/**
|
|
|
|
set angular direction
|
|
\param d angular direction to be set (1 is channel number increasing with angle, -1 decreasing)
|
|
\returns actual angular direction (1 is channel number increasing with angle, -1 decreasing)
|
|
*/
|
|
int setAngularDirection(int d){return (int)setAngularConversionParameter(ANGULAR_DIRECTION, (float)d);};
|
|
|
|
/**
|
|
\returns number of angular bins in the merging (360./binsize)
|
|
*/
|
|
int getNumberOfAngularBins(){return nBins;};
|
|
|
|
/**
|
|
get angular conversion
|
|
\param direction reference to diffractometer direction
|
|
\param angconv array that will be filled with the angular conversion constants
|
|
\returns 0 if angular conversion disabled, >0 otherwise
|
|
*/
|
|
virtual int getAngularConversion(int &direction, angleConversionConstant *angconv=NULL)=0;
|
|
|
|
|
|
/**
|
|
set angular conversion parameter
|
|
\param c parameter type (globaloffset, fineoffset, binsize, angular direction, move flag)
|
|
\param v value to be set
|
|
\returns actual value
|
|
*/
|
|
float setAngularConversionParameter(angleConversionParameter c, float v);
|
|
/**
|
|
get angular conversion parameter
|
|
\param c parameter type (globaloffset, fineoffset, binsize, angular direction, move flag)
|
|
\returns actual value
|
|
*/
|
|
float getAngularConversionParameter(angleConversionParameter c);
|
|
|
|
|
|
|
|
|
|
/**
|
|
set positions for the acquisition
|
|
\param nPos number of positions
|
|
\param pos array with the encoder positions
|
|
\returns number of positions
|
|
*/
|
|
virtual int setPositions(int nPos, float *pos);
|
|
/**
|
|
get positions for the acquisition
|
|
\param pos array which will contain the encoder positions
|
|
\returns number of positions
|
|
*/
|
|
virtual int getPositions(float *pos=NULL);
|
|
|
|
/**
|
|
deletes the array of merged data
|
|
\returns OK
|
|
*/
|
|
int deleteMerging();
|
|
|
|
/**
|
|
\returns pointer to the array o merged positions
|
|
*/
|
|
float *getMergedPositions(){return mergingBins;};
|
|
/**
|
|
\returns pointer to the array of merged counts
|
|
*/
|
|
float *getMergedCounts(){return mergingCounts;};
|
|
/**
|
|
\returns pointer to the array of merged errors
|
|
*/
|
|
float *getMergedErrors(){return mergingErrors;};
|
|
|
|
|
|
|
|
/**
|
|
sets the angular conversion file
|
|
\param fname file to read
|
|
\returns angular conversion flag
|
|
*/
|
|
|
|
int setAngularConversionFile(string fname);
|
|
|
|
|
|
/**
|
|
returns the angular conversion file
|
|
*/
|
|
string getAngularConversionFile(){if (setAngularCorrectionMask()) return string(angConvFile); else return string("none");};
|
|
|
|
|
|
/**
|
|
reads teh angular conversion file for the (multi)detector and writes it to shared memory
|
|
*/
|
|
virtual int readAngularConversionFile(string fname="")=0;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
\returns number of modules of the (multi)detector
|
|
*/
|
|
virtual int getNMods()=0;
|
|
|
|
/**
|
|
returns number of channels in the module
|
|
\param imod module number
|
|
\returns number of channels in the module
|
|
*/
|
|
virtual int getChansPerMod(int imod=0)=0;
|
|
|
|
/**
|
|
get the angular conversion contant of one modules
|
|
\param imod module number
|
|
\returns pointer to the angular conversion constant
|
|
*/
|
|
virtual angleConversionConstant *getAngularConversionPointer(int imod=0)=0;
|
|
|
|
/**
|
|
converts channel number to angle
|
|
\param pos encoder position
|
|
\returns array of angles corresponding to the channels
|
|
*/
|
|
float* convertAngles(float pos);
|
|
/**
|
|
converts channel number to angle for the current encoder position
|
|
\returns array of angles corresponding to the channels
|
|
*/
|
|
float *convertAngles(){return convertAngles(currentPosition);};
|
|
|
|
/**
|
|
\param imod module number
|
|
\returns move flag of the module (1 encoder is added to the angle, 0 not)
|
|
*/
|
|
virtual int getMoveFlag(int imod)=0;
|
|
|
|
/**
|
|
returns number of positions
|
|
*/
|
|
int getNumberOfPositions() {return *numberOfPositions;};
|
|
|
|
protected:
|
|
|
|
/** pointer to number of positions for the acquisition*/
|
|
int *numberOfPositions;
|
|
|
|
/** pointer to the detector positions for the acquisition*/
|
|
float *detPositions;
|
|
|
|
/** pointer to angular conversion file name*/
|
|
char *angConvFile;
|
|
|
|
/** pointer to angular bin size*/
|
|
float *binSize;
|
|
|
|
/** pointer to beamlien fine offset*/
|
|
float *fineOffset;
|
|
/** pointer to beamlien global offset*/
|
|
float *globalOffset;
|
|
/** pointer to beamlien angular direction*/
|
|
int *angDirection;
|
|
/** pointer to detector move flag (1 moves with encoder, 0 not)*/
|
|
int *moveFlag;
|
|
|
|
/** number of bins for angular conversion (360./binsize)*/
|
|
int nBins;
|
|
|
|
|
|
|
|
/**
|
|
current position of the detector
|
|
*/
|
|
float currentPosition;
|
|
/**
|
|
current position index of the detector
|
|
*/
|
|
int currentPositionIndex;
|
|
|
|
|
|
/**
|
|
enables/disable the angular conversion
|
|
\param i 1 sets, 0 unsets,, -1 gets
|
|
\returns actual angular conversion flag
|
|
*/
|
|
virtual int setAngularCorrectionMask(int i=-1)=0;
|
|
|
|
/**
|
|
returns current position index
|
|
*/
|
|
int getCurrentPositionIndex() {return currentPositionIndex;};
|
|
void incrementPositionIndex() {currentPositionIndex++;};
|
|
|
|
|
|
|
|
|
|
void registerAngleFunctionCallback(float( *fun)(float, float, float, float, float, float, float, int)) {angle = fun;};
|
|
|
|
|
|
|
|
private:
|
|
/** merging bins */
|
|
float *mergingBins;
|
|
|
|
/** merging counts */
|
|
float *mergingCounts;
|
|
|
|
/** merging errors */
|
|
float *mergingErrors;
|
|
|
|
/** merging multiplicity */
|
|
int *mergingMultiplicity;
|
|
|
|
float (*angle)(float, float, float, float, float, float, float, int);
|
|
|
|
};
|
|
|
|
#endif
|