Hardware configuration new - josalggui/MaRGE GitHub Wiki
System Configuration Notes
This section describes how to set up the system when running MaRGE for the first time. Currently, this tool is only available in the GUI branch, with a planned release to the master branch soon. Before proceeding, ensure that the Red Pitayas are configured properly by following this guide.
First Launch of MaRGE
When you open MaRGE for the first time, the new session window appears:
This window contains three key widgets:
- Scanner Checks – Displays missing configuration files.
- Information Area – Shows real-time system information.
- Session Tabs – Allows users to configure session parameters.
On the initial launch, you will notice:
- Errors displayed in the information area.
- Unchecked scanner checks.
- Disabled
Run Main GUI
buttons.
These issues stem from missing configuration files. This guide explains how to set them up properly.
Configuring the System Files
MaRGE requires the following eight elements to be configured upon first use:
- Projects
- Study Cases
- Gradient Hardware
- MaRCoS
- RF Configuration
- Red Pitaya IPs
- RF Coils
- Other Hardware Components
Setting Up Projects and Study Cases
To configure a project or study case:
- Click on the
Project/Study
box. - The box will be empty initially. Click
Add/Delete
to create a new entry. - A pop-up window appears where you can type the project/study name.
- Entering an existing name deletes that project/study.
Once added, clicking Update Scanner Hardware
in the session toolbar should check off Projects
and Study Cases
.
Configuring the Console and Red Pitayas
To configure the console and Red Pitayas:
- Navigate to the
Console
tab.
- Configure MaRCoS settings:
- Red Pitaya Model:
rp-122
orrp-125
- Gradient Board Model:
gpa-fhdo
orocra1
- Red Pitaya Model:
- Add the Red Pitaya IP (configured with a static IP):
- Enter the IP in the
IP
box and clickAdd
. - The new Red Pitaya appears in the console tab.
- Add multiple Red Pitayas if needed (e.g., for MIMO applications).
- Enter the IP in the
- Click
Save
and thenUpdate
to finalize the setup.MaRCoS
andRP IPs
should now be checked.
RF Configuration and RF Coils
To set up the RF system:
- Go to the
RF
tab.
- Define key parameters such as:
- Gyromagnetic ratio
- Larmor frequency
- RF dead time
- Add RF coils:
- Enter the RF coil ID and its RF efficiency.
- Click
Add
to include it in the configuration.
- Click
Save
andUpdate
.RFs
andRF Coils
should now be checked.- Added RF coils will appear in the selection box of the Session tab.
Configuring Gradients and Other Hardware
In the Gradients
and Others
tabs:
- Complete the configuration fields based on your hardware setup.
- Click
Save
and thenUpdate
.
Once all elements are configured:
- All checks should be marked.
- A
READY
message appears in the information console. - The
Run Main GUI
button becomes available.
Each time MaRGE is opened, the configuration is automatically loaded, allowing the user to proceed directly to the main window. The configuration can be modified and updated at any time to run the scanner with new parameters.