# uproot.interpretation.numerical.Numerical

Defined in [uproot.interpretation.numerical](https://github.com/scikit-hep/uproot/blob/f1299d71fa4f435b1901386346c8a42adbd72642/src/uproot/interpretation/numerical.py) on [line 35](https://github.com/scikit-hep/uproot/blob/f1299d71fa4f435b1901386346c8a42adbd72642/src/uproot/interpretation/numerical.py#L35).

| **Inheritance order:**                                                                 |
|----------------------------------------------------------------------------------------|
| 1. [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md) |

### *class* uproot.interpretation.numerical.Numerical

Abstract superclass of numerical interpretations, including

* [uproot.AsDtype](uproot.interpretation.numerical.AsDtype.html.md)
* [uproot.AsSTLBits](uproot.interpretation.numerical.AsSTLBits.html.md)
* [uproot.interpretation.numerical.TruncatedNumerical](uproot.interpretation.numerical.TruncatedNumerical.html.md)

<a id="uproot-interpretation-numerical-numerical-cache-key"></a>

## cache_key

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.cache_key

String that uniquely specifies this interpretation, to use as part of
an array’s cache key.

<a id="uproot-interpretation-numerical-numerical-typename"></a>

## typename

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.typename

String that describes this interpretation as a C++ type.

This type might not exactly correspond to the type in C++, but it would
have equivalent meaning.

<a id="uproot-interpretation-numerical-numerical-numpy-dtype"></a>

## numpy_dtype

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.numpy_dtype

The `numpy.dtype` to use to put objects of this type in a NumPy array.

<a id="uproot-interpretation-numerical-numerical-awkward-form"></a>

## awkward_form

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.awkward_form(file, context=None, index_format='i64', header=False, tobject_header=False, breadcrumbs=())

* **Parameters:**
  * **file** ([uproot.ReadOnlyFile](uproot.reading.ReadOnlyFile.html.md)) – File to use to generate
    [uproot.Model](uproot.model.Model.html.md) classes from its
    [streamers](uproot.reading.ReadOnlyFile.html.md#uproot-reading-readonlyfile-streamers) and `file_path`
    for error messages.
  * **context** (*dict*) – Context for the Form-generation; defaults are
    the remaining arguments below.
  * **index_format** (*str*) – Format to use for indexes of the
    `awkward.forms.Form`; may be `"i32"`, `"u32"`, or
    `"i64"`.
  * **header** (*bool*) – If True, include header fields of each C++ class.
  * **tobject_header** (*bool*) – If True, include header fields of each `TObject`
    base class.
  * **breadcrumbs** (*tuple* *of* *class objects*) – Used to check for recursion.
    Types that contain themselves cannot be Awkward Arrays because the
    depth of instances is unknown.

The `awkward.forms.Form` to use to put objects of type type in an
Awkward Array.

<a id="uproot-interpretation-numerical-numerical-basket-array"></a>

## basket_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.basket_array(data, byte_offsets, basket, branch, context, cursor_offset, library, interp_options)

* **Parameters:**
  * **data** (array of `numpy.uint8`) – Raw but uncompressed data from the
    `TBasket`. If the `TBasket` has offsets and navigational
    metadata, it is not included in this array.
  * **byte_offsets** (array of `numpy.int32`) – Index where each entry of
    the `TBasket` starts and stops. The header is not included
    (i.e. the first offset is `0`), and the length of this array
    is one greater than the number of entries in the `TBasket`.
  * **basket** ([uproot.models.TBasket.Model_TBasket](uproot.models.TBasket.Model_TBasket.html.md)) – The `TBasket` object.
  * **context** (*dict*) – Auxiliary data used in deserialization.
  * **cursor_offset** (*int*) – Correction to the integer keys used in
    [refs](uproot.source.cursor.Cursor.html.md#uproot-source-cursor-cursor-refs) for objects
    deserialized by reference
    ([uproot.deserialization.read_object_any](uproot.deserialization.read_object_any.html.md)).
  * **library** ([uproot.interpretation.library.Library](uproot.interpretation.library.Library.html.md)) – The
    requested library for output.
  * **interp_options** (*dict*) – Flags and other options passed through the
    interpretation process.

Performs the first step of interpretation, from uncompressed `TBasket`
data to a temporary array.

<a id="uproot-interpretation-numerical-numerical-final-array"></a>

## final_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.final_array(basket_arrays, entry_start, entry_stop, entry_offsets, library, branch, options)

* **Parameters:**
  * **basket_arrays** (*dict* *of* *int → array*) – Mapping from `TBasket`
    number to the temporary array returned by
    [basket_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-basket-array).
  * **entry_start** (*int*) – First entry to include when trimming any
    excess entries from the first `TBasket`.
  * **entry_stop** (*int*) – FIrst entry to exclude (one greater than the last
    entry to include) when trimming any excess entries from the
    last `TBasket`.
  * **entry_offsets** (*list* *of* *int*) – The
    [entry_offsets](uproot.behaviors.TBranch.TBranch.html.md#uproot-behaviors-tbranch-tbranch-entry-offsets) for this
    `TBranch`.
  * **library** ([uproot.interpretation.library.Library](uproot.interpretation.library.Library.html.md)) – The
    requested library for output.
  * **branch** ([uproot.TBranch](uproot.behaviors.TBranch.TBranch.html.md)) – The `TBranch`
    that is being interpreted.
  * **interp_options** (*dict*) – Flags and other options passed through the
    interpretation process.

Performs the last steps of interpretation, from a collection of
temporary arrays, one for each `TBasket`, to a trimmed, finalized,
grouped array, produced by the `library`.

<a id="uproot-interpretation-numerical-numerical-hook-before-basket-array"></a>

## hook_before_basket_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.hook_before_basket_array(\*args, \*\*kwargs)

Called in [basket_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-basket-array),
before any interpretation.

This is the first hook called in
[basket_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-basket-array).

<a id="uproot-interpretation-numerical-numerical-hook-after-basket-array"></a>

## hook_after_basket_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.hook_after_basket_array(\*args, \*\*kwargs)

Called in [basket_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-basket-array),
after all interpretation.

This is the last hook called in
[basket_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-basket-array).

<a id="uproot-interpretation-numerical-numerical-hook-before-final-array"></a>

## hook_before_final_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.hook_before_final_array(\*args, \*\*kwargs)

Called in [final_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-final-array),
before any trimming, finalization, or grouping.

This is the first hook called in
[final_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-final-array).

<a id="uproot-interpretation-numerical-numerical-hook-before-library-finalize"></a>

## hook_before_library_finalize

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.hook_before_library_finalize(\*args, \*\*kwargs)

Called in [final_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-final-array),
after trimming but before calling the
[finalize](uproot.interpretation.library.Library.html.md#uproot-interpretation-library-library-finalize) routine.

<a id="uproot-interpretation-numerical-numerical-hook-after-final-array"></a>

## hook_after_final_array

Inherited from [uproot.interpretation.Interpretation](uproot.interpretation.Interpretation.html.md).

#### Numerical.hook_after_final_array(\*args, \*\*kwargs)

Called in [final_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-final-array),
after all trimming, finalization, and grouping.

This is the last hook called in
[final_array](uproot.interpretation.Interpretation.html.md#uproot-interpretation-interpretation-final-array).
