Qbit

Base classes: BasisState, State

An object representing a product state of qubits.

This class represents a product state of qubits together with its associated multiplicative coefficient. Each qubit ($\vert 0 \rangle$ or $\vert 1 \rangle$) corresponds respectively to the $+1$ and $-1$ eigenstates of the Pauli $Z$ operator. In other words, $Z \vert 0 \rangle = \vert 0 \rangle, \quad Z \vert 1 \rangle = -\vert 1 \rangle.$ The number of qubits in the product state corresponds to the number of sites on which it has support.

Constructors

Qbit(integer num_sites) -> Qbit

Constructs a qubit product state of size num_sites with every qubit set to $0$.

Parameters

• num_sites: The number of qubits in the product state in a one to one correspondence with the sites.

Example

Qbit(4) // Returns (1 + 0i)|0000>

Qbit(const string bitstring) -> Qbit

Constructs a qubit product state from a string of consecutive characters "$0$" and "$1$".

Parameters

• bitstring: A string representing the states of the qubits in the product state.

Example

Qbit("00110") // Returns (1 + 0i)|00110>

Qbit(integer num_sites, real coefficient) -> Qbit

Constructs a qubit product state of the specified size with every qubit set to $0$ with a specified real (converted to complex) multiplicative coefficient.

Parameters

• num_sites: The number of qubits in the product state in a one to one correspondence with the sites.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit(4, 2.0) // Returns (2 + 0i)|0000>

Qbit(integer num_sites, bool coefficient) -> Qbit

Constructs a qubit product state of the specified size with every qubit set to $0$ with a specified bool (converted to complex) multiplicative coefficient.

Parameters

• num_sites: The number of qubits in the product state in a one to one correspondence with the sites.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit(4, true) // Returns (1 + 0i)|0000>

Qbit(integer num_sites, complex coefficient) -> Qbit

Constructs a qubit product state of the specified size with every qubit set to $0$ with a specified complex multiplicative coefficient.

Parameters

• num_sites: The number of qubits in the product state in a one to one correspondence with the sites.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit(4, 2.0 + 5.0i) // Returns (2 + 5i)|0000>

Qbit(const string bitstring, integer coefficient) -> Qbit

Constructs a qubit product state from a string of "$0$" and "$1$" with a specified integer (converted to complex) multiplicative coefficient.

Parameters

• bitstring: A string representing the states of the qubits in the product state.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit("00110", 3) // Returns (3 + 0i)|00110>

Qbit(const string bitstring, real coefficient) -> Qbit

Constructs a qubit product state from a string of "$0$" and "$1$" with a specified real (converted to complex) multiplicative coefficient.

Parameters

• bitstring: A string representing the states of the qubits in the product state.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit("00110", 2.0) // Returns (2 + 0i)|00110>

Qbit(const string bitstring, bool coefficient) -> Qbit

Constructs a qubit product state from a string of "$0$" and "$1$" with a specified bool (converted to complex) multiplicative coefficient.

Parameters

• bitstring: A string representing the states of the qubits in the product state.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit("00110", true) // Returns (1 + 0i)|00110>

Qbit(const string bitstring, complex coefficient) -> Qbit

Constructs a qubit product state from a string of "$0$" and "$1$" with a specified complex multiplicative coefficient.

Parameters

• bitstring: A string representing the states of the qubits in the product state.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit("00110", 2.0 + 5.0i) // Returns (2 + 5i)|00110>

Qbit(integer num_sites, integer coefficient) -> Qbit

Constructs a qubit product state of the specified size with every qubit set to $0$ with a specified integer (converted to complex) multiplicative coefficient.

Parameters

• num_sites: The number of qubits in the product state in a one to one correspondence with the sites.
• coefficient: The coefficient that multiplies the qubit product state.

Example

Qbit(4, 3) // Returns (3 + 0i)|0000>

Symbols

Name	Description
=	Assignment operator for Qbit objects.

Members

Name	Description
count	Returns the sum of the qubit states (interpreted as integers) in the product state.
flip	This method flips the qubit at the specified site in place.
flipped	Returns a copy of the product state with the specified site flipped.
insert	Inserts a qubit set to 0 at the specified site.
inserted	Returns a copy of the product state with a qubit in the $0$ state inserted to the left of the qubit at the specified site.
period	Returns the number of times the qubits have to be circularly shifted to the right by one site before the obtained product state is equal to the starting product state.
permute	Permutes in place the qubits of the product state according to the specified permutation vector.
permuted	Returns a copy of the product state with its qubits permuted according to the specified permutation vector.
reflect	Reverses the product state (reversed end-to-end) in place.
reflected	Returns a copy of the reflected (reversed end-to-end) product state.
set_representation	Sets the integer representation of the Qbit.
split	Splits the product state into a pair of Qbit objects according to specified set of sites for the resulting left and right product state.
swap	This methods swaps the qubits of the product state at the specified sites in place.
swapped	Returns a copy of the Qbit object with two specified qubits swapped.
translate	Circularly shifts in place the qubits of the product state by $1$ site to the right a number of times equal to the provided integer.
translated	Returns a copy of the product state with its qubits shifted by $1$ site to the right a number of times equal to the provided integer.