Diffusers documentation
RFD4ProteinaTransformer
RFD4ProteinaTransformer
Denoiser dari RFD4-Proteína. Prediksi kecepatan untuk dua modalitas yang diintegrasikan oleh sampler — posisi CA backbone dan latens lokal per-token — dari tensor molekul yang telah disiapkan. Input berupa tensor bernama plus pemetaan kondisioning yang isinya dipilih oleh konfigurasi checkpoint; parsing struktur berada di luar kelas ini.
from diffusers import RFD4ProteinaTransformer
transformer = RFD4ProteinaTransformer.from_pretrained(
"nvidia/RFD4-Proteina-Diffusers", subfolder="transformer"
)RFD4ProteinaTransformer
kelas diffusers.RFD4ProteinaTransformer
< source >( nlayers: int = 14token_dim: int = 768nheads: int = 12dim_cond: int = 256pair_repr_dim: int = 384latent_dim: int = 32token_type_emb_dim: int = 32cath_emb_dim: int = 32t_emb_dim: int = 256seq_sep_dim: int = 64xt_pair_dist_dim: int = 30xt_pair_dist_min: float = 0.1xt_pair_dist_max: float = 3.0feats_seq: tuple[str, ...] = ('xt_bb_ca', 'xt_local_latents', 'token_type', 'sequence_probabilities', 'cond_a37coors_nm', 'cond_a37coors_internal_nm', 'rasa_binned', 'secondary_structure', 'hbond_modernized', 'pistack', 'pication', 'saltbridge', 'hydrophobic', 'metal_coord', 'na_ss_state', 'hotspot', 'atom_charge', 'atomic_element', 'coord_group_seq', 'chirality', 'chain_centroid_xyz')feats_cond_seq: tuple[str, ...] = ('time_emb_bb_ca', 'time_emb_local_latents', 'cath_code', 'recycle_remaining')feats_pair_repr: tuple[str, ...] = ('xt_bb_ca_pair_dists', 'bond_mask', 'bond_order', 'is_aromatic', 'index_group_pair', 'molecule_idx_pair', 'molecule_entity_pair', 'token_bond_path_length', 'canonical_polymer_ordering', 'na_ss_pair')feats_pair_cond: tuple[str, ...] = ('time_emb_bb_ca', 'time_emb_local_latents')update_pair_repr_every_n: int = 2tri_mult_c: int = 256num_sequence_classes: int = 147num_token_types: int = 7recycle_conditioning_dim: int = 1 )
Parameter
- nlayers (
int, defaultnya14) — Jumlah lapisan trunk. - token_dim (
int, defaultnya768) — Lebar representasi token. - nheads (
int, defaultnya12) — Jumlah kepala perhatian per lapisan. - dim_cond (
int, defaultnya256) — Lebar vektor kondisioning (waktu, indeks daur ulang, label CATH). - pair_repr_dim (
int, defaultnya384) — Lebar representasi pasangan. - latent_dim (
int, defaultnya32) — Lebar laten lokal per token. - token_type_emb_dim (
int, defaultnya32) — Lebar embedding tipe token. - cath_emb_dim (
int, defaultnya32) — Lebar setiap embedding kelas/arsitektur/topologi CATH. - t_emb_dim (
int, defaultnya256) — Lebar embedding waktu sinusoidal. - seq_sep_dim (
int, defaultnya64) — Jumlah bin panjang jalur ikatan. - xt_pair_dist_dim (
int, defaultnya30) — Jumlah bin jarak pasangan backbone. - xt_pair_dist_min (
float, default0.1), xt_pair_dist_max (float, default3.0) — Rentang jarak pasangan dalam nanometer. - feats_seq, feats_cond_seq, feats_pair_repr, feats_pair_cond (
list[str]) — Nama fitur yang diproyeksikan ke input token, kondisioning, pasangan, dan kondisioning pasangan. - update_pair_repr_every_n (
int, defaultnya2) — Seberapa sering representasi pasangan diperbarui dari token di antara lapisan. - tri_mult_c (
int, defaultnya256) — Lebar tersembunyi dari perkalian segitiga dalam pembaruan tersebut. - num_token_types (
int, defaultnya7) — Ukuran kosakata tipe token: protein, RNA, DNA, atomized, unknown, glikan, dan asam amino non-kanonik. - recycle_conditioning_dim (
int, defaultnya1) — Lebar dari one-hotrecycle_remaining, ketika fitur tersebut ada difeats_cond_seq. - num_sequence_classes (
int, defaultnya147) — Ukuran kosakata residu yang diprediksi oleh pembacaan urutan.
RFD4 velocity denoiser dengan backbone berpasangan dan modalitas lokal-latent.
Model berjalan dalam dtype-nya sendiri: muat dengan dtype=torch.bfloat16 untuk inferensi presisi-rendah. State sampling yang diteruskan ke forward tetap dalam float32; embedding fitur dihitung dalam float32 dan di-cast pada proyeksi input.
forward
< source >( bb_ca: Tensorlocal_latents: Tensorbb_ca_time: Tensorlocal_latents_time: Tensorpadding_mask: Tensortoken_type: typing.Optional[torch.Tensor] = Noneatom37_mask: typing.Optional[torch.Tensor] = Noneconditioning: dict[str, typing.Any] | None = Nonerecycle_depth: int = 0attention_kwargs: dict[str, typing.Any] | None = Nonereturn_dict: bool = True ) → RFD4ProteinaTransformerOutput or tuple
Parameter
- bb_ca (
torch.Tensor) — Koordinat backbone berisik(batch, tokens, 3)dalam nanometer. - local_latents (
torch.Tensor) — Laten lokal berisik(batch, tokens, latent_dim). - bb_ca_time (
torch.Tensor) —(batch,)waktu backbone dalam [0, 1]. - local_latents_time (
torch.Tensor) —(batch,)waktu laten lokal dalam [0, 1]. - padding_mask (
torch.Tensor) —(batch, tokens), bernilai true di mana token tersebut asli, bukan padding. - token_type (
torch.Tensor, opsional) — kode token-type(batch, tokens). - atom37_mask (
torch.Tensor, opsional) —(batch, tokens, 37), bernilai true di mana slot atom digunakan. - conditioning (
dict[str, Any], opsional) — Tensor topologi dan kondisioning lainnya, di bawah kunci yang dihasilkan oleh preprocessor. Kunci mana yang dibaca ditentukan olehfeats_seq,feats_cond_seq,feats_pair_repr, danfeats_pair_conddari checkpoint; jika kunci yang diminta oleh fitur yang dikonfigurasi tidak ada, fitur tersebut akan tetap tanpa kondisioning alih-alih memicu error. - recycle_depth (
int, defaultnya0) — Jumlah lintasan trunk; nol tetap menjalankan satu lintasan. - attention_kwargs (
dict, opsional) — Hanyascaleyang dibaca, sebagai skala LoRA untuk panggilan ini. - return_dict (
bool, defaultnyaTrue) — Mengembalikan output bertipe, atau tuple dari field yang bukan None.
Mengembalikan
RFD4ProteinaTransformerOutput atau tuple
Kecepatan backbone/laten-lokal dan logit urutan/insersi opsional, sebelum integrasi scheduler.
Prediksi kecepatan dari tensor molekul yang telah disiapkan tanpa memajukan sampler.
RFD4ProteinaTransformerOutput
kelas diffusers.models.transformers.transformer_rfd4_proteina.RFD4ProteinaTransformerOutput
< source >( backbone: Tensorlocal_latents: typing.Optional[torch.Tensor] = Nonesequence_logits: typing.Optional[torch.Tensor] = Noneinsertion_logits: typing.Optional[torch.Tensor] = None )
Parameter
- backbone (
torch.Tensor) — Kecepatan backbone berbentuk(batch, tokens, 3), dalam nanometer per satuan waktu. - local_latents (
torch.Tensor) — Kecepatan laten dengan bentuk(batch, tokens, latent_dim). - sequence_logits (
torch.Tensor, opsional) — Logit residu dengan bentuk(batch, tokens, 147). - insertion_logits (
torch.Tensor, opsional) — Logit penugasan sisipan dengan bentuk(batch, tokens, tokens).
Prediksi denoiser sebelum integrasi scheduler.