Updated requirements, added quackseq autodoc.

This commit is contained in:
jupfi 2024-06-23 16:55:19 +02:00
parent 30fe0b575b
commit c53f87ca95
7 changed files with 45 additions and 12 deletions

View file

@ -1,4 +1,5 @@
sphinx sphinx
setuptools
pydata-sphinx-theme pydata-sphinx-theme
myst-parser myst-parser
nqrduck nqrduck
@ -7,5 +8,8 @@ nqrduck-spectrometer-limenqr
nqrduck-spectrometer-simulator nqrduck-spectrometer-simulator
nqrduck-autotm nqrduck-autotm
nqrduck-broadband nqrduck-broadband
quackseq
quackseq-simulator
quackseq-limenqr
sphinx-design sphinx-design
sphinxcontrib-bibtex sphinxcontrib-bibtex

View file

@ -23,4 +23,12 @@ API Reference
:caption: Other Components: :caption: Other Components:
limedriverbindings limedriverbindings
nqr-blochsimulator nqr-blochsimulator
.. toctree::
:maxdepth: 2
:caption: QuackSeq:
quackseq
quackseq-simulator
quackseq-limenqr

View file

@ -0,0 +1,8 @@
QuackSeq LimeNQR
================
.. autosummary::
:toctree: _autosummary
:recursive:
quackseq_limenqr

View file

@ -0,0 +1,8 @@
QuackSeq Simulator
==================
.. autosummary::
:toctree: _autosummary
:recursive:
quackseq_simulator

View file

@ -0,0 +1,8 @@
QuackSeq
========
.. autosummary::
:toctree: _autosummary
:recursive:
quackseq

View file

@ -1,9 +1,9 @@
# Welcome to the NQRduckumentation! # Welcome to the NQRduckumentation
<img src="_static/Logo_full.png" alt="NQRduck Logo" class="center"> <img src="_static/Logo_full.png" alt="NQRduck Logo" class="center">
<br> <br>
This program is intended as an educational tool for magnetic resonance experiments (NMR, NQR, ...). Its focus lies on modular behaviour depending on what nqrduck modules are installed. This program is intended as an educational tool for magnetic resonance experiments (NMR, NQR, ...). Its focus lies on modular behaviour depending on what nqrduck modules are installed.
::::{grid} 2 ::::{grid} 2
:gutter: 2 :gutter: 2
@ -22,9 +22,9 @@ There exists a range of different modules for the NQRduck software. The tutorial
::: :::
:::{grid-item-card} :::{grid-item-card}
:link: software_structure/index.html :link: software_structure/index.html
{fab}`python;pst-color-primary` **Software Structure** {fab}`python;pst-color-primary` **Software Structure**
^^^ ^^^
The NQRduck comes with a user friendly PyQt6 based user interface. Different Python modules can be installed via pip to customize the functionality of the program. The NQRduck comes with a user friendly PyQt6 based user interface. Different Python modules can be installed via pip to customize the functionality of the program.
::: :::
:::{grid-item-card} :::{grid-item-card}
:link: api_reference/index.html :link: api_reference/index.html
@ -47,4 +47,4 @@ tutorials/index
software_structure/index software_structure/index
api_reference/index api_reference/index
bibliography bibliography
``` ```

View file

@ -2,13 +2,11 @@
## Requirements ## Requirements
- Python 3.10+ - Python 3.10+
- pip - pip
- virtualenv - virtualenv
- About 600MB of free storage space - About 600MB of free storage space
## Steps (Linux) ## Steps (Linux)
1. Install the specified requirements. 1. Install the specified requirements.
@ -21,16 +19,15 @@
``` ```
3. You can now install the NQRduck core program: 3. You can now install the NQRduck core program:
```bash ```bash
pip install nqrduck pip install nqrduck
``` ```
4. Run the program with `nqrduck`. This should open up a window with the NQRduck install wizard. 4. Run the program with `nqrduck`. This should open up a window with the NQRduck install wizard.
5. The install wizard for different modules should open up. Install the modules you would like to use. Some modules have dependencies on other modules, but the install wizard will automatically install them for you. 5. The install wizard for different modules should open up. Install the modules you would like to use. Some modules have dependencies on other modules, but the install wizard will automatically install them for you.
6. You now need to restart the program. 6. You now need to restart the program.
7. You can switch between different modules with the toolbar. You can customize the appearance of the program in `Settings -> Preferences`. Settings are saved and restored on the next start. 7. You can switch between different modules with the toolbar. You can customize the appearance of the program in `Settings -> Preferences`. Settings are saved and restored on the next start.