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
setuptools
pydata-sphinx-theme
myst-parser
nqrduck
@ -7,5 +8,8 @@ nqrduck-spectrometer-limenqr
nqrduck-spectrometer-simulator
nqrduck-autotm
nqrduck-broadband
quackseq
quackseq-simulator
quackseq-limenqr
sphinx-design
sphinxcontrib-bibtex

View file

@ -23,4 +23,12 @@ API Reference
:caption: Other Components:
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">
<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
:gutter: 2
@ -22,9 +22,9 @@ There exists a range of different modules for the NQRduck software. The tutorial
:::
:::{grid-item-card}
: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}
:link: api_reference/index.html
@ -47,4 +47,4 @@ tutorials/index
software_structure/index
api_reference/index
bibliography
```
```

View file

@ -2,13 +2,11 @@
## Requirements
- Python 3.10+
- pip
- virtualenv
- About 600MB of free storage space
## Steps (Linux)
1. Install the specified requirements.
@ -21,16 +19,15 @@
```
3. You can now install the NQRduck core program:
```bash
```bash
pip install nqrduck
```
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.
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.