This source did not publish a separate summary. Review SKILL.md before using the skill.
SKILL.md
PyTDC (Therapeutics Data Commons)
Overview
PyTDC is an open-science platform providing AI-ready datasets and benchmarks for drug discovery and development. Access curated datasets spanning the entire therapeutics pipeline with standardized evaluation metrics and meaningful data splits, organized into three categories: single-instance prediction (molecular/protein properties), multi-instance prediction (drug-target interactions, DDI), and generation (molecule generation, retrosynthesis).
When to Use This Skill
This skill should be used when:
Working with drug discovery or therapeutic ML datasets
Benchmarking machine learning models on standardized pharmaceutical tasks
Predict pharmacokinetic properties of drug molecules.
from tdc.single_pred import ADME
data = ADME(name='Caco2_Wang') # Intestinal permeability
# Other datasets: HIA_Hou, Bioavailability_Ma, Lipophilicity_AstraZeneca, etc.
For complete oracle documentation, see references/oracles.md.
Advanced Features
Retrieve Available Datasets
from tdc.utils import retrieve_dataset_names
# Get all ADME datasets
adme_datasets = retrieve_dataset_names('ADME')
# Get all DTI datasets
dti_datasets = retrieve_dataset_names('DTI')
Label Transformations
# Get label mapping
label_map = data.get_label_map(name='DrugBank')
# Convert labels
from tdc.chem_utils import label_transform
transformed = label_transform(y, from_unit='nM', to_unit='p')
Database Queries
from tdc.utils import cid2smiles, uniprot2seq
# Convert PubChem CID to SMILES
smiles = cid2smiles(2244)
# Convert UniProt ID to amino acid sequence
sequence = uniprot2seq('P12345')
Common Workflows
Workflow 1: Train a Single Prediction Model
See scripts/load_and_split_data.py for a complete example:
from tdc.single_pred import ADME
from tdc import Evaluator
# Load data
data = ADME(name='Caco2_Wang')
split = data.get_split(method='scaffold', seed=42)
train, valid, test = split['train'], split['valid'], split['test']
# Train model (user implements)
# model.fit(train['Drug'], train['Y'])
# Evaluate
evaluator = Evaluator(name='MAE')
# score = evaluator(test['Y'], predictions)
Workflow 2: Benchmark Evaluation
See scripts/benchmark_evaluation.py for a complete example with multiple seeds and proper evaluation protocol.
Workflow 3: Molecular Generation with Oracles
See scripts/molecular_generation.py for an example of goal-directed generation using oracle functions.
Resources
This skill includes bundled resources for common TDC workflows:
scripts/
load_and_split_data.py: Template for loading and splitting TDC datasets with various strategies
benchmark_evaluation.py: Template for running benchmark group evaluations with proper 5-seed protocol
molecular_generation.py: Template for molecular generation using oracle functions
references/
datasets.md: Comprehensive catalog of all available datasets organized by task type
oracles.md: Complete documentation of all 17+ molecule generation oracles
utilities.md: Detailed guide to data processing, splitting, and evaluation utilities