Document Ramsey experiment

[hay-k]

We need to add proper documentation to all experiments, but let's start with this one.

Yesterday I learned that the Ramsey experiment is not doing true frequency detuning, but rather an artificial/fake detuning based on manipulating the relative phase of a pulse. This is not documented, and the knowledge about the motivation behind this particular choice seems to be fading out. Before this is completely forgotten, it should be documented.

• There should be brief documentation explaining what is the experiment doing in high level.
• There should be clear mentions of particular choices (like the handling of detuning mentioned above) done in the experiment, their motivation, and any references if available.

[Edoardo-Pedicillo]

• There should be brief documentation explaining what is the experiment doing in high level.

We are working in this direction, all our progresses about docs are documented in #649

[andrea-pasquale]

Thanks @hay-k for opening the issue.
Here is a reference to the artificial detuning by changing the relative phase

Gao's paper.
Theoretically the results should be the same but we should investigate more after running on hardware directly in both ways.
Moreover, this could be a good chance to use a proper notation instead of n_osc which corresponds to the number of oscillation that the user is expected to see. Perhaps indicating directly the detuning in Hz would be a better choice.

[hay-k]

Yeah, just to be clear, with this issue I am not implying or suggesting that one approach is better that the other. It may be a question worthwhile investigating, but it is a story for another day. Here I am just interested in having the choice of implementation documented, whatever it is.

[andrea-pasquale]

#861 (comment)

[scarrazza]

Shall we close this?

[andrea-pasquale]

I left this open on purpose because we want to expand a bit more the description of the Ramsey experiment.