unpack demodulated data onto 2-d map SCULIB_UNPACK_JIGGLE
If status is good on entry the data and variance of the output map will be initialised to ‘bad’ values, the quality to 1. If there are any data to unpack the routine will then attempt to do so. The method used depends on whether the switch covered part/all of the entire jiggle pattern or contains data for several repeats of the jiggle pattern.
In the first case, the routine will check that the indices of the section of jiggle pattern covered by this switch lie within the bounds of the full jiggle pattern. If not, an error will be reported and bad status returned. Otherwise, the datablock will be unpacked into the map as specified by the I_JIGGLE, J_JIGGLE arrays. Each map point just has its data, variance and quality copied from the demodulated data.
When the data covers several repeats of the jiggle pattern, the routine will check that the jiggle index of the first point in the datablock is 1 and that the number of data points is an integer multiple of the size of the jiggle. If not, an error will be reported and bad status returned. Otherwise, the datablock will be unpacked into the map as specified by I_JIGGLE, J_JIGGLE. The unpacking differs from the first case in that demodulated data with bad quality will be ignored. Points in the unpacked map will be set to the average of the values contributed by the separate jiggles, variances will be calculated from the dispersion of the values about the mean if there was more than 1, or set to the demodulated variance otherwise.