IXFrebin y dataset 2d

From LIBISIS
Jump to: navigation, search

This function will rebin an IXTdataset_2d object along the y dimension according to the supplied optional arguments to give an IXTdataset_2d object result. The two optional arguments are defined as follows:


  • Yref is an IXTdataset_2d object, if it is supplied then the dataset_2d object will be rebinned according to the binning of Yref
  • Ydesc is an array of bin boundaries and intervals with a simple and more general form.
    • basic form (ylo,dy,yhi)
      • dy > 0 constant bin width = dy
      • dy < 0 logarithmic binning y(m+1) = y(m) *(1+|dy|)
      • dy = 0 retain original bin boundaries
    • general form (y_1,dy_1,y_2,dy_2,...,y_n,dy_n,y_n+1)
      • dy_i > 0 constant bin width = dy_i
      • dy_i < 0 logarithmic binning y(m+1) = y(m) *(1+|dy_i|)
      • dy_i = 0 retain original bin boundaries


Rebinning is ONLY possible on histogram data.


F90 syntax

use IXMdataset_2d

type(IXTdataset_2d):: dataset_2d,result_d2d
type(IXTstatus)::status
! optional arguments
type(IXTdataset_2d)::Yref
real(dp)::Ydesc(:)
:
:
! using an array of bin boundaries and intervals
call IXFrebin_y_dataset_2d(result_d2d,status,dataset_2d,Ydesc)

! using a reference object
call IXFrebin_y_dataset_2d(result_d2d,status,dataset_2d,Yref)