source: sans/Dev/trunk/NCNR_User_Procedures/Reduction/VSANS/V_WorkFolderUtils.ipf @ 994

Last change on this file since 994 was 994, checked in by srkline, 6 years ago

more changes, lots of files.

File size: 29.4 KB
Line 
1#pragma rtGlobals=3             // Use modern global access method and strict wave access.
2#pragma version=1.0
3#pragma IgorVersion=6.1
4
5//*******************
6// Vers 1.0 JAN2016
7//
8//*******************
9//  VSANS Utility procedures for handling of workfiles (each is housed in a separate datafolder)
10//
11// - adding RAW data to a workfile
12// -- **this conversion applies the detector corrections**
13// -- Raw_to_work(newType) IS THE MAJOR ROUTINE TO APPLY DETECTOR CORRECTIONS
14//
15//
16// - copying workfiles to another folder
17//
18// - absolute scaling
19//
20// - (no) the WorkFile Math panel for simple image math (not done - maybe in the future?)
21// -
22// - (no) adding work.drk data without normalizing to monitor counts (the case not currently handled)
23//***************************
24
25//
26// Functions used for manipulation of the local Igor "WORK" folder
27// structure as raw data is displayed and processed.
28//
29//
30Strconstant ksDetectorListNoB = "FT;FB;FL;FR;MT;MB;ML;MR;"
31Strconstant ksDetectorListAll = "FT;FB;FL;FR;MT;MB;ML;MR;B;"
32
33
34//
35//Entry procedure from main panel
36//
37Proc CopyWorkFolder(oldType,newType)
38        String oldType,newType
39        Prompt oldType,"Source WORK data type",popup,"SAM;EMP;BGD;DIV;COR;CAL;RAW;ABS;STO;SUB;DRK;"
40        Prompt newType,"Destination WORK data type",popup,"SAM;EMP;BGD;DIV;COR;CAL;RAW;ABS;STO;SUB;DRK;"
41
42        // data folder "old" will be copied to "new" (either kills/copies or will overwrite)
43        CopyHDFToWorkFolder(oldtype,newtype)
44End
45
46//
47// copy what is needed for data processing (not the DAS_logs)
48// from the RawVSANS storage folder to the local WORK folder as needed
49//
50// TODO -- at what stage do I make copies of data in linear/log forms for data display?
51//                      -- when do I make the 2D error waves?
52//
53// TODO - decide what exactly I need to copy over. May be best to copy all, and delete
54//       what I know that I don't need
55//
56// TODO !!! DuplicateDataFolder will FAIL - in the base case of RAW data files, the
57//  data is actually in use - so it will fail every time. need an alternate solution. in SANS,
58// there are a limited number of waves to carry over, so Dupliate/O is used for rw, tw, data, etc.
59//
60// TODO : I also need a list of what is generated during processing that may be hanging around - that I need to
61//     be sure to get rid of - like the calibration waves, solidAngle, etc.
62//
63// hdfDF is the name only of the data in storage. May be full file name with extension (clean as needed)
64// type is the destination WORK folder for the copy
65//
66Function CopyHDFToWorkFolder(fromStr,toStr)
67        String fromStr,toStr
68       
69        String fromDF, toDF
70       
71        // make the DF paths - source and destination
72        fromDF = "root:Packages:NIST:VSANS:"+fromStr
73        toDF = "root:Packages:NIST:VSANS:"+toStr
74       
75//      // make a copy of the file name for my own use, since it's not in the file
76//      String/G $(toDF+":file_name") = root:
77       
78        // copy the folders
79        KillDataFolder/Z $toDF                  //DuplicateDataFolder will not overwrite, so Kill
80       
81        if(V_flag == 0)         // kill DF was OK
82                DuplicateDataFolder $("root:Packages:NIST:VSANS:"+fromStr),$("root:Packages:NIST:VSANS:"+toStr)
83               
84                // I can delete these if they came along with RAW
85                //   DAS_logs
86                //   top-level copies of data (duplicate links)
87                KillDataFolder/Z $(toDF+":entry:DAS_logs")
88                KillDataFolder/Z $(toDF+":entry:data")
89                KillDataFolder/Z $(toDF+":entry:data_B")
90                KillDataFolder/Z $(toDF+":entry:data_ML")
91                KillDataFolder/Z $(toDF+":entry:data_MR")
92                KillDataFolder/Z $(toDF+":entry:data_MT")
93                KillDataFolder/Z $(toDF+":entry:data_MB")
94                KillDataFolder/Z $(toDF+":entry:data_FL")
95                KillDataFolder/Z $(toDF+":entry:data_FR")
96                KillDataFolder/Z $(toDF+":entry:data_FT")
97                KillDataFolder/Z $(toDF+":entry:data_FB")
98
99                return(0)
100        else
101                // need to do this the hard way, duplicate/O recursively
102                // see V_CopyToWorkFolder()
103               
104                // everything on the top level
105                V_DuplicateDataFolder($(fromDF+":entry"),fromStr,toStr,0,"",0)  //no recursion here
106                // control
107                V_DuplicateDataFolder($(fromDF+":entry:control"),fromStr,toStr,0,"",1)  //yes recursion here
108                // instrument
109                V_DuplicateDataFolder($(fromDF+":entry:instrument"),fromStr,toStr,0,"",1)       //yes recursion here
110                // reduction
111                V_DuplicateDataFolder($(fromDF+":entry:reduction"),fromStr,toStr,0,"",1)        //yes recursion here
112                // sample
113                V_DuplicateDataFolder($(fromDF+":entry:sample"),fromStr,toStr,0,"",1)   //yes recursion here
114
115        endif   
116       
117        return(0)
118end
119
120
121////////
122// see the help entry for IndexedDir for help on (possibly) how to do this faster
123// -- see the function Function ScanDirectories(pathName, printDirNames)
124//
125
126
127// from IgorExchange On July 17th, 2011 jtigor
128// started from "Recursively List Data Folder Contents"
129// Posted July 15th, 2011 by hrodstein
130//
131//
132//
133Proc V_CopyWorkFolderTest(dataFolderStr, fromStr, toStr, level, sNBName, recurse)
134        String dataFolderStr="root:Packages:NIST:VSANS:RAW"
135        String fromStr = "RAW"
136        String toStr="SAM"
137        Variable level=0
138        String sNBName="DataFolderTree"
139        Variable recurse = 1
140       
141        V_DuplicateDataFolder($dataFolderStr, fromStr, toStr, level, sNBName, recurse)
142
143
144end
145
146// ListDataFolder(dfr, level)
147// Recursively lists objects in data folder.
148// Pass data folder path for dfr and 0 for level.
149// pass level == 0 for the first call
150//  sNBName = "" prints nothing. any name will generate a notebook
151//
152// recurse == 0 will do only the specified folder, anything else will recurse all levels
153// toStr is the string name of the top-level folder only, not the full path
154//
155//
156Function V_DuplicateDataFolder(dfr, fromStr, toStr, level, sNBName,recurse)
157        DFREF dfr
158        String fromStr
159        String toStr
160        Variable level                  // Pass 0 to start
161        String sNBName
162        Variable recurse
163 
164        String name
165        String dfName
166        String sString
167       
168        String toDF = ""
169 
170        if (level == 0)         // this is the data folder, generate if needed in the destination
171                name = GetDataFolder(1, dfr)
172//              sPrintf sString, "%s (data folder)\r", name
173                toDF = ReplaceString(fromStr,name,toStr,1)              // case-sensitive replace
174                sprintf sString, "NewDataFolder/O %s\r",toDF
175                NewDataFolder/O $(RemoveEnding(toDF,":"))                       // remove trailing semicolon if it's there
176               
177                V_WriteBrowserInfo(sString, 1, sNBName)
178        endif
179 
180        dfName = GetDataFolder(1, dfr)
181        toDF = ReplaceString(fromStr,dfName,toStr,1)            // case-sensitive replace
182        Variable i
183 
184        String indentStr = "\t"
185        for(i=0; i<level; i+=1)
186                indentStr += "\t"
187        endfor
188 
189        Variable numWaves = CountObjectsDFR(dfr, 1)
190        for(i=0; i<numWaves; i+=1)
191                name = GetIndexedObjNameDFR(dfr, 1, i)
192                //
193                // wave type does not matter now. Duplicate does not care
194                //
195                sPrintf sString, "Duplicate/O  %s,  %s\r",dfName+name,toDF+name
196                Duplicate/O $(dfName+name),$(toDF+name)
197               
198                V_WriteBrowserInfo(sString, 2, sNBName)
199        endfor 
200 
201        Variable numNumericVariables = CountObjectsDFR(dfr, 2) 
202        for(i=0; i<numNumericVariables; i+=1)
203                name = GetIndexedObjNameDFR(dfr, 2, i)
204                sPrintf sString, "%s%s (numeric variable)\r", indentStr, name
205                V_WriteBrowserInfo(sString, 3, sNBName)
206        endfor 
207 
208        Variable numStringVariables = CountObjectsDFR(dfr, 3)   
209        for(i=0; i<numStringVariables; i+=1)
210                name = GetIndexedObjNameDFR(dfr, 3, i)
211                sPrintf sString, "%s%s (string variable)\r", indentStr, name
212                V_WriteBrowserInfo(sString, 4, sNBName)
213        endfor 
214
215        if(recurse)
216                Variable numDataFolders = CountObjectsDFR(dfr, 4)       
217                for(i=0; i<numDataFolders; i+=1)
218                        name = GetIndexedObjNameDFR(dfr, 4, i)
219//                      sPrintf sString, "%s%s (data folder)\r", indentStr, name
220                         dfName = GetDataFolder(1, dfr)
221                         
222                        toDF = ReplaceString(fromStr,dfName,toStr,1)            // case-sensitive replace
223                        sprintf sString, "NewDataFolder/O %s\r",toDF+name
224                        NewDataFolder/O $(toDF+name)
225                       
226                       
227                        V_WriteBrowserInfo(sString, 1, sNBName)
228                        DFREF childDFR = dfr:$(name)
229                        V_DuplicateDataFolder(childDFR, fromStr, toStr, level+1, sNBName, recurse)
230                endfor 
231        endif
232         
233//when finished walking tree, save as RTF with dialog   
234//      if(level == 0 && strlen(sNBName) != 0)
235//              SaveNotebook /I /S=4  $sNBName
236//      endif
237End
238 
239Function V_WriteBrowserInfo(sString, vType, sNBName)
240        String sString
241        Variable vType
242        String sNBName
243 
244        if(strlen(sNBName) == 0)
245//              print sString
246                return 0
247        endif
248        DoWindow $sNBName
249        if(V_flag != 1)
250                NewNoteBook/F=0 /N=$sNBName /V=1 as sNBName
251        else
252                DoWindow/F $sNBName
253        endif
254        Notebook $sNBName selection={endOfFile, endOfFile}
255        if(vType == 1)          // a data folder
256//              Notebook $sNBName fstyle=1
257                Notebook $sNBName text=sString
258//              Notebook $sNBName fstyle=-1
259        else
260                Notebook $sNBName text=sString 
261        endif
262 
263End
264
265///////////////////////////////
266
267
268//
269// given the folder, duplicate the data -> linear_data and generate the error
270// TODO
271// -- do I want to use different names here? If it turns out that I don't need to drag a copy of
272//    the data around as "linear_data", then I can eliminate that, and rename the error wave
273// -- be sure the data is either properly written as 2D in the file, or converted to 2D before
274//    duplicating here
275// -- ? do I recast to DP here. Probably necessary since I'm doing a DP calculation, but Redimension
276//    is done in the Raw_to_Work step too. very confusing.
277Function V_MakeDataError(folderStr)
278        String folderStr
279       
280        SetDataFolder $folderStr
281        Wave data=data
282        Duplicate/O data linear_data                    // at this point, the data is still the raw data, and is linear_data
283       
284        // proper error for counting statistics, good for low count values too
285        // rather than just sqrt(n)
286        // see N. Gehrels, Astrophys. J., 303 (1986) 336-346, equation (7)
287        // for S = 1 in eq (7), this corresponds to one sigma error bars
288        Duplicate/O linear_data linear_data_error
289        linear_data_error = 1 + sqrt(linear_data + 0.75)                               
290        //
291       
292        SetDataFolder root:
293        return(0)
294End
295
296
297/////////////////////
298
299
300
301//testing procedure
302// TODO -- can't duplicate this with another proceudre, but if I change the name of the variable
303//   "newType" to "type", then when Raw_to_work() gets to CopyHDFToWorkFolder(), the KillDataFolder/Z
304//   line fails (but reports no error), then DuplicateDataFolder fails, and reports an error. Trying
305//   to simplify this condition, I can't reproduce the bug for WM...
306Proc Convert_to_Workfile(newtype, doadd)
307        String newtype,doadd
308        Prompt newtype,"WORK data type",popup,"SAM;EMP;BGD;ADJ;"
309        Prompt doadd,"Add to current WORK contents?",popup,"No;Yes;"
310       
311        //macro will take whatever is in RAW folder and "ADD" it to the folder specified
312        //in the popup menu
313       
314        //"add" = yes/no, don't add to previous runs
315        //switch here - two separate functions to avoid (my) confusion
316        Variable err// = Raw_to_work(newtype)
317        if(cmpstr(doadd,"No")==0)
318                //don't add to prev work contents, copy RAW contents to work and convert
319                err = Raw_to_work(newtype)
320        else
321                //yes, add RAW to the current work folder contents
322                Abort "Adding RAW data files is currently unsupported"
323                err = Add_raw_to_work(newtype)
324        endif
325       
326        String newTitle = "WORK_"+newtype
327        DoWindow/F VSANS_Data
328        DoWindow/T VSANS_Data, newTitle
329        KillStrings/Z newTitle
330       
331        //need to update the display with "data" from the correct dataFolder
332        UpdateDisplayInformation(newtype)
333       
334End
335
336
337//
338// THIS IS THE MAJOR ROUTINE TO APPLY DATA CORRECTIONS
339//
340//will copy the current contents of the RAW folder to the newType work folder
341//and do the geometric corrections and normalization to monitor counts
342//(the function Add_Raw_to_work(type) adds multiple runs together - and is LOW priority)
343//
344//the current display type is updated to newType (global)
345//
346Function Raw_to_work(newType)
347        String newType
348       
349        Variable deadTime,defmon,total_mon,total_det,total_trn,total_numruns,total_rtime
350        Variable ii,jj,itim,cntrate,dscale,scale,uscale
351        String destPath
352       
353        String fname = newType
354        String detStr
355        Variable ctTime
356
357        //initialize values before normalization
358        total_mon=0
359        total_det=0
360        total_trn=0
361        total_numruns=0
362        total_rtime=0
363       
364        //Not adding multiple runs, so wipe out the old contents of the work folder and
365        // replace with the contents of raw
366
367        destPath = "root:Packages:NIST:VSANS:" + newType
368       
369        //copy from current dir (RAW) to work, defined by newType
370        CopyHDFToWorkFolder("RAW",newType)
371       
372        // now work with the waves from the destination folder.
373       
374        // apply corrections ---
375        // switches to control what is done, don't do the transmission correction for the BGD measurement
376        // start with the DIV correction, before conversion to mm
377        // then do all of the other corrections, order doesn't matter.
378        // rescaling to default monitor counts however, must be LAST.
379
380// each correction must loop over each detector. tedious.
381
382        // (0) Redimension the data waves in the destination folder
383        //     so that they are DP, not integer
384        // TODO
385        // -- currently only redimensioning the data and linear_data_error - What else???
386        // -- ?? some of this is done at load time for RAW data. shouldn't be an issue to re-do the redimension
387        for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
388                detStr = StringFromList(ii, ksDetectorListAll, ";")
389                Wave w = V_getDetectorDataW(fname,detStr)
390                Wave w_err = V_getDetectorDataErrW(fname,detStr)
391                Redimension/D w,w_err
392        endfor
393       
394       
395        // (1) DIV correction
396        // do this in terms of pixels.
397        // TODO : This must also exist at the time the first work folder is generated.
398        //   So it must be in the user folder at the start of the experiment, and defined.
399        NVAR gDoDIVCor = root:Packages:NIST:VSANS:Globals:gDoDIVCor
400        if (gDoDIVCor == 1)
401                // need extra check here for file existence
402                // if not in DIV folder, load.
403                // if unable to load, skip correction and report error (Alert?) (Ask to Load?)
404                Print "Doing DIV correction"// for "+ detStr
405                for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
406                        detStr = StringFromList(ii, ksDetectorListAll, ";")
407                        Wave w = V_getDetectorDataW(fname,detStr)
408                        Wave w_err = V_getDetectorDataErrW(fname,detStr)
409                       
410                        DIVCorrection(w,w_err,detStr,newType)
411                endfor
412        else
413                Print "DIV correction not done"         // not an error since correction was unchecked
414        endif
415       
416        // (2) non-linear correction   
417        // TODO:
418        // x- currently, the "B" detector is skipped
419        // -- document what is generated here:
420        //    **in each detector folder: data_realDistX and data_realDistY (2D waves of the mm? position of the pixel)
421        // -- still not sure whether to duplicate these calculations as the RAW data is loaded. It would allow the RAW
422        //    data to be properly displayed, but without all of the (complete) set of corrections
423        // * the corrected distances are calculated into arrays, but nothing is done with them yet
424        // * there is enough information now to calculate the q-arrays
425        // -other corrections modify the data, this does NOT
426        NVAR gDoNonLinearCor = root:Packages:NIST:VSANS:Globals:gDoNonLinearCor
427        // generate a distance matrix for each of the detectors
428        if (gDoNonLinearCor == 1)
429                Print "Doing Non-linear correction"// for "+ detStr
430                for(ii=0;ii<ItemsInList(ksDetectorListNoB);ii+=1)
431                        detStr = StringFromList(ii, ksDetectorListNoB, ";")
432                        Wave w = V_getDetectorDataW(fname,detStr)
433//                      Wave w_err = V_getDetectorDataErrW(fname,detStr)
434                        Wave w_calib = V_getDetTube_spatialCalib(fname,detStr)
435                        Variable tube_width = V_getDet_tubeWidth(fname,detStr)
436                        NonLinearCorrection(w,w_calib,tube_width,detStr,destPath)
437
438                        //(2.4) Convert the beam center values from pixels to mm
439                        // TODO -- there needs to be a permanent location for these values??
440                        //
441                        ConvertBeamCtr_to_mm(fname,detStr,destPath)
442                                                       
443                        // (2.5) Calculate the q-values
444                        // calculating q-values can't be done unless the non-linear corrections are calculated
445                        // so go ahead and put it in this loop.
446                        // TODO :
447                        // -- make sure that everything is present before the calculation
448                        // -- beam center must be properly defined in terms of real distance
449                        // -- distances/zero location/ etc. must be clearly documented for each detector
450                        //      ** this assumes that NonLinearCorrection() has been run to generate data_RealDistX and Y
451                        // ** this routine Makes the waves QTot, qx, qy, qz in each detector folder.
452                        //
453                        V_Detector_CalcQVals(fname,detStr,destPath)
454                       
455                endfor
456               
457                //"B" is separate
458                NonLinearCorrection_B(fname,"B",destPath)
459                ConvertBeamCtr_to_mmB(fname,"B",destPath)
460                V_Detector_CalcQVals(fname,"B",destPath)
461               
462        else
463                Print "Non-linear correction not done"
464        endif
465
466        // (3) solid angle correction
467        NVAR gDoSolidAngleCor = root:Packages:NIST:VSANS:Globals:gDoSolidAngleCor
468        if (gDoSolidAngleCor == 1)
469                Print "Doing Solid Angle correction"// for "+ detStr
470                for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
471                        detStr = StringFromList(ii, ksDetectorListAll, ";")
472                        Wave w = V_getDetectorDataW(fname,detStr)
473                        Wave w_err = V_getDetectorDataErrW(fname,detStr)
474//                      Wave w_dt = V_getDetector_deadtime(fname,detStr)
475//                      SolidAngleCorrection(fill this in)
476                       
477                endfor
478        else
479                Print "Solid Angle correction not done"
480        endif   
481       
482        // (4) dead time correction
483        // TODO: -- remove the hard-wired test
484        // -- test for correct operation
485        // -- loop over all of the detectors
486        // -- B detector is a special case (do separately, then loop over NoB)
487        NVAR gDoDeadTimeCor = root:Packages:NIST:VSANS:Globals:gDoDeadTimeCor
488        if (gDoDeadTimeCor == 1)
489                Print "Doing DeadTime correction"// for "+ detStr
490                for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
491                        detStr = StringFromList(ii, ksDetectorListAll, ";")
492                        Wave w = V_getDetectorDataW(fname,detStr)
493                        Wave w_err = V_getDetectorDataErrW(fname,detStr)
494                        ctTime = V_getCount_time(fname)
495
496                        if(cmpstr(detStr,"B") == 0)
497                                Variable b_dt = V_getDetector_deadtime_B(fname,detStr)
498                                // do the correction for the back panel
499                               
500                                //      itim = integersread[2]
501                                //      cntrate = sum(data,-inf,inf)/itim               //use sum of detector counts rather than scaler value
502                                //      //TODO - do correct dead time correction for tubes
503                                //      deadtime = 1//DetectorDeadtime(textread[3],textread[9],dateAndTimeStr=textRead[1],dtime=realsRead[48])  //pick the correct deadtime
504                                //      dscale = 1/(1-deadTime*cntrate)
505                                //     
506                                       
507                                // dead time correction
508                                //      data *= dscale          //deadtime correction for everyone else, including NCNR
509                                //      data_err *= dscale
510                               
511                               
512                        else
513                                // do the corrections for 8 tube panels
514
515                                Wave w_dt = V_getDetector_deadtime(fname,detStr)
516                                //                      DeadTimeCorrectionTubes(w,w_err,w_dt,ctTime)
517
518
519                        endif
520                endfor
521               
522        else
523                Print "Dead Time correction not done"
524        endif   
525       
526       
527        // (5) angle-dependent tube shadowing
528        NVAR gDoTubeShadowCor = root:Packages:NIST:VSANS:Globals:gDoTubeShadowCor
529        if (gDoTubeShadowCor == 1)
530       
531        else
532                Print "Tube shadowing correction not done"
533        endif   
534               
535        // (6) angle dependent transmission correction
536        NVAR gDoTrans = root:Packages:NIST:VSANS:Globals:gDoTransmissionCor
537        if (gDoTrans == 1)
538                Print "Doing Large-angle transmission correction"// for "+ detStr
539                for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
540                        detStr = StringFromList(ii, ksDetectorListAll, ";")
541                        Wave w = V_getDetectorDataW(fname,detStr)
542                        Wave w_err = V_getDetectorDataErrW(fname,detStr)
543//                      TransmissionCorrection(fill this in)
544                       
545                endfor
546        else
547                Print "Sample Transmission correction not done"
548        endif   
549       
550        // (7) normalize to default monitor counts
551        // TODO -- each detector is rescaled separately, but the rescaling factor is global (only one monitor!)
552        // TODO -- but there are TWO monitors - so how to switch?
553        // TODO -- what do I really need to save?
554        Print "Doing monitor normalization"// for "+ detStr
555
556        defmon=1e8                      //default monitor counts
557        for(ii=0;ii<ItemsInList(ksDetectorListAll);ii+=1)
558                detStr = StringFromList(ii, ksDetectorListAll, ";")
559                Wave w = V_getDetectorDataW(fname,detStr)
560                Wave w_err = V_getDetectorDataErrW(fname,detStr)
561                Variable monCt = V_getBeamMonNormData(fname)
562//                      MonitorNormalization(fill this in)
563        //scale the data to the default montor counts
564       
565        // TODO -- un-comment these three lines once monitor counts are reasonable - currently monCt = 9!!!
566//              scale = defmon/monCt
567//              w *= scale
568//              w_err *= scale          //assumes total monitor count is so large there is essentially no error
569
570// TODO
571// -- to write back to the local value, get the wave reference rather than the value, then I can
572//    re-assign the value directly, rather than this method (which is not terrible)     
573                // V_getBeamMonNormSaved_count()
574                // save the true monitor counts? save the scaling factor?
575                String path = "entry:instrument:beam_monitor_norm:saved_count"
576                Wave/Z savW = $("root:Packages:NIST:VSANS:"+fname+":"+path)
577                savW[0] = scale
578        endfor
579       
580       
581        // (not done) angle dependent efficiency correction
582        NVAR doEfficiency = root:Packages:NIST:VSANS:Globals:gDoDetectorEffCor
583
584       
585// this function, in the past did the non-linear, solid angle, transmission, and efficiency corrections all at once
586//      DetCorr(data,data_err,realsread,doEfficiency,doTrans)           //the parameters are waves, and will be changed by the function
587
588
589       
590        //update totals to put in the work header (at the end of the function)
591//      total_mon += realsread[0]
592//
593//      total_det += dscale*realsread[2]
594//
595//      total_trn += realsread[39]
596//      total_rtime += integersread[2]
597//      total_numruns +=1
598//     
599
600        //all is done, except for the bookkeeping, updating the header information in the work folder
601
602//      integersread[3] = total_numruns                                         //numruns = 1
603//      realsread[1] = total_mon                        //save the true monitor count
604//      realsread[0] = defmon                                   //monitor ct = defmon
605//      realsread[2] = scale*total_det                  //scaled detector counts
606//     
607        //reset the current displaytype to "newtype"
608        String/G root:Packages:NIST:VSANS:Globals:gCurDispType=newType
609       
610        //return to root folder (redundant)
611        SetDataFolder root:
612       
613        Return(0)
614End
615
616
617//will "ADD" the current contents of the RAW folder to the newType work folder
618//and will ADD the RAW contents to the existing content of the newType folder
619// - used when adding multiple runs together
620//(the function Raw_to_work(type) makes a fresh workfile)
621//
622//the current display type is updated to newType (global)
623Function Add_raw_to_work(newType)
624        String newType
625       
626        // NEW OCT 2014
627        // this corrects for adding raw data files with different attenuation   
628        // does nothing if the attenuation of RAW and destination are the same
629        NVAR doAdjustRAW_Atten = root:Packages:NIST:gDoAdjustRAW_Atten
630        if(doAdjustRAW_Atten)
631                Adjust_RAW_Attenuation(newType)
632        endif
633       
634        String destPath=""
635       
636        // if the desired workfile doesn't exist, let the user know, and just make a new one
637        if(WaveExists($("root:Packages:NIST:"+newType + ":data")) == 0)
638                Print "There is no old work file to add to - a new one will be created"
639                //call Raw_to_work(), then return from this function
640                Raw_to_Work(newType)
641                Return(0)               //does not generate an error - a single file was converted to work.newtype
642        Endif
643       
644        NVAR pixelsX = root:myGlobals:gNPixelsX
645        NVAR pixelsY = root:myGlobals:gNPixelsY
646       
647        //now make references to data in newType folder
648        DestPath="root:Packages:NIST:"+newType 
649        WAVE data=$(destPath +":linear_data")                   // these wave references point to the EXISTING work data
650        WAVE data_copy=$(destPath +":data")                     // these wave references point to the EXISTING work data
651        WAVE dest_data_err=$(destPath +":linear_data_error")                    // these wave references point to the EXISTING work data
652        WAVE/T textread=$(destPath + ":textread")
653        WAVE integersread=$(destPath + ":integersread")
654        WAVE realsread=$(destPath + ":realsread")
655       
656        Variable deadTime,defmon,total_mon,total_det,total_trn,total_numruns,total_rtime
657        Variable ii,jj,itim,cntrate,dscale,scale,uscale,wrk_beamx,wrk_beamy,xshift,yshift
658
659
660        defmon=1e8                      //default monitor counts
661       
662        //Yes, add to previous run(s) in work, that does exist
663        //use the actual monitor count run.savmon rather than the normalized monitor count
664        //in run.moncnt and unscale the work data
665       
666        total_mon = realsread[1]        //saved monitor count
667        uscale = total_mon/defmon               //unscaling factor
668        total_det = uscale*realsread[2]         //unscaled detector count
669        total_trn = uscale*realsread[39]        //unscaled trans det count
670        total_numruns = integersread[3] //number of runs in workfile
671        total_rtime = integersread[2]           //total counting time in workfile
672        //retrieve workfile beamcenter
673        wrk_beamx = realsread[16]
674        wrk_beamy = realsread[17]
675        //unscale the workfile data in "newType"
676        //
677        //check for log-scaling and adjust if necessary
678        // should not be needed now - using display flag instead
679//      ConvertFolderToLinearScale(newType)
680        //
681        //then unscale the data array
682        data *= uscale
683        dest_data_err *= uscale
684       
685        //DetCorr() has not been applied to the data in RAW , do it now in a local reference to the raw data
686        WAVE raw_data = $"root:Packages:NIST:RAW:linear_data"
687        WAVE raw_data_err = $"root:Packages:NIST:RAW:linear_data_error"
688        WAVE raw_reals =  $"root:Packages:NIST:RAW:realsread"
689        WAVE/T raw_text = $"root:Packages:NIST:RAW:textread"
690        WAVE raw_ints = $"root:Packages:NIST:RAW:integersread"
691       
692        //check for log-scaling of the raw data - make sure it's linear
693        // should not be needed now - using display flag instead
694//      ConvertFolderToLinearScale("RAW")
695       
696        // switches to control what is done, don't do the transmission correction for the BGD measurement
697        NVAR doEfficiency = root:Packages:NIST:gDoDetectorEffCorr
698        NVAR gDoTrans = root:Packages:NIST:gDoTransmissionCorr
699        Variable doTrans = gDoTrans
700        if(cmpstr("BGD",newtype) == 0)
701                doTrans = 0             //skip the trans correction for the BGD file but don't change the value of the global
702        endif   
703       
704        DetCorr(raw_data,raw_data_err,raw_reals,doEfficiency,doTrans)   //applies correction to raw_data, and overwrites it
705       
706        //deadtime corrections to raw data
707        // TODO - do the tube correction for dead time now
708        deadTime = 1//DetectorDeadtime(raw_text[3],raw_text[9],dateAndTimeStr=raw_text[1],dtime=raw_reals[48])          //pick the correct detector deadtime, switch on date too
709        itim = raw_ints[2]
710        cntrate = sum(raw_data,-inf,inf)/itim           //080802 use data sum, rather than scaler value
711        dscale = 1/(1-deadTime*cntrate)
712
713#if (exists("ILL_D22")==6)
714        Variable tubeSum
715        // for D22 detector might need to use cntrate/128 as it is the tube response
716        for(ii=0;ii<pixelsX;ii+=1)
717                //sum the counts in each tube
718                tubeSum = 0
719                for(jj=0;jj<pixelsY;jj+=1)
720                        tubeSum += data[jj][ii]
721                endfor
722                // countrate in tube ii
723                cntrate = tubeSum/itim
724                // deadtime scaling in tube ii
725                dscale = 1/(1-deadTime*cntrate)
726                // multiply data[ii][] by the dead time
727                raw_data[][ii] *= dscale
728                raw_data_err[][ii] *= dscale
729        endfor
730#else
731        // dead time correction on all other RAW data, including NCNR
732        raw_data *= dscale
733        raw_data_err *= dscale
734#endif
735
736        //update totals by adding RAW values to the local ones (write to work header at end of function)
737        total_mon += raw_reals[0]
738
739        total_det += dscale*raw_reals[2]
740
741        total_trn += raw_reals[39]
742        total_rtime += raw_ints[2]
743        total_numruns +=1
744       
745        //do the beamcenter shifting if there is a mismatch
746        //and then add the two data sets together, changing "data" since it is the workfile data
747        xshift = raw_reals[16] - wrk_beamx
748        yshift = raw_reals[17] - wrk_beamy
749       
750        If((xshift != 0) || (yshift != 0))
751                DoAlert 1,"Do you want to ignore the beam center mismatch?"
752                if(V_flag==1)
753                        xshift=0
754                        yshift=0
755                endif
756        endif
757       
758        If((xshift == 0) && (yshift == 0))              //no shift, just add them
759                data += raw_data                //deadtime correction has already been done to the raw data
760                dest_data_err = sqrt(dest_data_err^2 + raw_data_err^2)                  // error of the sum
761        Endif
762       
763        //scale the data to the default montor counts
764        scale = defmon/total_mon
765        data *= scale
766        dest_data_err *= scale
767       
768        // keep "data" and linear_data in sync in the destination folder
769        data_copy = data
770       
771        //all is done, except for the bookkeeping of updating the header info in the work folder
772        textread[1] = date() + " " + time()             //date + time stamp
773        integersread[3] = total_numruns                                         //numruns = more than one
774        realsread[1] = total_mon                        //save the true monitor count
775        realsread[0] = defmon                                   //monitor ct = defmon
776        integersread[2] = total_rtime                   // total counting time
777        realsread[2] = scale*total_det                  //scaled detector counts
778        realsread[39] = scale*total_trn                 //scaled transmission counts
779       
780        //Add the added raw filename to the list of files in the workfile
781        String newfile = ";" + raw_text[0]
782        SVAR oldList = $(destPath + ":fileList")
783        String/G $(destPath + ":fileList") = oldList + newfile
784       
785        //reset the current display type to "newtype"
786        SVAR gCurDispType = root:Packages:NIST:VSANS:Globals:gCurDispType
787        gCurDispType = newType
788       
789        //return to root folder (redundant)
790        SetDataFolder root:
791       
792        Return(0)
793End
794
795
796//used for adding DRK (beam shutter CLOSED) data to a workfile
797//force the monitor count to 1, since it's irrelevant
798// run data through normal "add" step, then unscale default monitor counts
799//to get the data back on a simple time basis
800//
801Function Raw_to_Work_NoNorm(type)
802        String type
803       
804        WAVE reals=$("root:Packages:NIST:RAW:realsread")
805        reals[1]=1              //true monitor counts, still in raw
806        Raw_to_work(type)
807        //data is now in "type" folder
808        WAVE data=$("root:Packages:NIST:"+type+":linear_data")
809        WAVE data_copy=$("root:Packages:NIST:"+type+":data")
810        WAVE data_err=$("root:Packages:NIST:"+type+":linear_data_error")
811        WAVE new_reals=$("root:Packages:NIST:"+type+":realsread")
812       
813        Variable norm_mon,tot_mon,scale
814       
815        norm_mon = new_reals[0]         //should be 1e8
816        tot_mon = new_reals[1]          //should be 1
817        scale= norm_mon/tot_mon
818       
819        data /= scale           //unscale the data
820        data_err /= scale
821       
822        // to keep "data" and linear_data in sync
823        data_copy = data
824       
825        return(0)
826End
827
828//used for adding DRK (beam shutter CLOSED) data to a workfile
829//force the monitor count to 1, since it's irrelevant
830// run data through normal "add" step, then unscale default monitor counts
831//to get the data back on a simple time basis
832//
833Function Add_Raw_to_Work_NoNorm(type)
834        String type
835       
836        WAVE reals=$("root:Packages:NIST:RAW:realsread")
837        reals[1]=1              //true monitor counts, still in raw
838        Add_Raw_to_work(type)
839        //data is now in "type" folder
840        WAVE data=$("root:Packages:NIST:"+type+":linear_data")
841        WAVE data_copy=$("root:Packages:NIST:"+type+":data")
842        WAVE data_err=$("root:Packages:NIST:"+type+":linear_data_error")
843        WAVE new_reals=$("root:Packages:NIST:"+type+":realsread")
844       
845        Variable norm_mon,tot_mon,scale
846       
847        norm_mon = new_reals[0]         //should be 1e8
848        tot_mon = new_reals[1]          //should be equal to the number of runs (1 count per run)
849        scale= norm_mon/tot_mon
850       
851        data /= scale           //unscale the data
852        data_err /= scale
853       
854        // to keep "data" and linear_data in sync
855        data_copy = data
856       
857        return(0)
858End
859
Note: See TracBrowser for help on using the repository browser.