Skip to content

Braket

BraketDeviceRoute 

BraketDeviceRoute(parent: Optional[Builder] = None)

Bases: Builder


              flowchart TD
              bloqade.analog.builder.backend.braket.BraketDeviceRoute[BraketDeviceRoute]
              bloqade.analog.builder.base.Builder[Builder]
              bloqade.analog.builder.parse.trait.Parse[Parse]
              bloqade.analog.builder.parse.trait.ParseRegister[ParseRegister]
              bloqade.analog.builder.parse.trait.ParseSequence[ParseSequence]
              bloqade.analog.builder.parse.trait.ParseCircuit[ParseCircuit]
              bloqade.analog.builder.parse.trait.ParseRoutine[ParseRoutine]
              bloqade.analog.builder.parse.trait.Show[Show]

                              bloqade.analog.builder.base.Builder --> bloqade.analog.builder.backend.braket.BraketDeviceRoute
                                bloqade.analog.builder.parse.trait.Parse --> bloqade.analog.builder.base.Builder
                                bloqade.analog.builder.parse.trait.ParseRegister --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseSequence --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseCircuit --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseRoutine --> bloqade.analog.builder.parse.trait.Parse
                

                bloqade.analog.builder.parse.trait.Show --> bloqade.analog.builder.base.Builder
                



              click bloqade.analog.builder.backend.braket.BraketDeviceRoute href "" "bloqade.analog.builder.backend.braket.BraketDeviceRoute"
              click bloqade.analog.builder.base.Builder href "" "bloqade.analog.builder.base.Builder"
              click bloqade.analog.builder.parse.trait.Parse href "" "bloqade.analog.builder.parse.trait.Parse"
              click bloqade.analog.builder.parse.trait.ParseRegister href "" "bloqade.analog.builder.parse.trait.ParseRegister"
              click bloqade.analog.builder.parse.trait.ParseSequence href "" "bloqade.analog.builder.parse.trait.ParseSequence"
              click bloqade.analog.builder.parse.trait.ParseCircuit href "" "bloqade.analog.builder.parse.trait.ParseCircuit"
              click bloqade.analog.builder.parse.trait.ParseRoutine href "" "bloqade.analog.builder.parse.trait.ParseRoutine"
              click bloqade.analog.builder.parse.trait.Show href "" "bloqade.analog.builder.parse.trait.Show"
Source code in .venv/lib/python3.12/site-packages/bloqade/analog/builder/base.py 
10
11
12
13
14
def __init__(
    self,
    parent: Optional["Builder"] = None,
) -> None:
    self.__parent__ = parent

aquila 

aquila() -> BraketHardwareRoutine

Specify QuEra's Aquila QPU on Braket to submit your program to.

The number of shots you specify in the subsequent .run method will either: - dictate the number of times your program is run - dictate the number of times per parameter your program is run if you have a variable with batch assignments/intend to conduct a parameter sweep

  • Possible next steps are:
    • ...aquila().run(shots): To submit to hardware and WAIT for results (blocking)
    • ...aquila().run_async(shots): To submit to hardware and immediately allow for other operations to occur
Source code in .venv/lib/python3.12/site-packages/bloqade/analog/builder/backend/braket.py 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
def aquila(self) -> "BraketHardwareRoutine":
    """
    Specify QuEra's Aquila QPU on Braket to submit your program to.

    The number of shots you specify in the subsequent `.run` method will either:
        - dictate the number of times your program is run
        - dictate the number of times per parameter your program is run if
          you have a variable with batch assignments/intend to conduct
          a parameter sweep


    - Possible next steps are:
        - `...aquila().run(shots)`: To submit to hardware and WAIT for
            results (blocking)
        - `...aquila().run_async(shots)`: To submit to hardware and immediately
            allow for other operations to occur
    """
    return self.parse().braket.aquila()

device 

device(device_arn) -> BraketHardwareRoutine

Specify QPU based on the device ARN on Braket to submit your program to.

The number of shots you specify in the subsequent .run method will either: - dictate the number of times your program is run - dictate the number of times per parameter your program is run if you have a variable with batch assignments/intend to conduct a parameter sweep

  • Possible next steps are:
    • ...device(arn).run(shots): To submit to hardware and WAIT for results (blocking)
    • ...device(arn).run_async(shots): To submit to hardware and immediately allow for other operations to occur
Source code in .venv/lib/python3.12/site-packages/bloqade/analog/builder/backend/braket.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
def device(self, device_arn) -> "BraketHardwareRoutine":
    """
    Specify QPU based on the device ARN on Braket to submit your program to.

    The number of shots you specify in the subsequent `.run` method will either:
        - dictate the number of times your program is run
        - dictate the number of times per parameter your program is run if
            you have a variable with batch assignments/intend to conduct
            a parameter sweep


    - Possible next steps are:
        - `...device(arn).run(shots)`: To submit to hardware and WAIT for
            results (blocking)
        - `...device(arn).run_async(shots)`: To submit to hardware and immediately
            allow for other operations to occur
    """
    return self.parse().braket.device(device_arn)

local_emulator 

local_emulator() -> BraketLocalEmulatorRoutine

Specify the Braket local emulator to submit your program to.

  • The number of shots you specify in the subsequent .run method will either:
    • dictate the number of times your program is run
    • dictate the number of times per parameter your program is run if you have a variable with batch assignments/intend to conduct a parameter sweep
  • Possible next steps are:
    • ...local_emulator().run(shots): to submit to the emulator and await results
Source code in .venv/lib/python3.12/site-packages/bloqade/analog/builder/backend/braket.py 
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
def local_emulator(self) -> "BraketLocalEmulatorRoutine":
    """
    Specify the Braket local emulator to submit your program to.

    - The number of shots you specify in the subsequent `.run` method will either:
        - dictate the number of times your program is run
        - dictate the number of times per parameter your program is run if
          you have a variable with batch assignments/intend to
          conduct a parameter sweep
    - Possible next steps are:
        - `...local_emulator().run(shots)`: to submit to the emulator
            and await results

    """
    return self.parse().braket.local_emulator()

BraketService 

BraketService(parent: Optional[Builder] = None)

Bases: Builder


              flowchart TD
              bloqade.analog.builder.backend.braket.BraketService[BraketService]
              bloqade.analog.builder.base.Builder[Builder]
              bloqade.analog.builder.parse.trait.Parse[Parse]
              bloqade.analog.builder.parse.trait.ParseRegister[ParseRegister]
              bloqade.analog.builder.parse.trait.ParseSequence[ParseSequence]
              bloqade.analog.builder.parse.trait.ParseCircuit[ParseCircuit]
              bloqade.analog.builder.parse.trait.ParseRoutine[ParseRoutine]
              bloqade.analog.builder.parse.trait.Show[Show]

                              bloqade.analog.builder.base.Builder --> bloqade.analog.builder.backend.braket.BraketService
                                bloqade.analog.builder.parse.trait.Parse --> bloqade.analog.builder.base.Builder
                                bloqade.analog.builder.parse.trait.ParseRegister --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseSequence --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseCircuit --> bloqade.analog.builder.parse.trait.Parse
                
                bloqade.analog.builder.parse.trait.ParseRoutine --> bloqade.analog.builder.parse.trait.Parse
                

                bloqade.analog.builder.parse.trait.Show --> bloqade.analog.builder.base.Builder
                



              click bloqade.analog.builder.backend.braket.BraketService href "" "bloqade.analog.builder.backend.braket.BraketService"
              click bloqade.analog.builder.base.Builder href "" "bloqade.analog.builder.base.Builder"
              click bloqade.analog.builder.parse.trait.Parse href "" "bloqade.analog.builder.parse.trait.Parse"
              click bloqade.analog.builder.parse.trait.ParseRegister href "" "bloqade.analog.builder.parse.trait.ParseRegister"
              click bloqade.analog.builder.parse.trait.ParseSequence href "" "bloqade.analog.builder.parse.trait.ParseSequence"
              click bloqade.analog.builder.parse.trait.ParseCircuit href "" "bloqade.analog.builder.parse.trait.ParseCircuit"
              click bloqade.analog.builder.parse.trait.ParseRoutine href "" "bloqade.analog.builder.parse.trait.ParseRoutine"
              click bloqade.analog.builder.parse.trait.Show href "" "bloqade.analog.builder.parse.trait.Show"
Source code in .venv/lib/python3.12/site-packages/bloqade/analog/builder/base.py 
10
11
12
13
14
def __init__(
    self,
    parent: Optional["Builder"] = None,
) -> None:
    self.__parent__ = parent

braket property 

braket

Specify the Braket backend. This allows you to access the AWS Braket local emulator OR go submit things to QuEra hardware on AWS Braket service.

  • Possible Next Steps are:
    • ...braket.aquila(): target submission to the QuEra Aquila QPU
    • ...braket.local_emulator(): target submission to the Braket local emulator