> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# atoti_ai.AutoExplain

### *final class* atoti\_ai.AutoExplain

Manage the Auto-Explain feature of a [`Cube`](./atoti.cube#atoti.Cube).

<Callout icon="link">
  **See also**:
  [`atoti.Cube.auto_explain`](./atoti.Cube.auto_explain#atoti.Cube.auto_explain).
</Callout>

| [`excluded_hierarchies`](./atoti_ai.AutoExplain.excluded_hierarchies#atoti_ai.AutoExplain.excluded_hierarchies)                                                 | The hierarchies that are never explored.                                                                                                                             |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`excluded_hierarchies_per_measure`](./atoti_ai.AutoExplain.excluded_hierarchies_per_measure#atoti_ai.AutoExplain.excluded_hierarchies_per_measure)             | The per-measure overrides of [`excluded_hierarchies`](./atoti_ai.AutoExplain.excluded_hierarchies#atoti_ai.AutoExplain.excluded_hierarchies), keyed by measure name. |
| [`included_hierarchies`](./atoti_ai.AutoExplain.included_hierarchies#atoti_ai.AutoExplain.included_hierarchies)                                                 | The hierarchies exploration is restricted to.                                                                                                                        |
| [`included_hierarchies_per_measure`](./atoti_ai.AutoExplain.included_hierarchies_per_measure#atoti_ai.AutoExplain.included_hierarchies_per_measure)             | The per-measure overrides of [`included_hierarchies`](./atoti_ai.AutoExplain.included_hierarchies#atoti_ai.AutoExplain.included_hierarchies), keyed by measure name. |
| [`max_depth`](./atoti_ai.AutoExplain.max_depth#atoti_ai.AutoExplain.max_depth)                                                                                  | The maximum number of hierarchies the algorithm drills down through.                                                                                                 |
| [`max_distinct_hierarchies`](./atoti_ai.AutoExplain.max_distinct_hierarchies#atoti_ai.AutoExplain.max_distinct_hierarchies)                                     | The maximum number of distinct hierarchies reported across the explanation.                                                                                          |
| [`max_entropy`](./atoti_ai.AutoExplain.max_entropy#atoti_ai.AutoExplain.max_entropy)                                                                            | The maximum entropy above which a level is considered too uniform to explain.                                                                                        |
| [`max_members_per_level`](./atoti_ai.AutoExplain.max_members_per_level#atoti_ai.AutoExplain.max_members_per_level)                                              | The maximum number of members reported per level.                                                                                                                    |
| [`min_percentage_absolute_contribution`](./atoti_ai.AutoExplain.min_percentage_absolute_contribution#atoti_ai.AutoExplain.min_percentage_absolute_contribution) | The minimum absolute contribution (as a percentage) a member must reach to be reported.                                                                              |
| [`min_percentage_relative_contribution`](./atoti_ai.AutoExplain.min_percentage_relative_contribution#atoti_ai.AutoExplain.min_percentage_relative_contribution) | The minimum relative contribution (as a percentage) a member must reach to be reported.                                                                              |
| [`min_variation_threshold`](./atoti_ai.AutoExplain.min_variation_threshold#atoti_ai.AutoExplain.min_variation_threshold)                                        | The minimum variation a contributor must reach to be reported.                                                                                                       |
| [`opposite_contributors_included`](./atoti_ai.AutoExplain.opposite_contributors_included#atoti_ai.AutoExplain.opposite_contributors_included)                   | Whether contributors moving in the opposite direction of the overall variation are also reported.                                                                    |