Bitsandbytes documentation

Embedding

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Embedding

The embedding class is used to store and retrieve word embeddings from their indices. There are two types of embeddings in bitsandbytes, the standard PyTorch Embedding class and the StableEmbedding class.

The StableEmbedding class was introduced in the 8-bit Optimizers via Block-wise Quantization paper to reduce gradient variance as a result of the non-uniform distribution of input tokens. This class is designed to support quantization.

Embedding

class bitsandbytes.nn.Embedding

< >

( num_embeddings: int embedding_dim: int padding_idx: Optional = None max_norm: Optional = None norm_type: float = 2.0 scale_grad_by_freq: bool = False sparse: bool = False _weight: Optional = None device: Optional = None )

Embedding class to store and retrieve word embeddings from their indices.

__init__

< >

( num_embeddings: int embedding_dim: int padding_idx: Optional = None max_norm: Optional = None norm_type: float = 2.0 scale_grad_by_freq: bool = False sparse: bool = False _weight: Optional = None device: Optional = None )

Parameters

  • num_embeddings (int) — The number of unique embeddings (vocabulary size).
  • embedding_dim (int) — The dimensionality of the embedding.
  • padding_idx (Optional[int]) — Pads the output with zeros at the given index.
  • max_norm (Optional[float]) — Renormalizes embeddings to have a maximum L2 norm.
  • norm_type (float, defaults to 2.0) — The p-norm to compute for the max_norm option.
  • scale_grad_by_freq (bool, defaults to False) — Scale gradient by frequency during backpropagation.
  • sparse (bool, defaults to False) — Computes dense gradients. Set to True to compute sparse gradients instead.
  • _weight (Optional[Tensor]) — Pretrained embeddings.

StableEmbedding

class bitsandbytes.nn.StableEmbedding

< >

( num_embeddings: int embedding_dim: int padding_idx: Optional = None max_norm: Optional = None norm_type: float = 2.0 scale_grad_by_freq: bool = False sparse: bool = False _weight: Optional = None device = None dtype = None )

Parameters

  • norm (torch.nn.LayerNorm) — Layer normalization applied after the embedding.

Custom embedding layer designed to improve stability during training for NLP tasks by using 32-bit optimizer states. It is designed to reduce gradient variations that can result from quantization. This embedding layer is initialized with Xavier uniform initialization followed by layer normalization.

Example:

# Initialize StableEmbedding layer with vocabulary size 1000, embedding dimension 300
embedding_layer = StableEmbedding(num_embeddings=1000, embedding_dim=300)

# Reset embedding parameters
embedding_layer.reset_parameters()

# Perform a forward pass with input tensor
input_tensor = torch.tensor([1, 2, 3])
output_embedding = embedding_layer(input_tensor)

Methods: reset_parameters(): Reset embedding parameters using Xavier uniform initialization. forward(input: Tensor) -> Tensor: Forward pass through the stable embedding layer.

__init__

< >

( num_embeddings: int embedding_dim: int padding_idx: Optional = None max_norm: Optional = None norm_type: float = 2.0 scale_grad_by_freq: bool = False sparse: bool = False _weight: Optional = None device = None dtype = None )

Parameters

  • num_embeddings (int) — The number of unique embeddings (vocabulary size).
  • embedding_dim (int) — The dimensionality of the embedding.
  • padding_idx (Optional[int]) — Pads the output with zeros at the given index.
  • max_norm (Optional[float]) — Renormalizes embeddings to have a maximum L2 norm.
  • norm_type (float, defaults to 2.0) — The p-norm to compute for the max_norm option.
  • scale_grad_by_freq (bool, defaults to False) — Scale gradient by frequency during backpropagation.
  • sparse (bool, defaults to False) — Computes dense gradients. Set to True to compute sparse gradients instead.
  • _weight (Optional[Tensor]) — Pretrained embeddings.
< > Update on GitHub