QXel.simulator.density_matrix_simulator module

class QXel.simulator.density_matrix_simulator.DensityMatrixSimulator

Bases: BaseSimulator

High-level entry point for density-matrix simulation.

__init__()

Create a simulator with the state-vector-style transpiler stack.

run(qubit_count, operations, results=[], *, shots=0, max_fusion=4, compute_type='cpu', data_type='complex128', offload_type='none', do_overlap=False, path=None)

Transpile and execute a circuit with the density-matrix backend.

Parameters:

  • qubit_count (int) – Total logical qubit count.

  • operations (list[Operator]) – Circuit operations in logical qubit order.

  • results (list[Result], optional) – Result descriptors to evaluate.

  • shots (int, optional) – Number of measurement samples to draw.

  • max_fusion (int, optional) – Largest gate width generated by the fusion pass.

  • compute_type (str, optional) – Execution backend. Supported values include "cpu", "cuda", and "cuquantum".

  • data_type (str, optional) – Scalar storage type. Currently only "complex128" is accepted.

  • offload_type (str, optional) – Secondary storage tier used when the full density matrix cannot stay resident in the compute buffer.

  • do_overlap (bool, optional) – Reserved for interface parity with the state-vector simulator.

  • path (Optional[list[str] | str], optional) – Storage roots used for filesystem offloading.

Returns:

Materialized result payloads in the same order as results.

Return type:

list