class_docstr: Auto Multi-class HeteroGraph Node Classifier.
  
  Used to automatically solve the heterogeneous node classification problems.
  
  Parameters
  ----------
  feature_module: autogl.module.feature.BaseFeatureEngineer or str or None
      The (name of) auto feature engineer used to process the given dataset. Default ``deepgl``.
      Disable feature engineer by setting it to ``None``.
  
  graph_models: list of autogl.module.model.BaseModel or list of str
      The (name of) models to be optimized as backbone. Default ``['gat', 'gcn']``.
  
  hpo_module: autogl.module.hpo.BaseHPOptimizer or str or None
      The (name of) hpo module used to search for best hyper parameters. Default ``anneal``.
      Disable hpo by setting it to ``None``.
  
  ensemble_module: autogl.module.ensemble.BaseEnsembler or str or None
      The (name of) ensemble module used to ensemble the multi-models found. Default ``voting``.
      Disable ensemble by setting it to ``None``.
  
  max_evals: int (Optional)
      If given, will set the number eval times the hpo module will use.
      Only be effective when hpo_module is ``str``. Default ``None``.
  
  default_trainer: str (Optional)
      The (name of) the trainer used in this solver. Default to ``NodeClassificationFull``.
  
  trainer_hp_space: list of dict (Optional)
      trainer hp space or list of trainer hp spaces configuration.
      If a single trainer hp is given, will specify the hp space of trainer for every model.
      If a list of trainer hp is given, will specify every model with corrsponding
      trainer hp space.
      Default ``None``.
  
  model_hp_spaces: list of list of dict (Optional)
      model hp space configuration.
      If given, will specify every hp space of every passed model. Default ``None``.
      If the encoder(-decoder) is passed, the space should be a dict containing keys "encoder"
      and "decoder", specifying the detailed encoder decoder hp spaces.
  
  size: int (Optional)
      The max models ensemble module will use. Default ``None``.
  
  device: torch.device or str
      The device where model will be running on. If set to ``auto``, will use gpu when available.
      You can also specify the device by directly giving ``gpu`` or ``cuda:0``, etc.
      Default ``auto``.
class_docstr_tok: ["Auto","Multi-class","HeteroGraph","Node","Classifier",".","Used","to","automatically","solve","the","heterogeneous","node","classification","problems",".","Parameters","--","--","--","--","--","feature_module",":","autogl.module.feature.BaseFeatureEngineer","or","str","or","None","The","(","name","of",")","auto","feature","engineer","used","to","process","the","given","dataset",".","Default","``","deepgl","``",".","Disable","feature","engineer","by","setting","it","to","``","None","``",".","graph_models",":","list","of","autogl.module.model.BaseModel","or","list","of","str","The","(","name","of",")","models","to","be","optimized","as","backbone",".","Default","``","[","'gat","'",",","'gcn","'","]","``",".","hpo_module",":","autogl.module.hpo.BaseHPOptimizer","or","str","or","None","The","(","name","of",")","hpo","module","used","to","search","for","best","hyper","parameters",".","Default","``","anneal","``",".","Disable","hpo","by","setting","it","to","``","None","``",".","ensemble_module",":","autogl.module.ensemble.BaseEnsembler","or","str","or","None","The","(","name","of",")","ensemble","module","used","to","ensemble","the","multi-models","found",".","Default","``","voting","``",".","Disable","ensemble","by","setting","it","to","``","None","``",".","max_evals",":","int","(","Optional",")","If","given",",","will","set","the","number","eval","times","the","hpo","module","will","use",".","Only","be","effective","when","hpo_module","is","``","str","``",".","Default","``","None","``",".","default_trainer",":","str","(","Optional",")","The","(","name","of",")","the","trainer","used","in","this","solver",".","Default","to","``","NodeClassificationFull","``",".","trainer_hp_space",":","list","of","dict","(","Optional",")","trainer","hp","space","or","list","of","trainer","hp","spaces","configuration",".","If","a","single","trainer","hp","is","given",",","will","specify","the","hp","space","of","trainer","for","every","model",".","If","a","list","of","trainer","hp","is","given",",","will","specify","every","model","with","corrsponding","trainer","hp","space",".","Default","``","None","``",".","model_hp_spaces",":","list","of","list","of","dict","(","Optional",")","model","hp","space","configuration",".","If","given",",","will","specify","every","hp","space","of","every","passed","model",".","Default","``","None","``",".","If","the","encoder","(","-decoder",")","is","passed",",","the","space","should","be","a","dict","containing","keys","``","encoder","''","and","``","decoder","''",",","specifying","the","detailed","encoder","decoder","hp","spaces",".","size",":","int","(","Optional",")","The","max","models","ensemble","module","will","use",".","Default","``","None","``",".","device",":","torch.device","or","str","The","device","where","model","will","be","running","on",".","If","set","to","``","auto","``",",","will","use","gpu","when","available",".","You","can","also","specify","the","device","by","directly","giving","``","gpu","``","or","``","cuda:0","``",",","etc",".","Default","``","auto","``","."]
docstr: Fit current solver on given dataset.
  
  Parameters
  ----------
  dataset: autogl.data.Dataset
      The dataset needed to fit on. This dataset must have only one graph.
  
  time_limit: int
      The time limit of the whole fit process (in seconds). If set below 0,
      will ignore time limit. Default ``-1``.
  
  inplace: bool
      Whether we process the given dataset in inplace manner. Default ``False``.
      Set it to True if you want to save memory by modifying the given dataset directly.
  
  evaluation_method: (list of) str or autogl.module.train.evaluation
      A (list of) evaluation method for current solver. If ``infer``, will automatically
      determine. Default ``infer``.
  
  seed: int (Optional)
      The random seed. If set to ``None``, will run everything at random.
      Default ``None``.
  
  Returns
  -------
  self: autogl.solver.AutoNodeClassifier
      A reference of current solver.
docstr_tok: ["Fit","current","solver","on","given","dataset",".","Parameters","--","--","--","--","--","dataset",":","autogl.data.Dataset","The","dataset","needed","to","fit","on",".","This","dataset","must","have","only","one","graph",".","time_limit",":","int","The","time","limit","of","the","whole","fit","process","(","in","seconds",")",".","If","set","below","0",",","will","ignore","time","limit",".","Default","``","-1","``",".","inplace",":","bool","Whether","we","process","the","given","dataset","in","inplace","manner",".","Default","``","False","``",".","Set","it","to","True","if","you","want","to","save","memory","by","modifying","the","given","dataset","directly",".","evaluation_method",":","(","list","of",")","str","or","autogl.module.train.evaluation","A","(","list","of",")","evaluation","method","for","current","solver",".","If","``","infer","``",",","will","automatically","determine",".","Default","``","infer","``",".","seed",":","int","(","Optional",")","The","random","seed",".","If","set","to","``","None","``",",","will","run","everything","at","random",".","Default","``","None","``",".","Returns","--","--","--","-","self",":","autogl.solver.AutoNodeClassifier","A","reference","of","current","solver","."]
code: def fit(
      self,
      dataset,
      time_limit=-1,
      evaluation_method="infer",
      seed=None,
  ) -> "AutoHeteroNodeClassifier":
      """
      Fit current solver on given dataset.
  
      Parameters
      ----------
      dataset: autogl.data.Dataset
          The dataset needed to fit on. This dataset must have only one graph.
  
      time_limit: int
          The time limit of the whole fit process (in seconds). If set below 0,
          will ignore time limit. Default ``-1``.
  
      inplace: bool
          Whether we process the given dataset in inplace manner. Default ``False``.
          Set it to True if you want to save memory by modifying the given dataset directly.
  
      evaluation_method: (list of) str or autogl.module.train.evaluation
          A (list of) evaluation method for current solver. If ``infer``, will automatically
          determine. Default ``infer``.
  
      seed: int (Optional)
          The random seed. If set to ``None``, will run everything at random.
          Default ``None``.
  
      Returns
      -------
      self: autogl.solver.AutoNodeClassifier
          A reference of current solver.
      """
      set_seed(seed)
  
      if time_limit < 0:
          time_limit = 3600 * 24
      time_begin = time.time()
  
      graph_data = dataset[0]
      field = dataset.schema["target_node_type"]
      all_labels = graph_data.nodes[field].data["label"]
      num_classes = all_labels.max().item() + 1
  
      # initialize leaderboard
      if evaluation_method == "infer":
          if hasattr(dataset, "metric"):
              evaluation_method = [dataset.metric]
          else:
              num_of_label = num_classes
              if num_of_label == 2:
                  evaluation_method = ["auc"]
              else:
                  evaluation_method = ["acc"]
      assert isinstance(evaluation_method, list)
      evaluator_list = get_feval(evaluation_method)
  
      self.leaderboard = LeaderBoard(
          [e.get_eval_name() for e in evaluator_list],
          {
              e.get_eval_name(): e.is_higher_better()
              for e in evaluator_list
          },
      )
  
      # set up the dataset
      assert (
          "train_mask" in graph_data.nodes[field].data
          and "val_mask" in graph_data.nodes[field].data
      ), (
          "Currently only support"
          " Dataset with default train/val/test split"
      )
  
      self.dataset = dataset
  
      # check whether the dataset has features.
      # currently we only support hetero graph classification with features.
  
      feat = graph_data.nodes[field].data["feat"]
      assert feat is not None, (
          "Does not support fit on non node-feature dataset!"
          " Please add node features to dataset or specify feature engineers that generate"
          " node features."
      )
  
      num_features = feat.size(-1)
  
      # initialize graph networks
      self._init_graph_module(
          self.gml,
          num_features=num_features,
          num_classes=num_classes,
          feval=evaluator_list,
          device=self.runtime_device,
          loss="nll_loss"
          if not hasattr(dataset, "loss")
          else self.dataset.loss,
          dataset=dataset,
      )
  
      # train the models and tune hpo
      result_valid = []
      names = []
      for idx, model in enumerate(self.graph_model_list):
          time_for_each_model = (
              time_limit - time.time() + time_begin
          ) / (len(self.graph_model_list) - idx)
          if self.hpo_module is None:
              model.initialize()
              model.train(dataset, True)
              optimized = model
          else:
              optimized, _ = self.hpo_module.optimize(
                  trainer=model,
                  dataset=dataset,
                  time_limit=time_for_each_model,
              )
          # to save memory, all the trainer derived will be mapped to cpu
          optimized.to(torch.device("cpu"))
          name = str(optimized) + "_idx%d" % (idx)
          names.append(name)
          performance_on_valid, _ = optimized.get_valid_score(
              return_major=False
          )
          result_valid.append(
              optimized.get_valid_predict_proba().cpu().numpy()
          )
          self.leaderboard.insert_model_performance(
              name,
              dict(
                  zip(
                      [e.get_eval_name() for e in evaluator_list],
                      performance_on_valid,
                  )
              ),
          )
          self.trained_models[name] = optimized
  
      # fit the ensemble model
      if self.ensemble_module is not None:
          performance = self.ensemble_module.fit(
              result_valid,
              all_labels[graph_data.nodes[field].data["val_mask"]]
              .cpu()
              .numpy(),
              names,
              evaluator_list,
              n_classes=num_classes,
          )
          self.leaderboard.insert_model_performance(
              "ensemble",
              dict(
                  zip(
                      [e.get_eval_name() for e in evaluator_list],
                      performance,
                  )
              ),
          )
  
      return self
  
imports: import time
  import json
  from copy import deepcopy
  from typing import Sequence
  import torch
  import numpy
  import yaml
  from ..base import BaseClassifier
  from ...base import _parse_hp_space, _initialize_single_model, _parse_model_hp
  from ....module.train import TRAINER_DICT, BaseNodeClassificationHetTrainer
  from ....module.train import get_feval
  from ...utils import LeaderBoard, set_seed
  from ....utils import get_logger
label_desc: Use image node_id 3 for calling the AutoHeteroNodeClassifier obj's underlying member method code with example usage: obj.fit(dataset, time_limit, evaluation_method, seed) and returns: self