How psp3dcg/lightrosetta works
Project type and purpose
• LightRoseTTA is an open‑source, PyTorch‑based protein structure prediction system.
• It provides both an inference pipeline (test_script.py, LightRoseTTA_test.py, data_pipeline.py) and a training pipeline (LightRoseTTA_training_code.zip plus generate/prepare scripts).
• Core functionality: given one or more FASTA sequences, generate multiple‑sequence alignment (MSA) features, build an atom‑level graph, run an SE(3)‑equivariant graph neural network, and output predicted 3D structures in PDB format.
File structure
Top‑level:
• LightRoseTTA-env.yml — Conda environment spec
• download_datasets.py — fetch large biological databases
• data_pipeline.py, test_script.py, LightRoseTTA_test.py — orchestrate inference
• LightRoseTTA_preprocess_train_data.zip, LightRoseTTA_training_code.zip — separate training resources
• README.md — installation, usage, training/testing instructions
• weights/ — pretrained model files
Key packages:
• msa_feat/ — MSA feature generation (calls BLAST, CS-BLAST, PSIPRED, runs shells)
• atom_graph/ — build amino‑acid graph representations (node labels, bond types)
• model/ — defines LightRoseTTA network modules (embeddings, attention_module, SE3_network, transformer, refine_net, distance_predictor, etc.)
• utils/ & confs/ — shared utilities (parsers, kinematics, PDB generation, logging, profiling)
README for additional insights
• Highlights external dependencies (Uniref30, BFD, pdb100 datasets; blast, csblast, psipred).
• Testing and training use separate scripts and data archives.
Essential details to capture
• The two‑stage nature: preprocessing vs model execution
• All major sub‑packages and their roles
• External dependencies and where they plug in
• Clear separation of training vs inference
• Data inputs/outputs at each boundary