Skip to content

Commit

Permalink
update docs to latest function names and remove private functions fro…
Browse files Browse the repository at this point in the history
…m api docs
  • Loading branch information
ccoffrin committed Mar 28, 2022
1 parent 6290918 commit d7adf1b
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 11 deletions.
10 changes: 5 additions & 5 deletions docs/src/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,22 @@
Modules = [QuantumAnnealing]
Pages = ["base.jl"]
Order = [:function]
Private = true
Private = false
```

# Simulate Functions
```@autodocs
Modules = [QuantumAnnealing]
Pages = ["simulate.jl"]
Order = [:function]
Private = true
Private = false
```

```@autodocs
Modules = [QuantumAnnealing]
Pages = ["simulate_de.jl"]
Order = [:function]
Private = true
Private = false
```

## Annealing Schedules
Expand All @@ -37,13 +37,13 @@ AS_DW_QUADRATIC
Modules = [QuantumAnnealing]
Pages = ["ising.jl"]
Order = [:function]
Private = true
Private = false
```

# D-Wave Functions
```@autodocs
Modules = [QuantumAnnealing]
Pages = ["dwave.jl"]
Order = [:function]
Private = true
Private = false
```
12 changes: 6 additions & 6 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ QuantumAnnealing provides the [`read_bqpjson`](@ref) function for reading `bqpjs

As part of [D-Wave Systems' documentation](https://docs.dwavesys.com/docs/latest/doc_physical_properties.html) annealing schedules are provided as `xlsx` files
with four columns `s`, `A(s)`, `B(s)`, `C (normalized)`.
The [`parse_dwave_annealing_schedule`](@ref) parses this data (in `csv` format) and converts it into the conventions used by QuantumAnnealing.
The [`read_dwave_annealing_schedule`](@ref) parses this data (in `csv` format) and converts it into the conventions used by QuantumAnnealing.

Users are strongly encouraged to download annealing schedules for specific
D-Wave Systems devices of interest, however a canonical D-Wave annealing
Expand All @@ -111,7 +111,7 @@ preliminary testing and debugging.
Although the _global_ annealing schedule is fixed in D-Wave hardware an
[_annealing schedule parameter_](https://docs.dwavesys.com/docs/latest/c_qpu_annealing.html#varying-the-global-anneal-schedule) can be used to modify how the schedule is
executed in time by specifying a list of control points. QuantumAnnealing
provides the function [`dwave_annealing_protocol`](@ref) to apply these changes
provides the function [`annealing_protocol_dwave`](@ref) to apply these changes
to an annealing schedule inside of QuantumAnnealing.

### D-Wave Simulation
Expand All @@ -133,16 +133,16 @@ state\_index = \sum^n_{i = 1} 2^{i-1} q_i
```
In this encoding, qubit 1 (i.e. $q_1$) is the least significant digit and qubit $n$ (i.e. $q_n$) is the most significant digit.
For example, in a 3 qibit system the a state value of 4 is equivalent to the binary array in Julia `[0,0,1]`.
The translation functions [`int2binary`](@ref) and [`binary2int`](@ref) performs these conversions following the code's conventions.
The translation functions [`int_to_binary`](@ref) and [`binary_to_int`](@ref) performs these conversions following the code's conventions.

When printing qubit states as strings using the bra-ket notation (i.e. `|xyz⟩`) the least significant qubit is presented as the right most value.
For example, in a 3 qubit system the state index 4 is presented as `|100⟩` in the bra-ket notation.
The translation function [`binary2braket`](@ref) performs this encoding.
The translation function [`binary_to_braket`](@ref) performs this encoding.

When translating binary 0/1 qubit values into up/down spin values the following conversion is used $\sigma_i = (-1)^{q_i}$, specifically $0 \rightarrow 1$ (up) and $1 \rightarrow -1$ (down).
This conversion is done so that the following property holds, $mod(q_1 + q_2, 2) = \sigma_1 \sigma_2$.
The function [`binary2spin`](@ref) performs this translation.
When presenting up/down qubit states as strings using the bra-ket notation the values are presented as $\uparrow$/$\downarrow$ using the helper function [`spin2braket`](@ref).
The function [`binary_to_spin`](@ref) performs this translation.
When presenting up/down qubit states as strings using the bra-ket notation the values are presented as $\uparrow$/$\downarrow$ using the helper function [`spin_to_braket`](@ref).
For example, in a 3 qubit system the state index 4 is presented as `|↓↑↑⟩` in the up/down bra-ket notation.


Expand Down

2 comments on commit d7adf1b

@ccoffrin
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v0.2.0 @JuliaRegistrator register

@JuliaRegistrator
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Registration pull request created: JuliaRegistries/General/57431

After the above pull request is merged, it is recommended that a tag is created on this repository for the registered package version.

This will be done automatically if the Julia TagBot GitHub Action is installed, or can be done manually through the github interface, or via:

git tag -a v0.2.0 -m "<description of version>" d7adf1b2c25aed9e9937c35d639de954102797e2
git push origin v0.2.0

Please sign in to comment.