New in Quantum Cloud Services, you can now easily book and manage reservations on Rigetti's QPU lattices using the command-line interface. To use this functionality, you'll need to be connected to your QMI.
- Booking a new reservation
First, you'll need to select a lattice that you would like to reserve and execute your program with. To view a list of all available lattices, use the following command:
$ qcs lattices
All available lattices will be displayed, ordered by number of qubits (low-to-high), for example:
Copy the name of the lattice you'd like to reserve, for example Aspen-0-6Q-C.
Next, to book a reservation for your selected lattice, type:
$ qcs reserve --help
You'll be presented with a list of options to include for booking your lattice at a preferred time and duration.
All times are displayed in your local time zone—specifically, based on your browser location at the time in which you uploaded your SSH key to QCS.
If the date and time you entered are not available, the CLI will automatically propose the next available times for you to accept or decline. To book a proposed time, simply enter y to confirm and you'll receive a confirmation message. To decline and try an alternative time, enter n and the next available time will be proposed.
- Viewing your current and upcoming reservations
You can view a list of your scheduled reservations with the following command:
$ qcs reservations
- Changing or canceling an existing reservation
To change an upcoming reservation, you'll need to cancel it and book a new reservation.
To cancel, first locate the ID of the reservation by using the qcs reservations command. Next, use qcs cancel command and enter y when prompted to confirm your cancellation.
$ qcs cancel -i <PASTE_RESERVATION_ID>
Then, to book a new reservation, follow the instructions above.
Preparing for your upcoming reservation
Once you've scheduled a reservation, here's some tips to help you get the most out of your reserved time:
Begin developing your program locally, and then copy your file to your QMI. You can continue editing this file on your QMI using third-party tools, or simply replace this file with an updated version.
Test and run your program on the QVM simulator before your reservation begins. Refer to the ForestTM SDK docs for more details on using the QVM. Here are some tips:
When running your program on the QVM simulator, remember to target the corresponding lattice in which you've reserved:
After testing your program on the QVM simulator, remember to update your program to target the lattice (rather than the QVM) by setting as_qvm=False.
To queue your program to automatically execute at the start of your reservation, rather than having to manually initialize its execution, follow this guide. Alternatively, during your reserved time, you can execute your program manually (i.e. $ python <YOUR_FILE_NAME>), run a Jupyter notebook, interact with your lattice in iPython from your Terminal, or work in whatever way you prefer.
If you need help with scheduling or managing your reservations, contact our support team at email@example.com.