sagemaker-core 1.0.62__py3-none-any.whl → 2.3.1__py3-none-any.whl

sagemaker/core/clarify/__init__.py

@@ -0,0 +1,2898 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+"""This module configures the SageMaker Clarify bias and model explainability processor jobs.
+
+SageMaker Clarify
+==================
+"""
+from __future__ import absolute_import, print_function
+
+import copy
+import json
+import logging
+import os
+import re
+
+import tempfile
+from abc import ABC, abstractmethod
+from typing import List, Literal, Union, Dict, Optional, Any
+from enum import Enum
+from schema import Schema, And, Use, Or, Optional as SchemaOptional, Regex
+from sagemaker.core import s3
+from sagemaker.core import image_uris
+from sagemaker.core.helper.session_helper import Session
+from sagemaker.core.network import NetworkConfig
+from sagemaker.core.shapes import ProcessingInput, ProcessingOutput
+from sagemaker.core.processing import Processor
+from sagemaker.core.common_utils import (
+    format_tags,
+    Tags,
+    name_from_base,
+)
+
+logger = logging.getLogger(__name__)
+
+
+ENDPOINT_NAME_PREFIX_PATTERN = "^[a-zA-Z0-9](-*[a-zA-Z0-9])"
+
+# asym shap val config default values (timeseries)
+ASYM_SHAP_VAL_DEFAULT_EXPLANATION_DIRECTION = "chronological"
+ASYM_SHAP_VAL_DEFAULT_EXPLANATION_GRANULARITY = "timewise"
+ASYM_SHAP_VAL_EXPLANATION_DIRECTIONS = [
+    "chronological",
+    "anti_chronological",
+    "bidirectional",
+]
+ASYM_SHAP_VAL_GRANULARITIES = [
+    "timewise",
+    "fine_grained",
+]
+
+ANALYSIS_CONFIG_SCHEMA_V1_0 = Schema(
+    {
+        SchemaOptional("version"): str,
+        "dataset_type": And(
+            str,
+            Use(str.lower),
+            lambda s: s
+            in (
+                "text/csv",
+                "application/jsonlines",
+                "application/json",
+                "application/sagemakercapturejson",
+                "application/x-parquet",
+                "application/x-image",
+            ),
+        ),
+        SchemaOptional("dataset_uri"): str,
+        SchemaOptional("headers"): [str],
+        SchemaOptional("label"): Or(str, int),
+        # this field indicates user provides predicted_label in dataset
+        SchemaOptional("predicted_label"): Or(str, int),
+        SchemaOptional("features"): str,
+        SchemaOptional("label_values_or_threshold"): [Or(int, float, str)],
+        SchemaOptional("probability_threshold"): float,
+        SchemaOptional("segment_config"): [
+            {
+                SchemaOptional("config_name"): str,
+                "name_or_index": Or(str, int),
+                "segments": [[Or(str, int)]],
+                SchemaOptional("display_aliases"): [str],
+            }
+        ],
+        SchemaOptional("facet"): [
+            {
+                "name_or_index": Or(str, int),
+                SchemaOptional("value_or_threshold"): [Or(int, float, str)],
+            }
+        ],
+        SchemaOptional("facet_dataset_uri"): str,
+        SchemaOptional("facet_headers"): [str],
+        SchemaOptional("predicted_label_dataset_uri"): str,
+        SchemaOptional("predicted_label_headers"): [str],
+        SchemaOptional("excluded_columns"): [Or(int, str)],
+        SchemaOptional("joinsource_name_or_index"): Or(str, int),
+        SchemaOptional("group_variable"): Or(str, int),
+        SchemaOptional("time_series_data_config"): {
+            "target_time_series": Or(str, int),
+            "item_id": Or(str, int),
+            "timestamp": Or(str, int),
+            SchemaOptional("related_time_series"): Or([str], [int]),
+            SchemaOptional("static_covariates"): Or([str], [int]),
+            SchemaOptional("dataset_format"): And(
+                str,
+                Use(str.lower),
+                lambda s: s
+                in (
+                    "columns",
+                    "item_records",
+                    "timestamp_records",
+                ),
+            ),
+        },
+        "methods": {
+            SchemaOptional("shap"): {
+                SchemaOptional("baseline"): Or(
+                    # URI of the baseline data file
+                    str,
+                    # Inplace baseline data (a list of something)
+                    [
+                        Or(
+                            # CSV row
+                            [Or(int, float, str, None)],
+                            # JSON row (any JSON object). As I write this only
+                            # SageMaker JSONLines Dense Format ([1])
+                            # is supported and the validation is NOT done
+                            # by the schema but by the data loader.
+                            # [1] https://docs.aws.amazon.com/sagemaker/latest/dg/cdf-inference.html#cm-jsonlines
+                            {object: object},
+                        )
+                    ],
+                    # Arbitrary JSON object as baseline
+                    {object: object},
+                ),
+                SchemaOptional("num_clusters"): int,
+                SchemaOptional("use_logit"): bool,
+                SchemaOptional("num_samples"): int,
+                SchemaOptional("agg_method"): And(
+                    str, Use(str.lower), lambda s: s in ("mean_abs", "median", "mean_sq")
+                ),
+                SchemaOptional("save_local_shap_values"): bool,
+                SchemaOptional("text_config"): {
+                    "granularity": And(
+                        str, Use(str.lower), lambda s: s in ("token", "sentence", "paragraph")
+                    ),
+                    "language": And(
+                        str,
+                        Use(str.lower),
+                        lambda s: s
+                        in (
+                            "chinese",
+                            "zh",
+                            "danish",
+                            "da",
+                            "dutch",
+                            "nl",
+                            "english",
+                            "en",
+                            "french",
+                            "fr",
+                            "german",
+                            "de",
+                            "greek",
+                            "el",
+                            "italian",
+                            "it",
+                            "japanese",
+                            "ja",
+                            "lithuanian",
+                            "lt",
+                            "multi-language",
+                            "xx",
+                            "norwegian bokmål",
+                            "nb",
+                            "polish",
+                            "pl",
+                            "portuguese",
+                            "pt",
+                            "romanian",
+                            "ro",
+                            "russian",
+                            "ru",
+                            "spanish",
+                            "es",
+                            "afrikaans",
+                            "af",
+                            "albanian",
+                            "sq",
+                            "arabic",
+                            "ar",
+                            "armenian",
+                            "hy",
+                            "basque",
+                            "eu",
+                            "bengali",
+                            "bn",
+                            "bulgarian",
+                            "bg",
+                            "catalan",
+                            "ca",
+                            "croatian",
+                            "hr",
+                            "czech",
+                            "cs",
+                            "estonian",
+                            "et",
+                            "finnish",
+                            "fi",
+                            "gujarati",
+                            "gu",
+                            "hebrew",
+                            "he",
+                            "hindi",
+                            "hi",
+                            "hungarian",
+                            "hu",
+                            "icelandic",
+                            "is",
+                            "indonesian",
+                            "id",
+                            "irish",
+                            "ga",
+                            "kannada",
+                            "kn",
+                            "kyrgyz",
+                            "ky",
+                            "latvian",
+                            "lv",
+                            "ligurian",
+                            "lij",
+                            "luxembourgish",
+                            "lb",
+                            "macedonian",
+                            "mk",
+                            "malayalam",
+                            "ml",
+                            "marathi",
+                            "mr",
+                            "nepali",
+                            "ne",
+                            "persian",
+                            "fa",
+                            "sanskrit",
+                            "sa",
+                            "serbian",
+                            "sr",
+                            "setswana",
+                            "tn",
+                            "sinhala",
+                            "si",
+                            "slovak",
+                            "sk",
+                            "slovenian",
+                            "sl",
+                            "swedish",
+                            "sv",
+                            "tagalog",
+                            "tl",
+                            "tamil",
+                            "ta",
+                            "tatar",
+                            "tt",
+                            "telugu",
+                            "te",
+                            "thai",
+                            "th",
+                            "turkish",
+                            "tr",
+                            "ukrainian",
+                            "uk",
+                            "urdu",
+                            "ur",
+                            "vietnamese",
+                            "vi",
+                            "yoruba",
+                            "yo",
+                        ),
+                    ),
+                    SchemaOptional("max_top_tokens"): int,
+                },
+                SchemaOptional("image_config"): {
+                    SchemaOptional("num_segments"): int,
+                    SchemaOptional("segment_compactness"): int,
+                    SchemaOptional("feature_extraction_method"): str,
+                    SchemaOptional("model_type"): str,
+                    SchemaOptional("max_objects"): int,
+                    SchemaOptional("iou_threshold"): float,
+                    SchemaOptional("context"): float,
+                    SchemaOptional("debug"): {
+                        SchemaOptional("image_names"): [str],
+                        SchemaOptional("class_ids"): [int],
+                        SchemaOptional("sample_from"): int,
+                        SchemaOptional("sample_to"): int,
+                    },
+                },
+                SchemaOptional("seed"): int,
+                SchemaOptional("features_to_explain"): [Or(int, str)],
+            },
+            SchemaOptional("pre_training_bias"): {"methods": Or(str, [str])},
+            SchemaOptional("post_training_bias"): {"methods": Or(str, [str])},
+            SchemaOptional("pdp"): {
+                "grid_resolution": int,
+                SchemaOptional("features"): [Or(str, int)],
+                SchemaOptional("top_k_features"): int,
+            },
+            SchemaOptional("report"): {"name": str, SchemaOptional("title"): str},
+            SchemaOptional("asymmetric_shapley_value"): {
+                "direction": And(
+                    str,
+                    Use(str.lower),
+                    lambda s: s
+                    in (
+                        "chronological",
+                        "anti_chronological",
+                        "bidirectional",
+                    ),
+                ),
+                "granularity": And(
+                    str,
+                    Use(str.lower),
+                    lambda s: s
+                    in (
+                        "timewise",
+                        "fine_grained",
+                    ),
+                ),
+                SchemaOptional("num_samples"): int,
+                SchemaOptional("baseline"): Or(
+                    str,
+                    {
+                        SchemaOptional("target_time_series", default="zero"): And(
+                            str,
+                            Use(str.lower),
+                            lambda s: s
+                            in (
+                                "zero",
+                                "mean",
+                            ),
+                        ),
+                        SchemaOptional("related_time_series"): And(
+                            str,
+                            Use(str.lower),
+                            lambda s: s
+                            in (
+                                "zero",
+                                "mean",
+                            ),
+                        ),
+                        SchemaOptional("static_covariates"): {Or(str, int): [Or(str, int, float)]},
+                    },
+                ),
+            },
+        },
+        SchemaOptional("predictor"): {
+            SchemaOptional("endpoint_name"): str,
+            SchemaOptional("endpoint_name_prefix"): And(str, Regex(ENDPOINT_NAME_PREFIX_PATTERN)),
+            SchemaOptional("model_name"): str,
+            SchemaOptional("target_model"): str,
+            SchemaOptional("instance_type"): str,
+            SchemaOptional("initial_instance_count"): int,
+            SchemaOptional("accelerator_type"): str,
+            SchemaOptional("content_type"): And(
+                str,
+                Use(str.lower),
+                lambda s: s
+                in (
+                    "text/csv",
+                    "application/jsonlines",
+                    "application/json",
+                    "image/jpeg",
+                    "image/png",
+                    "application/x-npy",
+                ),
+            ),
+            SchemaOptional("accept_type"): And(
+                str,
+                Use(str.lower),
+                lambda s: s in ("text/csv", "application/jsonlines", "application/json"),
+            ),
+            SchemaOptional("label"): Or(str, int),
+            SchemaOptional("probability"): Or(str, int),
+            SchemaOptional("label_headers"): [Or(str, int)],
+            SchemaOptional("content_template"): Or(str, {str: str}),
+            SchemaOptional("record_template"): str,
+            SchemaOptional("custom_attributes"): str,
+            SchemaOptional("time_series_predictor_config"): {
+                "forecast": str,
+            },
+        },
+    }
+)
+
+
+class DatasetType(Enum):
+    """Enum to store different dataset types supported in the Analysis config file"""
+
+    TEXTCSV = "text/csv"
+    JSONLINES = "application/jsonlines"
+    JSON = "application/json"
+    PARQUET = "application/x-parquet"
+    IMAGE = "application/x-image"
+
+
+class TimeSeriesJSONDatasetFormat(Enum):
+    """Possible dataset formats for JSON time series data files.
+
+    Below is an example ``COLUMNS`` dataset for time series explainability::
+
+        {
+            "ids": [1, 2],
+            "timestamps": [3, 4],
+            "target_ts": [5, 6],
+            "rts1": [0.25, 0.5],
+            "rts2": [1.25, 1.5],
+            "scv1": [10, 20],
+            "scv2": [30, 40]
+        }
+
+    For this example, JMESPaths are specified when creating ``TimeSeriesDataConfig`` as follows::
+
+        item_id="ids"
+        timestamp="timestamps"
+        target_time_series="target_ts"
+        related_time_series=["rts1", "rts2"]
+        static_covariates=["scv1", "scv2"]
+
+    Below is an example ``ITEM_RECORDS`` dataset for time series explainability::
+
+        [
+            {
+                "id": 1,
+                "scv1": 10,
+                "scv2": "red",
+                "timeseries": [
+                    {"timestamp": 1, "target_ts": 5, "rts1": 0.25, "rts2": 10},
+                    {"timestamp": 2, "target_ts": 6, "rts1": 0.35, "rts2": 20},
+                    {"timestamp": 3, "target_ts": 4, "rts1": 0.45, "rts2": 30}
+                ]
+            },
+            {
+                "id": 2,
+                "scv1": 20,
+                "scv2": "blue",
+                "timeseries": [
+                    {"timestamp": 1, "target_ts": 4, "rts1": 0.25, "rts2": 40},
+                    {"timestamp": 2, "target_ts": 2, "rts1": 0.35, "rts2": 50}
+                ]
+            }
+        ]
+
+    For this example, JMESPaths are specified when creating ``TimeSeriesDataConfig`` as follows::
+
+        item_id="[*].id"
+        timestamp="[*].timeseries[].timestamp"
+        target_time_series="[*].timeseries[].target_ts"
+        related_time_series=["[*].timeseries[].rts1", "[*].timeseries[].rts2"]
+        static_covariates=["[*].scv1", "[*].scv2"]
+
+    Below is an example ``TIMESTAMP_RECORDS`` dataset for time series explainability::
+
+        [
+            {"id": 1, "timestamp": 1, "target_ts": 5, "scv1": 10, "rts1": 0.25},
+            {"id": 1, "timestamp": 2, "target_ts": 6, "scv1": 10, "rts1": 0.5},
+            {"id": 1, "timestamp": 3, "target_ts": 3, "scv1": 10, "rts1": 0.75},
+            {"id": 2, "timestamp": 5, "target_ts": 10, "scv1": 20, "rts1": 1}
+        ]
+
+    For this example, JMESPaths are specified when creating ``TimeSeriesDataConfig`` as follows::
+
+        item_id="[*].id"
+        timestamp="[*].timestamp"
+        target_time_series="[*].target_ts"
+        related_time_series=["[*].rts1"]
+        static_covariates=["[*].scv1"]
+    """
+
+    COLUMNS = "columns"
+    ITEM_RECORDS = "item_records"
+    TIMESTAMP_RECORDS = "timestamp_records"
+
+
+class SegmentationConfig:
+    """Config object that defines segment(s) of the dataset on which metrics are computed."""
+
+    def __init__(
+        self,
+        name_or_index: Union[str, int],
+        segments: List[List[Union[str, int]]],
+        config_name: Optional[str] = None,
+        display_aliases: Optional[List[str]] = None,
+    ):
+        """Initializes a segmentation configuration for a dataset column.
+
+        Args:
+            name_or_index (str or int): The name or index of the column in the dataset on which
+                the segment(s) is defined.
+            segments (List[List[str or int]]): Each List of values represents one segment. If N
+                Lists are provided, we generate N+1 segments - the additional segment, denoted as
+                the '__default__' segment, is for the rest of the values that are not covered by
+                these lists. For continuous columns, a segment must be given as strings in interval
+                notation (eg.: ["[1, 4]"] or ["(2, 5]"]). A segment can also be composed of
+                multiple intervals (eg.: ["[1, 4]", "(5, 6]"] is one segment). For categorical
+                columns, each segment should contain one or more of the categorical values for
+                the categorical column, which may be strings or integers.
+                Eg,: For a continuous column, ``segments`` could be
+                [["[1, 4]", "(5, 6]"], ["(7, 9)"]] - this generates 3 segments including the
+                default segment. For a categorical columns with values ("A", "B", "C", "D"),
+                ``segments``,could be [["A", "B"]]. This generate 2 segments, including the default
+                segment.
+            config_name (str) - Optional name for the segment config to identify the config.
+            display_aliases (List[str]) - Optional list of display names for the ``segments`` for
+                the analysis output and report. This list should be the same length as the number of
+                lists provided in ``segments`` or with one additional display alias for the default
+                segment.
+
+        Raises:
+            ValueError: when the ``name_or_index`` is None, ``segments`` is invalid, or a wrong
+                number of ``display_aliases`` are specified.
+        """
+        if name_or_index is None:
+            raise ValueError("`name_or_index` cannot be None")
+        self.name_or_index = name_or_index
+        if (
+            not segments
+            or not isinstance(segments, list)
+            or not all([isinstance(segment, list) for segment in segments])
+        ):
+            raise ValueError("`segments` must be a list of lists of values or intervals.")
+        self.segments = segments
+        self.config_name = config_name
+        if display_aliases is not None and not (
+            len(display_aliases) == len(segments) or len(display_aliases) == len(segments) + 1
+        ):
+            raise ValueError(
+                "Number of `display_aliases` must equal the number of segments"
+                " specified or with one additional default segment display alias."
+            )
+        self.display_aliases = display_aliases
+
+    def to_dict(self) -> Dict[str, Any]:  # pragma: no cover
+        """Returns SegmentationConfig as a dict."""
+        segment_config_dict = {"name_or_index": self.name_or_index, "segments": self.segments}
+        if self.config_name:
+            segment_config_dict["config_name"] = self.config_name
+        if self.display_aliases:
+            segment_config_dict["display_aliases"] = self.display_aliases
+        return segment_config_dict
+
+
+class TimeSeriesDataConfig:
+    """Config object for TimeSeries explainability data configuration fields."""
+
+    def __init__(
+        self,
+        target_time_series: Union[str, int],
+        item_id: Union[str, int],
+        timestamp: Union[str, int],
+        related_time_series: Optional[List[Union[str, int]]] = None,
+        static_covariates: Optional[List[Union[str, int]]] = None,
+        dataset_format: Optional[TimeSeriesJSONDatasetFormat] = None,
+    ):
+        """Initialises TimeSeries explainability data configuration fields.
+
+        Args:
+            target_time_series (str or int): A string or a zero-based integer index.
+                Used to locate the target time series in the shared input dataset.
+                If this parameter is a string, then all other parameters except
+                `dataset_format` must be strings or lists of strings. If
+                this parameter is an int, then all other parameters except
+                `dataset_format` must be ints or lists of ints.
+            item_id (str or int): A string or a zero-based integer index. Used to
+                locate item id in the shared input dataset.
+            timestamp (str or int): A string or a zero-based integer index. Used to
+                locate timestamp in the shared input dataset.
+            related_time_series (list[str] or list[int]): Optional. An array of strings
+                or array of zero-based integer indices. Used to locate all related time
+                series in the shared input dataset (if present).
+            static_covariates (list[str] or list[int]): Optional.  An array of strings or
+                array of zero-based integer indices. Used to locate all static covariate
+                fields in the shared input dataset (if present).
+            dataset_format (TimeSeriesJSONDatasetFormat): Describes the format
+                of the data files provided for analysis. Should only be provided
+                when dataset is in JSON format.
+
+        Raises:
+            ValueError: If any required arguments are not provided or are the wrong type.
+        """
+        # check target_time_series, item_id, and timestamp are provided
+        if not target_time_series:
+            raise ValueError("Please provide a target time series.")
+        if not item_id:
+            raise ValueError("Please provide an item id.")
+        if not timestamp:
+            raise ValueError("Please provide a timestamp.")
+        # check all arguments are the right types
+        if not isinstance(target_time_series, (str, int)):
+            raise ValueError("Please provide a string or an int for ``target_time_series``")
+        params_type = type(target_time_series)
+        if not isinstance(item_id, params_type):
+            raise ValueError(f"Please provide {params_type} for ``item_id``")
+        if not isinstance(timestamp, params_type):
+            raise ValueError(f"Please provide {params_type} for ``timestamp``")
+        # add mandatory fields to an internal dictionary
+        self.time_series_data_config = dict()
+        _set(target_time_series, "target_time_series", self.time_series_data_config)
+        _set(item_id, "item_id", self.time_series_data_config)
+        _set(timestamp, "timestamp", self.time_series_data_config)
+        # check optional arguments are right types if provided
+        related_time_series_error_message = (
+            f"Please provide a list of {params_type} for ``related_time_series``"
+        )
+        if related_time_series:
+            if not isinstance(related_time_series, list):
+                raise ValueError(
+                    related_time_series_error_message
+                )  # related_time_series is not a list
+            if not all([isinstance(value, params_type) for value in related_time_series]):
+                raise ValueError(
+                    related_time_series_error_message
+                )  # related_time_series is not a list of strings or list of ints
+            if params_type == str and not all(related_time_series):
+                raise ValueError("Please do not provide empty strings in ``related_time_series``.")
+            _set(
+                related_time_series, "related_time_series", self.time_series_data_config
+            )  # related_time_series is valid, add it
+        static_covariates_series_error_message = (
+            f"Please provide a list of {params_type} for ``static_covariates``"
+        )
+        if static_covariates:
+            if not isinstance(static_covariates, list):
+                raise ValueError(
+                    static_covariates_series_error_message
+                )  # static_covariates is not a list
+            if not all([isinstance(value, params_type) for value in static_covariates]):
+                raise ValueError(
+                    static_covariates_series_error_message
+                )  # static_covariates is not a list of strings or list of ints
+            if params_type == str and not all(static_covariates):
+                raise ValueError("Please do not provide empty strings in ``static_covariates``.")
+            _set(
+                static_covariates, "static_covariates", self.time_series_data_config
+            )  # static_covariates is valid, add it
+        if params_type == str:
+            # check dataset_format is provided and valid
+            if not isinstance(dataset_format, TimeSeriesJSONDatasetFormat):
+                raise ValueError("Please provide a valid dataset format.")
+            _set(dataset_format.value, "dataset_format", self.time_series_data_config)
+        else:
+            if dataset_format:
+                raise ValueError(
+                    "Dataset format should only be provided when data files are JSONs."
+                )
+
+    def get_time_series_data_config(self):
+        """Returns part of an analysis config dictionary."""
+        return copy.deepcopy(self.time_series_data_config)
+
+
+class DataConfig:
+    """Config object related to configurations of the input and output dataset."""
+
+    def __init__(
+        self,
+        s3_data_input_path: str,
+        s3_output_path: str,
+        s3_analysis_config_output_path: Optional[str] = None,
+        label: Optional[str] = None,
+        headers: Optional[List[str]] = None,
+        features: Optional[str] = None,
+        dataset_type: str = "text/csv",
+        s3_compression_type: str = "None",
+        joinsource: Optional[Union[str, int]] = None,
+        facet_dataset_uri: Optional[str] = None,
+        facet_headers: Optional[List[str]] = None,
+        predicted_label_dataset_uri: Optional[str] = None,
+        predicted_label_headers: Optional[List[str]] = None,
+        predicted_label: Optional[Union[str, int]] = None,
+        excluded_columns: Optional[Union[List[int], List[str]]] = None,
+        segmentation_config: Optional[List[SegmentationConfig]] = None,
+        time_series_data_config: Optional[TimeSeriesDataConfig] = None,
+    ):
+        """Initializes a configuration of both input and output datasets.
+
+        Args:
+            s3_data_input_path (str): Dataset S3 prefix/object URI.
+            s3_output_path (str): S3 prefix to store the output.
+            s3_analysis_config_output_path (str): S3 prefix to store the analysis config output.
+                If this field is None, then the ``s3_output_path`` will be used
+                to store the ``analysis_config`` output.
+            label (str): Target attribute of the model required by bias metrics. Specified as
+                column name or index for CSV dataset or a JMESPath expression for JSON/JSON Lines.
+                *Required parameter* except for when the input dataset does not contain the label.
+                Note: For JSON, the JMESPath query must result in a list of labels for each
+                sample.  For JSON Lines, it must result in the label for each line.
+                Only a single label per sample is supported at this time.
+            headers ([str]): List of column names in the dataset. If not provided, Clarify will
+                generate headers to use internally. For time series explainability cases,
+                please provide headers in the order of item_id, timestamp, target_time_series,
+                all related_time_series columns, and then all static_covariate columns.
+            features (str): JMESPath expression to locate the feature values
+                if the dataset format is JSON/JSON Lines.
+                Note: For JSON, the JMESPath query must result in a 2-D list (or a matrix) of
+                feature values.  For JSON Lines, it must result in a 1-D list of features for each
+                line.
+            dataset_type (str): Format of the dataset. Valid values are ``"text/csv"`` for CSV,
+                ``"application/jsonlines"`` for JSON Lines, ``"application/json"`` for JSON, and
+                ``"application/x-parquet"`` for Parquet.
+            s3_compression_type (str): Valid options are "None" or ``"Gzip"``.
+            joinsource (str or int): The name or index of the column in the dataset that
+                acts as an identifier column (for instance, while performing a join).
+                This column is only used as an identifier, and not used for any other computations.
+                This is an optional field in all cases except:
+
+                * The dataset contains more than one file and `save_local_shap_values`
+                  is set to true in :class:`~sagemaker.clarify.ShapConfig`, and/or
+                * When the dataset and/or facet dataset and/or predicted label dataset
+                  are in separate files.
+
+            facet_dataset_uri (str): Dataset S3 prefix/object URI that contains facet attribute(s),
+                used for bias analysis on datasets without facets.
+
+                * If the dataset and the facet dataset are one single file each, then
+                  the original dataset and facet dataset must have the same number of rows.
+                * If the dataset and facet dataset are in multiple files (either one), then
+                  an index column, ``joinsource``, is required to join the two datasets.
+
+                Clarify will not use the ``joinsource`` column and columns present in the facet
+                dataset when calling model inference APIs.
+                Note: this is only supported for ``"text/csv"`` dataset type.
+            facet_headers (list[str]): List of column names in the facet dataset.
+            predicted_label_dataset_uri (str): Dataset S3 prefix/object URI with predicted labels,
+                which are used directly for analysis instead of making model inference API calls.
+
+                * If the dataset and the predicted label dataset are one single file each, then the
+                  original dataset and predicted label dataset must have the same number of rows.
+                * If the dataset and predicted label dataset are in multiple files (either one),
+                  then an index column, ``joinsource``, is required to join the two datasets.
+
+                Note: this is only supported for ``"text/csv"`` dataset type.
+            predicted_label_headers (list[str]): List of column names in the predicted label dataset
+            predicted_label (str or int): Predicted label of the target attribute of the model
+                required for running bias analysis. Specified as column name or index for CSV data,
+                or a JMESPath expression for JSON/JSON Lines.
+                Clarify uses the predicted labels directly instead of making model inference API
+                calls.
+                Note: For JSON, the JMESPath query must result in a list of predicted labels for
+                each sample.  For JSON Lines, it must result in the predicted label for each line.
+                Only a single predicted label per sample is supported at this time.
+            excluded_columns (list[int] or list[str]): A list of names or indices of the columns
+                which are to be excluded from making model inference API calls.
+            segmentation_config (list[SegmentationConfig]): A list of ``SegmentationConfig``
+                objects.
+            time_series_data_config (TimeSeriesDataConfig): Optional. A config object for TimeSeries
+                data specific fields, required for TimeSeries explainability use cases.
+
+        Raises:
+            ValueError: when the ``dataset_type`` is invalid, predicted label dataset parameters
+                are used with un-supported ``dataset_type``, or facet dataset parameters
+                are used with un-supported ``dataset_type``
+        """
+        if dataset_type not in [
+            "text/csv",
+            "application/jsonlines",
+            "application/json",
+            "application/x-parquet",
+            "application/x-image",
+        ]:
+            raise ValueError(
+                f"Invalid dataset_type '{dataset_type}'."
+                f" Please check the API documentation for the supported dataset types."
+            )
+        # predicted_label and excluded_columns are only supported for tabular datasets
+        if dataset_type not in [
+            "text/csv",
+            "application/jsonlines",
+            "application/json",
+            "application/x-parquet",
+        ]:
+            if predicted_label:
+                raise ValueError(
+                    f"The parameter 'predicted_label' is not supported"
+                    f" for dataset_type '{dataset_type}'."
+                    f" Please check the API documentation for the supported dataset types."
+                )
+            if excluded_columns:
+                raise ValueError(
+                    f"The parameter 'excluded_columns' is not supported"
+                    f" for dataset_type '{dataset_type}'."
+                    f" Please check the API documentation for the supported dataset types."
+                )
+        # parameters for analysis on datasets without facets are only supported for CSV datasets
+        if dataset_type != "text/csv":
+            if facet_dataset_uri or facet_headers:
+                raise ValueError(
+                    f"The parameters 'facet_dataset_uri' and 'facet_headers'"
+                    f" are not supported for dataset_type '{dataset_type}'."
+                    f" Please check the API documentation for the supported dataset types."
+                )
+            if predicted_label_dataset_uri or predicted_label_headers:
+                raise ValueError(
+                    f"The parameters 'predicted_label_dataset_uri' and 'predicted_label_headers'"
+                    f" are not supported for dataset_type '{dataset_type}'."
+                    f" Please check the API documentation for the supported dataset types."
+                )
+        # check if any other format other than JSON is provided for time series case
+        if time_series_data_config:
+            if dataset_type != "application/json":
+                raise ValueError(
+                    "Currently time series explainability only supports JSON format data."
+                )
+        # features JMESPath is required for JSON as we can't derive it ourselves
+        if dataset_type == "application/json" and features is None and not time_series_data_config:
+            raise ValueError("features JMESPath is required for application/json dataset_type")
+        self.s3_data_input_path = s3_data_input_path
+        self.s3_output_path = s3_output_path
+        self.s3_analysis_config_output_path = s3_analysis_config_output_path
+        self.s3_data_distribution_type = "FullyReplicated"
+        self.s3_compression_type = s3_compression_type
+        self.label = label
+        self.headers = headers
+        self.features = features
+        self.facet_dataset_uri = facet_dataset_uri
+        self.facet_headers = facet_headers
+        self.predicted_label_dataset_uri = predicted_label_dataset_uri
+        self.predicted_label_headers = predicted_label_headers
+        self.predicted_label = predicted_label
+        self.excluded_columns = excluded_columns
+        self.segmentation_configs = segmentation_config
+        self.analysis_config = {
+            "dataset_type": dataset_type,
+        }
+        _set(features, "features", self.analysis_config)
+        _set(headers, "headers", self.analysis_config)
+        _set(label, "label", self.analysis_config)
+        _set(joinsource, "joinsource_name_or_index", self.analysis_config)
+        _set(facet_dataset_uri, "facet_dataset_uri", self.analysis_config)
+        _set(facet_headers, "facet_headers", self.analysis_config)
+        _set(
+            predicted_label_dataset_uri,
+            "predicted_label_dataset_uri",
+            self.analysis_config,
+        )
+        _set(predicted_label_headers, "predicted_label_headers", self.analysis_config)
+        _set(predicted_label, "predicted_label", self.analysis_config)
+        _set(excluded_columns, "excluded_columns", self.analysis_config)
+        if segmentation_config:
+            _set(
+                [item.to_dict() for item in segmentation_config],
+                "segment_config",
+                self.analysis_config,
+            )
+        if time_series_data_config:
+            _set(
+                time_series_data_config.get_time_series_data_config(),
+                "time_series_data_config",
+                self.analysis_config,
+            )
+
+    def get_config(self):
+        """Returns part of an analysis config dictionary."""
+        return copy.deepcopy(self.analysis_config)
+
+
+class BiasConfig:
+    """Config object with user-defined bias configurations of the input dataset."""
+
+    def __init__(
+        self,
+        label_values_or_threshold: List[Union[int, float, str]],
+        facet_name: Union[str, int, List[str], List[int]],
+        facet_values_or_threshold: Optional[Union[int, float, str]] = None,
+        group_name: Optional[str] = None,
+    ):
+        """Initializes a configuration of the sensitive groups in the dataset.
+
+        Args:
+            label_values_or_threshold ([int or float or str]): List of label value(s) or threshold
+                to indicate positive outcome used for bias metrics.
+                The appropriate threshold depends on the problem type:
+
+                * Binary: The list has one positive value.
+                * Categorical:The list has one or more (but not all) categories
+                  which are the positive values.
+                * Regression: The list should include one threshold that defines the **exclusive**
+                  lower bound of positive values.
+
+            facet_name (str or int or list[str] or list[int]): Sensitive attribute column name
+                (or index in the input data) to use when computing bias metrics. It can also be a
+                list of names (or indexes) for computing metrics for multiple sensitive attributes.
+            facet_values_or_threshold ([int or float or str] or [[int or float or str]]):
+                The parameter controls the values of the sensitive group.
+                If ``facet_name`` is a scalar, then it can be None or a list.
+                Depending on the data type of the facet column, the values mean:
+
+                * Binary data: None means computing the bias metrics for each binary value.
+                  Or add one binary value to the list, to compute its bias metrics only.
+                * Categorical data: None means computing the bias metrics for each category. Or add
+                  one or more (but not all) categories to the list, to compute their
+                  bias metrics v.s. the other categories.
+                * Continuous data: The list should include one and only one threshold which defines
+                  the **exclusive** lower bound of a sensitive group.
+
+                If ``facet_name`` is a list, then ``facet_values_or_threshold`` can be None
+                if all facets are of binary or categorical type.
+                Otherwise, ``facet_values_or_threshold`` should be a list, and each element
+                is the value or threshold of the corresponding facet.
+            group_name (str): Optional column name or index to indicate a group column to be used
+                for the bias metric
+                `Conditional Demographic Disparity in Labels `(CDDL) <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-cddl.html>`_
+                or
+                `Conditional Demographic Disparity in Predicted Labels (CDDPL) <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-cddpl.html>`_.
+
+        Raises:
+            ValueError: If the number of ``facet_names`` doesn't equal number of ``facet values``
+        """  # noqa E501  # pylint: disable=c0301
+        if isinstance(facet_name, list):
+            assert len(facet_name) > 0, "Please provide at least one facet"
+            if facet_values_or_threshold is None:
+                facet_list = [
+                    {"name_or_index": single_facet_name} for single_facet_name in facet_name
+                ]
+            elif len(facet_values_or_threshold) == len(facet_name):
+                facet_list = []
+                for i, single_facet_name in enumerate(facet_name):
+                    facet = {"name_or_index": single_facet_name}
+                    if facet_values_or_threshold is not None:
+                        _set(facet_values_or_threshold[i], "value_or_threshold", facet)
+                    facet_list.append(facet)
+            else:
+                raise ValueError(
+                    "The number of facet names doesn't match the number of facet values"
+                )
+        else:
+            facet = {"name_or_index": facet_name}
+            _set(facet_values_or_threshold, "value_or_threshold", facet)
+            facet_list = [facet]
+        self.analysis_config = {
+            "label_values_or_threshold": label_values_or_threshold,
+            "facet": facet_list,
+        }
+        _set(group_name, "group_variable", self.analysis_config)
+
+    def get_config(self):
+        """Returns a dictionary of bias detection configurations, part of the analysis config"""
+        return copy.deepcopy(self.analysis_config)
+
+
+class TimeSeriesModelConfig:
+    """Config object for TimeSeries predictor configuration fields."""
+
+    def __init__(
+        self,
+        forecast: str,
+    ):
+        """Initializes model configuration fields for TimeSeries explainability use cases.
+
+        Args:
+            forecast (str): JMESPath expression to extract the forecast result.
+
+        Raises:
+            ValueError: when ``forecast`` is not a string or not provided
+        """
+        # check string forecast is provided
+        if not isinstance(forecast, str):
+            raise ValueError(
+                "Please provide a string JMESPath expression for ``forecast`` "
+                "to extract the forecast result."
+            )
+        # add fields to an internal config dictionary
+        self.time_series_model_config = dict()
+        _set(forecast, "forecast", self.time_series_model_config)
+
+    def get_time_series_model_config(self):
+        """Returns TimeSeries model config dictionary"""
+        return copy.deepcopy(self.time_series_model_config)
+
+
+class ModelConfig:
+    """Config object related to a model and its endpoint to be created."""
+
+    def __init__(
+        self,
+        model_name: Optional[str] = None,
+        instance_count: Optional[int] = None,
+        instance_type: Optional[str] = None,
+        accept_type: Optional[str] = None,
+        content_type: Optional[str] = None,
+        content_template: Optional[str] = None,
+        record_template: Optional[str] = None,
+        custom_attributes: Optional[str] = None,
+        accelerator_type: Optional[str] = None,
+        endpoint_name_prefix: Optional[str] = None,
+        target_model: Optional[str] = None,
+        endpoint_name: Optional[str] = None,
+        time_series_model_config: Optional[TimeSeriesModelConfig] = None,
+    ):
+        r"""Initializes a configuration of a model and the endpoint to be created for it.
+
+        Args:
+            model_name (str): Model name (as created by
+                `CreateModel <https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateModel.html>`_.
+                Cannot be set when ``endpoint_name`` is set.
+                Must be set with ``instance_count``, ``instance_type``
+            instance_count (int): The number of instances of a new endpoint for model inference.
+                Cannot be set when ``endpoint_name`` is set.
+                Must be set with ``model_name``, ``instance_type``
+            instance_type (str): The type of
+                `EC2 instance <https://aws.amazon.com/ec2/instance-types/>`_
+                to use for model inference; for example, ``"ml.c5.xlarge"``.
+                Cannot be set when ``endpoint_name`` is set.
+                Must be set with ``instance_count``, ``model_name``
+            accept_type (str): The model output format to be used for getting inferences with the
+                shadow endpoint. Valid values are ``"text/csv"`` for CSV,
+                ``"application/jsonlines"`` for JSON Lines, and ``"application/json"`` for JSON.
+                Default is the same as ``content_type``.
+            content_type (str): The model input format to be used for getting inferences with the
+                shadow endpoint. Valid values are ``"text/csv"`` for CSV,
+                ``"application/jsonlines"`` for JSON Lines, and ``"application/json"`` for JSON.
+                Default is the same as ``dataset_format``.
+            content_template (str): A template string to be used to construct the model input from
+                dataset instances. It is only used, and required, when ``model_content_type`` is
+                ``"application/jsonlines"`` or ``"application/json"``. When ``model_content_type``
+                is ``application/jsonlines``, the template should have one and only one
+                placeholder, ``$features``, which will be replaced by a features list for each
+                record to form the model inference input.  When ``model_content_type`` is
+                ``application/json``, the template can have either placeholder ``$record``, which
+                will be replaced by a single record templated by ``record_template`` and only a
+                single record at a time will be sent to the model, or placeholder ``$records``,
+                which will be replaced by a list of records, each templated by ``record_template``.
+            record_template (str): A template string to be used to construct each record of the
+                model input from dataset instances.  It is only used, and required, when
+                ``model_content_type`` is ``"application/json"``.
+                The template string may contain one of the following:
+
+                * Placeholder ``$features`` that will be substituted by the array of feature values
+                  and/or an optional placeholder ``$feature_names`` that will be substituted by the
+                  array of feature names.
+                * Exactly one placeholder ``$features_kvp`` that will be substituted by the
+                  key-value pairs of feature name and feature value.
+                * Or for each feature, if "A" is the feature name in the ``headers`` configuration,
+                  then placeholder syntax ``"${A}"`` (the double-quotes are part of the
+                  placeholder) will be substituted by the feature value.
+
+                ``record_template`` will be used in conjunction with ``content_template`` to
+                construct the model input.
+
+                **Examples:**
+
+                Given:
+
+                * ``headers``: ``["A", "B"]``
+                * ``features``: ``[[0, 1], [3, 4]]``
+
+                Example model input 1::
+
+                    {
+                        "instances": [[0, 1], [3, 4]],
+                        "feature_names": ["A", "B"]
+                    }
+
+                content_template and record_template to construct above:
+
+                * ``content_template``: ``"{\"instances\": $records}"``
+                * ``record_template``: ``"$features"``
+
+                Example model input 2::
+
+                    [
+                        { "A": 0, "B": 1 },
+                        { "A": 3, "B": 4 },
+                    ]
+
+                content_template and record_template to construct above:
+
+                * ``content_template``: ``"$records"``
+                * ``record_template``: ``"$features_kvp"``
+
+                Or, alternatively:
+
+                * ``content_template``: ``"$records"``
+                * ``record_template``: ``"{\"A\": \"${A}\", \"B\": \"${B}\"}"``
+
+                Example model input 3 (single record only)::
+
+                    { "A": 0, "B": 1 }
+
+                content_template and record_template to construct above:
+
+                * ``content_template``: ``"$record"``
+                * ``record_template``: ``"$features_kvp"``
+            custom_attributes (str): Provides additional information about a request for an
+                inference submitted to a model hosted at an Amazon SageMaker endpoint. The
+                information is an opaque value that is forwarded verbatim. You could use this
+                value, for example, to provide an ID that you can use to track a request or to
+                provide other metadata that a service endpoint was programmed to process. The value
+                must consist of no more than 1024 visible US-ASCII characters as specified in
+                Section 3.3.6.
+                `Field Value Components <https://tools.ietf.org/html/rfc7230#section-3.2.6>`_
+                of the Hypertext Transfer Protocol (HTTP/1.1).
+            accelerator_type (str): SageMaker
+                `Elastic Inference <https://docs.aws.amazon.com/sagemaker/latest/dg/ei.html>`_
+                accelerator type to deploy to the model endpoint instance
+                for making inferences to the model.
+            endpoint_name_prefix (str): The endpoint name prefix of a new endpoint. Must follow
+                pattern ``^[a-zA-Z0-9](-\*[a-zA-Z0-9]``.
+            target_model (str): Sets the target model name when using a multi-model endpoint. For
+                more information about multi-model endpoints, see
+                https://docs.aws.amazon.com/sagemaker/latest/dg/multi-model-endpoints.html
+            endpoint_name (str): Sets the endpoint_name when re-uses an existing endpoint.
+                Cannot be set when ``model_name``, ``instance_count``,
+                and ``instance_type`` set
+            time_series_model_config (TimeSeriesModelConfig): Optional. A config object for
+                TimeSeries predictor specific fields, required for TimeSeries
+                explainability use cases.
+
+        Raises:
+            ValueError: when the
+                - ``endpoint_name_prefix`` is invalid,
+                - ``accept_type`` is invalid,
+                - ``content_type`` is invalid,
+                - ``content_template`` has no placeholder "features"
+                - both [``endpoint_name``]
+                   AND [``model_name``, ``instance_count``, ``instance_type``] are set
+                - both [``endpoint_name``] AND [``endpoint_name_prefix``] are set
+        """
+
+        # validation
+        _model_endpoint_config_rule = (
+            all([model_name, instance_count, instance_type]),
+            all([endpoint_name]),
+        )
+        assert any(_model_endpoint_config_rule) and not all(_model_endpoint_config_rule)
+        if endpoint_name:
+            assert not endpoint_name_prefix
+
+        # main init logic
+        self.predictor_config = (
+            {
+                "model_name": model_name,
+                "instance_type": instance_type,
+                "initial_instance_count": instance_count,
+            }
+            if not endpoint_name
+            else {"endpoint_name": endpoint_name}
+        )
+        if endpoint_name_prefix:
+            if re.search("^[a-zA-Z0-9](-*[a-zA-Z0-9])", endpoint_name_prefix) is None:
+                raise ValueError(
+                    "Invalid endpoint_name_prefix."
+                    " Please follow pattern ^[a-zA-Z0-9](-*[a-zA-Z0-9])."
+                )
+            self.predictor_config["endpoint_name_prefix"] = endpoint_name_prefix
+        if accept_type is not None:
+            if accept_type not in ["text/csv", "application/jsonlines", "application/json"]:
+                raise ValueError(
+                    f"Invalid accept_type {accept_type}."
+                    f" Please choose text/csv or application/jsonlines."
+                )
+            if time_series_model_config and accept_type == "text/csv":
+                raise ValueError(
+                    "``accept_type`` must be JSON or JSONLines for time series explainability."
+                )
+            self.predictor_config["accept_type"] = accept_type
+        if content_type is not None:
+            if content_type not in [
+                "text/csv",
+                "application/jsonlines",
+                "application/json",
+                "image/jpeg",
+                "image/jpg",
+                "image/png",
+                "application/x-npy",
+            ]:
+                raise ValueError(
+                    f"Invalid content_type {content_type}."
+                    f" Please choose text/csv or application/jsonlines."
+                )
+            if content_type == "application/jsonlines":
+                if content_template is None:
+                    raise ValueError(
+                        f"content_template field is required for content_type {content_type}"
+                    )
+                if "$features" not in content_template:
+                    raise ValueError(
+                        f"Invalid content_template {content_template}."
+                        f" Please include a placeholder $features."
+                    )
+            if content_type == "application/json":
+                if content_template is None or record_template is None:
+                    raise ValueError(
+                        f"content_template and record_template are required for content_type "
+                        f"{content_type}"
+                    )
+                if "$record" not in content_template:
+                    raise ValueError(
+                        f"Invalid content_template {content_template}."
+                        f" Please include either placeholder $records or $record."
+                    )
+            if time_series_model_config and content_type not in [
+                "application/json",
+                "application/jsonlines",
+            ]:
+                raise ValueError(
+                    "``content_type`` must be JSON or JSONLines for time series explainability."
+                )
+            self.predictor_config["content_type"] = content_type
+        if content_template is not None:
+            self.predictor_config["content_template"] = content_template
+        if record_template is not None:
+            self.predictor_config["record_template"] = record_template
+        _set(custom_attributes, "custom_attributes", self.predictor_config)
+        _set(accelerator_type, "accelerator_type", self.predictor_config)
+        _set(target_model, "target_model", self.predictor_config)
+        if time_series_model_config:
+            _set(
+                time_series_model_config.get_time_series_model_config(),
+                "time_series_predictor_config",
+                self.predictor_config,
+            )
+
+    def get_predictor_config(self):
+        """Returns part of the predictor dictionary of the analysis config."""
+        return copy.deepcopy(self.predictor_config)
+
+
+class ModelPredictedLabelConfig:
+    """Config object to extract a predicted label from the model output."""
+
+    def __init__(
+        self,
+        label: Optional[Union[str, int]] = None,
+        probability: Optional[Union[str, int]] = None,
+        probability_threshold: Optional[float] = None,
+        label_headers: Optional[List[str]] = None,
+    ):
+        """Initializes a model output config to extract the predicted label or predicted score(s).
+
+        The following examples show different parameter configurations depending on the endpoint:
+
+        * **Regression task:**
+          The model returns the score, e.g. ``1.2``. We don't need to specify
+          anything. For json output, e.g. ``{'score': 1.2}``, we can set ``label='score'``.
+        * **Binary classification:**
+
+          * The model returns a single probability score. We want to classify as ``"yes"``
+            predictions with a probability score over ``0.2``.
+            We can set ``probability_threshold=0.2`` and ``label_headers="yes"``.
+          * The model returns ``{"probability": 0.3}``, for which we would like to apply a
+            threshold of ``0.5`` to obtain a predicted label in ``{0, 1}``.
+            In this case we can set ``label="probability"``.
+          * The model returns a tuple of the predicted label and the probability.
+            In this case we can set ``label = 0``.
+        * **Multiclass classification:**
+
+          * The model returns ``{'labels': ['cat', 'dog', 'fish'],
+            'probabilities': [0.35, 0.25, 0.4]}``. In this case we would set
+            ``probability='probabilities'``, ``label='labels'``,
+            and infer the predicted label to be ``'fish'``.
+          * The model returns ``{'predicted_label': 'fish', 'probabilities': [0.35, 0.25, 0.4]}``.
+            In this case we would set the ``label='predicted_label'``.
+          * The model returns ``[0.35, 0.25, 0.4]``. In this case, we can set
+            ``label_headers=['cat','dog','fish']`` and infer the predicted label to be ``'fish'``.
+
+        Args:
+            label (str or int): Index or JMESPath expression to locate the prediction
+                in the model output. In case, this is a predicted label of the same type
+                as the label in the dataset, no further arguments need to be specified.
+            probability (str or int): Index or JMESPath expression to locate the predicted score(s)
+                in the model output.
+            probability_threshold (float): An optional value for binary prediction tasks in which
+                the model returns a probability, to indicate the threshold to convert the
+                prediction to a boolean value. Default is ``0.5``.
+            label_headers (list[str]): List of headers, each for a predicted score in model output.
+                For bias analysis, it is used to extract the label value with the highest score as
+                predicted label. For explainability jobs, it is used to beautify the analysis report
+                by replacing placeholders like ``'label0'``.
+
+        Raises:
+            TypeError: when the ``probability_threshold`` cannot be cast to a float
+        """
+        self.label = label
+        self.probability = probability
+        self.probability_threshold = probability_threshold
+        self.label_headers = label_headers
+        if probability_threshold is not None:
+            try:
+                float(probability_threshold)
+            except ValueError:
+                raise TypeError(
+                    f"Invalid probability_threshold {probability_threshold}. "
+                    f"Please choose one that can be cast to float."
+                )
+        self.predictor_config = {}
+        _set(label, "label", self.predictor_config)
+        _set(probability, "probability", self.predictor_config)
+        _set(label_headers, "label_headers", self.predictor_config)
+
+    def get_predictor_config(self):
+        """Returns ``probability_threshold`` and predictor config dictionary."""
+        return self.probability_threshold, copy.deepcopy(self.predictor_config)
+
+
+class ExplainabilityConfig(ABC):
+    """Abstract config class to configure an explainability method."""
+
+    @abstractmethod
+    def get_explainability_config(self):
+        """Returns config."""
+        return None
+
+
+class PDPConfig(ExplainabilityConfig):
+    """Config class for Partial Dependence Plots (PDP).
+
+    `PDPs <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-partial-dependence-plots.html>`_
+    show the marginal effect (the dependence) a subset of features has on the predicted
+    outcome of an ML model.
+
+    When PDP is requested (by passing in a :class:`~sagemaker.clarify.PDPConfig` to the
+    ``explainability_config`` parameter of :class:`~sagemaker.clarify.SageMakerClarifyProcessor`),
+    the Partial Dependence Plots are included in the output
+    `report <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-feature-attribute-baselines-reports.html>`__
+    and the corresponding values are included in the analysis output.
+    """  # noqa E501
+
+    def __init__(
+        self, features: Optional[List] = None, grid_resolution: int = 15, top_k_features: int = 10
+    ):
+        """Initializes PDP config.
+
+        Args:
+            features (None or list): List of feature names or indices for which partial dependence
+                plots are computed and plotted. When :class:`~sagemaker.clarify.ShapConfig`
+                is provided, this parameter is optional, as Clarify will compute the
+                partial dependence plots for top features based on
+                `SHAP <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-shapley-values.html>`__
+                attributions. When :class:`~sagemaker.clarify.ShapConfig` is not provided,
+                ``features`` must be provided.
+            grid_resolution (int): When using numerical features, this integer represents the
+                number of buckets that the range of values must be divided into. This decides the
+                granularity of the grid in which the PDP are plotted.
+            top_k_features (int): Sets the number of top SHAP attributes used to compute
+                partial dependence plots.
+        """  # noqa E501
+        self.pdp_config = {
+            "grid_resolution": grid_resolution,
+            "top_k_features": top_k_features,
+        }
+        if features is not None:
+            self.pdp_config["features"] = features
+
+    def get_explainability_config(self):
+        """Returns PDP config dictionary."""
+        return copy.deepcopy({"pdp": self.pdp_config})
+
+
+class TextConfig:
+    """Config object to handle text features for text explainability
+
+    `SHAP analysis <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-model-explainability.html>`__
+    breaks down longer text into chunks (e.g. tokens, sentences, or paragraphs)
+    and replaces them with the strings specified in the baseline for that feature.
+    The `shap value <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-shapley-values.html>`_
+    of a chunk then captures how much replacing it affects the prediction.
+    """  # noqa E501  # pylint: disable=c0301
+
+    _SUPPORTED_GRANULARITIES = ["token", "sentence", "paragraph"]
+    _SUPPORTED_LANGUAGES = [
+        "chinese",
+        "zh",
+        "danish",
+        "da",
+        "dutch",
+        "nl",
+        "english",
+        "en",
+        "french",
+        "fr",
+        "german",
+        "de",
+        "greek",
+        "el",
+        "italian",
+        "it",
+        "japanese",
+        "ja",
+        "lithuanian",
+        "lt",
+        "multi-language",
+        "xx",
+        "norwegian bokmål",
+        "nb",
+        "polish",
+        "pl",
+        "portuguese",
+        "pt",
+        "romanian",
+        "ro",
+        "russian",
+        "ru",
+        "spanish",
+        "es",
+        "afrikaans",
+        "af",
+        "albanian",
+        "sq",
+        "arabic",
+        "ar",
+        "armenian",
+        "hy",
+        "basque",
+        "eu",
+        "bengali",
+        "bn",
+        "bulgarian",
+        "bg",
+        "catalan",
+        "ca",
+        "croatian",
+        "hr",
+        "czech",
+        "cs",
+        "estonian",
+        "et",
+        "finnish",
+        "fi",
+        "gujarati",
+        "gu",
+        "hebrew",
+        "he",
+        "hindi",
+        "hi",
+        "hungarian",
+        "hu",
+        "icelandic",
+        "is",
+        "indonesian",
+        "id",
+        "irish",
+        "ga",
+        "kannada",
+        "kn",
+        "kyrgyz",
+        "ky",
+        "latvian",
+        "lv",
+        "ligurian",
+        "lij",
+        "luxembourgish",
+        "lb",
+        "macedonian",
+        "mk",
+        "malayalam",
+        "ml",
+        "marathi",
+        "mr",
+        "nepali",
+        "ne",
+        "persian",
+        "fa",
+        "sanskrit",
+        "sa",
+        "serbian",
+        "sr",
+        "setswana",
+        "tn",
+        "sinhala",
+        "si",
+        "slovak",
+        "sk",
+        "slovenian",
+        "sl",
+        "swedish",
+        "sv",
+        "tagalog",
+        "tl",
+        "tamil",
+        "ta",
+        "tatar",
+        "tt",
+        "telugu",
+        "te",
+        "thai",
+        "th",
+        "turkish",
+        "tr",
+        "ukrainian",
+        "uk",
+        "urdu",
+        "ur",
+        "vietnamese",
+        "vi",
+        "yoruba",
+        "yo",
+    ]
+
+    def __init__(
+        self,
+        granularity: str,
+        language: str,
+    ):
+        """Initializes a text configuration.
+
+        Args:
+            granularity (str): Determines the granularity in which text features are broken down
+                to. Accepted values are ``"token"``, ``"sentence"``, or ``"paragraph"``.
+                Computes `shap values <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-shapley-values.html>`_
+                for these units.
+            language (str): Specifies the language of the text features. Accepted values are
+                one of the following:
+                ``"chinese"``, ``"danish"``, ``"dutch"``, ``"english"``, ``"french"``, ``"german"``,
+                ``"greek"``, ``"italian"``, ``"japanese"``, ``"lithuanian"``, ``"multi-language"``,
+                ``"norwegian bokmål"``, ``"polish"``, ``"portuguese"``, ``"romanian"``,
+                ``"russian"``, ``"spanish"``, ``"afrikaans"``, ``"albanian"``, ``"arabic"``,
+                ``"armenian"``, ``"basque"``, ``"bengali"``, ``"bulgarian"``, ``"catalan"``,
+                ``"croatian"``, ``"czech"``, ``"estonian"``, ``"finnish"``, ``"gujarati"``,
+                ``"hebrew"``, ``"hindi"``, ``"hungarian"``, ``"icelandic"``, ``"indonesian"``,
+                ``"irish"``, ``"kannada"``, ``"kyrgyz"``, ``"latvian"``, ``"ligurian"``,
+                ``"luxembourgish"``, ``"macedonian"``, ``"malayalam"``, ``"marathi"``, ``"nepali"``,
+                ``"persian"``, ``"sanskrit"``, ``"serbian"``, ``"setswana"``, ``"sinhala"``,
+                ``"slovak"``, ``"slovenian"``, ``"swedish"``, ``"tagalog"``, ``"tamil"``,
+                ``"tatar"``, ``"telugu"``, ``"thai"``, ``"turkish"``, ``"ukrainian"``, ``"urdu"``,
+                ``"vietnamese"``, ``"yoruba"``. Use "multi-language" for a mix of multiple
+                languages. The corresponding two-letter ISO codes are also accepted.
+
+        Raises:
+            ValueError: when ``granularity`` is not in list of supported values
+                or ``language`` is not in list of supported values
+        """  # noqa E501  # pylint: disable=c0301
+        if granularity not in TextConfig._SUPPORTED_GRANULARITIES:
+            raise ValueError(
+                f"Invalid granularity {granularity}. Please choose among "
+                f"{TextConfig._SUPPORTED_GRANULARITIES}"
+            )
+        if language not in TextConfig._SUPPORTED_LANGUAGES:
+            raise ValueError(
+                f"Invalid language {language}. Please choose among "
+                f"{TextConfig._SUPPORTED_LANGUAGES}"
+            )
+        self.text_config = {
+            "granularity": granularity,
+            "language": language,
+        }
+
+    def get_text_config(self):
+        """Returns a text config dictionary, part of the analysis config dictionary."""
+        return copy.deepcopy(self.text_config)
+
+
+class ImageConfig:
+    """Config object for handling images"""
+
+    def __init__(
+        self,
+        model_type: str,
+        num_segments: Optional[int] = None,
+        feature_extraction_method: Optional[str] = None,
+        segment_compactness: Optional[float] = None,
+        max_objects: Optional[int] = None,
+        iou_threshold: Optional[float] = None,
+        context: Optional[float] = None,
+    ):
+        """Initializes a config object for Computer Vision (CV) Image explainability.
+
+        `SHAP for CV explainability <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-model-explainability-computer-vision.html>`__.
+        generating heat maps that visualize feature attributions for input images.
+        These heat maps highlight the image's features according
+        to how much they contribute to the CV model prediction.
+
+        ``"IMAGE_CLASSIFICATION"`` and ``"OBJECT_DETECTION"`` are the two supported CV use cases.
+
+        Args:
+            model_type (str): Specifies the type of CV model and use case. Accepted options:
+                ``"IMAGE_CLASSIFICATION"`` or ``"OBJECT_DETECTION"``.
+            num_segments (None or int): Approximate number of segments to generate when running
+                SKLearn's `SLIC method <https://scikit-image.org/docs/dev/api/skimage.segmentation.html?highlight=slic#skimage.segmentation.slic>`_
+                for image segmentation to generate features/superpixels.
+                The default is None. When set to None, runs SLIC with 20 segments.
+            feature_extraction_method (None or str): method used for extracting features from the
+                image (ex: "segmentation"). Default is ``"segmentation"``.
+            segment_compactness (None or float): Balances color proximity and space proximity.
+                Higher values give more weight to space proximity, making superpixel
+                shapes more square/cubic. We recommend exploring possible values on a log
+                scale, e.g., 0.01, 0.1, 1, 10, 100, before refining around a chosen value.
+                The default is None. When set to None, runs with the default value of ``5``.
+            max_objects (None or int): Maximum number of objects displayed when running SHAP
+                with an ``"OBJECT_DETECTION"`` model. The Object detection algorithm may detect
+                more than the ``max_objects`` number of objects in a single image.
+                In that case, the algorithm displays the top ``max_objects`` number of objects
+                according to confidence score. Default value is None. In the ``"OBJECT_DETECTION"``
+                case, passing in None leads to a default value of ``3``.
+            iou_threshold (None or float): Minimum intersection over union for the object
+                bounding box to consider its confidence score for computing SHAP values,
+                in the range ``[0.0, 1.0]``. Used only for the ``"OBJECT_DETECTION"`` case,
+                where passing in None sets the default value of ``0.5``.
+            context (None or float): The portion of the image outside the bounding box used
+                in SHAP analysis, in the range ``[0.0, 1.0]``. If set to ``1.0``, the whole image
+                is considered; if set to ``0.0`` only the image inside bounding box is considered.
+                Only used for the ``"OBJECT_DETECTION"`` case,
+                when passing in None sets the default value of ``1.0``.
+
+        """  # noqa E501  # pylint: disable=c0301
+        self.image_config = {}
+
+        if model_type not in ["OBJECT_DETECTION", "IMAGE_CLASSIFICATION"]:
+            raise ValueError(
+                "Clarify SHAP only supports object detection and image classification methods. "
+                "Please set model_type to OBJECT_DETECTION or IMAGE_CLASSIFICATION."
+            )
+        self.image_config["model_type"] = model_type
+        _set(num_segments, "num_segments", self.image_config)
+        _set(feature_extraction_method, "feature_extraction_method", self.image_config)
+        _set(segment_compactness, "segment_compactness", self.image_config)
+        _set(max_objects, "max_objects", self.image_config)
+        _set(iou_threshold, "iou_threshold", self.image_config)
+        _set(context, "context", self.image_config)
+
+    def get_image_config(self):
+        """Returns the image config part of an analysis config dictionary."""
+        return copy.deepcopy(self.image_config)
+
+
+class SHAPConfig(ExplainabilityConfig):
+    """Config class for `SHAP <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-model-explainability.html>`__.
+
+    The SHAP algorithm calculates feature attributions by computing
+    the contribution of each feature to the prediction outcome, using the concept of
+    `Shapley values <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-shapley-values.html>`_.
+
+    These attributions can be provided for specific predictions (locally)
+    and at a global level for the model as a whole.
+    """  # noqa E501  # pylint: disable=c0301
+
+    def __init__(
+        self,
+        baseline: Optional[Union[str, List, Dict]] = None,
+        num_samples: Optional[int] = None,
+        agg_method: Optional[str] = None,
+        use_logit: bool = False,
+        save_local_shap_values: bool = True,
+        seed: Optional[int] = None,
+        num_clusters: Optional[int] = None,
+        text_config: Optional[TextConfig] = None,
+        image_config: Optional[ImageConfig] = None,
+        features_to_explain: Optional[List[Union[str, int]]] = None,
+    ):
+        """Initializes config for SHAP analysis.
+
+        Args:
+            baseline (None or str or list or dict): `Baseline dataset <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-feature-attribute-shap-baselines.html>`_
+                for the Kernel SHAP algorithm, accepted in the form of:
+                S3 object URI, a list of rows (with at least one element),
+                or None (for no input baseline). The baseline dataset must have the same format
+                as the input dataset specified in :class:`~sagemaker.clarify.DataConfig`.
+                Each row must have only the feature columns/values and omit the label column/values.
+                If None, a baseline will be calculated automatically on the input dataset
+                using K-means (for numerical data) or K-prototypes (if there is categorical data).
+            num_samples (None or int): Number of samples to be used in the Kernel SHAP algorithm.
+                This number determines the size of the generated synthetic dataset to compute the
+                SHAP values. If not provided then Clarify job will choose a proper value according
+                to the count of features.
+            agg_method (None or str): Aggregation method for global SHAP values. Valid values are
+                ``"mean_abs"`` (mean of absolute SHAP values for all instances),
+                ``"median"`` (median of SHAP values for all instances) and
+                ``"mean_sq"`` (mean of squared SHAP values for all instances).
+                If None is provided, then Clarify job uses the method ``"mean_abs"``.
+            use_logit (bool): Indicates whether to apply the logit function to model predictions.
+                Default is False. If ``use_logit`` is true then the SHAP values will
+                have log-odds units.
+            save_local_shap_values (bool): Indicates whether to save the local SHAP values
+                in the output location. Default is True.
+            seed (int): Seed value to get deterministic SHAP values. Default is None.
+            num_clusters (None or int): If a ``baseline`` is not provided, Clarify automatically
+                computes a baseline dataset via a clustering algorithm (K-means/K-prototypes), which
+                takes ``num_clusters`` as a parameter. ``num_clusters`` will be the resulting size
+                of the baseline dataset. If not provided, Clarify job uses a default value.
+            text_config (:class:`~sagemaker.clarify.TextConfig`): Config object for handling
+                text features. Default is None.
+            image_config (:class:`~sagemaker.clarify.ImageConfig`): Config for handling image
+                features. Default is None.
+            features_to_explain: A list of names or indices of dataset features to compute SHAP
+                values for. If not provided, SHAP values are computed for all features by default.
+                Currently only supported for tabular datasets.
+
+        Raises:
+            ValueError: when ``agg_method`` is invalid, ``baseline`` and ``num_clusters`` are provided
+                together, or ``features_to_explain`` is specified when ``text_config`` or
+                ``image_config`` is provided
+        """  # noqa E501  # pylint: disable=c0301
+        if agg_method is not None and agg_method not in [
+            "mean_abs",
+            "median",
+            "mean_sq",
+        ]:
+            raise ValueError(
+                f"Invalid agg_method {agg_method}." f" Please choose mean_abs, median, or mean_sq."
+            )
+        if num_clusters is not None and baseline is not None:
+            raise ValueError(
+                "Baseline and num_clusters cannot be provided together. "
+                "Please specify one of the two."
+            )
+        self.shap_config = {
+            "use_logit": use_logit,
+            "save_local_shap_values": save_local_shap_values,
+        }
+        _set(baseline, "baseline", self.shap_config)
+        _set(num_samples, "num_samples", self.shap_config)
+        _set(agg_method, "agg_method", self.shap_config)
+        _set(seed, "seed", self.shap_config)
+        _set(num_clusters, "num_clusters", self.shap_config)
+        if text_config:
+            _set(text_config.get_text_config(), "text_config", self.shap_config)
+            if not save_local_shap_values:
+                logger.warning(
+                    "Global aggregation is not yet supported for text features. "
+                    "Consider setting save_local_shap_values=True to inspect local text "
+                    "explanations."
+                )
+        if image_config:
+            _set(image_config.get_image_config(), "image_config", self.shap_config)
+        if features_to_explain is not None and (
+            text_config is not None or image_config is not None
+        ):
+            raise ValueError(
+                "`features_to_explain` is not supported for datasets containing text features or images."
+            )
+        _set(features_to_explain, "features_to_explain", self.shap_config)
+
+    def get_explainability_config(self):
+        """Returns a shap config dictionary."""
+        return copy.deepcopy({"shap": self.shap_config})
+
+
+class AsymmetricShapleyValueConfig(ExplainabilityConfig):
+    """Config class for Asymmetric Shapley value algorithm for time series explainability.
+
+    Asymmetric Shapley Values are a variant of the Shapley Value that drop the symmetry axiom [1].
+    We use these to determine how features contribute to the forecasting outcome. Asymmetric
+    Shapley values can take into account the temporal dependencies of the time series that
+    forecasting models take as input.
+
+    [1] Frye, Christopher, Colin Rowat, and Ilya Feige. "Asymmetric shapley values: incorporating
+    causal knowledge into model-agnostic explainability." NeurIPS (2020).
+    https://doi.org/10.48550/arXiv.1910.06358
+    """
+
+    def __init__(
+        self,
+        direction: Literal[
+            "chronological",
+            "anti_chronological",
+            "bidirectional",
+        ] = ASYM_SHAP_VAL_DEFAULT_EXPLANATION_DIRECTION,
+        granularity: Literal[
+            "timewise",
+            "fine_grained",
+        ] = ASYM_SHAP_VAL_DEFAULT_EXPLANATION_GRANULARITY,
+        num_samples: Optional[int] = None,
+        baseline: Optional[Union[str, Dict[str, Any]]] = None,
+    ):
+        """Initialises config for time series explainability with Asymmetric Shapley Values.
+
+        AsymmetricShapleyValueConfig is used specifically and only for TimeSeries explainability
+        purposes.
+
+        Args:
+            direction (str): Type of explanation to be used. Available explanation
+                types are ``"chronological"``, ``"anti_chronological"``, and ``"bidirectional"``.
+            granularity (str): Explanation granularity to be used. Available granularity options
+                are ``"timewise"`` and ``"fine_grained"``.
+            num_samples (None or int): Number of samples to be used in the Asymmetric Shapley
+                Value forecasting algorithm. Only applicable when using ``"fine_grained"``
+                explanations.
+            baseline (str or dict): Link to a baseline configuration or a dictionary for it. The
+                baseline config is used to replace out-of-coalition values for the corresponding
+                datasets (also known as background data). For temporal data (target time series,
+                related time series), the baseline value types are "zero", where all
+                out-of-coalition values will be replaced with 0.0, or "mean", all out-of-coalition
+                values will be replaced with the average of a time series. For static data
+                (static covariates), a baseline value for each covariate should be provided for
+                each possible item_id. An example config follows, where ``item1`` and ``item2``
+                are item ids::
+
+                    {
+                        "target_time_series": "zero",
+                        "related_time_series": "zero",
+                        "static_covariates": {
+                            "item1": [1, 1],
+                            "item2": [0, 1]
+                        }
+                    }
+
+        Raises:
+            ValueError: when ``direction`` or ``granularity`` are not valid, ``num_samples`` is not
+                provided for fine-grained explanations, ``num_samples`` is provided for non
+                fine-grained explanations, or when ``direction`` is not ``"chronological"`` while
+                ``granularity`` is ``"fine_grained"``.
+        """
+        self.asymmetric_shapley_value_config = dict()
+        # validate explanation direction
+        if direction not in ASYM_SHAP_VAL_EXPLANATION_DIRECTIONS:
+            raise ValueError(
+                "Please provide a valid explanation direction from: "
+                + ", ".join(ASYM_SHAP_VAL_EXPLANATION_DIRECTIONS)
+            )
+        # validate granularity
+        if granularity not in ASYM_SHAP_VAL_GRANULARITIES:
+            raise ValueError(
+                "Please provide a valid granularity from: " + ", ".join(ASYM_SHAP_VAL_GRANULARITIES)
+            )
+        if granularity == "fine_grained":
+            if not isinstance(num_samples, int):
+                raise ValueError("Please provide an integer for ``num_samples``.")
+            if direction != "chronological":
+                raise ValueError(
+                    f"{direction} and {granularity} granularity are not supported together."
+                )
+        elif num_samples:  # validate num_samples is not provided when unnecessary
+            raise ValueError("``num_samples`` is only used for fine-grained explanations.")
+        # validate baseline if provided as a dictionary
+        if isinstance(baseline, dict):
+            temporal_baselines = ["zero", "mean"]  # possible baseline options for temporal fields
+            if "target_time_series" in baseline:
+                target_baseline = baseline.get("target_time_series")
+                if target_baseline not in temporal_baselines:
+                    raise ValueError(
+                        f"Provided value {target_baseline} for ``target_time_series`` is "
+                        f"invalid. Please select one of {temporal_baselines}."
+                    )
+            if "related_time_series" in baseline:
+                related_baseline = baseline.get("related_time_series")
+                if related_baseline not in temporal_baselines:
+                    raise ValueError(
+                        f"Provided value {related_baseline} for ``related_time_series`` is "
+                        f"invalid. Please select one of {temporal_baselines}."
+                    )
+        # set explanation type and (if provided) num_samples in internal config dictionary
+        _set(direction, "direction", self.asymmetric_shapley_value_config)
+        _set(granularity, "granularity", self.asymmetric_shapley_value_config)
+        _set(
+            num_samples, "num_samples", self.asymmetric_shapley_value_config
+        )  # _set() does nothing if a given argument is None
+        _set(baseline, "baseline", self.asymmetric_shapley_value_config)
+
+    def get_explainability_config(self):
+        """Returns an asymmetric shap config dictionary."""
+        return copy.deepcopy({"asymmetric_shapley_value": self.asymmetric_shapley_value_config})
+
+
+class SageMakerClarifyProcessor(Processor):
+    """Handles SageMaker Processing tasks to compute bias metrics and model explanations."""
+
+    _CLARIFY_DATA_INPUT = "/opt/ml/processing/input/data"
+    _CLARIFY_CONFIG_INPUT = "/opt/ml/processing/input/config"
+    _CLARIFY_OUTPUT = "/opt/ml/processing/output"
+
+    def __init__(
+        self,
+        role: Optional[str] = None,
+        instance_count: int = None,
+        instance_type: str = None,
+        volume_size_in_gb: int = 30,
+        volume_kms_key: Optional[str] = None,
+        output_kms_key: Optional[str] = None,
+        max_runtime_in_seconds: Optional[int] = None,
+        sagemaker_session: Optional[Session] = None,
+        env: Optional[Dict[str, str]] = None,
+        tags: Optional[Tags] = None,
+        network_config: Optional[NetworkConfig] = None,
+        job_name_prefix: Optional[str] = None,
+        version: Optional[str] = None,
+        skip_early_validation: bool = False,
+    ):
+        """Initializes a SageMakerClarifyProcessor to compute bias metrics and model explanations.
+
+        Instance of :class:`~sagemaker.processing.Processor`.
+
+        Args:
+            role (str): An AWS IAM role name or ARN. Amazon SageMaker Processing
+                uses this role to access AWS resources, such as
+                data stored in Amazon S3.
+            instance_count (int): The number of instances to run
+                a processing job with.
+            instance_type (str): The type of
+                `EC2 instance <https://aws.amazon.com/ec2/instance-types/>`_
+                to use for model inference; for example, ``"ml.c5.xlarge"``.
+            volume_size_in_gb (int): Size in GB of the
+                `EBS volume <https://docs.aws.amazon.com/sagemaker/latest/dg/host-instance-storage.html>`_.
+                to use for storing data during processing (default: 30 GB).
+            volume_kms_key (str): A
+                `KMS key <https://docs.aws.amazon.com/sagemaker/latest/dg/key-management.html>`_
+                for the processing volume (default: None).
+            output_kms_key (str): The KMS key ID for processing job outputs (default: None).
+            max_runtime_in_seconds (int): Timeout in seconds (default: None).
+                After this amount of time, Amazon SageMaker terminates the job,
+                regardless of its current status. If ``max_runtime_in_seconds`` is not
+                specified, the default value is ``86400`` seconds (24 hours).
+            sagemaker_session (:class:`~sagemaker.session.Session`):
+                :class:`~sagemaker.session.Session` object which manages interactions
+                with Amazon SageMaker and any other AWS services needed. If not specified,
+                the Processor creates a :class:`~sagemaker.session.Session`
+                using the default AWS configuration chain.
+            env (dict[str, str]): Environment variables to be passed to
+                the processing jobs (default: None).
+            tags (Optional[Tags]): Tags to be passed to the processing job
+                (default: None). For more, see
+                https://docs.aws.amazon.com/sagemaker/latest/dg/API_Tag.html.
+            network_config (:class:`~sagemaker.network.NetworkConfig`):
+                A :class:`~sagemaker.network.NetworkConfig`
+                object that configures network isolation, encryption of
+                inter-container traffic, security group IDs, and subnets.
+            job_name_prefix (str): Processing job name prefix.
+            version (str): Clarify version to use.
+            skip_early_validation (bool): To skip schema validation of the generated analysis_schema.json.
+        """  # noqa E501  # pylint: disable=c0301
+        container_uri = image_uris.retrieve("clarify", sagemaker_session.boto_region_name, version)
+        self._last_analysis_config = None
+        self.job_name_prefix = job_name_prefix
+        self.skip_early_validation = skip_early_validation
+        super(SageMakerClarifyProcessor, self).__init__(
+            role,
+            container_uri,
+            instance_count,
+            instance_type,
+            None,  # We manage the entrypoint.
+            volume_size_in_gb,
+            volume_kms_key,
+            output_kms_key,
+            max_runtime_in_seconds,
+            None,  # We set method-specific job names below.
+            sagemaker_session,
+            env,
+            format_tags(tags),
+            network_config,
+        )
+
+    def run(self, **_):
+        """Overriding the base class method but deferring to specific run_* methods."""
+        raise NotImplementedError(
+            "Please choose a method of run_pre_training_bias, run_post_training_bias or "
+            "run_explainability."
+        )
+
+    def _run(
+        self,
+        data_config: DataConfig,
+        analysis_config: Dict[str, Any],
+        wait: bool,
+        logs: bool,
+        job_name: str,
+        kms_key: str,
+        experiment_config: Dict[str, str],
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` with the SageMaker Clarify container
+
+        and analysis config.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            analysis_config (dict): Config following the analysis_config.json format.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """
+        # for debugging: to access locally, i.e. without a need to look for it in an S3 bucket
+        self._last_analysis_config = analysis_config
+        logger.info("Analysis Config: %s", analysis_config)
+        if not self.skip_early_validation:
+            ANALYSIS_CONFIG_SCHEMA_V1_0.validate(analysis_config)
+
+        with tempfile.TemporaryDirectory() as tmpdirname:
+            analysis_config_file = os.path.join(tmpdirname, "analysis_config.json")
+            with open(analysis_config_file, "w") as f:
+                json.dump(analysis_config, f)
+            s3_analysis_config_file = _upload_analysis_config(
+                analysis_config_file,
+                data_config.s3_analysis_config_output_path or data_config.s3_output_path,
+                self.sagemaker_session,
+                kms_key,
+            )
+            from sagemaker.core.shapes import ProcessingS3Input, ProcessingS3Output
+
+            config_input = ProcessingInput(
+                input_name="analysis_config",
+                s3_input=ProcessingS3Input(
+                    s3_uri=s3_analysis_config_file,
+                    local_path=self._CLARIFY_CONFIG_INPUT,
+                    s3_data_type="S3Prefix",
+                    s3_input_mode="File",
+                    s3_compression_type="None",
+                ),
+            )
+            data_input = ProcessingInput(
+                input_name="dataset",
+                s3_input=ProcessingS3Input(
+                    s3_uri=data_config.s3_data_input_path,
+                    local_path=self._CLARIFY_DATA_INPUT,
+                    s3_data_type="S3Prefix",
+                    s3_input_mode="File",
+                    s3_data_distribution_type=data_config.s3_data_distribution_type,
+                    s3_compression_type=data_config.s3_compression_type,
+                ),
+            )
+            result_output = ProcessingOutput(
+                output_name="analysis_result",
+                s3_output=ProcessingS3Output(
+                    s3_uri=data_config.s3_output_path,
+                    local_path=self._CLARIFY_OUTPUT,
+                    s3_upload_mode=ProcessingOutputHandler.get_s3_upload_mode(analysis_config),
+                ),
+            )
+
+            return super().run(
+                inputs=[data_input, config_input],
+                outputs=[result_output],
+                wait=wait,
+                logs=logs,
+                job_name=job_name,
+                kms_key=kms_key,
+                experiment_config=experiment_config,
+            )
+
+    def run_pre_training_bias(
+        self,
+        data_config: DataConfig,
+        data_bias_config: BiasConfig,
+        methods: Union[str, List[str]] = "all",
+        wait: bool = True,
+        logs: bool = True,
+        job_name: Optional[str] = None,
+        kms_key: Optional[str] = None,
+        experiment_config: Optional[Dict[str, str]] = None,
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` to compute pre-training bias methods
+
+        Computes the requested ``methods`` on the input data. The ``methods`` compare
+        metrics (e.g. fraction of examples) for the sensitive group(s) vs. the other examples.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            data_bias_config (:class:`~sagemaker.clarify.BiasConfig`): Config of sensitive groups.
+            methods (str or list[str]): Selects a subset of potential metrics:
+                ["`CI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-bias-metric-class-imbalance.html>`_",
+                "`DPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-true-label-imbalance.html>`_",
+                "`KL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kl-divergence.html>`_",
+                "`JS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-jensen-shannon-divergence.html>`_",
+                "`LP <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-lp-norm.html>`_",
+                "`TVD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-total-variation-distance.html>`_",
+                "`KS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kolmogorov-smirnov.html>`_",
+                "`CDDL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-cddl.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name. When ``job_name`` is not specified,
+                if ``job_name_prefix`` in :class:`~sagemaker.clarify.SageMakerClarifyProcessor` is
+                specified, the job name will be the ``job_name_prefix`` and current timestamp;
+                otherwise use ``"Clarify-Pretraining-Bias"`` as prefix.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """  # noqa E501  # pylint: disable=c0301
+        analysis_config = _AnalysisConfigGenerator.bias_pre_training(
+            data_config, data_bias_config, methods
+        )
+        # when name is either not provided (is None) or an empty string ("")
+        job_name = job_name or name_from_base(self.job_name_prefix or "Clarify-Pretraining-Bias")
+        return self._run(
+            data_config,
+            analysis_config,
+            wait,
+            logs,
+            job_name,
+            kms_key,
+            experiment_config,
+        )
+
+    def run_post_training_bias(
+        self,
+        data_config: DataConfig,
+        data_bias_config: BiasConfig,
+        model_config: Optional[ModelConfig] = None,
+        model_predicted_label_config: Optional[ModelPredictedLabelConfig] = None,
+        methods: Union[str, List[str]] = "all",
+        wait: bool = True,
+        logs: bool = True,
+        job_name: Optional[str] = None,
+        kms_key: Optional[str] = None,
+        experiment_config: Optional[Dict[str, str]] = None,
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` to compute posttraining bias
+
+        Spins up a model endpoint and runs inference over the input dataset in
+        the ``s3_data_input_path`` (from the :class:`~sagemaker.clarify.DataConfig`) to obtain
+        predicted labels. Using model predictions, computes the requested posttraining bias
+        ``methods`` that compare metrics (e.g. accuracy, precision, recall) for the
+        sensitive group(s) versus the other examples.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            data_bias_config (:class:`~sagemaker.clarify.BiasConfig`): Config of sensitive groups.
+            model_config (:class:`~sagemaker.clarify.ModelConfig`): Config of the model and its
+                endpoint to be created. This is required unless``predicted_label_dataset_uri`` or
+                ``predicted_label`` is provided in ``data_config``.
+            model_predicted_label_config (:class:`~sagemaker.clarify.ModelPredictedLabelConfig`):
+                Config of how to extract the predicted label from the model output.
+            methods (str or list[str]): Selector of a subset of potential metrics:
+                ["`DPPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dppl.html>`_"
+                , "`DI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-di.html>`_",
+                "`DCA <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dca.html>`_",
+                "`DCR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dcr.html>`_",
+                "`RD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-rd.html>`_",
+                "`DAR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dar.html>`_",
+                "`DRR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-drr.html>`_",
+                "`AD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ad.html>`_",
+                "`CDDPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-cddpl.html>`_
+                ", "`TE <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-te.html>`_",
+                "`FT <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ft.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name. When ``job_name`` is not specified,
+                if ``job_name_prefix`` in :class:`~sagemaker.clarify.SageMakerClarifyProcessor`
+                is specified, the job name will be the ``job_name_prefix`` and current timestamp;
+                otherwise use ``"Clarify-Posttraining-Bias"`` as prefix.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """  # noqa E501  # pylint: disable=c0301
+        analysis_config = _AnalysisConfigGenerator.bias_post_training(
+            data_config,
+            data_bias_config,
+            model_predicted_label_config,
+            methods,
+            model_config,
+        )
+        # when name is either not provided (is None) or an empty string ("")
+        job_name = job_name or name_from_base(self.job_name_prefix or "Clarify-Posttraining-Bias")
+        return self._run(
+            data_config,
+            analysis_config,
+            wait,
+            logs,
+            job_name,
+            kms_key,
+            experiment_config,
+        )
+
+    def run_bias(
+        self,
+        data_config: DataConfig,
+        bias_config: BiasConfig,
+        model_config: Optional[ModelConfig] = None,
+        model_predicted_label_config: Optional[ModelPredictedLabelConfig] = None,
+        pre_training_methods: Union[str, List[str]] = "all",
+        post_training_methods: Union[str, List[str]] = "all",
+        wait: bool = True,
+        logs: bool = True,
+        job_name: Optional[str] = None,
+        kms_key: Optional[str] = None,
+        experiment_config: Optional[Dict[str, str]] = None,
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` to compute the requested bias methods
+
+        Computes metrics for both the pre-training and the post-training methods.
+        To calculate post-training methods, it spins up a model endpoint and runs inference over the
+        input examples in 's3_data_input_path' (from the :class:`~sagemaker.clarify.DataConfig`)
+        to obtain predicted labels.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            bias_config (:class:`~sagemaker.clarify.BiasConfig`): Config of sensitive groups.
+            model_config (:class:`~sagemaker.clarify.ModelConfig`): Config of the model and its
+                endpoint to be created. This is required unless``predicted_label_dataset_uri`` or
+                ``predicted_label`` is provided in ``data_config``.
+            model_predicted_label_config (:class:`~sagemaker.clarify.ModelPredictedLabelConfig`):
+                Config of how to extract the predicted label from the model output.
+            pre_training_methods (str or list[str]): Selector of a subset of potential metrics:
+                ["`CI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-bias-metric-class-imbalance.html>`_",
+                "`DPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-true-label-imbalance.html>`_",
+                "`KL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kl-divergence.html>`_",
+                "`JS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-jensen-shannon-divergence.html>`_",
+                "`LP <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-lp-norm.html>`_",
+                "`TVD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-total-variation-distance.html>`_",
+                "`KS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kolmogorov-smirnov.html>`_",
+                "`CDDL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-cddl.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            post_training_methods (str or list[str]): Selector of a subset of potential metrics:
+                ["`DPPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dppl.html>`_"
+                , "`DI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-di.html>`_",
+                "`DCA <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dca.html>`_",
+                "`DCR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dcr.html>`_",
+                "`RD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-rd.html>`_",
+                "`DAR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dar.html>`_",
+                "`DRR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-drr.html>`_",
+                "`AD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ad.html>`_",
+                "`CDDPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-cddpl.html>`_
+                ", "`TE <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-te.html>`_",
+                "`FT <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ft.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name. When ``job_name`` is not specified,
+                if ``job_name_prefix`` in :class:`~sagemaker.clarify.SageMakerClarifyProcessor` is
+                specified, the job name will be ``job_name_prefix`` and the current timestamp;
+                otherwise use ``"Clarify-Bias"`` as prefix.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """  # noqa E501  # pylint: disable=c0301
+        analysis_config = _AnalysisConfigGenerator.bias(
+            data_config,
+            bias_config,
+            model_config,
+            model_predicted_label_config,
+            pre_training_methods,
+            post_training_methods,
+        )
+        # when name is either not provided (is None) or an empty string ("")
+        job_name = job_name or name_from_base(self.job_name_prefix or "Clarify-Bias")
+        return self._run(
+            data_config,
+            analysis_config,
+            wait,
+            logs,
+            job_name,
+            kms_key,
+            experiment_config,
+        )
+
+    def run_explainability(
+        self,
+        data_config: DataConfig,
+        model_config: ModelConfig,
+        explainability_config: Union[ExplainabilityConfig, List],
+        model_scores: Optional[Union[int, str, ModelPredictedLabelConfig]] = None,
+        wait: bool = True,
+        logs: bool = True,
+        job_name: Optional[str] = None,
+        kms_key: Optional[str] = None,
+        experiment_config: Optional[Dict[str, str]] = None,
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` computing feature attributions.
+
+        Spins up a model endpoint.
+
+        Currently, only SHAP and  Partial Dependence Plots (PDP) are supported
+        as explainability methods.
+        You can request both methods or one at a time with the ``explainability_config`` parameter.
+
+        When SHAP is requested in the ``explainability_config``,
+        the SHAP algorithm calculates the feature importance for each input example
+        in the ``s3_data_input_path`` of the :class:`~sagemaker.clarify.DataConfig`,
+        by creating ``num_samples`` copies of the example with a subset of features
+        replaced with values from the ``baseline``.
+        It then runs model inference to see how the model's prediction changes with the replaced
+        features. If the model output returns multiple scores importance is computed for each score.
+        Across examples, feature importance is aggregated using ``agg_method``.
+
+        When PDP is requested in the ``explainability_config``,
+        the PDP algorithm calculates the dependence of the target response
+        on the input features and marginalizes over the values of all other input features.
+        The Partial Dependence Plots are included in the output
+        `report <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-feature-attribute-baselines-reports.html>`__
+        and the corresponding values are included in the analysis output.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            model_config (:class:`~sagemaker.clarify.ModelConfig`): Config of the model and its
+                endpoint to be created.
+            explainability_config (:class:`~sagemaker.clarify.ExplainabilityConfig` or list):
+                Config of the specific explainability method or a list of
+                :class:`~sagemaker.clarify.ExplainabilityConfig` objects.
+                Currently, SHAP and PDP are the two methods supported.
+                You can request multiple methods at once by passing in a list of
+                `~sagemaker.clarify.ExplainabilityConfig`.
+            model_scores (int or str or :class:`~sagemaker.clarify.ModelPredictedLabelConfig`):
+                Index or JMESPath expression to locate the predicted scores in the model output.
+                This is not required if the model output is a single score. Alternatively,
+                it can be an instance of :class:`~sagemaker.clarify.SageMakerClarifyProcessor`
+                to provide more parameters like ``label_headers``.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name. When ``job_name`` is not specified,
+                if ``job_name_prefix`` in :class:`~sagemaker.clarify.SageMakerClarifyProcessor`
+                is specified, the job name will be composed of ``job_name_prefix`` and current
+                timestamp; otherwise use ``"Clarify-Explainability"`` as prefix.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """  # noqa E501  # pylint: disable=c0301
+        analysis_config = _AnalysisConfigGenerator.explainability(
+            data_config, model_config, model_scores, explainability_config
+        )
+        # when name is either not provided (is None) or an empty string ("")
+        job_name = job_name or name_from_base(self.job_name_prefix or "Clarify-Explainability")
+        return self._run(
+            data_config,
+            analysis_config,
+            wait,
+            logs,
+            job_name,
+            kms_key,
+            experiment_config,
+        )
+
+    def run_bias_and_explainability(
+        self,
+        data_config: DataConfig,
+        model_config: ModelConfig,
+        explainability_config: Union[ExplainabilityConfig, List[ExplainabilityConfig]],
+        bias_config: BiasConfig,
+        pre_training_methods: Union[str, List[str]] = "all",
+        post_training_methods: Union[str, List[str]] = "all",
+        model_predicted_label_config: ModelPredictedLabelConfig = None,
+        wait=True,
+        logs=True,
+        job_name=None,
+        kms_key=None,
+        experiment_config=None,
+    ):
+        """Runs a :class:`~sagemaker.processing.ProcessingJob` computing feature attributions.
+
+        For bias:
+        Computes metrics for both the pre-training and the post-training methods.
+        To calculate post-training methods, it spins up a model endpoint and runs inference over the
+        input examples in 's3_data_input_path' (from the :class:`~sagemaker.clarify.DataConfig`)
+        to obtain predicted labels.
+
+        For Explainability:
+        Spins up a model endpoint.
+
+        Currently, only SHAP and  Partial Dependence Plots (PDP) are supported
+        as explainability methods.
+        You can request both methods or one at a time with the ``explainability_config`` parameter.
+
+        When SHAP is requested in the ``explainability_config``,
+        the SHAP algorithm calculates the feature importance for each input example
+        in the ``s3_data_input_path`` of the :class:`~sagemaker.clarify.DataConfig`,
+        by creating ``num_samples`` copies of the example with a subset of features
+        replaced with values from the ``baseline``.
+        It then runs model inference to see how the model's prediction changes with the replaced
+        features. If the model output returns multiple scores importance is computed for each score.
+        Across examples, feature importance is aggregated using ``agg_method``.
+
+        When PDP is requested in the ``explainability_config``,
+        the PDP algorithm calculates the dependence of the target response
+        on the input features and marginalizes over the values of all other input features.
+        The Partial Dependence Plots are included in the output
+        `report <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-feature-attribute-baselines-reports.html>`__
+        and the corresponding values are included in the analysis output.
+
+        Args:
+            data_config (:class:`~sagemaker.clarify.DataConfig`): Config of the input/output data.
+            model_config (:class:`~sagemaker.clarify.ModelConfig`): Config of the model and its
+                endpoint to be created.
+            explainability_config (:class:`~sagemaker.clarify.ExplainabilityConfig` or list):
+                Config of the specific explainability method or a list of
+                :class:`~sagemaker.clarify.ExplainabilityConfig` objects.
+                Currently, SHAP and PDP are the two methods supported.
+                You can request multiple methods at once by passing in a list of
+                `~sagemaker.clarify.ExplainabilityConfig`.
+            bias_config (:class:`~sagemaker.clarify.BiasConfig`): Config of sensitive groups.
+            pre_training_methods (str or list[str]): Selector of a subset of potential metrics:
+                ["`CI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-bias-metric-class-imbalance.html>`_",
+                "`DPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-true-label-imbalance.html>`_",
+                "`KL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kl-divergence.html>`_",
+                "`JS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-jensen-shannon-divergence.html>`_",
+                "`LP <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-lp-norm.html>`_",
+                "`TVD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-total-variation-distance.html>`_",
+                "`KS <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-kolmogorov-smirnov.html>`_",
+                "`CDDL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-data-bias-metric-cddl.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            post_training_methods (str or list[str]): Selector of a subset of potential metrics:
+                ["`DPPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dppl.html>`_"
+                , "`DI <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-di.html>`_",
+                "`DCA <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dca.html>`_",
+                "`DCR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dcr.html>`_",
+                "`RD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-rd.html>`_",
+                "`DAR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-dar.html>`_",
+                "`DRR <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-drr.html>`_",
+                "`AD <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ad.html>`_",
+                "`CDDPL <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-cddpl.html>`_
+                ", "`TE <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-te.html>`_",
+                "`FT <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-post-training-bias-metric-ft.html>`_"].
+                Defaults to str "all" to run all metrics if left unspecified.
+            model_predicted_label_config (
+                int or
+                str or
+                :class:`~sagemaker.clarify.ModelPredictedLabelConfig`
+            ):
+                Index or JMESPath expression to locate the predicted scores in the model output.
+                This is not required if the model output is a single score. Alternatively,
+                it can be an instance of :class:`~sagemaker.clarify.SageMakerClarifyProcessor`
+                to provide more parameters like ``label_headers``.
+            wait (bool): Whether the call should wait until the job completes (default: True).
+            logs (bool): Whether to show the logs produced by the job.
+                Only meaningful when ``wait`` is True (default: True).
+            job_name (str): Processing job name. When ``job_name`` is not specified,
+                if ``job_name_prefix`` in :class:`~sagemaker.clarify.SageMakerClarifyProcessor`
+                is specified, the job name will be composed of ``job_name_prefix`` and current
+                timestamp; otherwise use ``"Clarify-Explainability"`` as prefix.
+            kms_key (str): The ARN of the KMS key that is used to encrypt the
+                user code file (default: None).
+            experiment_config (dict[str, str]): Experiment management configuration.
+                Optionally, the dict can contain three keys:
+                ``'ExperimentName'``, ``'TrialName'``, and ``'TrialComponentDisplayName'``.
+
+                The behavior of setting these keys is as follows:
+
+                * If ``'ExperimentName'`` is supplied but ``'TrialName'`` is not, a Trial will be
+                  automatically created and the job's Trial Component associated with the Trial.
+                * If ``'TrialName'`` is supplied and the Trial already exists,
+                  the job's Trial Component will be associated with the Trial.
+                * If both ``'ExperimentName'`` and ``'TrialName'`` are not supplied,
+                  the Trial Component will be unassociated.
+                * ``'TrialComponentDisplayName'`` is used for display in Amazon SageMaker Studio.
+        """  # noqa E501  # pylint: disable=c0301
+        analysis_config = _AnalysisConfigGenerator.bias_and_explainability(
+            data_config,
+            model_config,
+            model_predicted_label_config,
+            explainability_config,
+            bias_config,
+            pre_training_methods,
+            post_training_methods,
+        )
+        # when name is either not provided (is None) or an empty string ("")
+        job_name = job_name or name_from_base(
+            self.job_name_prefix or "Clarify-Bias-And-Explainability"
+        )
+        return self._run(
+            data_config,
+            analysis_config,
+            wait,
+            logs,
+            job_name,
+            kms_key,
+            experiment_config,
+        )
+
+
+class _AnalysisConfigGenerator:
+    """Creates analysis_config objects for different type of runs."""
+
+    @classmethod
+    def bias_and_explainability(
+        cls,
+        data_config: DataConfig,
+        model_config: ModelConfig,
+        model_predicted_label_config: ModelPredictedLabelConfig,
+        explainability_config: Union[ExplainabilityConfig, List[ExplainabilityConfig]],
+        bias_config: BiasConfig,
+        pre_training_methods: Union[str, List[str]] = "all",
+        post_training_methods: Union[str, List[str]] = "all",
+    ):
+        """Generates a config for Bias and Explainability"""
+        # TimeSeries bias metrics are not supported
+        if (
+            isinstance(explainability_config, AsymmetricShapleyValueConfig)
+            or "time_series_data_config" in data_config.analysis_config
+            or (model_config and "time_series_predictor_config" in model_config.predictor_config)
+        ):
+            raise ValueError("Bias metrics are unsupported for time series.")
+        analysis_config = {**data_config.get_config(), **bias_config.get_config()}
+        analysis_config = cls._add_methods(
+            analysis_config,
+            pre_training_methods=pre_training_methods,
+            post_training_methods=post_training_methods,
+            explainability_config=explainability_config,
+        )
+        analysis_config = cls._add_predictor(
+            analysis_config, model_config, model_predicted_label_config
+        )
+        return analysis_config
+
+    @classmethod
+    def explainability(
+        cls,
+        data_config: DataConfig,
+        model_config: ModelConfig,
+        model_predicted_label_config: ModelPredictedLabelConfig,
+        explainability_config: Union[ExplainabilityConfig, List[ExplainabilityConfig]],
+    ):
+        """Generates a config for Explainability"""
+        # determine if this is a time series explainability case by checking
+        # if *both* TimeSeriesDataConfig and TimeSeriesModelConfig were given
+        ts_data_conf_absent = "time_series_data_config" not in data_config.analysis_config
+        ts_model_conf_absent = "time_series_predictor_config" not in model_config.predictor_config
+
+        if isinstance(explainability_config, AsymmetricShapleyValueConfig):
+            if ts_data_conf_absent:
+                raise ValueError("Please provide a TimeSeriesDataConfig to DataConfig.")
+            if ts_model_conf_absent:
+                raise ValueError("Please provide a TimeSeriesModelConfig to ModelConfig.")
+            # Check static covariates baseline matches number of provided static covariate columns
+            _AnalysisConfigGenerator._validate_time_series_static_covariates_baseline(
+                explainability_config=explainability_config,
+                data_config=data_config,
+            )
+        else:
+            if not ts_data_conf_absent:
+                raise ValueError(
+                    "Please provide an AsymmetricShapleyValueConfig for time series "
+                    "explainability cases. For non time series cases, please do not provide a "
+                    "TimeSeriesDataConfig."
+                )
+            if not ts_model_conf_absent:
+                raise ValueError(
+                    "Please provide an AsymmetricShapleyValueConfig for time series "
+                    "explainability cases. For non time series cases, please do not provide a "
+                    "TimeSeriesModelConfig."
+                )
+
+        # construct whole analysis config
+        analysis_config = data_config.analysis_config
+        analysis_config = cls._add_predictor(
+            analysis_config, model_config, model_predicted_label_config
+        )
+        analysis_config = cls._add_methods(
+            analysis_config,
+            explainability_config=explainability_config,
+        )
+        return analysis_config
+
+    @classmethod
+    def bias_pre_training(
+        cls,
+        data_config: DataConfig,
+        bias_config: BiasConfig,
+        methods: Union[str, List[str]],
+    ):
+        """Generates a config for Bias Pre Training"""
+        analysis_config = {**data_config.get_config(), **bias_config.get_config()}
+        analysis_config = cls._add_methods(analysis_config, pre_training_methods=methods)
+        return analysis_config
+
+    @classmethod
+    def bias_post_training(
+        cls,
+        data_config: DataConfig,
+        bias_config: BiasConfig,
+        model_predicted_label_config: ModelPredictedLabelConfig,
+        methods: Union[str, List[str]],
+        model_config: ModelConfig,
+    ):
+        """Generates a config for Bias Post Training"""
+        analysis_config = {**data_config.get_config(), **bias_config.get_config()}
+        analysis_config = cls._add_methods(analysis_config, post_training_methods=methods)
+        analysis_config = cls._add_predictor(
+            analysis_config, model_config, model_predicted_label_config
+        )
+        return analysis_config
+
+    @classmethod
+    def bias(
+        cls,
+        data_config: DataConfig,
+        bias_config: BiasConfig,
+        model_config: ModelConfig,
+        model_predicted_label_config: ModelPredictedLabelConfig,
+        pre_training_methods: Union[str, List[str]] = "all",
+        post_training_methods: Union[str, List[str]] = "all",
+    ):
+        """Generates a config for Bias"""
+        analysis_config = {**data_config.get_config(), **bias_config.get_config()}
+        analysis_config = cls._add_methods(
+            analysis_config,
+            pre_training_methods=pre_training_methods,
+            post_training_methods=post_training_methods,
+        )
+        analysis_config = cls._add_predictor(
+            analysis_config, model_config, model_predicted_label_config
+        )
+        return analysis_config
+
+    @classmethod
+    def _add_predictor(
+        cls,
+        analysis_config: Dict,
+        model_config: ModelConfig,
+        model_predicted_label_config: ModelPredictedLabelConfig,
+    ):
+        """Extends analysis config with predictor."""
+        analysis_config = {**analysis_config}
+        if isinstance(model_config, ModelConfig):
+            analysis_config["predictor"] = model_config.get_predictor_config()
+        else:
+            if (
+                "shap" in analysis_config["methods"]
+                or "pdp" in analysis_config["methods"]
+                or "asymmetric_shapley_value" in analysis_config["methods"]
+            ):
+                raise ValueError(
+                    "model_config must be provided when explainability methods are selected."
+                )
+            if (
+                "predicted_label_dataset_uri" not in analysis_config
+                and "predicted_label" not in analysis_config
+            ):
+                raise ValueError(
+                    "model_config must be provided when `predicted_label_dataset_uri` or "
+                    "`predicted_label` are not provided in data_config."
+                )
+        if isinstance(model_predicted_label_config, ModelPredictedLabelConfig):
+            (
+                probability_threshold,
+                predictor_config,
+            ) = model_predicted_label_config.get_predictor_config()
+            if predictor_config and "predictor" in analysis_config:
+                analysis_config["predictor"].update(predictor_config)
+            _set(probability_threshold, "probability_threshold", analysis_config)
+        elif "predictor" in analysis_config:
+            _set(model_predicted_label_config, "label", analysis_config["predictor"])
+        return analysis_config
+
+    @classmethod
+    def _add_methods(
+        cls,
+        analysis_config: Dict,
+        pre_training_methods: Union[str, List[str]] = None,
+        post_training_methods: Union[str, List[str]] = None,
+        explainability_config: Union[ExplainabilityConfig, List[ExplainabilityConfig]] = None,
+        report: bool = True,
+    ):
+        """Extends analysis config with methods."""
+        # validate
+        params = [pre_training_methods, post_training_methods, explainability_config]
+        if not any(params):
+            raise AttributeError(
+                "analysis_config must have at least one working method: "
+                "One of the "
+                "`pre_training_methods`, `post_training_methods`, `explainability_config`."
+            )
+
+        # main logic
+        analysis_config = {**analysis_config}
+        if "methods" not in analysis_config:
+            analysis_config["methods"] = {}
+
+        if report:
+            analysis_config["methods"]["report"] = {
+                "name": "report",
+                "title": "Analysis Report",
+            }
+
+        if pre_training_methods:
+            analysis_config["methods"]["pre_training_bias"] = {"methods": pre_training_methods}
+
+        if post_training_methods:
+            analysis_config["methods"]["post_training_bias"] = {"methods": post_training_methods}
+
+        if explainability_config is not None:
+            if isinstance(explainability_config, AsymmetricShapleyValueConfig):
+                explainability_methods = explainability_config.get_explainability_config()
+            else:
+                explainability_methods = cls._merge_explainability_configs(
+                    explainability_config,
+                )
+            analysis_config["methods"] = {
+                **analysis_config["methods"],
+                **explainability_methods,
+            }
+        return analysis_config
+
+    @classmethod
+    def _merge_explainability_configs(
+        cls,
+        explainability_config: Union[ExplainabilityConfig, List[ExplainabilityConfig]],
+    ):
+        """Merges explainability configs, when more than one."""
+        non_ts = "Please do not provide Asymmetric Shapley Value configs for non-TimeSeries uses."
+        # validation
+        if isinstance(explainability_config, AsymmetricShapleyValueConfig):
+            raise ValueError(non_ts)
+        if (
+            isinstance(explainability_config, PDPConfig)
+            and "features" not in explainability_config.get_explainability_config()["pdp"]
+        ):
+            raise ValueError("PDP features must be provided when ShapConfig is not provided")
+        if isinstance(explainability_config, list):
+            if len(explainability_config) == 0:
+                raise ValueError("Please provide at least one explainability config.")
+            # list validation
+            for config in explainability_config:
+                # ensure all provided explainability configs are not AsymmetricShapleyValueConfig
+                if isinstance(config, AsymmetricShapleyValueConfig):
+                    raise ValueError(non_ts)
+            # main logic
+            explainability_methods = {}
+            for config in explainability_config:
+                explain_config = config.get_explainability_config()
+                explainability_methods.update(explain_config)
+            if not len(explainability_methods) == len(explainability_config):
+                raise ValueError("Duplicate explainability configs are provided")
+            if (
+                "shap" not in explainability_methods
+                and "features" not in explainability_methods["pdp"]
+            ):
+                raise ValueError("PDP features must be provided when ShapConfig is not provided")
+            return explainability_methods
+        return explainability_config.get_explainability_config()
+
+    @classmethod
+    def _validate_time_series_static_covariates_baseline(
+        cls,
+        explainability_config: AsymmetricShapleyValueConfig,
+        data_config: DataConfig,
+    ):
+        """Validates static covariates in baseline for asymmetric shapley value (for time series).
+
+        Checks that baseline values set for static covariate columns are
+        consistent between every item_id and the number of static covariate columns
+        provided in DataConfig.
+        """
+        baseline = explainability_config.get_explainability_config()[
+            "asymmetric_shapley_value"
+        ].get("baseline")
+        if isinstance(baseline, dict) and "static_covariates" in baseline:
+            covariate_count = len(
+                data_config.get_config()["time_series_data_config"].get("static_covariates", [])
+            )
+            if covariate_count > 0:
+                for item_id in baseline.get("static_covariates", []):
+                    baseline_entry = baseline["static_covariates"][item_id]
+                    if not isinstance(baseline_entry, list):
+                        raise ValueError(
+                            f"Baseline entry for {item_id} must be a list, is "
+                            f"{type(baseline_entry)}."
+                        )
+                    if len(baseline_entry) != covariate_count:
+                        raise ValueError(
+                            f"Length of baseline entry for {item_id} does not match number "
+                            f"of static covariate columns. Please ensure every covariate "
+                            f"has a baseline value for every item id."
+                        )
+            else:
+                raise ValueError(
+                    "Static covariate baselines are provided in AsymmetricShapleyValueConfig "
+                    "when no static covariate columns are provided in TimeSeriesDataConfig. "
+                    "Please check these configs."
+                )
+
+
+def _upload_analysis_config(analysis_config_file, s3_output_path, sagemaker_session, kms_key):
+    """Uploads the local ``analysis_config_file`` to the ``s3_output_path``.
+
+    Args:
+        analysis_config_file (str): File path to the local analysis config file.
+        s3_output_path (str): S3 prefix to store the analysis config file.
+        sagemaker_session (:class:`~sagemaker.session.Session`):
+            :class:`~sagemaker.session.Session` object which manages interactions with
+            Amazon SageMaker and any other AWS services needed. If not specified,
+            the processor creates a :class:`~sagemaker.session.Session`
+            using the default AWS configuration chain.
+        kms_key (str): The ARN of the KMS key that is used to encrypt the
+            user code file (default: None).
+
+    Returns:
+        The S3 URI of the uploaded file.
+    """
+    return s3.S3Uploader.upload(
+        local_path=analysis_config_file,
+        desired_s3_uri=s3_output_path,
+        sagemaker_session=sagemaker_session,
+        kms_key=kms_key,
+    )
+
+
+class ProcessingOutputHandler:
+    """Class to handle the parameters for SagemakerProcessor.Processingoutput"""
+
+    class S3UploadMode(Enum):
+        """Enum values for different uplaod modes to s3 bucket"""
+
+        CONTINUOUS = "Continuous"
+        ENDOFJOB = "EndOfJob"
+
+    @classmethod
+    def get_s3_upload_mode(cls, analysis_config: Dict[str, Any]) -> str:
+        """Fetches s3_upload mode based on the shap_config values
+
+        Args:
+            analysis_config (dict): dict Config following the analysis_config.json format
+
+        Returns:
+            The s3_upload_mode type for the processing output.
+        """
+        dataset_type = analysis_config["dataset_type"]
+        return (
+            ProcessingOutputHandler.S3UploadMode.CONTINUOUS.value
+            if dataset_type == DatasetType.IMAGE.value
+            else ProcessingOutputHandler.S3UploadMode.ENDOFJOB.value
+        )
+
+
+def _set(value, key, dictionary):
+    """Sets dictionary[key] = value if value is not None."""
+    if value is not None:
+        dictionary[key] = value
+
+
+# Public API
+__all__ = [
+    "AsymmetricShapleyValueConfig",
+    "BiasConfig",
+    "DataConfig",
+    "DatasetType",
+    "ExplainabilityConfig",
+    "ImageConfig",
+    "ModelConfig",
+    "ModelPredictedLabelConfig",
+    "PDPConfig",
+    "ProcessingOutputHandler",
+    "SageMakerClarifyProcessor",
+    "SegmentationConfig",
+    "SHAPConfig",
+    "TextConfig",
+    "TimeSeriesDataConfig",
+    "TimeSeriesJSONDatasetFormat",
+    "TimeSeriesModelConfig",
+]