ts-quantum/dist/quantum/src/states/composite.js

TypeScript library for quantum mechanics calculations and utilities

/**
 * Multi-type quantum composition operations
 */
import { StateVector } from './stateVector';
import { validatePartialTrace } from '../utils/validation';
/**
 * Composes multiple Hilbert spaces via tensor product
 */
export function composeSpaces(spaces) {
    if (spaces.length === 0) {
        throw new Error('Empty spaces array');
    }
    return spaces.reduce((acc, space) => acc.tensorProduct(space));
}
/**
 * Composes multiple state vectors via tensor product
 */
export function composeStates(states) {
    if (states.length === 0) {
        throw new Error('Empty states array');
    }
    // Convert to StateVector instances if needed and use tensorProduct
    const stateVectors = states.map(state => state instanceof StateVector ? state : new StateVector(state.dimension, state.amplitudes, state.basis));
    return stateVectors.reduce((acc, state) => acc.tensorProduct(state));
}
/**
 * Composes multiple operators via tensor product
 */
export function composeOperators(operators) {
    if (operators.length === 0) {
        throw new Error('Empty operators array');
    }
    const [first, ...rest] = operators;
    return rest.reduce((acc, op) => acc.tensorProduct(op), first);
}
/**
 * Creates a bipartite split of a Hilbert space
 */
export function bipartiteSplit(space, firstDimension) {
    const totalDim = space.dimension;
    if (totalDim % firstDimension !== 0) {
        throw new Error('First dimension must divide total dimension');
    }
    const secondDimension = totalDim / firstDimension;
    return space.decompose([firstDimension, secondDimension]);
}
/**
 * Wrapper for partial trace operation that handles composite systems.
 * This function provides a convenient interface for performing partial trace
 * operations on composite quantum systems.
 *
 * @param operator - The quantum operator to perform partial trace on
 * @param dims - Array of dimensions for each subsystem
 * @param traceOutIndices - Indices of subsystems to trace out
 * @returns Reduced operator after tracing out specified subsystems
 */
export function partialTrace(operator, dims, traceOutIndices) {
    // Use standardized validation
    validatePartialTrace(dims, operator.dimension, traceOutIndices);
    // Delegate to operator's implementation
    return operator.partialTrace(dims, traceOutIndices);
}
//# sourceMappingURL=composite.js.map