Papers › 3D-MolT5: Leveraging Discrete Structural Information for Molecule-Text Modeling

3D-MolT5: Leveraging Discrete Structural Information for Molecule-Text Modeling

9 Jun 2024arXiv:2406.05797archive 2025-07-28

Qizhi Pei, Rui Yan, Kaiyuan Gao, Jinhua Zhu, Lijun Wu

The integration of molecular and natural language representations has emerged as a focal point in molecular science, with recent advancements in Language Models (LMs) demonstrating significant potential for comprehensive modeling of both domains. However, existing approaches face notable limitations, particularly in their neglect of three-dimensional (3D) information, which is crucial for understanding molecular structures and functions. While some efforts have been made to incorporate 3D molecular information into LMs using external structure encoding modules, significant difficulties remain, such as insufficient interaction across modalities in pre-training and challenges in modality alignment. To address the limitations, we propose \textbf{3D-MolT5}, a unified framework designed to model molecule in both sequence and 3D structure spaces. The key innovation of our approach lies in mapping fine-grained 3D substructure representations into a specialized 3D token vocabulary. This methodology facilitates the seamless integration of sequence and structure representations in a tokenized format, enabling 3D-MolT5 to encode molecular sequences, molecular structures, and text sequences within a unified architecture. Leveraging this tokenized input strategy, we build a foundation model that unifies the sequence and structure data formats. We then conduct joint pre-training with multi-task objectives to enhance the model's comprehension of these diverse modalities within a shared representation space. Thus, our approach significantly improves cross-modal interaction and alignment, addressing key challenges in previous work. Further instruction tuning demonstrated that our 3D-MolT5 has strong generalization ability and surpasses existing methods with superior performance in multiple downstream tasks. Our code is available at https://github.com/QizhiPei/3D-MolT5.

PaperPDFCodeCode Syntology ran

In Syntology View this paper on Syntology: its repositories, every harvested function with whether it ran, its licence and the call to fetch it.

Open this paper in Syntology's Atlas, the map of the papers in Syntology's graph and their citations.

For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2406.05797")

Code

Syntology Ran 10 of 16 code samples harvested from 1 repository linked to this paper; 6 have no recorded run. Of those that ran: 2 ran · honoured contract; 8 ran with no contract checked.

By repository: official repository: 16 samples from 1 repository, 10 ran. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

qizhipei/3d-molt5 officialmentioned in paperApache-2.0 report

Repository list and official/mentioned flags are the archive's, frozen 2025-07-28. Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

16 samples harvested; 10 ran; 2 honoured the contract we drafted; 6 have no recorded run. Read from Syntology's graph 2026-09-25; that is when this build read the record, not when the samples ran.

2ran · honoured contract
8ran
6unverified

Licence: 0 of the 16 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from QizhiPei/3D-MolT5. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

compute_input_and_target_lengths QizhiPei/3D-MolT5/3d_molt5/utils/copied_utils.py official repository ran Apache-2.0 (permissive) · d8c4822a9c1aff8b · report
extra_stats QizhiPei/3D-MolT5/3d_molt5/utils/train_utils.py official repository ran Apache-2.0 (permissive) · 15064abfc178475b · report
filter_selfies QizhiPei/3D-MolT5/3d_molt5/utils/train_utils.py official repository ran fingerprinted Apache-2.0 (permissive) · 747f68a91549b9bf · report
get_num_atoms_wH qizhipei/3d-molt5/3d_tokenization/3d_tokenize.py official repository ran · honoured contract Apache-2.0 (permissive) · 59d99c8d54d8f826 · report
get_num_atoms_woH qizhipei/3d-molt5/3d_tokenization/3d_tokenize.py official repository ran · honoured contract Apache-2.0 (permissive) · 8a25d2a3c55b13e5 · report
maybe_grad_clip_and_grad_calc QizhiPei/3D-MolT5/3d_molt5/utils/train_utils.py official repository ran Apache-2.0 (permissive) · 3a896a738d3c3bf4 · report
tokenize_function QizhiPei/3D-MolT5/3d_molt5/utils/copied_utils.py official repository ran Apache-2.0 (permissive) · 8a721263c3f886fd · report
tokenize_function_desc2seq_fp QizhiPei/3D-MolT5/3d_molt5/utils/custom_utils.py official repository ran Apache-2.0 (permissive) · 4ba39870e34467be · report
tokenize_function_fp QizhiPei/3D-MolT5/3d_molt5/utils/custom_utils.py official repository ran Apache-2.0 (permissive) · 459ed31c700da2f1 · report
tokenize_function_seq2desc_fp QizhiPei/3D-MolT5/3d_molt5/utils/custom_utils.py official repository ran Apache-2.0 (permissive) · b978f1a04e323c37 · report
FPT5EncoderStack qizhipei/3d-molt5/3d_molt5/utils/FPT5ForConditionalGeneration.py official repository unverified Apache-2.0 (permissive) · 8169ff566a7422b7 · report
FPT5ForConditionalGeneration qizhipei/3d-molt5/3d_molt5/utils/FPT5ForConditionalGeneration.py official repository unverified Apache-2.0 (permissive) · 2676a83bc4dcb809 · report
get_config QizhiPei/3D-MolT5/3d_molt5/utils/model_utils.py official repository unverified Apache-2.0 (permissive) · 844d192ab050d3cb · report
get_model QizhiPei/3D-MolT5/3d_molt5/utils/model_utils.py official repository unverified Apache-2.0 (permissive) · 1e65195a7a6b943d · report
get_tokenizer QizhiPei/3D-MolT5/3d_molt5/utils/model_utils.py official repository unverified Apache-2.0 (permissive) · 57301c9d45efc851 · report
setup_basics QizhiPei/3D-MolT5/3d_molt5/utils/gen_utils.py official repository unverified Apache-2.0 (permissive) · 29336ef2f9c5bce1 · report

Tasks

Molecular Property PredictionMolecule CaptioningProperty Prediction

Results from the paper archive 2025-07-28

No leaderboard rows for this paper in the archive.

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections