class_docstr: Stores the explainability results of a :class:`ShapExplainer <darts.explainability.shap_explainer.ShapExplainer>`
  with convenient access to the results. It extends the :class:`HorizonBasedExplainabilityResult
  <HorizonBasedExplainabilityResult>` and carries additional information specific to the Shap explainers.
  In particular, in addition to the `explained_forecasts` (which in the case of the `ShapExplainer` are the
  shap values), it also provides access to the corresponding `feature_values` and the underlying `shap.Explanation`
  object.
  
  - :func:`get_explanation() <ShapExplainabilityResult.get_explanation>`: explained forecast for a given horizon
    (and target component)
  - :func:`get_feature_values() <ShapExplainabilityResult.get_feature_values>`: feature values for a given horizon
    (and target component).
  - :func:`get_shap_explanation_object() <ShapExplainabilityResult.get_shap_explanation_object>`: `shap.Explanation`
    object for a given horizon (and target component).
  
  Examples
  --------
  >>> explainer = ShapExplainer(model)  # requires `background` if model was trained on multiple series
  >>> explain_results = explainer.explain()
  >>> exlained_fc = explain_results.get_explanation(horizon=1)
  >>> feature_values = explain_results.get_feature_values(horizon=1)
  >>> shap_objects = explain_results.get_shap_explanation_objects(horizon=1)
class_docstr_tok: ["Stores","the","explainability","results","of","a",":","class",":","`","ShapExplainer","<","darts.explainability.shap_explainer.ShapExplainer",">","`","with","convenient","access","to","the","results",".","It","extends","the",":","class",":","`","HorizonBasedExplainabilityResult","<","HorizonBasedExplainabilityResult",">","`","and","carries","additional","information","specific","to","the","Shap","explainers",".","In","particular",",","in","addition","to","the","`","explained_forecasts","`","(","which","in","the","case","of","the","`","ShapExplainer","`","are","the","shap","values",")",",","it","also","provides","access","to","the","corresponding","`","feature_values","`","and","the","underlying","`","shap.Explanation","`","object",".","-",":","func",":","`","get_explanation","(",")","<","ShapExplainabilityResult.get_explanation",">","`",":","explained","forecast","for","a","given","horizon","(","and","target","component",")","-",":","func",":","`","get_feature_values","(",")","<","ShapExplainabilityResult.get_feature_values",">","`",":","feature","values","for","a","given","horizon","(","and","target","component",")",".","-",":","func",":","`","get_shap_explanation_object","(",")","<","ShapExplainabilityResult.get_shap_explanation_object",">","`",":","`","shap.Explanation","`","object","for","a","given","horizon","(","and","target","component",")",".","Examples","--","--","--","--",">",">",">","explainer","=","ShapExplainer","(","model",")","#","requires","`","background","`","if","model","was","trained","on","multiple","series",">",">",">","explain_results","=","explainer.explain","(",")",">",">",">","exlained_fc","=","explain_results.get_explanation","(","horizon=1",")",">",">",">","feature_values","=","explain_results.get_feature_values","(","horizon=1",")",">",">",">","shap_objects","=","explain_results.get_shap_explanation_objects","(","horizon=1",")"]
docstr: Returns one or several `TimeSeries` representing the feature values
  for a given horizon and component.
  
  Parameters
  ----------
  horizon
      The horizon for which to return the feature values.
  component
      The component for which to return the feature values. Does not
      need to be specified for univariate series.
docstr_tok: ["Returns","one","or","several","`","TimeSeries","`","representing","the","feature","values","for","a","given","horizon","and","component",".","Parameters","--","--","--","--","--","horizon","The","horizon","for","which","to","return","the","feature","values",".","component","The","component","for","which","to","return","the","feature","values",".","Does","not","need","to","be","specified","for","univariate","series","."]
code: def get_feature_values(
      self, horizon: int, component: Optional[str] = None
  ) -> Union[TimeSeries, List[TimeSeries]]:
      """
      Returns one or several `TimeSeries` representing the feature values
      for a given horizon and component.
  
      Parameters
      ----------
      horizon
          The horizon for which to return the feature values.
      component
          The component for which to return the feature values. Does not
          need to be specified for univariate series.
      """
      return self._query_explainability_result(
          self.feature_values, horizon, component
      )
  
imports: from abc import ABC, abstractmethod
  from typing import Any, Dict, List, Optional, Union
  import pandas
  import shap
  from darts import TimeSeries
  from darts.logging import get_logger, raise_if, raise_if_not, raise_log
label_desc: Use image node_id 2 for calling the ShapExplainabilityResult obj's underlying member method code with example usage: obj.get_feature_values(horizon, component) and returns: self