nqrduck-spectrometer-limenqr/README.md

49 lines
2.6 KiB
Markdown
Raw Normal View History

2024-02-17 17:52:26 +00:00
# NQRduck Module: Spectrometer LimeNQR
This module is a part of the NQRduck project. It is a submodule of the [spectrometer module](https://github.com/nqrduck/nqrduck-spectrometer) for the NQRduck project. It is designed to be used with the [NQRduck](https://github.com/nqrduck) project.
The module provides a Graphical User Interface (GUI) for the control of the LimeSDR based spectrometer. It is designed to be used with the NQRduck project. The GUI is based on the [PyQt5](https://pypi.org/project/PyQt5/) library
The original code for the control of the LimeSDR based spectrometer was part of the paper by A. Doll; Pulsed and continuous-wave magnetic resonance spectroscopy using a low-cost software-defined radio. AIP Advances 1 November 2019; 9 (11): 115110. https://doi.org/10.1063/1.5127746. More information about the original code can be found in the [LimeDriver](https://github.com/nqrduck/limedriver) project.
The currently supported LimeSDR devices are:
- LimeSDR Mini v2.0 (probably also v1.x, but not tested)
- LimeSDR USB
## Installation
### Requirements
- [LimeSuite](https://wiki.myriadrf.org/Lime_Suite)
- [HDF5](https://www.hdfgroup.org/solutions/hdf5/)
You can find more information about the installation of dependencies in the [LimeDriver](https://github.com/nqrduck/limedriver) project.
Additional dependencies should be installed by the pyproject.toml file when installing this module.
2024-03-02 19:30:08 +00:00
### Setup
2024-02-17 17:52:26 +00:00
To install the module you need the NQRduck core. You can find the installation instructions for the NQRduck core [here](https://github.com/nqrduck/nqrduck).
Ideally you should install the module in a virtual environment. You can create a virtual environment by running the following command in the terminal:
```bash
python -m venv nqrduck
```
2024-04-23 16:06:12 +00:00
You can install this module and the dependencies by running the following command in the terminal after cloning the repositor and navigating to the module directory:
2024-02-17 17:52:26 +00:00
```bash
pip install .
```
2024-04-23 16:06:12 +00:00
Alternatively you can install the module via the PyPi package manager by running the following command in the terminal:
```bash
pip install nqrduck-spectrometer-limenqr
```
2024-02-17 17:52:26 +00:00
## Usage
The module is used together with the NQRduck [pulseprogrammer](htpps://github.com/nqrduck-pulseprogrammer) module.
### Notes
- When using the LimeSDR USB use the TX Matching: 0 and RX Matching: 0 for frequencies below 1.5GHz in the settings of the module.
- For the LimeSDR Mini 2.0 use the TX Matching: 2 and RX Matching: 2 for frequencies bellow 1.5GHz.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.