Add ORCA backends and documentation

[Omar-ORCA]

Description

Added documentation for ORCA backend. Python implementation can be found in #1690.
This PR closes #1388
It also partially fixes #1285

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[khalatepradnya]

/ok to test

Command Bot: Processing...

[github-actions]

CUDA Quantum Docs Bot: A preview of the documentation can be found here.

[khalatepradnya]

/ok to test

Command Bot: Processing...

[khalatepradnya]

Suggested patch#1 for spellings:

diff --git a/.github/workflows/config/spelling_allowlist.txt b/.github/workflows/config/spelling_allowlist.txt
index d33b9603a..cc4fd98fb 100644
--- a/.github/workflows/config/spelling_allowlist.txt
+++ b/.github/workflows/config/spelling_allowlist.txt
@@ -62,7 +62,6 @@ NVQC
 NVQIR
 OQC
 ORCA
-ORCA's
 OpenACC
 OpenMP
 OpenMPI
@@ -126,7 +125,6 @@ bitstrings
 boolean
 boson
 broadcasted
-bs
 buildable
 callable
 callables
@@ -224,7 +222,6 @@ namespace
 namespaces
 natively
 normalization
-np
 nullary
 optimizer
 optimizers
@@ -241,7 +238,6 @@ prepend
 preprocessor
 probability
 programmatically
-ps
 pybind
 quantize
 quantized
diff --git a/docs/sphinx/examples/cpp/providers/orca.cpp b/docs/sphinx/examples/cpp/providers/orca.cpp
index 4ec859252..bd06a8783 100644
--- a/docs/sphinx/examples/cpp/providers/orca.cpp
+++ b/docs/sphinx/examples/cpp/providers/orca.cpp
@@ -1,7 +1,6 @@
 // Compile and run with:
 // ```
-// nvq++ --target orca --orca-url $ORCA_ACCESS_URL orca.cpp -o out.x
-// && ./out.x
+// nvq++ --target orca --orca-url $ORCA_ACCESS_URL orca.cpp -o out.x && ./out.x
 // ```
 // To use the ORCA Computing target you will need to set the ORCA_ACCESS_URL
 // environment variable or pass the url to the --orca-url flag.
@@ -53,8 +52,10 @@ int main() {
 
   // Optionally, we can also specify the phase shifter angles (created as a
   // linear spaced vector of angles), if the system includes phase shifters
+  // ```
   // std::vector<double> ps_angles(n_beam_splitters);
   // linear_spaced_vector(ps_angles, M_PI / 6, M_PI / 3, n_beam_splitters);
+  // ```
 
   // we can also set number of requested samples
   int n_samples{10000};
@@ -67,8 +68,10 @@ int main() {
   // If the system includes phase shifters, the phase shifter angles can be
   // included in the call
 
+  // ```
   // auto counts = cudaq::orca::sample(input_state, loop_lengths, bs_angles,
   //                                   ps_angles, n_samples);
+  // ```
 
   // Print the results
   counts.dump();
diff --git a/docs/sphinx/examples/python/providers/orca.py b/docs/sphinx/examples/python/providers/orca.py
index a0314c5d6..9e488ea15 100644
--- a/docs/sphinx/examples/python/providers/orca.py
+++ b/docs/sphinx/examples/python/providers/orca.py
@@ -38,7 +38,9 @@ bs_angles = np.linspace(np.pi / 8, np.pi / 3, n_beam_splitters)
 
 # Optionally, we can also specify the phase shifter angles, if the system 
 # includes phase shifters
+# ```
 # ps_angles = np.linspace(np.pi / 6, np.pi / 3, n_beam_splitters)
+# ```
 
 # we can also set number of requested samples
 n_samples = 10000
@@ -50,8 +52,10 @@ counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles, n_samples)
 
 # If the system includes phase shifters, the phase shifter angles can be 
 # included in the call
+# ```
 # counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles, ps_angles, 
 #                            n_samples)
+# ```
 
 # Print the results
 print(counts)

[github-actions]

CLA Assistant Lite bot All Contributors have signed the CLA.

[khalatepradnya]

/ok to test

Command Bot: Processing...

[github-actions]

CUDA Quantum Docs Bot: A preview of the documentation can be found here.

[schweitzpgi]

This is blocked waiting for a "code owner".

[bmhowe23]

/ok to test

Command Bot: Processing...

[bmhowe23]

LGTM. Thanks @Omar-ORCA.

[github-actions]

CUDA Quantum Docs Bot: A preview of the documentation can be found here.

[bmhowe23]

/ok to test

Command Bot: Processing...