qiskit-documentation/docs/api/qiskit/0.27/qiskit.aqua.utils.random_no...

37 lines
1.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: random_non_hermitian
description: API reference for qiskit.aqua.utils.random_non_hermitian
in_page_toc_min_heading_level: 1
python_api_type: function
python_api_name: qiskit.aqua.utils.random_non_hermitian
---
# qiskit.aqua.utils.random\_non\_hermitian
<Function id="qiskit.aqua.utils.random_non_hermitian" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/aqua/utils/random_matrix_generator.py" signature="random_non_hermitian(N, M=None, sings=None, K=None, srange=None, sparsity=None, trunc=None)">
Generate random (sparse) matrix with given properties (singular values). Sparsity is achieved by truncating Pauli matrices. Sparsity settings alternate the singular values due to truncation.
**Parameters**
* **N** (*int*) size of matrix
* **M** (*int*) size of matrix
* **sings** (*Union(list, tuple, np.ndarray)*) list of N singular values. Overrides K, srange.
* **K** (*Union(float, list, tuple)*) condition number. Either use only condition number K or list/tuple of (K, lmin). Where lmin specifies the smallest singular value.
* **srange** (*Union(list, tuple, nd.ndarray)*) \[min, max] list for singular value range, min >= 0. (default=\[0, 1]).
* **sparsity** (*float*) sparsity of matrix. Overrides trunc.
* **trunc** (*int*) limit of Pauli matrices.
**Returns**
random matrix
**Return type**
np.ndarray
**Raises:**
ValueError: invalid matrix
</Function>