IXFregroup y dataset 2d

This function will regroup an IXTdataset_2d object along the y dimension according to the supplied params(ylo,dy,yhi) argument to give an IXTdataset_2d object result. It regroups data with new bin boundaries to ensure that bins have minimum width determined by the parameter dy with limits ylo,yhi, but ensuring the bin boundaries are coincident with original bin boundaries.

• dy > 0 constant bin width = dy
• dy < 0 logarithmic binning y(m+1) = y(m) *(1+|dy|)
• dy = 0 retain original bin boundaries

The difference between IXFrebin_y_dataset_2d and IXFregroup_y_dataset_2d is that in the former the data in the original bins may be divided by the new bin boundaries. In the latter case, new bins are created only by combining whole bins.

Regrouping is ONLY permitted on histogram data.

F90 syntax

use IXMdataset_2d

type(IXTdataset_2d):: dataset_2d,result_d2d
type(IXTstatus)::status
real(dp)::params(3)

call IXFregroup_y_dataset_2d(result_d2d,dataset_2d,params,status)