You are reading QUBO Solver v0.7.2, an older version of this documentation. Go to the latest version (v0.10.0)
Utilities
Utilities
Section titled “Utilities”Utilities provide helper functions to calculate and classify key metrics, as well as to save and load QUBO instances and datasets.
Density
Section titled “Density”- Calculate Density: Compute the fraction of non-zero elements in the QUBO matrix.
- Classify Density: Categorize density as SPARSE, MEDIUM, or HIGH.
from qubosolver.utils.density import calculate_density, classify_density
coefficients = torch.tensor([[0, 1, -2], [1, 0, 3], [-2, 3, 0]])size = 3
# Calculate densitydensity = calculate_density(coefficients, size)
# Classify densitydensity_type = classify_density(density)
print(f"Density: {density}, Classified as: {density_type}")Save and Load
Section titled “Save and Load”- Save a QUBOInstance: Save a
QUBOInstanceto a file. - Load a QUBOInstance: Load a
QUBOInstancefrom a file. - Save a QUBODataset: Save a
QUBODatasetto a file. - Load a QUBODataset: Load a
QUBODatasetfrom a file.
from qubosolver import QUBOInstance
# Define a QUBO coefficient matrixcoefficients = [[0, 1, -2], [1, 0, 3], [-2, 3, 0]]instance = QUBOInstance(coefficients=coefficients)
# Save and load a QUBOInstanceQUBOInstance.save("qubo_instance.pt", instance)loaded_instance = QUBOInstance.load("qubo_instance.pt")print(loaded_instance)from qubosolver import QUBODatasetfrom qubosolver.utils import save_qubo_dataset, load_qubo_dataset
dataset = QUBODataset.from_random(n=5, size=4, densities=[0.3, 0.7], coefficient_bounds=(-10,10), device="cpu")
# Save and load a QUBODatasetsave_qubo_dataset(dataset, "qubo_dataset.pt")loaded_dataset = load_qubo_dataset("qubo_dataset.pt")print(f"Loaded dataset size: {len(loaded_dataset)}")