braket.aws.aws_quantum_simulator module

class braket.aws.aws_quantum_simulator.AwsQuantumSimulator(arn: str, aws_session=None)[source]

Bases: braket.devices.device.Device

Amazon Braket implementation of a quantum simulator. Use this class to retrieve the latest metadata about the simulator, and to run a task on the simulator.

Parameters
  • arn (str) – The ARN of the simulator, for example,

  • "arn – aws:aqx:::quantum-simulator:aqx:qs1”.

  • aws_session (AwsSession, optional) – An AWS session object. Default = None.

run(task_specification: Union[braket.circuits.circuit.Circuit, braket.annealing.problem.Problem], s3_destination_folder: braket.aws.aws_session.S3DestinationFolder, shots: Optional[int] = None, *aws_quantum_task_args, **aws_quantum_task_kwargs)braket.aws.aws_quantum_task.AwsQuantumTask[source]

Run a task on the simulator device.

Parameters
Returns

AwsQuantumTask – An AwsQuantumTask that tracks the task execution on the device.

Examples

>>> circuit = Circuit().h(0).cnot(0, 1)
>>> device = AwsQuantumSimulator("arn:aws:aqx:::quantum-simulator:aqx:qs1")
>>> device.run(circuit, ("bucket", "key"), shots=1000)
>>> circuit = Circuit().h(0).cnot(0, 1)
>>> device = AwsQuantumSimulator("arn:aws:aqx:::quantum-simulator:aqx:qs1")
>>> device.run(circuit=circuit, s3_destination_folder=("bucket", "key"), shots=1000)
refresh_metadata() → None[source]

Refresh the AwsQuantumSimulator object with the most recent simulator metadata.

property arn

Returns the ARN of the simulator.

Type

str

property properties

Return the simulator properties

Type

Dict[str, Any]