nvalchemi-data-structures

Construct AtomicData and Batch objects for GPU-ready atomic graph workflows.

127|32|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/NVIDIA/nvalchemi-toolkit --skill nvalchemi-data-structures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nvalchemi-data-structures
Source: https://github.com/NVIDIA/nvalchemi-toolkit/tree/main/.claude/skills/nvalchemi-data-structures
Command: npx skills add https://github.com/NVIDIA/nvalchemi-toolkit --skill nvalchemi-data-structures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Graph-based representations of atomic systems and efficient batching for GPU computation are essential for scalable simulations and analytics. This skill provides core data structures to manage atomic graphs (AtomicData) and batched multiple systems (Batch).

Core Features & Use Cases

  • Core classes: AtomicData and Batch (Pydantic BaseModel with DataMixin) for GPU-ready data handling.
  • Flexible fields: positions, atomic_numbers, neighbor_list, energy, cell, pbc, and more; data can be extended via info dict.
  • Batch operations: create batches from data lists, inspect batch sizes, and transfer to devices for high-throughput computations.
  • ASE integration: construct AtomicData from ASE Atoms objects for easy ingestion of external structures.
  • High-performance workflow: includes graph-based representations and preparation for GPU-accelerated pipelines.

Quick Start

Import AtomicData and Batch from nvalchemi.data and start by creating a small AtomicData instance, then batch it with Batch.from_data_list.

Frequently Asked Questions about nvalchemi-data-structures

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

FAQPage Schema
How do I represent atomic systems as graphs for GPU computation?

Graph-based atomic data models enable efficient representation and batching of atomic systems for GPU workflows. They construct AtomicData and Batch objects, enforcing a Pydantic schema for positions and atomic_numbers while supporting optional energy and cell fields.

How do I batch multiple atomic graphs for high-throughput simulations?

Batching multiple atomic graphs for high-throughput simulations is done by creating Batch objects from a list of AtomicData instances. This prepares the combined graph data for device-aware operations and GPU-accelerated pipelines.

Can I construct atomic graph data from ASE Atoms objects?

Yes, you can construct atomic graph data from ASE Atoms objects. The data structures support ASE integration, allowing you to easily ingest external structures into AtomicData instances for your GPU workflows.

What data schema is enforced for atomic data models?

The data schema enforced for atomic data models is Pydantic-based. It requires core fields like positions and atomic_numbers, supports optional system fields such as energy, cell, and pbc, and allows extending data via an info dict.

When do I need graph-based representations for atomic systems?

You need graph-based representations for atomic systems when performing scalable materials simulations, nanostructures analysis, or building machine-learning potentials that require efficient data batching and GPU-accelerated computation.