ambiguous-resonances-dataset
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 1 DOI reference(s) in README -
✓Academic publication links
Links to: aps.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.7%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: QISS-HZB
- License: gpl-3.0
- Language: Python
- Default Branch: main
- Size: 333 KB
Statistics
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Ambiguous Resonances Dataset
This repository contains the Python script for the graphical user interface (GUI) application of the dataset from the paper Ambiguous Resonances in Multipulse Quantum Sensing with Nitrogen Vacancy Centers in Diamonds by L. Tsunaki et al, available at: https://journals.aps.org/pra/abstract/10.1103/PhysRevA.111.022606
It is used to visualize and analyze the simulations of ambiguous resonances contained in the dataset, available at https://figshare.com/articles/dataset/Dataset_for_Ambiguous_Resonances_in_Multipulse_Quantum_Sensing_with_NVs/26245895 or https://box.fu-berlin.de/s/ajm6wijbKWJQKQS
In this GUI, the user can choose specific experimental parameters and compare with experimental data.

Setup
The application provides a GUI based on the
Python bindings for Qt6. It depends on NumPy, Matplotlib,
PyQt6/PySide6, andPyTables. Thus, we recommend creating a
conda virtual environment with:
sh
conda create --name dataset-env python numpy matplotlib pyside6 pytables
conda activate dataset-env
Usage
Download the HDF5 file from here or here and place it in the same directory as the script.
Optional: verify the integrity of the downloaded dataset
## sha256 checksum To make sure that the dataset was downloaded correctly, we provide the sha256 checksum. Run `sha256sum dataset.h5` on the downloaded file to obtain the checksum. It should match `94fd4c725c1353ac68a4102e8f825a59766bcafe5f6e140915a94df084845937`.And then to launch the GUI, one can simply run the following command in the cloned repository within the conda environment:
sh
python dataset_gui.py
This will launch the GUI with the standard HDF5 file. However, if the
user wants to have a different dataset file, the –-dataset flag can be
used as follows:
python dataset_gui.py --dataset /PATH/CUSTOM_DATASET.hdf5
The use of the GUI is intuitive and self-explanatory. There are two tabs, one for 15N and the other for 13C ambiguous resonances. The $ms$ state of the electronic spin transition should be chosen, with the order $M$ of the XY8 sequence, the bias magnetic field $B0$, minimum and maximum $\tau$ or $f$ range. In addition, for 15N, the angle $\theta$ must be specified and for 13C, the carbon families. The expected resonances from the gyromagnetic ratios of other nuclear spins can also be compared with.
A text file with experimental data can be
plotted together with the simulation for spectral disambiguation, with
the conditions that it can be read by numpy.loadtxt and its first
column representing $\tau$ or $f$ in the correct units and the second
indicating the XY8 intensity. Finally, the plot can be customized and
exported.
New simulations for ambiguous resonances are intended to be added to the dataset in the following months of the publishing of this paper. Depending on user feedback, the GUI might also undergo alterations.
Structure of the HDF5 file
The HDF5 file contains 3 groups, one each for 15N, 13C, and constants. The table structure for the data is:
15N: n15_group
| order | field | field_angle | ms | data | rabi | |-------|-------|-------------|-----|------|------| | ... | ... | ... | ... | ... | ... |
order: order of the XY8 sequence
field: static magnetic field in mT
field_angle: field misalignment angle in degrees
ms: spin state excited (+1 or -1)
data: the time series data for the simulated fluorescence
rabi: 1 indicates an uncertain Rabi period from the fit
13C: c13_group
| order | fam | field | ms | data | rabi | |-------|-----|-------|-----|------|------| | ... | ... | ... | ... | ... | ... |
order: order of the XY8 sequence
fam: 13C family
field: static magnetic field in mT
ms: spin state excited (+1 or -1)
data: the time series data for the simulated fluorescence
rabi: 1 indicates an uncertain Rabi period from the fit
Owner
- Name: QISS-HZB
- Login: QISS-HZB
- Kind: organization
- Repositories: 1
- Profile: https://github.com/QISS-HZB
Citation (CITATION.cff)
cff-version: 1.2.0
title: Ambiguous Resonances Dataset
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- given-names: Anmol
family-names: Singh
email: anmol.singh@helmholtz-berlin.de
orcid: 'https://orcid.org/0009-0000-1578-626X'
affiliation: Helmholtz Zentrum Berlin
- given-names: Lucas
email: lucas.tsunaki@helmholtz-berlin.de
affiliation: Helmholtz Zentrum Berlin
family-names: Tsunaki
orcid: 'https://orcid.org/0009-0003-3534-6300'
identifiers:
- type: doi
value: 10.1103/PhysRevA.111.022606
repository-code: 'https://github.com/QISS-HZB/ambiguous-resonances-dataset'
repository-artifact: >-
https://figshare.com/articles/dataset/Dataset_for_Ambiguous_Resonances_in_Multipulse_Quantum_Sensing_with_NVs/26245895
license: GPL-3.0
version: '2.0'
GitHub Events
Total
- Watch event: 1
- Push event: 2
Last Year
- Watch event: 1
- Push event: 2