ml-property-predict-scd

Train atomistic property prediction models from SelfConditionedDenoisingAtoms checkpoints.

144|21|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill ml-property-predict-scd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ml-property-predict-scd
Source: https://github.com/learningmatter-mit/AtomisticSkills/tree/main/.agents/skills/ml-property-predict-scd
Command: npx skills add https://github.com/learningmatter-mit/AtomisticSkills --skill ml-property-predict-scd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enables training or transfer of property-prediction models from SelfConditionedDenoisingAtoms (SCD) foundation checkpoints, reducing the effort to build ML pipelines for atomistic materials and molecular property datasets.

Core Features & Use Cases

  • Frozen SCD encoder embeddings: reuse pretrained SCD to generate mol_emb graph-level features (and optionally atom_embs) for downstream ML.
  • Lightweight head adaptation: train scalar_head, atom_emb_mlp, or mol_emb_mlp while keeping the SCD backbone frozen for faster iteration.
  • Full-model finetuning or pretraining: run upstream train.py for full finetuning or pretraining from scratch on new datasets.
  • Dataset onboarding guidance: provides a dataset contract for returning torch_geometric.data.Data with required fields for scalar/energy-force/periodic tasks.

Quick Start

Use the SCD frozen-backbone embedder to produce mol_emb features for a new molecular dataset task.

Frequently Asked Questions about ml-property-predict-scd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I predict molecular properties using pretrained graph embeddings?▼

You can predict molecular properties by using frozen SelfConditionedDenoisingAtoms encoder embeddings to generate mol_emb graph-level features for training lightweight downstream ML heads.

Can I finetune atomistic models for both molecules and periodic materials?▼

Yes, full-model finetuning supports both molecules and periodic materials, requiring correct checkpoint selection for each domain and enabling allow_periodic for periodic graph handling.

What is the dataset contract for training energy and force prediction models?▼

The dataset contract requires returning torch_geometric.data.Data objects containing the specific fields necessary for scalar, energy-force, or periodic property prediction tasks.

Do I need a specific Conda environment to train SCD property prediction models?▼

Yes, you must configure a scd-agent Conda environment to run the SCD foundation checkpoints for atomistic property prediction, lightweight head training, or pretraining from scratch.

What is the best way to adapt a pretrained materials science model for a new dataset?▼

The best way is lightweight head adaptation: train a scalar_head, atom_emb_mlp, or mol_emb_mlp while keeping the SCD backbone frozen to iterate faster on new datasets.

Why does my periodic material property prediction fail during dataset onboarding?▼

Periodic material prediction fails if the dataset contract is violated or if allow_periodic and noise_in_loader settings are not correctly configured for periodic graph handling.