class_docstr: To implement the `influence` method, classes inheriting from `TracInCPBase` will
  separately implement the private `_self_influence`, `_get_k_most_influential`,
  and `_influence` methods. The public `influence` method is a wrapper for these
  private methods.
docstr: This is the key method of this class, and can be run in 2 different modes,
  where the mode that is run depends on the arguments passed to this method:
  
  - influence score mode: This mode is used if `k` is None. This mode computes
    the influence score of every example in training dataset `train_dataset`
    on every example in the test batch represented by `inputs`.
  - k-most influential mode: This mode is used if `k` is not None, and an int.
    This mode computes the proponents or opponents of every example in the
    test batch represented by `inputs`. In particular, for each test example in
    the test batch, this mode computes its proponents (resp. opponents),
    which are the indices in the training dataset `train_dataset` of the
    training examples with the `k` highest (resp. lowest) influence scores on the
    test example. Proponents are computed if `proponents` is True. Otherwise,
    opponents are computed. For each test example, this method also returns the
    actual influence score of each proponent (resp. opponent) on the test
    example.
  
  Args:
  
      inputs (tuple): `inputs` is the test batch and is a tuple of
              any, where the last element is assumed to be the labels for the
              batch. That is, `model(*batch[0:-1])` produces the output for
              `model`, and `batch[-1]` are the labels, if any. This is the same
              assumption made for each batch yielded by training dataset
              `train_dataset` - please see its documentation in `__init__` for
              more details on the assumed structure of a batch.
      k (int, optional): If not provided or `None`, the influence score mode will
              be run. Otherwise, the k-most influential mode will be run,
              and `k` is the number of proponents / opponents to return per
              example in the test batch.
              Default: None
      proponents (bool, optional): Whether seeking proponents (`proponents=True`)
              or opponents (`proponents=False`), if running in k-most influential
              mode.
              Default: True
      show_progress (bool, optional): For all modes, computation of results
              requires "training dataset computations": computations for each
              batch in the training dataset `train_dataset`, which may
              take a long time. If `show_progress` is true, the progress of
              "training dataset computations" will be displayed. In particular,
              the number of batches for which computations have been performed
              will be displayed. It will try to use tqdm if available for
              advanced features (e.g. time estimation). Otherwise, it will
              fallback to a simple output of progress.
              Default: False
  
  Returns:
      The return value of this method depends on which mode is run.
  
      - influence score mode: if this mode is run (`k` is None), returns a 2D
        tensor `influence_scores` of shape `(input_size, train_dataset_size)`,
        where `input_size` is the number of examples in the test batch, and
        `train_dataset_size` is the number of examples in training dataset
        `train_dataset`. In other words, `influence_scores[i][j]` is the
        influence score of the `j`-th example in `train_dataset` on the `i`-th
        example in the test batch.
      - k-most influential mode: if this mode is run (`k` is an int), returns
        a namedtuple `(indices, influence_scores)`. `indices` is a 2D tensor of
        shape `(input_size, k)`, where `input_size` is the number of examples in
        the test batch. If computing proponents (resp. opponents),
        `indices[i][j]` is the index in training dataset `train_dataset` of the
        example with the `j`-th highest (resp. lowest) influence score (out of
        the examples in `train_dataset`) on the `i`-th example in the test
        dataset. `influence_scores` contains the corresponding influence scores.
        In particular, `influence_scores[i][j]` is the influence score of example
        `indices[i][j]` in `train_dataset` on example `i` in the test batch
        represented by `inputs`.
docstr_tok: ["This","is","the","key","method","of","this","class",",","and","can","be","run","in","2","different","modes",",","where","the","mode","that","is","run","depends","on","the","arguments","passed","to","this","method",":","-","influence","score","mode",":","This","mode","is","used","if","`","k","`","is","None",".","This","mode","computes","the","influence","score","of","every","example","in","training","dataset","`","train_dataset","`","on","every","example","in","the","test","batch","represented","by","`","inputs","`",".","-","k-most","influential","mode",":","This","mode","is","used","if","`","k","`","is","not","None",",","and","an","int",".","This","mode","computes","the","proponents","or","opponents","of","every","example","in","the","test","batch","represented","by","`","inputs","`",".","In","particular",",","for","each","test","example","in","the","test","batch",",","this","mode","computes","its","proponents","(","resp",".","opponents",")",",","which","are","the","indices","in","the","training","dataset","`","train_dataset","`","of","the","training","examples","with","the","`","k","`","highest","(","resp",".","lowest",")","influence","scores","on","the","test","example",".","Proponents","are","computed","if","`","proponents","`","is","True",".","Otherwise",",","opponents","are","computed",".","For","each","test","example",",","this","method","also","returns","the","actual","influence","score","of","each","proponent","(","resp",".","opponent",")","on","the","test","example",".","Args",":","inputs","(","tuple",")",":","`","inputs","`","is","the","test","batch","and","is","a","tuple","of","any",",","where","the","last","element","is","assumed","to","be","the","labels","for","the","batch",".","That","is",",","`","model","(","*","batch","[","0",":","-1","]",")","`","produces","the","output","for","`","model","`",",","and","`","batch","[","-1","]","`","are","the","labels",",","if","any",".","This","is","the","same","assumption","made","for","each","batch","yielded","by","training","dataset","`","train_dataset","`","-","please","see","its","documentation","in","`","__init__","`","for","more","details","on","the","assumed","structure","of","a","batch",".","k","(","int",",","optional",")",":","If","not","provided","or","`","None","`",",","the","influence","score","mode","will","be","run",".","Otherwise",",","the","k-most","influential","mode","will","be","run",",","and","`","k","`","is","the","number","of","proponents","\/","opponents","to","return","per","example","in","the","test","batch",".","Default",":","None","proponents","(","bool",",","optional",")",":","Whether","seeking","proponents","(","`","proponents=True","`",")","or","opponents","(","`","proponents=False","`",")",",","if","running","in","k-most","influential","mode",".","Default",":","True","show_progress","(","bool",",","optional",")",":","For","all","modes",",","computation","of","results","requires","``","training","dataset","computations","''",":","computations","for","each","batch","in","the","training","dataset","`","train_dataset","`",",","which","may","take","a","long","time",".","If","`","show_progress","`","is","true",",","the","progress","of","``","training","dataset","computations","''","will","be","displayed",".","In","particular",",","the","number","of","batches","for","which","computations","have","been","performed","will","be","displayed",".","It","will","try","to","use","tqdm","if","available","for","advanced","features","(","e.g",".","time","estimation",")",".","Otherwise",",","it","will","fallback","to","a","simple","output","of","progress",".","Default",":","False","Returns",":","The","return","value","of","this","method","depends","on","which","mode","is","run",".","-","influence","score","mode",":","if","this","mode","is","run","(","`","k","`","is","None",")",",","returns","a","2D","tensor","`","influence_scores","`","of","shape","`","(","input_size",",","train_dataset_size",")","`",",","where","`","input_size","`","is","the","number","of","examples","in","the","test","batch",",","and","`","train_dataset_size","`","is","the","number","of","examples","in","training","dataset","`","train_dataset","`",".","In","other","words",",","`","influence_scores","[","i","]","[","j","]","`","is","the","influence","score","of","the","`","j","`","-th","example","in","`","train_dataset","`","on","the","`","i","`","-th","example","in","the","test","batch",".","-","k-most","influential","mode",":","if","this","mode","is","run","(","`","k","`","is","an","int",")",",","returns","a","namedtuple","`","(","indices",",","influence_scores",")","`",".","`","indices","`","is","a","2D","tensor","of","shape","`","(","input_size",",","k",")","`",",","where","`","input_size","`","is","the","number","of","examples","in","the","test","batch",".","If","computing","proponents","(","resp",".","opponents",")",",","`","indices","[","i","]","[","j","]","`","is","the","index","in","training","dataset","`","train_dataset","`","of","the","example","with","the","`","j","`","-th","highest","(","resp",".","lowest",")","influence","score","(","out","of","the","examples","in","`","train_dataset","`",")","on","the","`","i","`","-th","example","in","the","test","dataset",".","`","influence_scores","`","contains","the","corresponding","influence","scores",".","In","particular",",","`","influence_scores","[","i","]","[","j","]","`","is","the","influence","score","of","example","`","indices","[","i","]","[","j","]","`","in","`","train_dataset","`","on","example","`","i","`","in","the","test","batch","represented","by","`","inputs","`","."]
code: def influence(  # type: ignore[override]
      self,
      inputs: Union[Tuple[Any, ...], DataLoader],
      k: Optional[int] = None,
      proponents: bool = True,
      unpack_inputs: bool = True,
      show_progress: bool = False,
  ) -> Union[Tensor, KMostInfluentialResults]:
      r"""
      This is the key method of this class, and can be run in 2 different modes,
      where the mode that is run depends on the arguments passed to this method:
  
      - influence score mode: This mode is used if `k` is None. This mode computes
        the influence score of every example in training dataset `train_dataset`
        on every example in the test batch represented by `inputs`.
      - k-most influential mode: This mode is used if `k` is not None, and an int.
        This mode computes the proponents or opponents of every example in the
        test batch represented by `inputs`. In particular, for each test example in
        the test batch, this mode computes its proponents (resp. opponents),
        which are the indices in the training dataset `train_dataset` of the
        training examples with the `k` highest (resp. lowest) influence scores on the
        test example. Proponents are computed if `proponents` is True. Otherwise,
        opponents are computed. For each test example, this method also returns the
        actual influence score of each proponent (resp. opponent) on the test
        example.
  
      Args:
  
          inputs (tuple): `inputs` is the test batch and is a tuple of
                  any, where the last element is assumed to be the labels for the
                  batch. That is, `model(*batch[0:-1])` produces the output for
                  `model`, and `batch[-1]` are the labels, if any. This is the same
                  assumption made for each batch yielded by training dataset
                  `train_dataset` - please see its documentation in `__init__` for
                  more details on the assumed structure of a batch.
          k (int, optional): If not provided or `None`, the influence score mode will
                  be run. Otherwise, the k-most influential mode will be run,
                  and `k` is the number of proponents / opponents to return per
                  example in the test batch.
                  Default: None
          proponents (bool, optional): Whether seeking proponents (`proponents=True`)
                  or opponents (`proponents=False`), if running in k-most influential
                  mode.
                  Default: True
          show_progress (bool, optional): For all modes, computation of results
                  requires "training dataset computations": computations for each
                  batch in the training dataset `train_dataset`, which may
                  take a long time. If `show_progress` is true, the progress of
                  "training dataset computations" will be displayed. In particular,
                  the number of batches for which computations have been performed
                  will be displayed. It will try to use tqdm if available for
                  advanced features (e.g. time estimation). Otherwise, it will
                  fallback to a simple output of progress.
                  Default: False
  
      Returns:
          The return value of this method depends on which mode is run.
  
          - influence score mode: if this mode is run (`k` is None), returns a 2D
            tensor `influence_scores` of shape `(input_size, train_dataset_size)`,
            where `input_size` is the number of examples in the test batch, and
            `train_dataset_size` is the number of examples in training dataset
            `train_dataset`. In other words, `influence_scores[i][j]` is the
            influence score of the `j`-th example in `train_dataset` on the `i`-th
            example in the test batch.
          - k-most influential mode: if this mode is run (`k` is an int), returns
            a namedtuple `(indices, influence_scores)`. `indices` is a 2D tensor of
            shape `(input_size, k)`, where `input_size` is the number of examples in
            the test batch. If computing proponents (resp. opponents),
            `indices[i][j]` is the index in training dataset `train_dataset` of the
            example with the `j`-th highest (resp. lowest) influence score (out of
            the examples in `train_dataset`) on the `i`-th example in the test
            dataset. `influence_scores` contains the corresponding influence scores.
            In particular, `influence_scores[i][j]` is the influence score of example
            `indices[i][j]` in `train_dataset` on example `i` in the test batch
            represented by `inputs`.
      """
      pass
  
imports: import glob
  import warnings
  from abc import abstractmethod
  from os.path import join
  from typing import Any, Callable, Iterator, List, Optional, Tuple, Type, Union
  import torch
  from captum._utils.av import AV
  from captum._utils.common import _parse_version
  from captum._utils.progress import NullProgress, progress
  from captum.influence._core.influence import DataInfluence
  from captum.influence._utils.common import _check_loss_fn, _compute_jacobian_sample_wise_grads_per_batch, _format_inputs_dataset, _get_k_most_influential_helper, _gradient_dot_product, _influence_route_to_helpers, _load_flexible_state_dict, _self_influence_by_batches_helper, _set_active_parameters, KMostInfluentialResults
  from captum.log import log_usage
  from torch import Tensor
  from torch.nn import Module
  from torch.utils.data import DataLoader, Dataset
label_desc: Use image node_id 5 for calling the TracInCPBase obj's underlying member method code with example usage: obj.influence(inputs, k, proponents, unpack_inputs, show_progress) without return types