IXFregroup x dataset 2d

From LIBISIS
Jump to navigation Jump to search


This function will regroup an IXTdataset_2d object along the x dimension according to the supplied params(xlo,dx,xhi) 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 dx with limits xlo,xhi, but ensuring the bin boundaries are coincident with original bin boundaries.


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


The difference between IXFrebin_x_dataset_2d and IXFregroup_x_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_x_dataset_2d(result_d2d,dataset_2d,params,status)