Defined in uproot.writing.identify on line 1418.

uproot.writing.identify.to_TH3x(fName, fTitle, data, fEntries, fTsumw, fTsumw2, fTsumwx, fTsumwx2, fTsumwy, fTsumwy2, fTsumwxy, fTsumwz, fTsumwz2, fTsumwxz, fTsumwyz, fSumw2, fXaxis, fYaxis, fZaxis, fNcells=None, fBarOffset=0, fBarWidth=1000, fMaximum=-1111.0, fMinimum=-1111.0, fNormFactor=0.0, fContour=None, fOption='', fFunctions=None, fBufferSize=0, fBuffer=None, fBinStatErrOpt=0, fStatOverflows=2, fLineColor=602, fLineStyle=1, fLineWidth=1, fFillColor=0, fFillStyle=1001, fMarkerColor=1, fMarkerStyle=1, fMarkerSize=1.0)
  • fName (None or str) – Temporary name, will be overwritten by the writing process because Uproot’s write syntax is file[name] = histogram.

  • fTitle (str) – Real title of the histogram.

  • data (numpy.ndarray or uproot.models.TArray.Model_TArray) – Bin contents with first bin as underflow, last bin as overflow. The dtype of this array determines the return type of this function (TH3C, TH3D, TH3F, TH3I, or TH3S).

  • fEntries (float) – Number of entries. (https://root.cern.ch/doc/master/classTH1.html)

  • fTsumw (float) – Total Sum of weights.

  • fTsumw2 (float) – Total Sum of squares of weights.

  • fTsumwx (float) – Total Sum of weight*X.

  • fTsumwx2 (float) – Total Sum of weight*X*X.

  • fTsumwy (float) – Total Sum of weight*Y. (TH3 only: https://root.cern.ch/doc/master/classTH3.html)

  • fTsumwy2 (float) – Total Sum of weight*Y*Y. (TH3 only.)

  • fTsumwxy (float) – Total Sum of weight*X*Y. (TH3 only.)

  • fTsumwz (float) – Total Sum of weight*Z. (TH3 only.)

  • fTsumwz2 (float) – Total Sum of weight*Z*Z. (TH3 only.)

  • fTsumwxz (float) – Total Sum of weight*X*Z. (TH3 only.)

  • fTsumwyz (float) – Total Sum of weight*Y*Z. (TH3 only.)

  • fSumw2 (None or numpy.ndarray of numpy.float64 or uproot.models.TArray.Model_TArrayD) – Array of sum of squares of weights. If None, a zero-length uproot.models.TArray.Model_TArrayD is created in its place.

  • fXaxis (uproot.models.TH.Model_TAxis_v10) – Use uproot.writing.identify.to_TAxis with fName="xaxis" and fTitle="".

  • fYaxis (uproot.models.TH.Model_TAxis_v10) – Use uproot.writing.identify.to_TAxis with fName="yaxis" and fTitle="".

  • fZaxis (uproot.models.TH.Model_TAxis_v10) – Use uproot.writing.identify.to_TAxis with fName="zaxis" and fTitle="".

  • fNcells (None or int) – Number of bins(1D), cells (2D) +U/Overflows. Computed from data if None.

  • fBarOffset (int) – (1000*offset) for bar charts or legos

  • fBarWidth (int) – (1000*width) for bar charts or legos

  • fMaximum (float) – Maximum value for plotting.

  • fMinimum (float) – Minimum value for plotting.

  • fNormFactor (float) – Normalization factor.

  • fContour (None or numpy.ndarray of numpy.float64 or uproot.models.TArray.Model_TArrayD) – Array to display contour levels. None generates an empty array.

  • fOption (str or uproot.models.TString.Model_TString) – Histogram options.

  • fFunctions (None, list, or uproot.models.TList.Model_TList) – ->Pointer to list of functions (fits and user). None generates an empty list.

  • fBufferSize (None or int) – fBuffer size. Computed from fBuffer if None.

  • fBuffer (None or numpy.ndarray of numpy.float64) – Buffer of entries accumulated before automatically choosing the binning. (Irrelevant for serialization?) None generates an empty array.

  • fBinStatErrOpt (int) – Option for bin statistical errors.

  • fStatOverflows (int) – Per object flag to use under/overflows in statistics.

  • fLineColor (int) – Line color. (https://root.cern.ch/doc/master/classTAttLine.html)

  • fLineStyle (int) – Line style.

  • fLineWidth (int) – Line width.

  • fFillColor (int) – Fill area color. (https://root.cern.ch/doc/master/classTAttFill.html)

  • fFillStyle (int) – Fill area style.

  • fMarkerColor (int) – Marker color. (https://root.cern.ch/doc/master/classTAttMarker.html)

  • fMarkerStyle (int) – Marker style.

  • fMarkerSize (float) – Marker size.

This function is for developers to create TH3* objects that can be written to ROOT files, to implement conversion routines. The choice of TH3C, TH3D, TH3F, TH3I, or TH3S depends on the dtype of the data array.