La référence de la librairie SageMaker model parallel v2

• hybrid_shard_degree(Entier) — Spécifie un degré de parallélisme fragmenté. La valeur doit être un entier compris entre 0 etworld_size. La valeur par défaut est 0.

  • S'il est défini sur0, il revient à l' PyTorchimplémentation native et API dans le script, quand tensor_parallel_degree est égal à 1. Sinon, il calcule la plus grande valeur possible sur la hybrid_shard_degree base de tensor_parallel_degree etworld_size. Lorsque vous revenez aux cas d' PyTorch FSDPutilisation natifs, si FULL_SHARD c'est la stratégie que vous utilisez, elle se répercute sur l'ensemble du cluster deGPUs. Si _HYBRID_SHARD_ZERO2 c'était HYBRID_SHARD ou était la stratégie, cela équivaut hybrid_shard_degree à 8. Lorsque le parallélisme des tenseurs est activé, il se divise en fonction de la version révisée. hybrid_shard_degree

  • S'il est défini sur1, il revient à l' PyTorchimplémentation native et API pour NO_SHARD dans le script, quand tensor_parallel_degree est égal à 1. Sinon, c'est équivalent à l'NO_SHARDintérieur de n'importe quel groupe tensor parallel donné.

  • S'il est défini sur un entier compris entre 2 etworld_size, le partitionnement se produit sur le nombre spécifié deGPUs. Si vous ne le configurez pas sharding_strategy dans le FSDP script, il est remplacé par. HYBRID_SHARD Si vous définissez_HYBRID_SHARD_ZERO2, le paramètre sharding_strategy que vous spécifiez est utilisé.

• sm_activation_offloading(Boolean) — Spécifie s'il faut activer l'implémentation du déchargement par SMP activation. SiFalse, le déchargement utilise l' PyTorch implémentation native. SiTrue, il utilise l'implémentation de déchargement par SMP activation. Vous devez également utiliser le wrapper PyTorch d'activation (torch.distributed.algorithms._checkpoint.checkpoint_wrapper.offload_wrapper) dans votre script. Pour en savoir plus, consultez Déchargement de l'activation. La valeur par défaut est True.

• activation_loading_horizon(Entier) — Un entier spécifiant le type d'horizon de déchargement d'activation pourFSDP. Il s'agit du nombre maximum de couches contrôlées ou déchargées dont les entrées peuvent se trouver simultanément dans la GPU mémoire. Pour en savoir plus, consultez Déchargement de l'activation. La valeur d'entrée doit être un entier positif. La valeur par défaut est 2.

• fsdp_cache_flush_warnings(Booléen) — Détecte et avertit en cas de vidage du cache dans le gestionnaire de PyTorch mémoire, car cela peut dégrader les performances de calcul. La valeur par défaut est True.

• allow_empty_shards(Boolean) — S'il faut autoriser les fragments vides lors du partitionnement des tenseurs si le tenseur n'est pas divisible. Il s'agit d'un correctif expérimental en cas de crash lors du point de contrôle dans certains scénarios. La désactivation de cette option revient au PyTorch comportement d'origine. La valeur par défaut est False.

• tensor_parallel_degree(Entier) — Spécifie un degré de parallélisme tensoriel. La valeur doit être comprise entre 1 etworld_size. La valeur par défaut est 1. Notez que le fait de transmettre une valeur supérieure à 1 n'active pas automatiquement le parallélisme du contexte ; vous devez également utiliser le torch.sagemaker.transform API pour intégrer le modèle dans votre script d'entraînement. Pour en savoir plus, consultez Parallélisme de tenseur.

• context_parallel_degree(Entier) — Spécifie le degré de parallélisme du contexte. La valeur doit être comprise entre 1 world_size et et doit être<= hybrid_shard_degree. La valeur par défaut est 1. Notez que le fait de transmettre une valeur supérieure à 1 n'active pas automatiquement le parallélisme du contexte ; vous devez également utiliser le torch.sagemaker.transform API pour intégrer le modèle dans votre script d'entraînement. Pour en savoir plus, consultez Parallélisme du contexte.

• expert_parallel_degree(Entier) — Spécifie un degré de parallélisme expert. La valeur doit être comprise entre 1 etworld_size. La valeur par défaut est 1. Notez que le fait de transmettre une valeur supérieure à 1 n'active pas automatiquement le parallélisme du contexte ; vous devez également utiliser le torch.sagemaker.transform API pour intégrer le modèle dans votre script d'entraînement. Pour en savoir plus, consultez Parallélisme expert.

• random_seed(Entier) — Nombre initial pour les opérations aléatoires dans les modules distribués par parallélisme SMP tensoriel ou parallélisme expert. Cette graine est ajoutée aux rangs parallèles aux tenseurs ou aux rangs parallèles aux experts pour définir la valeur initiale réelle de chaque rang. Il est unique pour chaque rang parallèle au tenseur et au parallèle expert. SMPv2 s'assure que le nombre aléatoire généré entre les rangs parallèle aux tenseurs et parallèles aux experts correspond respectivement aux cas et. non-tensor-parallelism non-expert-parallelism

• model(nn.Module) — Un PyTorch modèle pour encapsuler et appliquer la fonctionnalité d'initialisation différée des paramètres de la SMP v2.

• init_method_using_config(Appelable) — Si vous utilisez l'implémentation tensor parallel de SMP v2 ou supportéeModèles Hugging Face Transformer compatibles avec le parallélisme SMP des tenseurs, conservez ce paramètre à la valeur par défaut, qui est. None Par défaut, DelayedParamIniter API il découvre comment initialiser correctement le modèle donné. Pour tous les autres modèles, vous devez créer une fonction d'initialisation de paramètres personnalisée et l'ajouter à votre script. L'extrait de code suivant est la init_method_using_config fonction par défaut implémentée par la SMP v2 pour. Modèles Hugging Face Transformer compatibles avec le parallélisme SMP des tenseurs Utilisez l'extrait de code suivant comme référence pour créer votre propre fonction de configuration d'initialisation, l'ajouter à votre script et la transmettre au init_method_using_config paramètre du. SMP DelayedParamIniter API

  from torch.sagemaker.utils.module_utils import empty_module_params, move_buffers_to_device
  
  # Define a custom init config function.
  def custom_init_method_using_config(module):
      d = torch.cuda.current_device()
      empty_module_params(module, device=d)
      if isinstance(module, (nn.Linear, Conv1D)):
          module.weight.data.normal_(mean=0.0, std=config.initializer_range)
          if module.bias is not None:
              module.bias.data.zero_()
      elif isinstance(module, nn.Embedding):
          module.weight.data.normal_(mean=0.0, std=config.initializer_range)
          if module.padding_idx is not None:
              module.weight.data[module.padding_idx].zero_()
      elif isinstance(module, nn.LayerNorm):
          module.weight.data.fill_(1.0)
          module.bias.data.zero_()
      elif isinstance(module, LlamaRMSNorm):
          module.weight.data.fill_(1.0)
      move_buffers_to_device(module, device=d)
  
  delayed_initer = DelayedParamIniter(model, init_method_using_config=custom_init_method_using_config)

  Pour plus d'informations sur les torch.sagemaker.module_util fonctions de l'extrait de code précédent, consultez. torch.sagemakerfonctions et propriétés utilitaires

• verbose(Boolean) — S'il faut activer une journalisation plus détaillée lors de l'initialisation et de la validation. La valeur par défaut est False.

• get_param_init_fn()— Renvoie la fonction d'initialisation des paramètres que vous pouvez transmettre à l'param_init_fnargument de la classe PyTorch FSDP wrapper.

• get_post_param_init_fn()— Renvoie la fonction d'initialisation des paramètres que vous pouvez transmettre à l'post_param_init_fnargument de la classe PyTorch FSDP wrapper. Cela est nécessaire lorsque vous avez lié des poids dans le modèle. Le modèle doit implémenter la méthodetie_weights. Pour plus d'informations, consultez les remarques sur le poids liéInitialisation différée des paramètres.

• count_num_params(module: nn.Module, *args: Tuple[nn.Parameter]) — Suit le nombre de paramètres initialisés par la fonction d'initialisation des paramètres. Cela permet de mettre en œuvre la validate_params_and_buffers_inited méthode suivante. Il n'est généralement pas nécessaire d'appeler cette fonction de manière explicite, car la validate_params_and_buffers_inited méthode appelle implicitement cette méthode dans le backend.

• validate_params_and_buffers_inited(enabled: bool=True) — Il s'agit d'un gestionnaire de contexte qui permet de valider que le nombre de paramètres initialisés correspond au nombre total de paramètres du modèle. Cela confirme également que tous les paramètres et tampons se trouvent désormais sur des GPU appareils plutôt que sur des méta-appareils. Elle se pose AssertionErrors si ces conditions ne sont pas remplies. Ce gestionnaire de contexte est uniquement facultatif et vous n'êtes pas obligé de l'utiliser pour initialiser les paramètres.

• state_dict(dict) - Obligatoire. Le dicton de l'État de sauver.

• checkpoint_id(str) - Obligatoire. Le chemin de stockage dans lequel enregistrer les points de contrôle.

• storage_writer(StorageWriter) - Facultatif. Une instance de StorageWriterin PyTorch pour effectuer des opérations d'écriture. Si cela n'est pas spécifié, la configuration par défaut de StorageWriterest utilisée.

• planner(SavePlanner) - Facultatif. Un exemple d'SavePlannerin PyTorch. Si cela n'est pas spécifié, la configuration par défaut de SavePlannerest utilisée.

• process_group(ProcessGroup) - Facultatif. Le groupe de processus sur lequel travailler. SiNone, le groupe de processus (global) par défaut est utilisé.

• coordinator_rank(int) - Facultatif. Le rang du coordinateur lors de l'exécution d'opérateurs de communication collective tels queAllReduce.

• queue(AsyncRequestQueue) - Facultatif. Le planificateur asynchrone à utiliser. Par défaut, il prend le paramètre globalDEFAULT_ASYNC_REQUEST_QUEUE.

• sharded_strategy(PyTorchDistSaveShardedStrategy) - Facultatif. La stratégie fragmentée à utiliser pour sauver les points de contrôle. Si ce n'est pas spécifié, torch.sagemaker.distributed.checkpoint.state_dict_saver.PyTorchDistSaveShardedStrategy il est utilisé par défaut.

• wait_error_handling(bool) - Facultatif. Un indicateur indiquant s'il faut attendre que tous les grades aient terminé de traiter les erreurs. La valeur par défaut est True.

• force_check_all_plans(bool) - Facultatif. Un indicateur qui détermine s'il convient de synchroniser de force les plans entre les grades, même en cas d'accès au cache. La valeur par défaut est True.

• s3_region(str) - Facultatif. Région dans laquelle se trouve le compartiment S3. Si elle n'est pas spécifiée, la région est déduite ducheckpoint_id.

• s3client_config(S3ClientConfig) - Facultatif. La classe de données exposant les paramètres configurables pour le client S3. Si elle n'est pas fournie, la configuration par défaut de S3 ClientConfig est utilisée. Le part_size paramètre est défini sur 64 Mo par défaut.

• blocking(bool) - Facultatif. SiTrue, il attendra que toutes les demandes actives soient terminées. Dans le cas contraire, il ne finalise que les demandes asynchrones déjà terminées. La valeur par défaut est True.

• process_group(ProcessGroup) - Facultatif. Le groupe de processus sur lequel opérer. S'il est défini surNone, le groupe de processus (global) par défaut est utilisé.

• Une liste contenant les indices des appels asynchrones est finalisée avec succès.

• state_dict(dict) - Obligatoire. Le dicton de l'État de sauver.

• checkpoint_id(str) - Obligatoire. Le chemin de stockage dans lequel enregistrer les points de contrôle.

• storage_writer(StorageWriter) - Facultatif. Une instance de StorageWriterin PyTorch pour effectuer des opérations d'écriture. Si cela n'est pas spécifié, la configuration par défaut de StorageWriterest utilisée.

• planner(SavePlanner) - Facultatif. Un exemple d'SavePlannerin PyTorch. Si cela n'est pas spécifié, la configuration par défaut de SavePlannerest utilisée.

• process_group(ProcessGroup) - Facultatif. Le groupe de processus sur lequel travailler. SiNone, le groupe de processus (global) par défaut est utilisé.

• coordinator_rank(int) - Facultatif. Le rang du coordinateur lors de l'exécution d'opérateurs de communication collective tels queAllReduce.

• wait_error_handling(bool) - Facultatif. Un indicateur indiquant s'il faut attendre que tous les grades aient terminé de traiter les erreurs. La valeur par défaut est True.

• force_check_all_plans(bool) - Facultatif. Un indicateur qui détermine s'il convient de synchroniser de force les plans entre les grades, même en cas d'accès au cache. La valeur par défaut est True.

• s3_region(str) - Facultatif. Région dans laquelle se trouve le compartiment S3. Si elle n'est pas spécifiée, la région est déduite ducheckpoint_id.

• s3client_config(S3ClientConfig) - Facultatif. La classe de données exposant les paramètres configurables pour le client S3. Si elle n'est pas fournie, la configuration par défaut de S3 ClientConfig est utilisée. Le part_size paramètre est défini sur 64 Mo par défaut.

• state_dict(dict) - Obligatoire. Le state_dict à charger.

• checkpoint_id(str) - Obligatoire. L'identifiant d'un point de contrôle. La signification de checkpoint_id dépend du stockage. Il peut s'agir d'un chemin d'accès à un dossier ou à un fichier. Il peut également s'agir d'une clé si le stockage est un stockage clé-valeur.

• storage_reader(StorageReader) - Facultatif. Une instance de StorageReaderin PyTorch pour effectuer des opérations de lecture. S'il n'est pas spécifié, le point de contrôle distribué déduira automatiquement le lecteur en fonction du. checkpoint_id Si checkpoint_id c'est également None le cas, une erreur d'exception est déclenchée.

• planner(StorageReader) - Facultatif. Un exemple d'LoadPlannerin PyTorch. Si elle n'est pas spécifiée, la configuration par défaut de LoadPlannerest utilisée.

• check_keys_matched(bool) - Facultatif. Si cette option est activée, vérifie si les state_dict clés de tous les grades correspondent à l'aide deAllGather.

• s3_region(str) - Facultatif. Région dans laquelle se trouve le compartiment S3. Si elle n'est pas spécifiée, la région est déduite ducheckpoint_id.

• s3client_config(S3ClientConfig) - Facultatif. La classe de données exposant les paramètres configurables pour le client S3. Si elle n'est pas fournie, la configuration par défaut de S3 ClientConfig est utilisée. Le part_size paramètre est défini sur 64 Mo par défaut.

• smp_moe(Boolean) - S'il faut utiliser l'SMPimplémentation de MoE. La valeur par défaut est True.

• random_seed(Entier) - Numéro initial pour les opérations aléatoires dans les modules distribués parallèles par des experts. Cette graine est ajoutée au rang parallèle expert pour définir la valeur initiale réelle de chaque rang. Il est unique pour chaque grade d'expert parallel. La valeur par défaut est 12345.

• moe_load_balancing(String) - Spécifiez le type d'équilibrage de charge du routeur MoE. Les options valides sont aux_losssinkhorn,balanced, etnone. La valeur par défaut est sinkhorn.

• global_token_shuffle(Booléen) - S'il faut répartir les jetons entre les rangs EP au sein d'un même groupe EP. La valeur par défaut est False.

• moe_all_to_all_dispatcher(Boolean) - S'il faut utiliser le all-to-all répartiteur pour les communications dans MoE. La valeur par défaut est True.

• moe_aux_loss_coeff(Float) - Coefficient de perte d'équilibrage de charge auxiliaire. La valeur par défaut est 0.001.

• moe_z_loss_coeff(Float) - Coefficient de perte z. La valeur par défaut est 0.001.

• attention_dropout_prob(float) — Probabilité d'abandon à appliquer à l'attention. La valeur par défaut est 0.0.

• scale(float) — S'il est passé, ce facteur d'échelle est appliqué pour softmax. S'il est défini sur None (qui est également la valeur par défaut), le facteur d'échelle est1 / sqrt(attention_head_size). La valeur par défaut est None.

• triton_flash_attention(bool) — En cas de réussite, l'implémentation de Flash Attention par Triton est utilisée. Cela est nécessaire pour soutenir Attention with Linear Biases (ALiBi) (voir le use_alibi paramètre suivant). Cette version du noyau ne supporte pas le dropout. La valeur par défaut est False.

• use_alibi(bool) — S'il est passé, il active Attention with Linear Biases (ALiBi) à l'aide du masque fourni. Lors de son utilisationALiBi, il faut un masque d'attention préparé comme suit. La valeur par défaut est False.

  def generate_alibi_attn_mask(attention_mask, batch_size, seq_length, 
      num_attention_heads, alibi_bias_max=8):
      device, dtype = attention_mask.device, attention_mask.dtype
      alibi_attention_mask = torch.zeros(
          1, num_attention_heads, 1, seq_length, dtype=dtype, device=device
      )
  
      alibi_bias = torch.arange(1 - seq_length, 1, dtype=dtype, device=device).view(
          1, 1, 1, seq_length
      )
      m = torch.arange(1, num_attention_heads + 1, dtype=dtype, device=device)
      m.mul_(alibi_bias_max / num_attention_heads)
      alibi_bias = alibi_bias * (1.0 / (2 ** m.view(1, num_attention_heads, 1, 1)))
  
      alibi_attention_mask.add_(alibi_bias)
      alibi_attention_mask = alibi_attention_mask[..., :seq_length, :seq_length]
      if attention_mask is not None and attention_mask.bool().any():
          alibi_attention_mask.masked_fill(
              attention_mask.bool().view(batch_size, 1, 1, seq_length), float("-inf")
          )
  
      return alibi_attention_mask

• forward(self, qkv, attn_mask=None, causal=False, cast_dtype=None, layout="b h s d")— Une fonction de PyTorch module normale. Lorsque a module(x) est appelé, SMP exécute cette fonction automatiquement.

  • qkv— torch.Tensor de la forme suivante : (batch_size x seqlen x (3 x num_heads) x head_size) ou (batch_size, (3 x num_heads) x seqlen x head_size) un tuple dont torch.Tensors chacun peut avoir une forme(batch_size x seqlen x num_heads x head_size), ou(batch_size x num_heads x seqlen x head_size). Un argument de mise en page approprié doit être transmis en fonction de la forme.

  • attn_mask— torch.Tensor du formulaire suivant(batch_size x 1 x 1 x seqlen). Pour activer ce paramètre de masque d'attention, il nécessite triton_flash_attention=True etuse_alibi=True. Pour savoir comment générer un masque d'attention à l'aide de cette méthode, consultez les exemples de code surFlashAttention. La valeur par défaut est None.

  • causal— Lorsque ce paramètre est défini surFalse, qui est la valeur par défaut de l'argument, aucun masque n'est appliqué. Lorsqu'elle est définie surTrue, la forward méthode utilise le masque triangulaire inférieur standard. La valeur par défaut est False.

  • cast_dtype— Lorsqu'il est défini sur une valeur particulièredtype, il convertit les qkv tenseurs sur le tenseur dtype précédentattn. Cela est utile pour des implémentations telles que le modèle Hugging Face Transformer GPT -NeOx, qui a q et k avec des intégrations rotatives. fp32 Si ce paramètre est défini surNone, aucun casting n'est appliqué. La valeur par défaut est None.

  • layout(chaîne) — Les valeurs disponibles sont b h s d oub s h d. Cela doit être défini sur la disposition des qkv tenseurs transmis, afin que les transformations appropriées puissent être appliquées. attn La valeur par défaut est b h s d.

• attention_dropout_prob(float) — Probabilité d'abandon à appliquer à l'attention. La valeur par défaut est 0.0.

• scale(float) — S'il est passé, ce facteur d'échelle est appliqué pour softmax. S'il est défini surNone, 1 / sqrt(attention_head_size) est utilisé comme facteur d'échelle. La valeur par défaut est None.

• forward(self, q, kv, causal=False, cast_dtype=None, layout="b s h d")— Une fonction de PyTorch module normale. Lorsque a module(x) est appelé, SMP exécute cette fonction automatiquement.

  • q— torch.Tensor de la forme suivante (batch_size x seqlen x num_heads x head_size) ou(batch_size x num_heads x seqlen x head_size). L'argument de mise en page approprié doit être transmis en fonction de la forme.

  • kv— torch.Tensor de la forme suivante (batch_size x seqlen x (2 x num_heads) x head_size) ou(batch_size, (2 x num_heads) x seqlen x head_size), ou un tuple de deux torch.Tensor s, dont chacun peut avoir la forme (batch_size x seqlen x num_heads x head_size) ou(batch_size x num_heads x seqlen x head_size). layoutL'argument approprié doit également être transmis en fonction de la forme.

  • causal— Lorsque ce paramètre est défini surFalse, qui est la valeur par défaut de l'argument, aucun masque n'est appliqué. Lorsqu'elle est définie surTrue, la forward méthode utilise le masque triangulaire inférieur standard. La valeur par défaut est False.

  • cast_dtype— Lorsqu'il est défini sur un dtype particulier, il convertit les qkv tenseurs en ce dtype auparavant. attn Cela est utile pour des implémentations telles que Hugging Face Transformers GPT -NeOx, qui comporte des intégrations rotatives. q,k fp32 Si ce paramètre est défini surNone, aucun casting n'est appliqué. La valeur par défaut est None.

  • layout (string) — Les valeurs disponibles sont "b h s d" ou"b s h d". Cela doit être défini sur la disposition des qkv tenseurs transmis, afin que les transformations appropriées puissent être appliquées. attn La valeur par défaut est "b h s d".

• config— Une FlashAttention configuration pour le modèle Lama.

• forward(self, hidden_states, attention_mask, position_ids, past_key_value, output_attentions, use_cache)

  • hidden_states(torch.Tensor) — États cachés d'un tenseur sous forme de(batch_size x seq_len x num_heads x head_size).

  • attention_mask(torch.LongTensor) — Masque pour éviter de faire attention au remplissage d'indices de jetons sous forme de(batch_size x seqlen). La valeur par défaut est None.

  • position_ids(torch.LongTensor) — Lorsqu'il ne l'est pasNone, il s'agit d'(batch_size x seqlen)indiquer les indices de position de chaque jeton de séquence d'entrée dans les intégrations de position. La valeur par défaut est None.

  • past_key_value(Cache) — États cachés précalculés (clé et valeurs dans les blocs d'attention personnelle et dans les blocs d'attention croisée). La valeur par défaut est None.

  • output_attentions(bool) — Indique s'il faut renvoyer les tenseurs d'attention de toutes les couches d'attention. La valeur par défaut est False.

  • use_cache(bool) — Indique s'il faut renvoyer les états past_key_values des valeurs clés. La valeur par défaut est False.

• model(torch.nn.Module) — Un modèle Modèles Hugging Face Transformer compatibles avec le parallélisme SMP des tenseurs à partir duquel transformer et appliquer la fonction de parallélisme tensoriel de la bibliothèque. SMP

• device(torch.device) — En cas de réussite, un nouveau modèle est créé sur cet appareil. Si le module d'origine possède un paramètre sur le méta-périphérique (voirInitialisation différée des paramètres), le module transformé sera également créé sur le méta-périphérique, en ignorant l'argument passé ici. La valeur par défaut est None.

• dtype(torch.dtype) — En cas de réussite, définit ce paramètre comme gestionnaire de contexte dtype pour la création du modèle et crée un modèle avec ce dtype. Cela n'est généralement pas nécessaire, car nous voulons créer le modèle avec fp32 lors de l'utilisationMixedPrecision, et fp32 c'est le dtype par défaut dans PyTorch. La valeur par défaut est None.

• config(dict) — Il s'agit d'un dictionnaire pour configurer le SMP transformateur. La valeur par défaut est None.

• load_state_dict_from_rank0(Booléen) — Par défaut, ce module crée une nouvelle instance du modèle avec de nouvelles pondérations. Lorsque cet argument est défini surTrue, SMP essaie de charger le dictionnaire d'état du PyTorch modèle d'origine du 0e rang dans le modèle transformé pour le groupe de tenseurs parallèles dont fait partie le 0e rang. Lorsque ce paramètre est défini surTrue, le rang 0 ne peut avoir aucun paramètre sur le méta-appareil. Seul le premier groupe tensoriel parallel renseigne les poids à partir du 0e rang après cet appel de transformation. Vous devez définir sync_module_states to True dans le FSDP wrapper pour obtenir ces poids du premier groupe parallèle de tenseurs vers tous les autres processus. Lorsque cette option est activée, la SMP bibliothèque charge le dictionnaire d'état à partir du modèle d'origine. La SMP bibliothèque prend le modèle avant state_dict la transformation, le convertit pour qu'il corresponde à la structure du modèle transformé, le divise pour chaque rang de tenseur parallèle, communique cet état du 0e rang aux autres rangs du groupe de tenseurs parallèles dont fait partie le 0e rang, et le charge. La valeur par défaut est False.

Fonctionnalités de l'utilitaire torch.sagemaker

• torch.sagemaker.init(config: Optional[Union[str, Dict[str, Any]]] = None) -> None— Initialise la tâche de PyTorch formation avecSMP.

• torch.sagemaker.is_initialized() -> bool— Vérifie si la tâche de formation est initialisée avecSMP. Lorsque vous revenez à la version native PyTorch alors que la tâche est initialisée avecSMP, certaines propriétés ne sont pas pertinentes et le deviennentNone, comme indiqué dans la liste des propriétés suivante.

• torch.sagemaker.utils.module_utils.empty_module_params(module: nn.Module, device: Optional[torch.device] = None, recurse: bool = False) -> nn.Module— Crée des paramètres vides sur les paramètres donnés, le device cas échéant, et il peut être récursif pour tous les modules imbriqués s'ils sont spécifiés.

• torch.sagemaker.utils.module_utils.move_buffers_to_device(module: nn.Module, device: torch.device, recurse: bool = False) -> nn.Module— Déplace les tampons des modules vers la valeur spécifiéedevice, et cela peut être récursif pour tous les modules imbriqués si cela est spécifié.

Propriétés

torch.sagemaker.statepossède plusieurs propriétés utiles après l'initialisation de SMP withtorch.sagemaker.init.

• torch.sagemaker.state.hybrid_shard_degree(int) — Le degré de parallélisme des données fragmentées, une copie des données saisies par l'utilisateur dans la SMP configuration transmise à. torch.sagemaker.init() Pour en savoir plus, consultez Utiliser la bibliothèque de parallélisme des SageMaker modèles v2.

• torch.sagemaker.state.rank(int) — Le classement global de l'appareil, dans la plage de[0, world_size).

• torch.sagemaker.state.rep_rank_process_group(torch.distributed.ProcessGroup) — Le groupe de processus comprenant tous les appareils ayant le même rang de réplication. Notez la différence subtile mais fondamentale avectorch.sagemaker.state.tp_process_group. Lorsqu'il revient au mode natif PyTorch, il revientNone.

• torch.sagemaker.state.tensor_parallel_degree(int) — Le degré de parallélisme du tenseur, une copie de l'entrée utilisateur dans la SMP configuration transmise à. torch.sagemaker.init() Pour en savoir plus, consultez Utiliser la bibliothèque de parallélisme des SageMaker modèles v2.

• torch.sagemaker.state.tp_size(int) — Un alias pourtorch.sagemaker.state.tensor_parallel_degree.

• torch.sagemaker.state.tp_rank(int) — Le rang de parallélisme des tenseurs pour le dispositif dans la plage de[0, tp_size), déterminé par le degré de parallélisme des tenseurs et le mécanisme de classement.

• torch.sagemaker.state.tp_process_group(torch.distributed.ProcessGroup) — Le groupe de processus tensor parallel comprenant tous les appareils ayant le même rang dans d'autres dimensions (par exemple, parallélisme et réplication de données partitionnées) mais des rangs tensoriels parallèles uniques. Lorsqu'il revient au mode natif PyTorch, il revientNone.

• torch.sagemaker.state.world_size(int) — Le nombre total d'appareils utilisés pendant l'entraînement.