gibuu is hosted by Hepforge, IPPP Durham
GiBUU

TABLE OF CONTENTS


/hist_multipleRuns [ Modules ]

[ Top ] [ Modules ]

NAME

module hist_multipleRuns

PURPOSE

Encapsulate routines and datas for 1D Histogramms, in which you want to store the results of several sequentiell runs.

Features of Histograms provided by this module:

  • store paramaters of the x-binning
  • enable two y-values (y and y2)
  • track keeping of under-/over-score the given extreme values of x.
  • provide simple-to-understand output routines (cf. WriteHist)
  • provide simple histogram arithmetic (not yet implemented)
  • many others...

Every Histogram prints his own multicolumn output. A multicolumn output of many different histograms for the same x-value is not implemented. This is done by the module "histMPf90".

INPUTS

...(This module needs no input)


hist_multipleRuns/histogram_mr [ Types ]

[ Top ] [ hist_multipleRuns ] [ Types ]

NAME

type histogram_mr

PURPOSE

Type definition to store all information for a multiple-run 1D Histogram.

SOURCE

  type histogram_mr
     type(histogram)  :: total                          ! total result of all runs
     type(histogram)  :: thisRun                        ! result of the present run
     integer          :: numRuns                        ! number of runs
     real, dimension (:) , Allocatable :: sumOfSquares  ! Sum (Squares of the result of a single run)
  end type histogram_mr

hist_multipleRuns/CreateHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine CreateHist_mr(H, HName,x1,x2,bin)

PURPOSE

This is the Constructor of a 1D-Histogram! Allocate Memory for the entries and put additional variables to their default.

INPUTS

  • type(histogram_mr) :: H -- Histogramm to be created
  • character*(*) :: HName -- Name of Histogram
  • real :: x1,x2,bin -- Minimal/maximal value for x-coordinate to be considered, bin-width

OUTPUT

H is changed


hist_multipleRuns/RemoveHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine RemoveHist_mr(H)

PURPOSE

Free the allocated memory

INPUTS

OUTPUT

H is changed


hist_multipleRuns/AddHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine AddHist_mr(H, x,y,y2)

PURPOSE

Add to the given histogram at the given x-value the weight y (y2). If y2 is given, also the second column is filled.

INPUTS

  • type(histogram_mr) :: H -- Histogramm to be used
  • real :: x -- x-value
  • real :: y -- weight to be added
  • real :: y2 -- second weight to be added [OPTIONAL]

OUTPUT

H is changed


hist_multipleRuns/startRunHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine startRunHist_mr(H)

PURPOSE

Tells the histogram that all next data belong to a new run

INPUTS

OUTPUT

H is changed


hist_multipleRuns/endRunHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine endRunHist_mr(H)

PURPOSE

Tells the histogram that the analysis of a run is finished

INPUTS

OUTPUT

H is changed


hist_multipleRuns/WriteHist_mr [ Subroutines ]

[ Top ] [ hist_multipleRuns ] [ Subroutines ]

NAME

subroutine WriteHist_mr(H,iFile,file)

PURPOSE

Write out the histogram including error analysis.

INPUTS

  • type(histogram),intent(in) :: H
  • integer, intent(in) :: iFile
  • character(*), intent(in),optional :: file

NOTES

The Histogram Data is not affected!!!