explain_segment
Drill into a specific data segment defined by condition variables to discover key factors driving a target outcome.
Instructions
Find drivers of a target outcome within a specific segment (CLARA method). Call this ONCE — like find_drivers, it returns a complete multi-level nested JSON in a single response. Do NOT call it multiple times to refine results.
Use this for local/conditional analysis: "within 1st class passengers, what drives survival?" The condition_variables define which variables describe the segment — araxai will find what values of those variables define the strongest sub-segments, then find drivers within them.
Use find_drivers first for the global picture; use explain_segment only when you need to drill into a specific slice of the data.
Args: dataset_name: Name of a dataset loaded with load_dataset target: Column name of the outcome variable target_class: The specific outcome value to explain condition_variables: Columns that define the segment to focus on (e.g. ["Journey_Type"]) attributes: Optional subset of columns to use as candidate drivers. Exclude columns that are direct encodings of the target, same as for find_drivers. min_base: Minimum records a rule must cover
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_name | Yes | ||
| target | Yes | ||
| target_class | Yes | ||
| condition_variables | Yes | ||
| attributes | No | ||
| min_base | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |