diff --git a/README.md b/README.md index 97d90585c..a691a1443 100644 --- a/README.md +++ b/README.md @@ -187,4 +187,6 @@ Bloqade wouldn't exist if we weren't fortunate enough to obtain feedback from aw If you find a bug, have an idea, or find an issue with our documentation, please feel free to file an issue on the [Github repo itself](https://github.com/QuEraComputing/bloqade-python/issues/new/choose). +After using/experimenting/tinkering/hacking with Bloqade it would also be helpful to us for you to fill out [this form](https://share.hsforms.com/1FJjYan2VQC6NfrQ5IPAcewdrwvd) which allows us to get some more detailed feedback. + *May the van der Waals force be with you!* diff --git a/docs/contributing/index.md b/docs/contributing/index.md index 51c7633d1..133257661 100644 --- a/docs/contributing/index.md +++ b/docs/contributing/index.md @@ -12,3 +12,4 @@ Thank you for your interest in contributing to the project! We welcome all contr - [Design Philosophy and Architecture](design-philosophy-and-architecture.md) - [Community Slack](community-slack.md) - [Ask a Question](asking-a-question.md) +- [Providing Feedback](providing-feedback.md) diff --git a/docs/contributing/providing-feedback.md b/docs/contributing/providing-feedback.md new file mode 100644 index 000000000..fe87f4ec8 --- /dev/null +++ b/docs/contributing/providing-feedback.md @@ -0,0 +1,7 @@ +# Providing Feedback + +While Github Issues are a great way for us to better understand any issues your having with Bloqade as well as provide us with feature requests, we're always looking for ways to collect more general feedback about what the user experience with Bloqade is like. + +To do that we have [this form](https://share.hsforms.com/1FJjYan2VQC6NfrQ5IPAcewdrwvd) where you can provide your thoughts after using/experimenting/tinkering/hacking with Bloqade. + +Your feedback will help guide the future of Bloqade's design so be honest and know that you're contributing to the future of Quantum Computing with Neutral Atoms! \ No newline at end of file diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md deleted file mode 100644 index f10335294..000000000 --- a/docs/tutorials/index.md +++ /dev/null @@ -1,5 +0,0 @@ -# Tutorials - -Below you will find some examples of how to use Bloqade. - -1. [Rabi Oscillations](scripts/rabi.py) diff --git a/docs/tutorials/scripts/rabi.py b/docs/tutorials/scripts/rabi.py deleted file mode 100644 index ef4c9876c..000000000 --- a/docs/tutorials/scripts/rabi.py +++ /dev/null @@ -1,104 +0,0 @@ -# --- -# jupyter: -# jupytext: -# formats: ipynb,py:percent -# hide_notebook_metadata: false -# text_representation: -# extension: .py -# format_name: percent -# format_version: '1.3' -# jupytext_version: 1.14.5 -# kernelspec: -# display_name: .venv -# language: python -# name: python3 -# --- - -# %% [markdown] -# # Single Qubit Rabi Oscillations -# ## Introduction -# In this example we show how to use Bloqade to emulate a -# Rabi oscillation as well as run it on hardware. - -# %% -from bloqade import start, cast -from bloqade.task.json import load_batch, save_batch -from decimal import Decimal -import matplotlib.pyplot as plt - - -# %% [markdown] - -# define program with one atom, with constant detuning but variable Rabi frequency, -# ramping up to "rabi_value" and then returning to 0.0. - -# %% -durations = cast(["ramp_time", "run_time", "ramp_time"]) - -rabi_oscillations_program = ( - start.add_position((0, 0)) - .rydberg.rabi.amplitude.uniform.piecewise_linear( - durations=durations, values=[0, "rabi_value", "rabi_value", 0] - ) - .detuning.uniform.constant(duration=sum(durations), value=0) -) - -# %% [markdown] -# Assign values to the variables in the program, -# allowing the `run_time` (time the Rabi amplitude stays at the value of -# "rabi_frequency" ) to sweep across a range of values. - -# %% -rabi_oscillation_job = rabi_oscillations_program.assign( - ramp_time=0.06, rabi_value=15, detuning_value=0.0 -).batch_assign(run_time=[Decimal("0.05") * i for i in range(21)]) - -# %% [markdown] -# Run the program in emulation, obtaining a report -# object. For each possible set of variable values -# to simulate (in this case, centered around the -# `run_time` variable), let the task have 10000 shots. - -# %% -emulator_results = rabi_oscillation_job.braket.local_emulator().run(1000) -save_batch("rabi-emulator-job.json", emulator_results) - - -# %% [markdown] -# Submit the same program to hardware, -# this time using `.parallelize` to make a copy of the original geometry -# (a single atom) that fills the FOV (Field-of-View Space), with at least -# 24 micrometers of distance between each atom. -# -# Unlike the emulation above, we only let each task -# run with 100 shots. A collection of tasks is known as a -# "Job" in Bloqade and jobs can be saved in JSON format -# so you can reload them later (a necessity considering -# how long it may take for the machine to handle tasks in the queue) - -# %% -""" -hardware_result = rabi_oscillation_job.parallelize(24).braket.aquila().submit(1000) -save_batch("rabi-job.json", hardware_result) -""" - -# %% [markdown] -# Load JSON and pull results from Braket - -# %% -emulator_report = load_batch("rabi-emulator-job.json").report() -# hardware_report = load_batch("rabi-job.json").fetch().report() - -times = emulator_report.list_param("run_time") -bitstrings = emulator_report.bitstrings() -emu_density = [ele.mean() for ele in bitstrings] -plt.plot(times, emu_density) - -# bitstrings = hardware_report.bitstrings() -# qpu_density = [ele.mean() for ele in bitstrings] - -# plt.plot(times, qpu_density) -plt.show() - - -# %% diff --git a/mkdocs.yml b/mkdocs.yml index f01dc643a..ff8cd50ba 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -21,7 +21,8 @@ nav: - Developing Bloqade: contributing/developing-bloqade.md - Design Philosophy and Architecture: contributing/design-philosophy-and-architecture.md - Community Slack: contributing/community-slack.md - - Asking a Question: 'contributing/asking-a-question.md' + - Asking a Question: contributing/asking-a-question.md + - Providing Feedback: contributing/providing-feedback.md - Tutorials: 'https://queracomputing.github.io/bloqade-python-examples/latest/' - Reference: - Builder Overview: builder-workflow/overview.md