cuStateVec: A High-Performance Library for State Vector Quantum Simulators

Welcome to the cuStateVec library documentation!

NVIDIA cuStateVec is a high-performance library dedicated to operations with state vectors for expressing quantum algorithms. cuStateVec is a component of the NVIDIA cuQuantum SDK. Functionalities of cuStateVec and cuStateVec Ex are described in Overview with a usage guide provided under Examples.

cuStateVec Ex provides new API set for easy and quick development of state vector simulators with scalable capabilities from single-GPU to multiple-node systems.

cuStateVec API

• Provide APIs for:

  • State vector initialization

  • Gate application

  • Measurement

  • Expectation

  • Sampling

  • Qubit reordering on single/multiple device(s)

  • Logging purposes

cuStateVec Ex API

• Provide features for:

  • API set that seamlessly scales from single-device to multi-node systems

  • Distributed state vectors across multiple devices and processes

  • Standard operations for state vector simulations

  • State Vector Updater with gate fusion and noise channel support

Support

• Supported GPU Architectures: Turing, Ampere, Ada, Hopper, Blackwell

• Supported OSes: Linux

• Supported CPU Architectures: x86_64, ARM64

Prerequisites

One of the following CUDA Toolkits and a compatible driver are required:

CUDA Toolkit	Minimum Required Linux Driver Version
CUDA® 12.x	>= 525.60.13
CUDA® 13.x	>= 580.65.06

Please refer to CUDA Toolkit Release Notes for the details.

Contents

• Release Notes
  • cuStateVec v1.11.0
  • cuStateVec v1.10.1
  • cuStateVec v1.10.0
  • cuStateVec v1.9.0
  • cuStateVec v1.8.0
  • cuStateVec v1.7.0
  • cuStateVec v1.6.0
  • cuStateVec v1.5.0
  • cuStateVec v1.4.1
  • cuStateVec v1.4.0
  • cuStateVec v1.3.0
  • cuStateVec v1.2.0
  • cuStateVec v1.1.0
  • cuStateVec v1.0.0
  • cuStateVec v0.1.1
  • cuStateVec v0.1.0
  • cuStateVec v0.0.1
• Overview
  • State Vector Representation and Core Concepts
  • Features Common to cuStateVec and cuStateVec Ex API
  • cuStateVec API Features
  • cuStateVec Ex API Features
  • In-Depth Guides
  • References
  • Citing cuQuantum
• Examples
  • Compilation
  • cuStateVec code example
  • cuStateVec Ex Samples
  • Useful tips
• API Reference
  • cuStateVec API Reference
  • cuStateVec Ex API Reference